dsh-whiteboard

DSH 协作白板

在 DeepSeek Harness 中，与 AI 共用一张可继续编辑的白板。

你画起点，让 AI 补流程；AI 画完，你继续拖动、改字、调整连线。产出是 Excalidraw 原生图形，不是一张无法修改的图片。

安装 0.3.0 · 示例文件 · AI 工具 · 验证状态

开发版，针对 DSH 0.2.1-rc.3 的公开接口开发。自动化测试与构建不等于真实 GUI 全面验收。

先试三个 Demo

场景	准备好的内容	想展示什么
点一下，看清关系	流程示例	阅读模式聚焦节点及直接相连的节点和连线。
一个会话，多张图	架构示例	按名称整理、搜索和切换独立白板，不把所有东西堆在一张图里。
人和 AI 接力编辑	需求起点	保留已有节点，让 AI 增量补充，再由人继续编辑。

这些是代码构建的虚构源文件，不是截图或 Computer Use 实录。 每组另附 AI 操作 JSON，可用于新建的演示白板；本轮尚未实测浏览器导入。

真实 GIF 尚未录制：录制工具已安装，但浏览器扩展未连接。不会用模拟动画冒充实录，也不放失效的 GIF 占位图。三段 录制分镜与恢复条件已准备好。

安装

不要只填裸包名 dsh-whiteboard。 npm 上同名 0.0.1 是他人的占位包，不是本项目，可能报“没有声明组合包”。本项目通过 GitHub Release 提供预构建包。

在 DSH 插件管理器中，粘贴下面的完整地址：

https://github.com/Fantasy421/dsh-whiteboard/releases/download/v0.3.0/dsh-whiteboard-0.3.0.tgz

也可以用 CLI：

dsh plugin --profile desktop add https://github.com/Fantasy421/dsh-whiteboard/releases/download/v0.3.0/dsh-whiteboard-0.3.0.tgz

安装或升级后保存工作并重启 DSH，再打开会话右侧栏的「协作白板」。只刷新旧安装不会下载新版；不要把仓库 ZIP 或 Release 页面地址当成安装包。

安装、升级、卸载与故障排查 →

一分钟上手

1. 打开右侧「协作白板」，先画一个节点，或让 AI 从空白开始。
2. 在原聊天框描述目标，不需要额外输入框或图像生成服务。
3. 直接在画布继续改；顶部名称展开白板管理，「大屏编辑」扩大工作区，「更多」收纳次要操作。

可以这样说：

先读取当前白板，保留已有“需求”节点，补充“设计”和“验收”，用箭头连接，给节点留出排版空间。

在当前会话新建一张“发布流程”白板，画出准备、检查、发布三个步骤。不要修改其他白板。

列出当前会话的白板。读取我指定的那张，把服务到存储的连线改成折线，保留其他内容。

多白板时，AI 应先列出并读取目标，写入明确的 boardId 和最新版本；遇到冲突重新读取、重新评估，不盲目覆盖。

能做什么

• 原生可编辑：形状、文字、自由笔、绑定箭头、曲线/折线；保留原生选择、拖动与撤销操作。
• 阅读模式：「更多 → 阅读模式」，点击节点高亮一跳入边/出边与邻居；空白或 Esc 清除，退出后编辑。不递归整条链，不猜测几何交叉线的关系。
• 同会话多白板：新建、命名、搜索、快速切换与软删除；旧单白板数据兼容保留。
• 紧凑侧栏与大屏：管理默认折叠，不常用操作放「更多」，选中线时才显示一键线型转换。
• 本地保存与导出：按会话/白板保存，导出 PNG、SVG、.excalidraw 源文件。
• 冲突保护：不同对象的并发修改可合并，同对象冲突暂停并保留草稿，不静默覆盖。

阅读高亮是本地 SVG 覆盖层，不给节点改色，也不写进导出；理想轮廓与原生随机手绘笔触不承诺像素级重合。曲线/折线不是自动避障路由器。

状态与边界

• 自动化：0.3.0 发布时 158 项测试及生产构建通过；本次文档与 Demo 更新为 162 项测试及构建通过，新增示例/链接校验。包含组件配原生生命周期桩、几何、同步与存储测试，不是完整浏览器验收。
• 实录：当前没有真实 GUI 录像或 GIF。示例文件仅经模型与结构校验；实际演示路径完成后再补证据。
• 限制：不是多人远程实时协作/CRDT；不支持网页嵌入；撤销历史仅在本次编辑器打开期间；字体有 CDN fallback，不承诺严格离线。
• 数据：白板保存在本机，浏览器保留恢复草稿。冲突时先导出备份；删除是目录软隐藏，目前没有恢复 UI。AI 工具输入应视为数据，不是执行电脑操作的指令。

完整验证与待验收清单 · 保存、恢复、容量与安全边界

文档与开发

文档	内容
安装	完整安装入口、升级、卸载和排错。
AI 工具	四个工具、显式目标、目录/场景版本与操作示例。
数据与安全	本地文件、草稿、软删除、容量和并发边界。
开发	源码结构、构建、打包及发布前检查。
Demo	可编辑源文件和 AI 操作数据。

Node.js 20+：

npm ci --legacy-peer-deps --ignore-scripts
npm run check
npm pack

MIT；第三方代码与字体保留各自许可证，详见 第三方声明 和 许可来源。