前言¶
用智能体梳理流程或画结构图时，常见做法是：在聊天里口述步骤，再另开绘图工具重画一遍，或在截图与文字之间来回粘贴。图形往往是静态图片，改一处就要整图重做。
DeepSeek Harness（DSH）支持通过客户端插件扩展界面与能力。Fantasy421 维护的 dsh-whiteboard 在会话右侧栏嵌入基于 Excalidraw 的可编辑白板：AI 可通过工具新建节点、连线并局部修改；你仍可用鼠标拖动、改字、换线型。生成的是矢量图形对象，不是一张不可编辑的位图。
下面介绍插件定位、能力与安装方式，并给出可复现的聊天提示示例。
这是什么¶
- 名称：dsh-whiteboard（仓库 Fantasy421/dsh-whiteboard）
- 维护者：Fantasy421
- 分类：客户端插件（
dsh.client注入侧栏等 UI 槽位） - 当前版本：0.3.0（README 写明基于 DSH
0.2.1-rc.3公开插件接口开发） - 许可证：MIT
一句话：Human + AI collaborative Excalidraw whiteboard for DeepSeek Harness——人与 AI 共用同一张本机白板，在聊天旁边聊边画。
社区目录页：skillhub.cn/plugins/Fantasy421/dsh-whiteboard（独立站点，与 DeepSeek / 幻方无官方从属关系）。
核心功能¶
两种创作方式¶
- 自然语言搭框架：在原聊天框描述想法，AI 可新建节点、补充文字、连接步骤，或先读取已有内容再局部修改。
- 鼠标打磨细节：AI 生成的节点与连线可选中、拖动、编辑；人机可接力（你先画起点，AI 再补；或 AI 出草图你再排版）。
能力与限制（据 README）¶
| 能力 | 说明 |
|---|---|
| 阅读模式 | 从「更多」进入；点节点高亮其一跳相连的节点与连线；点空白或 Esc 清除高亮。 |
| 多白板 | 按主题新建、重命名、搜索、切换；同一对话可多张图。 |
| 侧栏与大屏 | 聊天旁随手画；复杂内容可切大屏；次要操作默认收起。 |
| 曲线与折线 | 原生可编辑连线；AI 可指定线型；选中连线可在「更多」中转换。 |
| 保存与导出 | 按会话与白板本地保存；可导出 PNG、SVG、.excalidraw。 |
| 增量修改 | 不必每次重画整图；同对象冲突时暂停同步并保留草稿，避免静默覆盖。 |
使用说明中的边界：白板数据保存在本机；「协作」指人与 AI 共用白板，不是多人远程实时协作；目前不支持网页嵌入；撤销限于本次编辑器打开期间；字体加载不保证完全离线。草稿恢复、软删除与容量限制见仓库内 docs/data-and-safety.md。
AI 侧涉及白板时有四个工具，多白板场景应明确 boardId 与版本；详见 docs/ai-tools.md。
安装与启用¶
安装或升级前，插件随当前 DSH 进程与界面运行，建议先浏览仓库源码与 MIT 许可证，再决定是否安装。
在 DSH 插件管理器中粘贴完整 Release 地址（勿只填 dsh-whiteboard——npm 上同名 0.0.1 为其他作者的占位包）：
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，在会话右侧栏打开「协作白板」。更完整的安装、升级与故障排查见 docs/installation.md。
典型用法¶
快速开始（四步）¶
- 从右侧栏进入白板，直接绘图或让 AI 从空白开始。
- 继续用原聊天框描述节点、关系和布局。
- 拖动节点、改字、调整线型；顶部白板名称可管理多张白板。
- 在「更多」中进入阅读模式，或导出图片与源文件。
可试用的提示词（摘自 README）¶
整理流程
在当前白板画一个发布流程：准备 → 检查 → 发布。检查失败时回到准备，并给分支加上说明。
单独开一张图
在当前会话新建一张「系统架构」白板，画出界面、服务和存储的关系，不要修改其他白板。
只改局部
先读取我指定的白板，把服务到存储的连线改成折线，保留其他节点、文字和布局。
仓库 examples/ 提供流程图、系统架构、人机接力起点等 .excalidraw 及增量操作 JSON，见 examples/README.md。
适用场景与注意¶
适合谁
- 需要在 DSH 对话旁用流程图、架构图、待办结构表达思路，且希望 AI 参与建图与增量改图的开发者。
- 已使用 DSH
0.2.1-rc.3系客户端插件接口、并愿从 Release 包安装预构建产物的用户。
注意
- 必须使用上述 v0.3.0 Release
.tgz，不要用仓库源码 ZIP 代替预构建包。 - 数据本地存储；无多人实时协同与网页嵌入。
- 插件以当前 DSH 客户端权限运行，安装前请自行审阅源码与第三方声明（
THIRD_PARTY_NOTICES.md）。
结尾¶
dsh-whiteboard 把 Excalidraw 放进 DSH 右侧栏，让人与 AI 在同一张可编辑白板上接力：聊天里搭结构，画布里调细节，并可分主题管理多张图与导出源文件。
