侧栏画板 jaikensai888/dsh-drawio

dsh-drawio

在 DSH Web GUI 的侧边栏里直接画 draw.io 图。

说明

- 侧边栏点开工作区里的 .drawio 文件，就是一个真正的 draw.io 画布（形状面板、格式面板、连线都在）。
- 图纸就是工作区里的普通文件，能进 git、能被别的工具读写；新建默认落在 <工作区>/docs/diagrams/。
- 编辑器自托管：首次使用时下载并校验官方资源包到 ~/.dsh（约 51 MB），之后完全离线。
- 改动自动保存；文件在编辑器之外被改过时会拒绝覆盖并让你选，不会静默吞掉别人的改动。
- 明暗跟随 DSH：设置里选浅色/深色/跟随系统，画布立刻跟着变，不重载编辑器（见下方「深色模式」）。
- 不给模型任何工具，这是给人用的编辑器。

安装

cd $env:USERPROFILE\.dsh
dsh plugin --profile desktop add "github:jaikensai888/dsh-drawio#v0.1.4"

然后完全退出并重启 DSH Desktop（关窗口不算），再在浏览器里 Ctrl+Shift+R。

卸载：

cd $env:USERPROFILE\.dsh
dsh plugin --profile desktop remove dsh-drawio

要求：DSH Desktop 2.0.4+、dsh-better-sidebar 0.17.1+；首次使用需要联网，之后离线可用。
想调图纸目录、编辑器地址等参数，写在 profile 的 cordis.patch.yml 里（键与默认值见 src/config.ts）。

升级 DSH Desktop 之后「画布」不见了？

升级 App 会换掉它内部的 @deepseek-ai/dsh-client-modules，而那个服务是用
require.resolve('<包名>/package.json') 去定位每个插件的客户端清单的。所以只要
package.json 的 exports 没有导出 "./package.json"，客户端那一行会被静默丢弃： host 半照常在跑、/drawio/ping 也回 200，但左栏没有「画布」，.drawio 还会掉回代码预览器。

v0.1.4 已修掉这个坑（exports 补了 "./package.json"，并加了回归测试）。一条命令就能分辨现状（端口就是 GUI 的端口，不需要凭据）：

curl.exe -s http://127.0.0.1:<GUI 端口>/drawio/ping

| 返回 | 含义 | 怎么办 |
| 连不上 / 404 | host 半没挂上，插件已不在 profile 里 | 按上面「安装」重装一次 |
| "clientHalf":{"row":false,"bundle":null} | 客户端清单没被找到（就是这个坑） | 升级到 v0.1.4+：先 remove 再 add |
| "clientHalf":{"row":true,...} | 客户端半在页面里 | 刷新页面（Ctrl+Shift+R） |

clientHalf 是 v0.1.4 起 /drawio/ping 的一部分：以后任何一次升级只要「画布消失了」，先看这一个字段就知道是 host 行没了、清单没被认出来，还是只是页面没刷新。

使用

打开图纸 —— 在侧边栏文件树里点任意 .drawio，它就在编辑器标签页里打开：

在侧边栏里打开的 draw.io 画布

新建图纸 —— 三个入口任选：

1. 左栏底部、设置上方的「画布」按钮（侧栏收起时和设置一样只剩图标；一张图纸都没有的新工作区里，这是唯一入口）；
2. 编辑器工具栏的「新建」；
3. 在编辑器里打开一个不存在的路径时，面板会问你要不要在该路径创建。

保存 —— 自动的。工具栏右侧显示 已同步 / 未保存 / 保存中… / 已保存 / 有冲突。
出现冲突条，说明文件被编辑器以外的东西改过；面板提供「放弃本地改动，读磁盘」和「用我的版本覆盖」，由你决定，插件不会替你选：

冲突条

面板太窄 —— draw.io 会自己收起形状/格式面板。把编辑器标签页拖到主会话区域，它会变成可移动、可缩放的悬浮窗口；拖回侧边栏即停靠。

深色模式 —— 默认跟着 DSH 走：设置 →「通用」里选 浅色 / 深色 / 跟随系统，编辑器打开时用当前那一种；之后在设置里一改，画布立即切换，不会重载 iframe，画布上还没保存的东西不会丢。

想固定一种，写在 profile 的 cordis.patch.yml 里：

- id: drawio
config:
darkMode: dark # follow(默认) | light | dark

- darkMode: dark / light → 钉死这一种，不再跟随 DSH。
- uiTheme: dark → drawio 自带的深色外壳主题；它本身就等于深色，所以会把 darkMode 一并钉成 dark，避免出现深色外壳 + 浅色画布这种半深色状态。
- 两者都改不动 editorUrl 指向的外部编辑器：那是别人家的页面，插件不下发任何参数。

许可 MIT。drawio 编辑器资源来自 jgraph/drawio（Apache-2.0），由本插件在运行时下载到本机，不在本仓库分发。
实现细节与踩坑记录见 docs/PLAN.md 和 docs/GROUND-TRUTH.md。