内容
<div align="center">
# 编辑工具
### 使用AI编辑TikTok视频。本地运行。开源。
**免费、本地优先的视频编辑器，具备语音克隆、卡拉OK字幕、自动调整帧率和MCP大脑。**
**您的视频永远不会离开您的计算机。**
[](LICENSE)
[](#)
[](#)
[](https://github.com/pixelshelps-cloud/Editia/stargazers)
</div>
---
## 为什么选择编辑工具？
> **CapCut替代品。开源。运行在您的机器上。包含AI。**
每个人都想要病毒式内容。没有人愿意将他们的视频上传到陌生人的服务器上。编辑工具为您提供了一个专业的视频编辑器，它运行在您的笔记本电脑上，可以克隆语音，在本地Whisper中生成卡拉OK字幕，并允许**Claude、Cursor或任何MCP代理通过聊天编辑您的时间线**。
无需订阅。无需遥测。无需账号。**属于您。**
---
## 您将获得什么
### 🎬 专业编辑
- 多轨时间线，支持吸附、拖拽、波纹删除、撤销/重做
- 11种LUT预设（电影 · 复古 · 冷色 · 暖色 · 黑白 · 鲜艳 · 褪色 · 夜间 · 日落 · 戏剧）
- 颜色分级 + 手动裁剪 + 速度控制（0.25x → 4x · 慢动作 & 时间快进）
- PIP（画中画）支持TL/TR/BL/BR预设
- 淡入/淡出 + 10种过渡类型（交叉淡入、滑动、擦除、渐变）
### 🎤 AI语音克隆（本地）
- **通过XTTS-v2在您的GPU上克隆任何语音**
- 几秒内生成PT/ES/EN的配音
- 两个内置语音：`nuno`（男）· `clara`（女）——您可以自带
### 📝 卡拉OK字幕（本地）
- **faster-whisper** 在CUDA上的转录
- 5种流行预设：**卡拉OK · MrBeast · 广播 · 霓虹 · 简约**
- 逐字计时，实现TikTok风格的高亮
### 🎯 自动调整帧率 9:16，支持人脸跟踪
- **MediaPipe FaceDetector** 本地
- 实时人脸检测 → 自动裁剪 → 不会丢失主体
- 目标比例：9:16 · 1:1 · 4:5
### ✂️ 智能剪辑
- 检测PT/ES中的静默 + 填充词（eh, ah, tipo, sabes, pronto, vale…）
- 一键删除所有
### 🔥 病毒式剪辑
- 检测1小时视频的5个最佳时刻
- 自动导出为9:16的Shorts
### 🌊 自动混音
- **自动降低音乐音量**：当有语音时，音乐会自动降低
- 主音量 + VU表 + 每个剪辑的音量
- 波形图实时渲染在时间线上
### 🥁 节拍检测
- 对您的配乐进行FFT分析
- **自动剪辑** 视频 **在节拍上**
### 🧠 MCP大脑 —— 代理可以编辑您的时间线
- 标准MCP服务器，包含8种工具
- 支持 **Claude Code/Desktop, Cursor, Cline, Continue, Goose…**
- 输入“将此调整为9:16，并添加卡拉OK字幕”并观看变化
### 📤 导出
- H.264 / H.265 / VP9（MP4 或 WebM）
- 6种社交媒体预设：TikTok / Reels / Shorts / IG Feed / YouTube 1080p / 4K
- 自定义分辨率 + 帧率
### 🔒 优先考虑本地
- 零遥测。零账号。零服务器。
- 您的媒体永远不会离开您的机器。
- 开源MIT。
---
## 快速入门（Windows）
```bash
git clone https://github.com/pixelshelps-cloud/Editia.git
cd Editia
npm install
# 双击 ABRIR-EDITIA.bat
```
启动器启动：
- 编辑器位于 `http://localhost:5173`
- 本地转录引擎位于 `127.0.0.1:9173` （faster-whisper · CUDA）
- 本地语音引擎位于 `127.0.0.1:9174` （XTTS）
- MCP大脑位于 `ws://127.0.0.1:9175`
内置的30秒交互式导览会在首次运行时带您了解所有功能。
您可以随时通过 **Shift+T** 重新打开它。
## 快速入门（Linux/Mac）
```bash
npm install
npm run dev
```
对于辅助程序（Python + CUDA）：请参见 [`sidecar/transcribe/README.md`](sidecar/transcribe/README.md)。
---
## 连接MCP代理
在您的 `.mcp.json` 中添加以下内容（Claude Code, Cursor, Cline, Continue…）：
```json
{
"mcpServers": {
"editia": {
"command": "node",
"args": ["./sidecar/mcp/server.mjs"]
}
}
}
```
代理可用的工具：
`editia_get_timeline` · `editia_add_text` · `editia_split_clip` ·
`editia_delete_clip` · `editia_move_clip` · `editia_generate_captions` ·
`editia_generate_voice` · `editia_import_media`
然后输入类似以下内容：
- *"在第二个位置添加'Bem-vindos'，使用MrBeast风格"*
- *"按照歌曲的节拍剪辑这个视频"*
- *"将这个视频调整为9:16，并添加葡萄牙语的卡拉OK字幕"*
---
## 快捷键
| 键 | 操作 |
|---|---|
| `Space` | 播放 / 暂停 |
| `J / K / L` | 后退 / 暂停 / 前进（重复时加速） |
| `S` | 在播放头处分割剪辑 |
| `D` | 复制剪辑 |
| `M` | 添加标记 |
| `,` / `.` | 上一个 / 下一个标记 |
| `Tab` / `Shift+Tab` | 下一个 / 上一个剪辑 |
| `Del` / `Shift+Del` | 删除 / 波纹删除 |
| `Ctrl+Z` / `Ctrl+Y` | 撤销 / 重做 |
| `←` / `→` | 1帧 |
| `Shift+←` / `Shift+→` | 1秒 |
| `Alt+←` / `Alt+→` | 按1帧移动剪辑 |
| `Z` | 缩放以适应时间线 |
| `G` | 切换三分法则网格 |
| `Shift+T` | 重新打开30秒导览 |
| `?` | 显示所有快捷键 |
| `Esc` | 清除选择 / 关闭对话框 |
---
## 技术栈
| 层 | 库 | 许可证 |
|---|---|---|
| 编辑器 | React 18 + TypeScript + Vite + Tailwind + Zustand | MIT |
| 编码器 | **mediabunny** + WebCodecs | MIT |
| 人脸跟踪 | `@mediapipe/tasks-vision` | Apache 2.0 |
| 转录 | **faster-whisper** （本地 · CUDA） | MIT |
| 语音克隆 | **XTTS-v2** （本地 · GPU） | MPL 2.0 |
| 代理协议 | `@modelcontextprotocol/sdk` | MIT |
| 显示字体 | **Bricolage Grotesque** | OFL |
所有内容均为MIT/Apache许可。无需在您的fork的LICENSE中注明出处。
---
## 结构
```
editia/
├─ ABRIR-EDITIA.bat # 一键Windows启动器
├─ src/
│ ├─ components/ # UI（布局 / 预览 / 时间线 / 面板 / 检查器 / 入门）
│ ├─ stores/ # Zustand（项目 · UI · 播放 · 入门）
│ ├─ services/ # 转录 / TTS / 导出 / 智能剪辑 / 病毒式剪辑 / 自动调整帧率 /
│ │ # 代理桥 / 持久化 / 过渡 / 自动降低音乐音量 / 节拍检测 /
│ │ # 文本动画 / 缩略图 / 波形图 / 媒体探测 / 媒体获取 / 录音机
│ ├─ hooks/ # 快捷键 / 导入 / 预览渲染 / 引擎状态
│ ├─ lib/ # 时间 · ID · 吸附 · LUTs · 文本预设
│ ├─ data/ # 入门步骤
│ └─ types/ # 项目（整个数据模型）
└─ sidecar/
├─ transcribe/ # faster-whisper（9173）+ XTTS（9174）
└─ mcp/ # WebSocket桥 + MCP包装器（9175）
```
---
## 路线图
- [ ] 颜色曲线和色轮（DaVinci风格）
- [ ] 运动跟踪（锁定文本到主体）
- [ ] 色键 / 绿幕
- [ ] 稳定化
- [ ] AI超分辨率（4K）
- [ ] 多语言UI
欢迎提交PR。问题会带来啤酒。
---
## 作者
由 **Enrique Fernández** 构建。
MIT © 2026 Enrique Fernández.
---
<div align="center">
**如果编辑工具为您节省了10分钟，请给它一个 ⭐。**
**由 ❤️ 和零服务器构建。**
</div>
