dsh-drawio:在 DeepSeek Harness 侧边栏直接查看流程图
zhang-guo-wen/dsh-drawio
为 DeepSeek Harness 提供 .drawio 文件侧边栏预览的 DSH plugin,从文件树打开即渲染为流程图,无需查看 mxGraph XML 源码。
dsh-drawio 是一个 DSH plugin,把文件树里的 .drawio 源文件在 Web 侧边栏渲染成你画好的流程图,而不是让你面对一堆 mxGraph XML。它解决的是图表文件只能看源码、无法直观查看的问题,让你点开文件就能看到图形。核心能力包括只读惰性渲染、同时兼容明文与压缩两种保存格式、完全本地渲染并套用与 draw.io 默认值一致的样式表。它由 zhang-guo-wen 维护,采用 Apache-2.0 协议,编辑能力由另一个独立插件提供。
如何安装
dsh plugin --profile web add github:zhang-guo-wen/dsh-drawio- 分类
- 工具与能力
- 平台
- DSH Plugin
- 作者
- zhang-guo-wen
- 分发方式
- 插件
dsh-drawio 核心特性
dsh-drawio 仓库简介
它是做什么的?
zhang-guo-wen/dsh-drawio 是 DeepSeek Harness(DSH)的 .drawio 图表预览插件,把文件树里的 mxGraph XML 源文件直接渲染成你画好的流程图。它解决的是打开 .drawio 只能看到一堆 XML 源码、无法在侧边栏直观查看的问题,让你在 DSH 的 Web 侧边栏里点开文件就能看到图形。插件由 zhang-guo-wen 维护,采用 Apache-2.0 协议,纯本地渲染,不上传任何内容。
核心功能
- 只读且惰性渲染:文件在离屏环境解码与排版,面板只接收一个 SVG 数据地址,不注入引擎实例或活动 DOM,图表内容无法脚本化页面。
- 兼容两种 draw.io 保存格式:既支持明文 mxGraph XML,也支持 base64 + 原始 DEFLATE + 百分号转义的压缩体;多页文件渲染第一页。
- 完全本地渲染:不依赖托管查看器,渲染器套用与 draw.io 默认值一致的样式表,单元格样式串未写颜色时不会继承存储引擎自己的调色板,单元格自带样式仍然优先。
- 与编辑插件相互独立:编辑能力由另一个独立插件提供,本插件专注预览,两者互不依赖。
怎么使用这个插件?
在 DSH 的 Web 配置中启用后,从文件树打开任意 .drawio 文件,它就会在侧边栏渲染成图表而不是 XML 源码。使用前该配置需要已组合侧边栏文档预览能力(官方发布的 Web 配置均已包含),启用后重启宿主即可生效。需要注意已知限制:连线路由与连线标签位置与 draw.io 不完全一致,因为文件只存端点与 edgeStyle 名称、不存中间路径;引擎形状集之外的图形会画成普通矩形而不会省略。若标签与节点间距过窄,可在 draw.io 中拖动标签位置或加宽节点间距,让编辑器把显式坐标写回文件,所有查看器都会遵循。
报错怎么排查?
图表显示为普通矩形:说明该形状不在内置引擎的形状集内,属于已知限制,不会导致文件被跳过,可改用引擎支持的形状或在 draw.io 中确认图形类型。 连线拐点或标签位置与 draw.io 不一致:文件本身不保存路径,两个查看器各自计算,可在 draw.io 中拖动标签或加宽节点间距,把显式坐标写回文件后即可对齐。 侧边栏没有出现预览:确认当前 Web 配置已组合侧边栏文档预览能力,并确认插件已正确启用后重启宿主。
本页是基于该插件官方 README 独立重写的导读——权威文档和最新变更请以源头为准:zhang-guo-wen/dsh-drawio。插件是安装时就在你机器上运行的第三方代码;收录不代表背书——安装前请自行审阅源码。
DSH Plugin 常见问题
