{"_id":"chengfeng-videocut-skills","name":"chengfeng-videocut-skills","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"chengfeng-videocut-skills","version":"0.1.0","description":"Small installer for Chengfeng's videocut skills.","license":"Apache-2.0","author":{"name":"chengfeng / AI产品自由"},"homepage":"https://github.com/Agentchengfeng/chengfeng-videocut-skills#readme","repository":{"type":"git","url":"git+https://github.com/Agentchengfeng/chengfeng-videocut-skills.git"},"bugs":{"url":"https://github.com/Agentchengfeng/chengfeng-videocut-skills/issues"},"bin":{"chengfeng-videocut-skills":"bin/cli.js"},"keywords":["videocut","video-editing","skills","claude-code","codex","ai-agent"],"engines":{"node":">=18"},"_id":"chengfeng-videocut-skills@0.1.0","gitHead":"c9f152191d18a0568bb0e12c983a17264cb2d502","_nodeVersion":"23.10.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-UjGOpAwX3Fks4WilCDiLgm21X8zWQuBiT/CnIRdLAOQG4HysN2BVQHqlRxDOnaaBGiO07HIWrZWzQ0/EmIBquQ==","shasum":"7664df4b4b5aa04463462bef5d3337e772e7b5bc","tarball":"https://registry.npmjs.org/chengfeng-videocut-skills/-/chengfeng-videocut-skills-0.1.0.tgz","fileCount":6,"unpackedSize":31700,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCdKE+Q10KJ6E4hrtQR9YL7NcPcDazmCydsC9/B2vO+WgIgHewt75fXpagWwsjeStesmEDrHzEQR2xwsz0j4ZDeGcU="}]},"_npmUser":{"name":"chengfeng2025","email":"287738446@qq.com"},"directories":{},"maintainers":[{"name":"chengfeng2025","email":"287738446@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/chengfeng-videocut-skills_0.1.0_1781952223496_0.875400574280429"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-20T10:43:43.365Z","0.1.0":"2026-06-20T10:43:43.648Z","modified":"2026-06-20T10:43:43.824Z"},"maintainers":[{"name":"chengfeng2025","email":"287738446@qq.com"}],"description":"Small installer for Chengfeng's videocut skills.","homepage":"https://github.com/Agentchengfeng/chengfeng-videocut-skills#readme","keywords":["videocut","video-editing","skills","claude-code","codex","ai-agent"],"repository":{"type":"git","url":"git+https://github.com/Agentchengfeng/chengfeng-videocut-skills.git"},"author":{"name":"chengfeng / AI产品自由"},"bugs":{"url":"https://github.com/Agentchengfeng/chengfeng-videocut-skills/issues"},"license":"Apache-2.0","readme":"# Videocut Skills\n\n> 用 Claude Code Skills 构建的视频剪辑 Agent，专为口播视频设计\n\n## 官方来源\n\n本项目由 **chengfeng / AI产品自由** 原创并维护。\n\n- GitHub: https://github.com/Agentchengfeng\n- X: https://x.com/chengfeng240928\n- 小红书：AI产品自由\n- 公众号：AI产品自由\n- B站：AI产品自由\n- 抖音 / 视频号：AI产品自由\n\n原始仓库：\n\n```text\nhttps://github.com/Agentchengfeng/chengfeng-videocut-skills\n```\n\n如果你使用、转载、翻译、二次发布或改造成自己的 Skill，请保留原作者和原始仓库链接。\n\n本项目使用 **Apache License 2.0**。你可以学习、复制、修改、分发和商用，但重新分发或发布派生版本时，需要保留本仓库的 `LICENSE` 和 `NOTICE.md` 里的来源归属信息。\n\n如果你发现有人删掉来源、换名二次发布：\n\n1. 先保存证据：对方页面链接、截图、发布时间、下载包或 fork 记录。\n2. 给对方发一句话要求补回来源：请保留 `chengfeng / AI产品自由`、原始仓库链接和 `NOTICE.md`。\n3. 对方拒绝或不处理时，向平台提交版权/开源协议违规投诉，并附上本仓库链接、`LICENSE`、`NOTICE.md` 和对方删除来源的证据。\n4. GitHub 上可以开 Issue / Pull Request 要求补回；明显搬运且删来源的，可以走 GitHub DMCA 或平台侵权投诉流程。\n\n## 为什么做这个？\n\n剪映的\"智能剪口播\"有两个痛点：\n1. **无法理解语义**：重复说的句子、说错后纠正的内容，它识别不出来\n2. **字幕质量差**：专业术语（Claude Code、MCP、API）经常识别错误\n\n这个 Agent 用 Claude 的语义理解能力解决第一个问题，用自定义词典解决第二个问题。\n\n## 效果演示\n\n**输入**：19 分钟口播原片（各种口误、卡顿、重复）\n\n**输出**：\n- 自动识别 608 处问题（静音 114 + 口误/重复 494）\n- 剪辑后视频 72MB\n- 全程 AI 辅助，人工只需确认\n\n## 核心功能\n\n| 功能 | 说明 | 对比剪映 |\n|------|------|----------|\n| **语义理解** | AI 逐句分析，识别重说/纠正/卡顿 | 只能模式匹配 |\n| **静音检测** | >0.3s 自动标记，可调阈值 | 固定阈值 |\n| **重复句检测** | 相邻句开头≥5字相同 → 删前保后 | 无此功能 |\n| **句内重复** | \"好我们接下来好我们接下来做\" → 删重复部分 | 无此功能 |\n| **词典纠错** | 自定义专业术语词典 | 无此功能 |\n| **自更新** | 记住你的偏好，越用越准 | 无此功能 |\n\n## 快速开始\n\n### 1. 安装 Skills\n\n如果你只想复制命令，直接用 npm 安装：\n\n```bash\nnpx chengfeng-videocut-skills install\n```\n\n这个 npm 包只是一个很小的安装器。执行时会从 GitHub 拉取最新仓库：\n\n```text\nhttps://github.com/Agentchengfeng/chengfeng-videocut-skills\n```\n\n所以后续只需要维护 GitHub，用户每次执行命令都会安装仓库里的最新 Skills。\n\n它会把 Skills 安装到：\n\n- `~/.claude/skills/chengfeng-videocut-skills`\n- `~/.codex/skills/chengfeng-videocut-skills`\n\n也可以只安装到 Codex：\n\n```bash\nnpx chengfeng-videocut-skills install --target codex\n```\n\n如果你习惯从 GitHub 克隆，也可以用：\n\n```bash\n# 克隆到 Claude Code skills 目录\ngit clone https://github.com/Agentchengfeng/chengfeng-videocut-skills.git ~/.claude/skills/chengfeng-videocut-skills\n```\n\n### 2. 配置 API Key\n\n```bash\ncd ~/.claude/skills/chengfeng-videocut-skills\ncp .env.example .env\n# 编辑 .env，填入火山引擎 API Key\n```\n\n### 3. 安装环境\n\n打开 Claude Code，输入：\n\n```\n/chengfeng-videocut-skills:安装\n```\n\nAI 会自动：\n- 检查 Python、FFmpeg、Node.js\n- 安装 FunASR（口误识别模型，约 2GB）\n- 安装 Whisper large-v3（字幕模型，约 3GB）\n\n## 使用流程\n\n```\n┌─────────────────────────────────────────────────────────┐\n│  /chengfeng-videocut-skills:安装  → 首次使用，安装环境和模型 │\n└─────────────────────────────────────────────────────────┘\n                            ↓\n┌─────────────────────────────────────────────────────────┐\n│  /chengfeng-videocut-skills:剪口播 视频.mp4              │\n│                                                         │\n│  1. 提取音频 → 上传云端                                 │\n│  2. 火山引擎转录 → 字级别时间戳                         │\n│  3. AI 审核：静音/口误/重复/语气词                      │\n│  4. 生成审核网页 → 浏览器打开                           │\n└─────────────────────────────────────────────────────────┘\n                            ↓\n┌─────────────────────────────────────────────────────────┐\n│  【人工审核 + 执行剪辑】                                │\n│                                                         │\n│  - 单击跳转播放                                         │\n│  - 双击选中/取消                                        │\n│  - Shift 拖动多选                                       │\n│  - 确认后点击「执行剪辑」→ 自动 FFmpeg 剪辑            │\n└─────────────────────────────────────────────────────────┘\n                            ↓\n┌─────────────────────────────────────────────────────────┐\n│  /chengfeng-videocut-skills:字幕                         │\n│                                                         │\n│  - Whisper 转录                                         │\n│  - 词典纠错（Claude Code → claude code）                │\n│  - 人工确认 → 烧录字幕                                  │\n└─────────────────────────────────────────────────────────┘\n                            ↓\n┌─────────────────────────────────────────────────────────┐\n│  /chengfeng-videocut-skills:高清化  （可选）             │\n│                                                         │\n│  - 2-pass 编码 + 锐化                                   │\n│  - 自动匹配原片参数，码率 1.2x                          │\n│  - 像剪映一样导出高清                                   │\n└─────────────────────────────────────────────────────────┘\n                            ↓\n┌─────────────────────────────────────────────────────────┐\n│  /chengfeng-videocut-skills:自更新  （可选）             │\n│                                                         │\n│  告诉 AI 你的偏好，它会记住：                           │\n│  - \"静音阈值改成 1 秒\"                                  │\n│  - \"保留适量嗯作为过渡\"                                 │\n└─────────────────────────────────────────────────────────┘\n```\n\n## Skill 清单\n\n| Skill | 功能 | 输入 | 输出 |\n|-------|------|------|------|\n| `安装` | 环境准备 | 无 | 安装日志 |\n| `剪口播` | 转录 + AI 审核 + 剪辑 | 视频文件 | 剪辑后视频 |\n| `高清化` | 2-pass + 锐化导出 | 视频文件 | 高清视频 |\n| `导入字幕` | 剪后视频直转字幕 + 推送剪映草稿（默认字号 10 / 行间距 13） | 剪后视频 + 可选原稿 | SRT + 剪映草稿 |\n| `自更新` | 记录偏好 | 用户反馈 | 更新规则文件 |\n| `口播成片` | 分镜核对 + 时间线预览 + 合成导出 | 视频 + 字幕 + 可选素材 | 1080x1440 竖版 MP4 |\n\n## 目录结构\n\n```\nchengfeng-videocut-skills/\n├── README.md           # 本文件\n├── package.json        # npm 安装器配置\n├── .npmignore          # npm 发布排除规则\n├── LICENSE             # Apache-2.0 开源协议\n├── NOTICE.md           # 官方来源与转载归属声明\n├── CITATION.cff        # GitHub 引用信息\n├── .env.example        # API Key 模板\n├── bin/\n│   └── cli.js          # npx 安装入口，从 GitHub 拉取最新 Skills\n├── 安装/               # 环境安装 skill\n├── 剪口播/             # 核心：转录 + AI 审核 + 剪辑\n│   ├── SKILL.md        # 流程说明\n│   ├── *.js            # 脚本（生成字幕、审核页面、服务器）\n│   ├── *.sh            # 脚本（转录、剪辑）\n│   └── 用户习惯/       # 审核规则（可自定义）\n│       ├── 1-核心原则.md       # 删前保后\n│       ├── 2-语气词检测.md     # 嗯啊呃\n│       ├── 3-静音段处理.md     # >0.3s 删除\n│       ├── 4-重复句检测.md     # 相邻句开头相同\n│       ├── 5-卡顿词.md         # 那个那个、就是就是\n│       ├── 6-句内重复检测.md   # A+中间+A 模式\n│       ├── 7-连续语气词.md     # 嗯啊、啊呃\n│       └── 8-重说纠正.md       # 部分重复、否定纠正\n├── 导入字幕/           # 字幕生成与剪映草稿推送\n│   ├── SKILL.md\n│   └── scripts/\n├── 高清化/             # 2-pass + 锐化导出\n│   └── scripts/\n│       └── hd_export.sh\n├── 自更新/             # 自我进化机制\n└── 口播成片/           # 分镜核对 -> 时间线预览 -> 合成\n    ├── SKILL.md\n    ├── templates/      # storyboard-audit.html + timeline-preview.html\n    ├── references/\n    └── scripts/\n```\n\n## 技术架构\n\n```\n┌──────────────────┐     ┌──────────────────┐\n│   火山引擎 ASR   │────▶│  字级别时间戳    │\n│  （云端转录）    │     │  subtitles.json  │\n└──────────────────┘     └────────┬─────────┘\n                                  │\n                                  ▼\n┌──────────────────┐     ┌──────────────────┐\n│   Claude Code    │────▶│   AI 审核结果    │\n│  （语义分析）    │     │  auto_selected   │\n└──────────────────┘     └────────┬─────────┘\n                                  │\n                                  ▼\n┌──────────────────┐     ┌──────────────────┐\n│   审核网页       │────▶│   最终删除列表   │\n│  （人工确认）    │     │  delete_segments │\n└──────────────────┘     └────────┬─────────┘\n                                  │\n                                  ▼\n┌──────────────────┐     ┌──────────────────┐\n│     FFmpeg       │────▶│   剪辑后视频     │\n│  filter_complex  │     │   xxx_cut.mp4    │\n└──────────────────┘     └──────────────────┘\n```\n\n## 依赖\n\n| 依赖 | 用途 | 安装方式 |\n|------|------|----------|\n| Node.js 18+ | 运行脚本 | `brew install node` |\n| FFmpeg | 音视频处理 | `brew install ffmpeg` |\n| Python 3.8+ | 模型运行 | 系统自带 |\n| 火山引擎 API | 语音转录 | [申请 Key](https://console.volcengine.com/) |\n\n## 常见问题\n\n### Q: 火山引擎转录超时？\n\n上传音频到 uguu.se（脚本默认），不要用 catbox.moe（火山引擎访问慢）。\n\n### Q: 审核网页打不开？\n\n检查端口 8899 是否被占用：`lsof -i :8899`\n\n### Q: 剪辑后音画不同步？\n\n使用 `filter_complex + trim` 而非 `concat demuxer`，脚本已处理。\n\n### Q: 如何添加自定义词典？\n\n编辑 `字幕/词典.txt`，每行一个词：\n```\nClaude Code\nMCP\nAPI\n```\n\n## License\n\nApache License 2.0. See [LICENSE](LICENSE) and [NOTICE.md](NOTICE.md).\n","readmeFilename":"README.md","_rev":"1-31359473b1cfcd02f72b74b50ab1bab7"}