前言¶

在 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