soumatheusgomes/editonny

editonny – 适用于 Claude Code 和 Codex 的 AI 驱动视频编辑技能

它是什么

• 一个开源的 技能（插件），在你的计算机上运行，让你通过简单描述所需内容来编辑视频，使用自然语言即可。
• 与 Claude Code 和 Codex 代理配合使用，因此你可以输入类似“剪掉停顿，添加字幕，并将我演讲的这部分变成动态场景”的请求，该技能会完成繁重的工作。
• 所有转录、渲染和视觉处理均在本地进行 – 无需外部 LLM API 密钥（代理的订阅涵盖 LLM 调用）。

主要功能

功能	作用
暂停和错误剪切	自动检测静音、呼吸和错误开始并移除它们。
字幕生成	从音频生成字幕，并可使用多种字体进行样式设置。
音频修复和重新构图	标准化音量，可将素材重新构图到不同的宽高比，同时保持主体居中。
动态场景	将口头陈述转换为预构建的动画“目录”场景（145 个模板，79 个捆绑剪辑）。
本地转录和 OCR	使用本地语音转文本模型和 Apple Vision 或 Tesseract OCR 进行字幕检查。
全流程验证	在最终导出前显示 8-15 秒的样本供用户批准。
跨平台安装	一键安装请求适用于 Claude Code 和 Codex；也支持手动终端安装。

工作原理

1. 安装 – 将提供的安装请求粘贴到 Claude Code 或 Codex 中。代理会克隆仓库，设置 Python 环境（通过 uv），安装 FFmpeg、Node、OCR 工具，并验证一切。
2. 描述你的编辑 – 发送一个简短的命令（例如，$editonny 编辑来自 /videos 的 45 秒竖屏视频，剪掉停顿，添加字幕）。
3. 规划 – 该技能扫描素材，提出完整的编辑参数集，并等待你的确认。
4. 处理 – 它剪切视频，添加字幕，应用任何重新构图，并可选地根据口语文本插入动态场景剪辑。
5. 审查 – 保存 8-15 秒的预览；在最终 MP4 导出到 ~/Downloads/editonny/<日期-标题>/exports/ 之前，你可以批准或调整。

安装选项

• 代理驱动 – 从 README 复制多行请求，粘贴到 Claude Code（/editonny）或 Codex（$editonny）中。代理处理克隆、依赖安装和注册。
• 终端 –

  git clone https://github.com/soumatheusgomes/editonny.git
  cd editonny
  python3 install.py --target both   # 或 --target codex / --target claude
  

  之后运行提供的 doctor 和 media status 脚本以验证设置。

本地运行指南

npm ci               # 安装 Next.js 指南和设计系统
python3 editonny.py guide   # 在 http://localhost:4173 启动开发服务器

该指南是一个多语言（EN/PT-BR/ES）Web UI，帮助你构建编辑请求并浏览动态场景目录。

典型用例

• 快速社交媒体视频润色：移除“嗯”，添加字幕，并为 TikTok、Instagram Reels 等重新构图。
• 将口语产品演示转换为带有动画高亮场景的简短解释视频。
• 批量处理采访素材，只保留干净的片段和字幕。

项目结构（高级）

• skills/editonny/ – 可移植技能和 CLI 入口点。
• skills/editonny/engine/ – 用于音频分析、转录和视频拼接的核心 Python 代码。
• skills/editonny/visuals/ – 捆绑的动态场景资产和配方。
• web/ – Next.js 网站（指南），带有本地化请求构建器。
• design-system/ – 指南使用的可复用 React 组件库。
• docs/ – 详细的架构、安装、集成和验证文档。

许可证

• 第一方代码和文档采用 MIT 许可证。第三方资产保留其原始许可证（参见 THIRD_PARTY_NOTICES.md）。

获取帮助的地方

• 在 GitHub 上打开问题，给仓库加星，或通过 Instagram 或电子邮件联系作者（链接在 README 中）。

---

editonny 让你与 AI 代理对话，并获得一个完全编辑好的视频，无需仅云服务。