前言¶
在 DSH（DeepSeek Harness）里跑媒体类任务，一个常见问题是阶段失控：你让模型做一部旅行影片的粗剪，它可能一口气把分析、剪辑、调色、成片全部“处理完”，中间没有任何停下来等你确认的节点。靠提示词写一句“每步先问我”，在多阶段长流程里并不可靠。
dsh-cinematic-workflow 针对的就是这个点。它把一套电影级旅行影片导演工作流做成 DSH 插件，并把人工门控直接写进代码：阶段推进的唯一入口是人。下面介绍它的定位、工作流结构和用法。
这是什么¶
dsh-cinematic-workflow 是一个面向 DeepSeek Harness 的本地优先（local-first）、人工门控（human-gated）的作者式电影工作流插件，由 luoyuejun9 维护，MIT 许可，当前版本 0.1.0。
它覆盖一条完整的影片生产链路：媒体清单、创作方向、粗剪交付物、可直接导入的 FCPXML、Resolve 交接、克制文案/字幕，以及 QC 与交付记录。
先把边界说清楚：它明确不是 Final Cut Pro 或 DaVinci Resolve 的鼠标宏。它管理的是工作流、交付物与审核节点，不替你操作软件。
门控机制：规则写在代码里¶
插件的核心规则由代码强制执行：只有人工运行 /cinema continue <project-id>，且当前阶段具备所需交付物时，阶段才会推进。模型不能批准、跳过、合并或预运行后续阶段。
配套地，/cinema run 只排队当前阶段，同样不能推进项目。也就是说，模型可以生成分析、产出 EDL，但“进入下一阶段”这个决定始终留在人手里。
对多阶段媒体生产来说，这比在提示词里约束“请等待确认”可靠得多——门控不是约定，是执行路径。
工作流阶段与交付物¶
流程拆成六个阶段，每个阶段要求一批经过人工审核的交付物：
| 阶段 | 交付物 |
|---|---|
| Sample（可选） | 风格数据库 |
| Analysis | 媒体清单、导演笔记、创作基线、选定弧线 |
| Rough cut | EDL、FCPXML、声音计划、导演审阅 |
| Grade | 调色简报、Resolve 返回工件 |
| Finishing | 文案脚本、字幕、成片时间线 |
| Delivery | QC 报告、交付清单 |
与外部软件的集成有几条明确边界：
1、基础媒体清单是自动元数据采集，插件不声称已观看全部素材，素材层面的判断仍需要人来做。
2、cinema_build_fcpxml 可以从审核过的 EDL 生成 FCPXML 1.14，但不负责把它导入 Final Cut Pro。
3、Resolve 交接（v0.1）只生成交接简报，由你在 Resolve 中完成导入/导出，再用 /cinema attach 附加返回文件。
另外，如需外部 contact-sheet 或 QC 辅助，可自行安装 FFmpeg/FFprobe；没有这个依赖，插件仍然可用。
安装与启用¶
安装命令：
dsh profile install npm:dsh-cinematic-workflow
安装后需要重启或重新加载 DSH profile 才会生效。
版本与环境：包面向 DSH 0.1.0-rc.6，而 Harness 目前是开发者预览版，升级时建议锁定兼容版本；运行环境要求 Node >=22.19。
典型用法¶
先用 /cinema doctor 检查环境是否就绪：
/cinema doctor
从素材目录启动项目，指定标题与预设：
/cinema start "/path/to/footage" --title "My film" --preset travel-authorial
运行当前阶段：
/cinema run <project-id>
审核产出后，可以先记录创作决定而不推进，比如确定主题和叙事弧线：
/cinema choose <project-id> theme "freedom"
/cinema choose <project-id> arc "arrival → release → quiet afterglow"
确认当前阶段交付物齐全后，人工推进：
/cinema continue <project-id>
/cinema status、/cinema validate、/cinema revise、/cinema attach 随时可用。
内置预设与创作优先级¶
插件内置 travel-authorial 预设，偏好第一人称观察、留白、环境声与克制文案。
它的创作优先级是：创作者表达 > 故事 > 观众情绪 > 镜头语言 > 声音 > 色彩 > 剪辑手法 > 软件操作。软件操作排在最后，与“不是鼠标宏”的定位一致。
素材安全与来源追溯¶
几条与数据安全直接相关的设计：
- 源媒体永远不会被移动、重命名、转码、覆盖或上传。
- 项目记录位于
<workspace>/.dsh/cinematic/，建议加入 gitignore。 - 工件观察标注为
automatic、model-inference、human-confirmed或unresolved，每条信息的来源可追溯。 - 不要发布包含私密绝对路径、GPS 数据、人脸指标或个人媒体的项目文件夹。
适用场景与注意事项¶
适合两类人：一是想把旅行影片创作流程固化成可重复工作流的创作者；二是想在 DSH 里研究“模型参与但人工审核”如何落地的智能体开发者——这个插件的门控实现本身就是可参考的样本。
使用前注意：
1、插件以当前 dsh 进程的权限运行，安装前应检查源码与许可证。项目采用 MIT 许可，中文文档见 README.zh.md。
2、包面向 DSH 0.1.0-rc.6，Harness 是开发者预览版，升级时锁定兼容版本。
3、它不替代你在 Final Cut Pro 或 DaVinci Resolve 中的实际操作，最终的导入、导出和成片决策仍由你完成。
小结¶
dsh-cinematic-workflow 的价值不在“自动化剪辑”，而在把人在回路变成代码强制：交付物不齐、人不确认，阶段就不前进。对想让模型深入参与媒体创作、又不想交出审核权的开发者，这个设计思路值得一看。
- 社区目录页：https://www.skillhub.cn/plugins/luoyuejun9/dsh-cinematic-workflow
- GitHub 仓库：https://github.com/luoyuejun9/dsh-cinematic-workflow
