dsh-drawai：DeepSeek Harness 右侧栏里的可编辑画布与改图工具

它是做什么的？

DrawAI 是 DeepSeek Harness（DSH）的右侧栏可编辑画布插件，把一块能画图的面板和两个让模型直接改图的工具放进同一个工作区。它解决的是「人画的图、模型改的图、drawio 打开的图各存一份」的麻烦，三者读写的是同一份原生 .drawio 文件。画布负责手工绘制与调整，模型侧通过 diagram_read 与 diagram_apply 两个工具读取结构、按结构化指令改图，改完自动布局并原子写回。由 fourzkw 维护，采用 MIT 协议，最近更新于 2026-09。

核心功能

• 右侧栏画布：打开或新建工作区里的 .drawio，支持 9 种形状、8 色调色板、正交折线避让、双击就地改字、图层与顺序管理、多选对齐分布，并可导出 SVG / PNG。
• diagram_apply 改图工具：提供增删改、重接边、复制、排序、分层、导出等 15 个结构化 ops，改完自动布局并原子写回，支持 ids 批量与 as 别名。
• diagram_read 读取工具：返回节点与边、样式键、图层与父级、页面尺寸、边标签坐标、文件指纹 revision 以及你此刻的选区，可只读某一层或指定单元以节省上下文。
• 选中与回退联动：你在画布上选中什么模型就知道什么，模型的每一轮改动都能在界面上退回，最多连退 8 步。
• 原生文件无损写回：画布读不懂的单元逐字节保留，存出的文件可直接用 drawio / diagrams.net 打开继续编辑。

怎么使用这个插件？

在 DSH 中启用后，右侧栏会出现「DrawAI 画布」面板，刚打开时是空的，用「文件 → 新建画布…」或「文件 → 打开…」列出工作区里所有 .drawio 开始绘制。手工操作走面板菜单：双击节点改标签、右键编辑数据、图层与顺序面板调整层级、导出 SVG 或 PNG。让模型改图时，直接描述需求即可，模型会先调用 diagram_read 看清结构与当前选区，再用 diagram_apply 提交 ops；若担心与手工编辑冲突，可让模型带上 expectRevision，指纹对不上就报错且不写盘。需要回退时用「编辑 → 撤销 AI 改动」。

报错怎么排查？

模型改图报错时，最常见的原因是 expectRevision 与文件当前指纹不一致，说明你在 drawio 里同时改过，按官方说明重新读取再改即可。若 ops 引用了不存在的节点，工具会在写盘之前直接失败并列出已知 id，按提示修正引用即可。