# dsh-drawtalk **Repository Path**: rainnioe/dsh-drawtalk ## Basic Information - **Project Name**: dsh-drawtalk - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-10 - **Last Updated**: 2026-11-10 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # dsh-drawtalk · 画说(手绘讲解视频) DeepSeek Harness(dsh)插件:**图文讲解视频技能**——把讲解稿变成「手绘会动的画面」讲解视频。图形由代码逐笔绘出、文字逐字写出、讲到哪画到哪(音画对齐)。五套风格,本地 Chrome 渲染,**零生图 API 成本**,任何改动秒级重渲。 技能本体来自 [whiteboard-teacher-video](https://github.com/liangdabiao/whiteboard-teacher-video)(MIT,liangdabiao)。B 站效果示例:[GPS 是怎么工作的](https://www.bilibili.com/video/BV1mpn96UE7B/) · [勾股定理证明](https://www.bilibili.com/video/BV1yYJ46PE5R/) · [财务报表解释](https://www.bilibili.com/video/BV1U2xY6gEto/) image ## 装上以后有什么 | 能力 | 说明 | |---|---| | **手绘讲解视频技能** | `/whiteboard-teacher-video` 斜杠命令 + 模型自主触发:写分镜 → 确认 → 写口播 → 逐页画面 → 配音 → 渲染 MP4。五套风格(白板/黑板/书卷/暖色插画/科技深色)、29 个现成组件、15 个真实项目分镜示例 | | 侧栏「画说」面板 | 📖 工具选择(三个工具怎么选 + 三种视频怎么选,一键把指令填进对话框)+ 📊 制作进度 + 🎬 分镜示例浏览 | ## 怎么用 对话里一句话:**「做一个讲相对论的 90 秒手绘讲解视频」**。也可以打开侧栏「画说」→「📖 工具选择」,点按钮(做一条讲解视频 / 看制作进度 / 校验分镜)——会打开新对话并把指令填进输入框,补完内容回车即可(不自动发送)。 模型会按技能工作流:写分镜 → 停下来和你确认 → 写口播与逐页画面 → 配音(edge-tts 免费)→ 渲染成片(MP4,产出在工作区 `out/` 目录)。 **首次制作**模型会先做环境安装(一次性,约 2–4 分钟):从 GitHub 拉渲染引擎(约 16MB sparse checkout)+ npm 安装依赖(约 130MB)。需要本机有 git、Node 22+、Python 3、Chrome 或 Edge。 ## 怎么实现的 渲染引擎 [frametell](https://github.com/sitor-ai/frametell)(AGPL-3.0,Sitor Team)不进插件包——**整片是时间的纯函数** `renderAt(t)`,引擎在用户工作区副本里以独立进程被调用,用本机 Chrome 截图 + ffmpeg 编码,零生图 API 成本。 ## 自检 ```bash npm install && npm run build && npm test && npm run selftest ``` - `npm test`:14 个单测(快照完整/frontmatter/脚本齐备/addendum 三条/分镜示例/AGPL 引擎不入快照/制作清单与分镜校验/参数类型校验与序号归一化/浏览器半边守卫与面板注册) - `npm run selftest`:快照+provider+面板 API+引擎声明+人类闸门,零网络 ## 安装 从 npm 安装(推荐): ```bash dsh plugin --profile web add dsh-drawtalk ``` 固定版本:`dsh plugin --profile web add dsh-drawtalk@0.2.2`。 也可以从 Gitee 仓库安装: ```bash dsh plugin --profile web add git+https://gitee.com/rainnioe/dsh-drawtalk.git ``` 固定版本在地址后加 `#`,例如 `git+https://gitee.com/rainnioe/dsh-drawtalk.git#v0.2.2`。产物 `dist/client.js` 已入库并随 npm 包分发,两种安装方式都不需要本地跑 build,也不会触发 pnpm ≥10 的构建脚本审批。 ## 从 dsh-whiteboard-video 迁移 包名和安装源都变了,**依赖键必须先 remove 再 add**: ```bash dsh plugin --profile web remove dsh-whiteboard-video dsh plugin --profile web add dsh-drawtalk ``` (也可把第二行换成 `git+https://gitee.com/rainnioe/dsh-drawtalk.git`,两种源的包内容一致。) 然后重启 dsh web 进程并刷新页面(profile 组合只在启动时生效)。 ⚠️ 不要直接 `update dsh-whiteboard-video`:pnpm 容忍「旧依赖键指向新包名」的不匹配而不报错,但宿主 client-modules 会拿依赖键当期望包名去校验 manifest 的 `name`,不相等就把该行踢出 client 图——侧栏界面整块消失,宿主日志里还没有错误。 **制作进度不会丢**:持久化目录 `~/.dsh/whiteboard-video/`、API 路由 `/whiteboard-video/*`、内部 id `whiteboard-video` 和技能名 `whiteboard-teacher-video` 都刻意保留了旧名——它们是跨侧契约,不是展示名。 ## 许可 - 插件壳代码(src/lib/client/scripts):**MIT**(liangdabiao) - 技能快照内容(skills/whiteboard-teacher-video/):**MIT**(liangdabiao) - 渲染引擎 frametell:**AGPL-3.0-only**(Sitor Team)——不随插件分发,用户首次 setup 时从上游拉取;引擎以独立进程运行,产出的视频不构成衍生作品。详见快照内 `vendor/ATTRIBUTION.md`。 特别致谢社区支持:https://linux.do