前言¶

在 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，但“进入下一阶段”这个决定始终留在人手里。

对多阶段媒体生产来说，这比在提示词里约束“请等待确认”可靠得多——门控不是约定，是执行路径。

工作流阶段与交付物¶

流程拆成六个阶段，每个阶段要求一批经过人工审核的交付物：

与外部软件的集成有几条明确边界：

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