dsh-video-studio
zhengbo19240/dsh-video-studio
在你的DSH中插入一个Agent可调用的工作台
설치
dsh plugin --profile web add github:zhengbo19240/dsh-video-studioREADME
DSH Video Suite
在你的 DSH 中插入一个 Agent 可调用的工作台。
给 DeepSeek Harness 的一套视频工作台插件：工程文档只有一份，在 Host；对话里的 agent 和界面里的你，改的都是它。
这个仓库把三件东西放在一起，因为它们本来就是一条流水线：
| 包 | 作用 | 版本 |
|---|---|---|
packages/video-table | 视频工作台本体：时间线、预览、导出、音效、语音转字幕、配音，以及给 agent 的原生工具 | 0.2.0 |
packages/video-brief | 开工前的阶段机与门禁：10 槽位简报 → 分镜脚本确认 → 风格锁定 → 才允许改时间线 / 导出 | 0.3.0 |
packages/video-preset | 「视频剪辑」agent 预设：人格 + 工具集 + 剪辑纪律（工作流、动画原则、音效规则）。开新会话时可选 | 0.1.0 |
packages/motion-lib | 66 张代码动效卡（code.js 纯函数 + meta.json），工作台原生加载 | — |
packages/sound-library | 音效的声学索引与下载脚本；不含音频二进制 | — |
状态：可用。
packages/video-brief有完整测试；packages/video-table的测试是自包含的 Node 脚本（部分需要 ffmpeg / Chromium，缺依赖时会明确说明而不是假装通过）。
为什么是「一份工程文档」
大多数 agent 剪辑方案是「模型生成一段脚本 → 渲染」。这里反过来：时间线是一份带 revision 的 JSON，agent 的每次修改都走 preview → apply → undo，和人在面板上拖动是同一条路径、同一个撤销栈。所以：
- agent 改完，你刷新就能看见；
- 你改完，agent 下次
inspect读到的是同一份； - 任何一步都能撤销，不需要「重新生成一遍」。
三个包怎么拼起来
你 / agent
│
├─ video-brief 先问清 10 个槽位 → 写分镜脚本 → 你确认 → 定风格 → 才开闸
│
├─ video-table 工程 JSON（唯一真相）
│ ├─ 时间线 / 预览 / 导出（WebCodecs）
│ ├─ 代码图层 ── motion-lib 里的动效卡
│ ├─ 音效 ── sound-library 的索引 + 本地音频
│ └─ ASR / TTS（可选，需本机 ffmpeg + Python）
│
└─ 浏览器面板 和工作台共用同一份工程与同一套命令
video-brief 是可选的门禁，但强烈建议装：它拦的是「脚本没确认就开始剪」和「风格没定就改时间线」这两类返工。
快速开始
要求 DeepSeek 版本 > 0.2.1-rc5。插件来源：https://github.com/Zhengbo19240/dsh-video-studio
本仓库没有发布到 npm。 安装方式是 clone 仓库 + 跑安装脚本（把插件 link 进 profile）。 因此
dsh plugin --profile desktop add dsh-video-suite这类按包名安装的命令用不了——依赖的子包不在 npm 上。
这个仓库是 monorepo：两个必需插件 + 一个可选预设 + 两份数据。按下面四步走。
1. 取仓库、装依赖
git clone https://github.com/Zhengbo19240/dsh-video-studio
cd dsh-video-studio
npm install
工作台依赖 mp4-muxer / webm-muxer，不装 npm install 会在导出时报缺模块。
2. 装三个插件
一条命令（在仓库根目录执行，脚本会按绝对路径把三个插件 link 进 profile）：
# Windows
powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1
# macOS / Linux
bash ./scripts/install.sh
换 profile 或不要预设：-Profile tui、-WithPreset:$false；PROFILE=tui WITH_PRESET=0。
手动装（三个都装，路径用绝对路径）：
plugin_manager install_bundle target="link:<克隆目录>/packages/video-table"
plugin_manager install_bundle target="link:<克隆目录>/packages/video-brief"
plugin_manager install_bundle target="link:<克隆目录>/packages/video-preset"
| 插件 | 给什么 | 不装的后果 |
|---|---|---|
video-table | 工作台面板 + 全部 video_* 工具 | 没有面板，什么都做不了 |
video-brief | 阶段机：问询 → 脚本 → 风格 → 门禁 | 脚本没确认也会开工，风格没定也会改时间线 |
video-preset | 开新会话时多一个「视频剪辑」模式 | 没有完整人格与剪辑纪律，只有一个通用 agent |
三者不是一回事：
video-table 是「手」—— 能改时间线、能导出
video-brief 是「流程」—— 什么时候允许改
video-preset 是「这个人」—— 选了它，agent 才带着剪辑的判断力与纪律
video-brief 的提示段是宿主级的，装上就对每个会话生效；video-preset 的提示是模式级的，只有你开新会话并选中「视频剪辑」时才注入。
也可以手动改 profile：
dependencies里加三个link:<路径>，dsh.profile.bundles里加dsh-video-workbench、dsh-video-brief、dsh-video-preset。
3. 放数据（不做这步，插件能用但库是空的）
动效库（66 张卡）：
# 把仓库里的 packages/motion-lib 复制到 DSH 的数据目录
# Windows: %USERPROFILE%\.dsh\motion-lib
# macOS / Linux: ~/.dsh/motion-lib
# 或者用环境变量指过去，不必复制：
DSH_MOTION_LIB=<克隆目录>/packages/motion-lib
音效库（753 条索引 + 可选音频）：
npm run sounds:download # 下载 Kenney 的 CC0 音效包到 ~/.dsh/sound-library
# 或指定位置：DSH_SOUND_LIB=<任意目录>
索引里是相对路径，音频放对位置就直接命中，不需要重新分析。
4. 重启 DSH
宿主在启动时加载工具表与 RPC，装完必须重启。重启后在对话里说「打开视频工作台」，
或直接让它 video_setup（传一个工程目录）。
装好没有：四条验证
[ ] 面板能打开，顶栏有工程名 / 时长 / fps / 比例
[ ] 动效库列表不是空的（应该是 66 条）
[ ] 音效库能搜到东西（753 条里随便搜个 click）
[ ] video_stage_get 能返回 stage（装了两个插件时不是 undefined）
任何一条不过，看下面的排错。
排错
| 现象 | 原因 | 处理 |
|---|---|---|
| 面板打不开 / 没这个按钮 | 版本低于 0.2.1-rc5，或没重启 | 升级 DSH；重启 |
| 动效库空的 | 没放 ~/.dsh/motion-lib | 复制过去，或设 DSH_MOTION_LIB 后重启 |
| 音效搜不到 | 没跑 sounds:download，或路径不一致 | 跑下载；确认 ~/.dsh/sound-library/kenney/ 存在 |
| 无头渲帧出黑图 | 找不到浏览器 | 设 DSH_VIDEO_HEADLESS_BROWSER 指向 chrome/msedge |
| 导出报缺模块 | 没跑 npm install | 在仓库根目录装依赖后重启 |
| 导出很慢 | 逐帧渲染，正常 | 1080p 约每帧 20–80ms，取决于图层数 |
可选：浏览器路径
无头渲帧会自动找 Chrome / Edge 的常见安装位置（Windows / macOS / Linux）。装在非常规位置时：
DSH_VIDEO_HEADLESS_BROWSER=/path/to/chrome
音效库：仓库里为什么没有音频文件
能直接用，只是没有内置音效。 packages/sound-library/index.json 是一份已经算好的声学索引（753 条：时长、衰减、频谱质心、亮度、材质倾向……），它按 <根名>/<pack>/<相对路径> 索引，不含任何本机绝对路径。
想要声音，一条命令：
npm run sounds:download # 下载 Kenney 的 10 个 CC0 音效包
node packages/sound-library/scripts/download-sounds.mjs --list # 先看清单
它会下载并解压到 ~/.dsh/sound-library/kenney/，目录结构与索引逐字对齐，所以下完直接命中，不需要再跑分析器（那一步要 ffmpeg，753 个文件约半分钟）。
不下载也完全能用：本地搜索返回空列表并说明原因，Freesound 在线搜索（需自备 key）不受影响。
音频包来自 Kenney，CC0 1.0。我们不在仓库里重复分发这些二进制：它们本来就有稳定来源，而且 15 MB 的 ogg 会让每次 clone 变慢、让 diff 失去意义。索引才是这个仓库的产出。
Freesound 是可选能力，默认关闭，只从环境变量读 key，详见 docs/freesound.md。
动效库
packages/motion-lib/ 下每个目录是一张卡：
<id>/
├─ code.js export function render(ctx, t, env)，必须是 t 的纯函数（可任意 seek）
├─ meta.json 标题、标签、来源、许可、参数、依赖素材
└─ SKILL.md 少数需要外部渲染器的卡才有
用法：把目录复制（或软链）到 ~/.dsh/motion-lib/，或用环境变量 DSH_MOTION_LIB 指向它。工作台会扫描并列为原生动效，video_motion_insert 可直接插到时间线。
许可：66 张卡全部为可商用授权，逐条记录在 meta.json 的 license / source / author：
| 许可 | 张数 | 说明 |
|---|---|---|
| Apache-2.0 | 48 | 上游移植，须保留版权与许可声明 |
| MIT | 14 | 上游移植，须保留版权与许可声明 |
| 本仓库原创 | 4 | 随根目录 MIT |
本仓库不含任何非商用（Noncommercial）素材。 曾有部分卡片来自非商用授权（PolyForm / Shotcraft），已全部排除、不随本仓库分发。
根目录的 MIT 只覆盖本仓库原创代码；第三方卡按各自许可再分发。汇总见 packages/motion-lib/NOTICE.md，许可全文在 packages/motion-lib/LICENSES/。关于"为什么这样分许可"，见 docs/licensing.md。
缩略图没有随仓库分发（meta.json 的 thumb 为 null）。需要预览图时用工作台的 video_motion_list / 渲染工具现场生成。
文档
| 文档 | 讲什么 |
|---|---|
| docs/production-workflow.md | 一条片子从需求到导出的完整工序 |
| docs/lease.md | 写租约：多个 agent / 会话同时改一个工程时怎么不打架 |
| docs/transition-host.md | 转场宿主与合成 |
| docs/code-layer-media.md | 代码图层怎么拿媒体、怎么保证可 seek |
| docs/playback-loop.md | 播放循环与掉帧排查 |
| docs/headless-sampling.md | 无头渲帧：agent 怎么「看」到画面 |
| docs/camera-continuity.md | 机位连续性检查 |
| docs/motion-continuity.md | 动效连续性：卡顿、跳变、位移 |
| docs/audio-mix.md | 音频混音与音量包络 |
| docs/sound-tags.md | 声学标签：每个字段怎么测出来的 |
| docs/freesound.md | Freesound 接入：默认关闭、自备 key、遵守条款 |
测试
# 阶段机：完整、无外部依赖
npm test # = cd packages/video-brief && npm test
# 工作台：自包含的 Node 脚本，按需挑
node packages/video-table/scripts/smoke.mjs
node packages/video-table/scripts/route-test.mjs
node packages/video-table/scripts/media-test.mjs
node packages/video-table/scripts/undo-stack-test.mjs
packages/video-table/scripts/ 里的测试大多用临时目录与桩对象，不碰你的真实工程；少数（ASR、TTS、音效分析、无头渲染）需要本机 ffmpeg / Python / Chromium，缺依赖时脚本会直接说明缺什么。
没有随仓库发布的测试：8 个围绕内部策展台账的脚本（配方卡批次、机制合并记录、性能基线、样张对比）。它们断言的是内部台账文件，不是产品行为；公开仓库不带台账，也就不带这些断言。其余测试全部保留。
演示
这个系统的核心体验在动态里：一句话改完，时间线当场变。静态截图说明不了多少，所以不放图。 装上之后自己开一个工程，两分钟能看出它和「生成一段 MP4」的工具差在哪。
许可
本仓库原创代码采用 MIT，见 LICENSE。
- 动效卡：66 张全部为可商用许可（Apache-2.0 / MIT / 原创），汇总见 packages/motion-lib/NOTICE.md。本仓库不含非商用素材——曾有 82 张非商用卡（PolyForm / Shotcraft）已在发布前全部排除。
- 音效：来自 Kenney，CC0 1.0。
- agent 预设：提示词文本随根 LICENSE 以 MIT 发布，见 packages/video-preset/NOTICE.md。
安全
请不要在 issue / PR 里贴 API key、cookie、工程文件里的私人路径。报告安全问题的方式见 SECURITY.md。