前言¶
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