前言¶
DSH 插件體系裏,模型可以調用本地工具,也可以加載 Agent Skill。對本地視頻項目來說,風險往往不在“能不能生成一句編輯指令”,而在指令落到文件後是否可檢查、可回退、可限定目錄。下面介紹的 dsh-timeline-studio-plugin 提供的是這類橋接:它連接 DeepSeek Harness 與 Timeline Studio 的確定性 .timeline 命令層,並打包 edit-timeline-studio Agent Skill。
這是什麼¶
dsh-timeline-studio-plugin 由 MartinDelophy 維護,許可證爲 MIT。
它不是一個新的視頻編輯界面,而是讓 DeepSeek Harness 在對話中檢查 .timeline 項目、預覽修改、應用修改,並輸出 MP4。它依賴 Timeline Studio 提供的 .timeline 命令與渲染能力,而不是替代編輯器運行時。
核心功能¶
- 連接 DeepSeek Harness 與 Timeline Studio 的確定性
.timeline命令層。 - 打包
edit-timeline-studioAgent Skill。 - 提供七個 model-facing 工具,覆蓋項目、軌道、片段和 transcript 檢查、semantic diff、transactional apply,以及 verified MP4 rendering。
- 通過 revision checks 和 idempotent operation IDs 降低項目變更風險。
- 通過
allowedRoots建立文件系統邊界,輸入和輸出都帶 symlink-escape protection。 - Harness cancellation 會傳遞到 Timeline Studio 子進程。
安裝與啓用¶
先確認環境滿足以下要求:
- DeepSeek Harness
0.1.0-rc.6Developer Preview - Node.js
22.20+or24+ - 本地 Timeline Studio checkout
- FFmpeg/ffprobe
安裝插件:
dsh plugin --profile web add "github:MartinDelophy/dsh-timeline-studio-plugin#main"
該命令把倉庫作爲 bundle 安裝到 web profile。
啓用時需要設置 TIMELINE_STUDIO_ROOT,並指向本地 Timeline Studio checkout。當 TIMELINE_STUDIO_ROOT 未設置時,bundle 保持禁用,因此未配置的安裝不會破壞現有 Harness profile。設置後按當前 DSH 的啓動方式重啓。
典型用法¶
1、把包含 .timeline 項目的本地文件夾加入 Harness workspace,然後在聊天中描述期望的修改。
2、先做只讀檢查,例如:
檢查當前 workspace 中的 Timeline Studio 項目,告訴我它的時長、寬高比、軌道和媒體。先不要修改任何文件。
3、再做可預覽的修改,例如:
把項目改成 9:16。先給我編輯預覽;如果有效,保存爲新項目並渲染 MP4。不要覆蓋源文件。
4、Agent 工作流通常是:加載 edit-timeline-studio,檢查項目,在允許根目錄下寫一份 versioned edit plan,調用 diff;只有 diff 成功後調用 apply,最後檢查輸出項目並可選渲染。
適用場景¶
- 適合已有本地 Timeline Studio checkout,並希望把
.timeline修改放在可檢查工具流中的 DSH 用戶。 - 適合需要在 Harness 對話中完成項目檢查、編輯預覽、應用修改和 MP4 輸出的本地工作流。
注意事項¶
allowedRoots是強制安全邊界,不是提示詞。每個項目、計劃、導入素材和輸出都必須解析到允許的目錄內。- 插件會以當前
dsh進程權限訪問本地文件並執行媒體操作。安裝前請檢查源碼與MIT許可證,只把可信項目放入允許目錄。 - DeepSeek Harness 仍是 Developer Preview,可能引入兼容性破壞變化。
- Browser-only WebGPU generation 和 rich browser rendering 仍留在 Timeline Studio 編輯器;插件不支持的操作會作爲 tool errors 報告。
- 責任使用:只使用自己擁有或明確授權的面部與身份媒體;不要創建非法、侵權、虛假、誤導或身份濫用內容;用戶對自己的行爲和後果負責。
結尾¶
dsh-timeline-studio-plugin 的價值,在於把 Timeline Studio 的本地編輯能力收斂爲 DSH 中可檢查、可限制目錄邊界的工具流。
可在插件目錄中檢索 MartinDelophy/dsh-timeline-studio-plugin;GitHub 倉庫地址爲:
- https://github.com/MartinDelophy/dsh-timeline-studio-plugin