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 中快速生成動畫內容的開發者。
