zhang-guo-wen/dsh-drawioedit

dsh-drawioedit

背景：DeepSeek Harness

DeepSeek Harness（dsh）是 DeepSeek AI 开源的 agent harness，几乎所有能力都是 Cordis 插件。它处于 developer preview 阶段、迭代很快，会有破坏性变更（文档站，0.1.7-alpha.）；本插件是独立第三方包，@deepseek-ai/ 运行时从宿主解析。

这个插件解决什么问题

.drawio 图表原本没法在 DSH 里编辑；本插件在侧栏里用上游 draw.io 编辑器打开它，并把每次改动写回同一个文件。

截图

上游 draw.io 编辑器打开一个 .drawio 文件

这张截图是标签页里的随包编辑器：标题栏显示 example.drawio 与一次写入之后的 All changes saved；左侧是 draw.io 自己的形状面板，画布上是文件里的那张图。

安装

npx @deepseek-ai/dsh plugin --profile web add @guowenzhang/dsh-drawioedit

来自 npm 官方源：。装完重启宿主；本地目录开发安装、git 源与排查见 AGENTS.md。

用法

在标签页里打开图表

在文件树里点开 .drawio 文件，就会打开一个运行完整上游 draw.io 编辑器的侧栏标签页，并用文件名标注，而不是显示 "Untitled Diagram"。标签页里是 draw.io 自己的菜单、工具栏与形状面板；文件从会话工作区读出，在你改动之前不会写入任何内容。

边改边存

每次改动都写回标签页打开的那个文件：

| 编辑器里的动作 | 会发生什么 |
|---|---|
| 任意改动 | 一秒内写回，不弹任何对话框 |
| Ctrl+S | 立即写回 |
| 工具栏 Save 按钮 | 立即写回 |
| File → Save 与 File → Save As | 写回同一个文件 |
| 编辑器自己那条 "Unsaved changes. Click here to save." 提示 | 立即写回 |

Export as 依然会下载一份副本——副本本来就该这么出去。只有 host 确认之后才算保存成功，也正是在那时 drawio 的提示变成 "All changes saved"；若写入被拒——比如标签页打开期间 agent 改过同一个文件——标签页会在编辑器上方给出原因，而不是让它假装成功。

认准你在编辑哪个文件

图表以标签页打开的那个文件命名，所以 draw.io 的标题栏显示的是 example.drawio，而不是 "Untitled Diagram"。标签页只对应一个文件，因此 Save As 写回的仍是这个文件，而不是新建一个；要拿出工作区就用 Export as。

注意事项

- 这个包约 119 MB，而只读的 dsh-drawio 约 1 MB：下载里带着整个随包编辑器。
- 它依赖 draw.io 的内部实现。 编辑器由一段注入其页面的小脚本驱动，脚本钩住编辑器类，以及所有保存命令唯一汇入的那个方法；draw.io 升级若改了这两者的名字，编辑就会坏，直到本插件跟上。逐字段的机制见 AGENTS.md。

许可

Apache-2.0。内嵌编辑器为 Apache-2.0，其图标集与 stencil 库附带额外条款；详见 NOTICE。

与 draw.io Ltd 无从属或背书关系。"draw.io" 是 draw.io Ltd 的注册商标。本包内嵌其 Apache-2.0 许可的编辑器。

延伸阅读

- AGENTS.md —— 安装变体、构建、iframe 协议、随包编辑器、测试套件与排查。
- dsh-drawio —— 姊妹预览插件：只读、maxGraph，约 1 MB 而不是 119 MB。
- docs/example.drawio —— 截图里的那张图，想试着编辑的话可以直接用。
- DeepSeek Harness 文档。