DeepSeek Harness（DSH）的核心理念是“一切皆插件”。当开发者希望在会话中利用模型生成内容，而不是编写具体的实现代码时，dsh-animation-studio 提供了一个内置在教学会话里的“教学视频 agent”。
这是一个给 DSH 做的教学动画制作工作台插件，它把复杂的动画工程拆解成模型可理解的指令与数据。
核心机制¶
模型不写动画代码，只读写 JSON。
工作台将动画流程封装为 10 个面向模型的工具（anim_*）。模型通过这些工具操作一份 AnimationSpec（JSON IR），所有的变更都走 JSON Patch 格式。这意味着修改是原子化的（例如调整一个毫秒数），天然支持撤销与回滚。状态变更以事件形式记录，通过事件溯源与会话恢复，确保宿主重启或会话重开后，动画进度依然存在。
渲染层面支持 Motion Canvas，并自动后台化渲染与预览。在 Web 界面下，工具调用会生成会话卡片，卡片带有交互按钮，可直接触发预览或渲染。
功能概览¶
- JSON 优先工作流：模型只操作数据，不接触底层渲染引擎。
- 事件溯源与恢复：变更记录在插件独立的 sidecar 中，不污染宿主日志。
- 后台渲染：支持异步渲染任务，进度可见，支持中断。
- 交互式卡片：会话内直接展示视频预览与控制按钮。
- 旁白支持：内置旁白字幕与配音功能，支持自定义 TTS 外部命令。
- 可扩展性：渲染器支持替换，可接入其他引擎。
环境与安装¶
前置要求：
- Node.js >= 22
- DSH >= 0.1.5-rc.2
- 包管理器必须使用 pnpm
- 渲染需要 ffmpeg、Chrome/Edge/Chromium
- Linux 渲染需要 Xvfb 和中文字体
安装步骤：
1. 获取插件源码。
2. 执行安装命令（注意路径使用绝对路径）：
dsh plugin --profile web add F:\\path\\to\\dsh-animation-studio
安装完成后，重启 DSH，在会话中即可使用。
配置与使用¶
基础配置：
在 DSH 的配置中设置输出目录与 TTS（可选）。
典型用法：
1. 在 DSH 会话中提出需求，例如：“做一支讲梯度下降的 30 秒短片”。
2. 装好后先让 AI 调用 anim_diagnose 进行环境自检。
3. 随后直接在会话中与 Agent 交互，Agent 会调用内置工具完成从分镜到渲染的全流程。
注意：
- TTS 功能会将旁白文本发送给配置的外部命令，在离线环境需注意网络策略。
- Windows 下离线 tgz 路径不能包含空格。
总结¶
dsh-animation-studio 是一套面向模型的动画制作工作台，它通过 JSON Patch 和事件溯源机制，让模型在不编写代码的情况下完成教学视频的制作。适合需要在 DSH 中快速生成动画内容的开发者。
