dsh-drawioedit

English | 中文

背景：DeepSeek Harness

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

这个插件解决什么问题

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

截图

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

安装

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

来自 npm 官方源：https://www.npmjs.com/package/@guowenzhang/dsh-drawioedit。装完重启宿主；本地目录开发安装、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 文档。