智能剪辑流水线 lolistlisa/dsh-autocut

dsh-autocut

DeepSeek Harness（DSH）的中长视频自动剪辑插件：把「文案 + 口播 + 本地/在线素材」变成可继续精修的多轨时间线，并可直接导出剪映专业版草稿或 OTIO。

20 个 autocut_* 工具，所有中间产物都是 .autocut/ 下可编辑的 JSON/SRT/OTIO，不改写原始文案与录音。

状态：Windows 优先；剪映专业版 11.6 实测可打开加密草稿；MIT License。

它做什么

- 文案分段：LLM 按语义切句段，段号稳定；提供字符数校验，防止改写。
- 素材检索：本地目录递归索引（ffprobe 读时长/分辨率）；可选 Pexels/Pixabay 在线检索；网页参考素材登记链接与许可。
- 配乐：可选 Jamendo CC 曲库按叙事段落检索，标注商用/NC；也支持本地 BGM。
- 人工审阅：生成 review.html，勾选素材/配乐后导出 selections.json。
- 人声：faster-whisper 字级时间码；压缩长停顿、保守去喘气、响度统一；无录音时按字数估时并明确标注。
- 时间线：视频/音频/字幕多轨装配，输出 timeline.json + timeline.otio + SRT。
- 审片：FFmpeg 渲染 preview.mp4，烧录字幕。
- 交付：新建剪映加密草稿（不覆盖已有草稿）；或导出 OTIO 进达芬奇/Premiere 等。
- 局部重剪：换镜头/换配乐/改音效只重跑下游，人工锁定优先。

环境要求

| 项 | 要求 |
| DSH | 桌面端 0.2.x（engines.dsh >=0.2.0-0 <0.3.0） |
| OS | Windows 10/11（剪映导出依赖 Windows DLL；OTIO 部分跨平台） |
| Node | ≥ 22.12（DSH 自带即可） |
| Python | 3.10–3.12，建议直接用 DSH 运行时 Python |
| FFmpeg | ffmpeg + ffprobe 真实二进制，配置 FFMPEG_PATH / FFPROBE_PATH |
| 剪映 | 专业版 11.x；videoeditor.dll 用于草稿加密 |
| 密钥 | DEEPSEEK_API_KEY 必需（结构化/检索词/规划）；Pexels/Pixabay/Jamendo 可选 |

安装

A. DSH 插件市场

在 DSH 插件市场搜索 AutoCut（上架后可用），一键安装。

B. CLI

使用 DSH 自带的 dsh：

dsh plugin --profile desktop add "github:lolistlisa/dsh-autocut"

安装后完全退出 DSH（含托盘），再启动。

C. 本地开发

dsh plugin --profile desktop add "file:C:/path/to/dsh-autocut"

Python 依赖

装到 DSH 实际调用的那个 Python（PYTHON_PATH，或 %USERPROFILE%\.dsh\dsh-runtimes\...\python.exe）：

python -m pip install -r requirements.txt

关键：剪映 11.x 的草稿是加密的。PyPI 上的 pyJianYingDraft 不支持加密，必须用 aoguai fork。上面的 requirements.txt 已指向 fork；手动安装等价于：

python -m pip install "https://codeload.github.com/aoguai/pyJianYingDraft/zip/refs/heads/main"

如果 pip install git+https://github.com/... 失败（国内网络常见），用上面的 codeload zip 地址。

验证：

python -c "import pyJianYingDraft as d; print([n for n in dir(d) if 'Crypto' in n])"

应看到 JianyingDraftCryptoCodec 与 DraftCryptoConfig。

剪映导出准备

指向包含 videoeditor.dll 的安装目录（可用 JY_INSTALL_DIR 覆盖自动探测）
[Environment]::SetEnvironmentVariable("JY_INSTALL_DIR", "F:\JianyingPro\11.6.0.14552", "User")

- 自动探测常见路径（%LOCALAPPDATA%\JianyingPro\Apps、C:\Program Files\JianyingPro、F:\JianyingPro 等）；找不到时用 JY_INSTALL_DIR。
- 草稿目录默认 %LOCALAPPDATA%\JianyingPro\User Data\Projects\com.lveditor.draft，可用 JY_USER_DATA_DIR 覆盖。
- autocut_export_jianying 必须显式传 draft_dir；只新建草稿，不修改已有草稿。
- 其他剪映版本未验证；11.6.0.14552 已实测能打开。

密钥

全部用用户级环境变量，不要写进项目文件：

| 变量 | 用途 | 必需 |
| DEEPSEEK_API_KEY | 文案结构化、检索词、音效/配乐规划 | 是 |
| PEXELS_API_KEY | 在线视频素材 | 否 |
| PIXABAY_API_KEY | 在线视频素材 | 否 |
| JAMENDO_CLIENT_ID | CC 配乐检索 | 否 |
| FFMPEG_PATH / FFPROBE_PATH | 真实 ffmpeg/ffprobe | 是（渲染/索引） |
| PYTHON_PATH | 插件调用的 Python | 建议设置 |

配完重启 DSH（环境变量在进程启动时读取）。

快速开始（11 阶段）

autocut_init → autocut_analyze
autocut_research → autocut_research_music
autocut_review → 浏览器勾选 → .autocut/selections.json
autocut_prepare_selections(download=true)
autocut_transcribe → autocut_voice # 无录音：autocut_estimate_timing autocut_index → autocut_match autocut_sound → autocut_timeline autocut_preview autocut_export_jianying

产物：

<project>/
.autocut/
project.json
script_graph.json
online_materials.json
music_candidates.json
review.html
selections.json
voice_edit.json / clean_voice.wav
asset_catalog.json
asset_matches.json
sound_plan.json
timeline.json / timeline.otio
preview.mp4
exports/...

工具清单（20）

- 项目：autocut_init autocut_analyze autocut_status autocut_run
- 检索：autocut_research autocut_research_plan autocut_import_research autocut_research_music autocut_review autocut_prepare_selections
- 声音：autocut_transcribe autocut_estimate_timing autocut_voice autocut_sound
- 画面：autocut_index autocut_match autocut_timeline autocut_override
- 输出：autocut_preview autocut_export_jianying

已知限制

- 不渲染最终成片：preview.mp4 只用于审片；转场、花字样式、精细特效要在剪映/NLE 里完成。
- 剪映导出仅支持 Windows：依赖 videoeditor.dll；非 11.x 版本可能打不开，生成的是新草稿模板。
- 在线素材需要 Key：Pexels 可能暂停发放新 Key；没有 Key 时在线阶段为空，本地链路不受影响。
- 版权责任在用户：插件只登记链接与许可，不绕过授权；CC-BY 需署名，NC 曲目不能商用。
- 部分效果是元数据/关键帧：闪避、缩放、强调点需在剪映里复核；不同版本可能丢失。
- 29.97/23.976 等非整数帧率未做 NTSC 处理，默认按整数帧率。

隐私

- 文案/检索词会发送到 DeepSeek API；媒体文件留在本地，除非你明确选择下载在线素材。
- 密钥只从环境变量读取，不写入项目或日志。

开发

node --check index.js
npm pack --dry-run

License

MIT