前言¶

在 DeepSeek Harness（DSH）里做中长视频，常见做法是：文案在对话里改来改去，素材靠手工搜文件夹，时间线要么在 NLE 里从零搭，要么和智能体侧的中间结果对不上号。中间产物不可编辑、一改上游就要全链路重跑，也会拖慢迭代。

下面介绍社区插件 dsh-autocut（维护者 lolistlisa）：把「文案 + 口播 + 本地/在线素材」串成可继续精修的多轨时间线，并支持导出剪映专业版加密草稿或 OTIO。插件在 DSH 插件目录中归类为工作流；当前 GitHub 星标为 1。所有中间结果落在项目目录 .autocut/ 下的 JSON、SRT、OTIO，不改写原始文案与录音。

这是什么¶

dsh-autocut 是 DSH 的中长视频自动剪辑插件，提供 20 个 autocut_* 工具。它解决的是：语义分段、素材与配乐检索、人声时间码与响度处理、多轨装配、审片预览，以及交付到剪映或达芬奇/Premiere 等 OTIO 工作流——而不是在插件内渲染最终成片。

状态说明（来自 README）：Windows 优先；剪映专业版 11.6 实测可打开加密草稿；许可证为 MIT（package.json 版本 0.3.0）。

核心能力¶

文案与检索¶

• 文案分段：由 LLM 按语义切句段，段号稳定，并提供字符数校验，防止改写原文。
• 素材检索：本地目录递归索引（ffprobe 读时长/分辨率）；可选 Pexels、Pixabay 在线检索；网页参考素材可登记链接与许可。
• 配乐：可选 Jamendo CC 曲库按叙事段落检索并标注商用/NC；也支持本地 BGM。

审阅与人声¶

• 人工审阅：生成 review.html，在浏览器勾选素材/配乐后导出 selections.json。
• 人声：faster-whisper 字级时间码；可压缩长停顿、保守去喘气、响度统一；无录音时按字数估时并明确标注。

时间线、审片与交付¶

• 时间线：视频/音频/字幕多轨装配，输出 timeline.json、timeline.otio 与 SRT。
• 审片：FFmpeg 渲染 preview.mp4 并烧录字幕。
• 交付：新建剪映加密草稿（不覆盖已有草稿）；或导出 OTIO。
• 局部重剪：换镜头、换配乐、改音效时只重跑下游，人工锁定优先。

环境要求¶

安装前请对照 README 中的表格逐项准备：

安装与启用¶

DSH 生态是「一切皆插件」；社区目录页在 skillhub.cn，与 DeepSeek / 幻方无官方从属关系，不要当作官方应用商店。

插件市场¶

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

CLI 安装¶

使用 DSH 自带的 dsh：

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

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

本地开发时可指向目录：

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 草稿为加密格式；README 说明 PyPI 上的 pyJianYingDraft 不支持加密，须用 aoguai fork，requirements.txt 已指向该 fork。验证加密模块：

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

应看到 JianyingDraftCryptoCodec 与 DraftCryptoConfig。

剪映导出与密钥¶

剪映安装目录示例（可用 JY_INSTALL_DIR 覆盖自动探测）：

[Environment]::SetEnvironmentVariable("JY_INSTALL_DIR", "F:\JianyingPro\11.6.0.14552", "User")

autocut_export_jianying 必须显式传 draft_dir；只新建草稿。11.6.0.14552 已实测能打开；其他版本未验证。

密钥全部用用户级环境变量，不要写进项目文件。必需项包括 DEEPSEEK_API_KEY、FFMPEG_PATH、FFPROBE_PATH；在线素材与 Jamendo 为可选。配完后重启 DSH。

典型用法：11 阶段流水线¶

在 DSH 中按 README 推荐的顺序调用工具（也可通过 autocut_run 等组合使用，详见工具清单）：

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_preview、autocut_export_jianying）。完整列表见 GitHub README。

适用场景与注意¶

适合谁：在 Windows + DSH 0.2.x 下做口播/解说类中长视频，希望智能体帮忙分段、找素材、排时间线，再在剪映或 OTIO 生态里精修转场与特效的团队或个人。

插件运行方式：与其它 DSH 插件一样，以当前 DSH 进程权限运行；安装前应阅读源码与 MIT 许可证，自行评估密钥与本地媒体路径的暴露范围。

已知限制（摘自 README）：

• 不渲染最终成片；preview.mp4 仅审片用。
• 剪映导出仅 Windows，依赖 videoeditor.dll。
• 在线素材需要 API Key；无 Key 时在线阶段为空，本地链路仍可用。
• 版权责任在用户；CC-BY 需署名，NC 曲目不能商用。
• 29.97/23.976 等非整数帧率未做 NTSC 处理，默认按整数帧率。

隐私：文案与检索词会发送到 DeepSeek API；媒体文件默认留在本地，除非你明确下载在线素材。密钥只从环境变量读取。

结尾¶

dsh-autocut 把中长剪辑拆成可编辑、可局部重跑的 .autocut/ 流水线，并在 Windows 上对接剪映 11.x 加密草稿或 OTIO。若要安装说明与限制的最新表述，以仓库为准。

• 插件目录页：https://www.skillhub.cn/plugins/lolistlisa/dsh-autocut
• GitHub：https://github.com/lolistlisa/dsh-autocut