画布图表 hanzhangzzz/dsh-diagram

dsh-diagram

把你在 DSH 里读完的文章，变成一张能一直改、能保存、能导出的图。

这是 DeepSeek Harness（DSH）Desktop 和 Web 的画布插件。智能体先起草结构，你在同一个会话里用 Excalidraw 打磨文字和排版，不用换一个应用重做一遍。

在 DeepSeek Harness Desktop 里（推荐）：打开 Plugins → Add plugin，填入下面的包名，点 Install，再点 Enable now。

dsh-diagram@0.6.1

想在终端里用 DSH Web？运行 npx -y @deepseek-ai/dsh@0.1.7-rc.2 plugin --profile web add dsh-diagram@0.6.1。详见快速安装。

编辑 DSH 画布、保存并导出

dsh-diagram 0.5.0 · DSH 真实录屏（中文界面）。 剪辑了编辑、保存和一次真实导出的特写；模型生成的等待过程没有展示。

30 秒走完整个流程（0.6.1，带声音）： 从对话里起草 → 手动改标签 → 智能体读取你改过的版本 → 导出 PNG/SVG/.excalidraw。产品画面是真实录屏和导出结果；周围的动画只是示意。

https://github.com/user-attachments/assets/e0930087-f841-48af-84ea-fa39267f85b0

试一个完整工作流

在 Desktop 里点完 Enable now（或者重启 DSH Web）之后，把一篇文章放进会话，输入 / 并选择 canvas-diagram，然后发送：

Turn the article above into a diagram with just three main steps and short labels.
Use the Canvas so I can edit and export the result.

打开 Canvas，改一个标签，等 Saved 出现，点 PNG 导出。找不到入口？看快速安装和疑难排查。刚接触 DSH？先按 DSH 说明配好宿主和模型，再安装这个插件。

0.6.0 新增：先看全部分类，再逐条细读

大型分类树可以用可编辑的总览 + 完整明细索引。总览为每个终端条目显示一个标记；明细面板保留全部标签和描述。在画布中使用 Classification overview 或 Read details 导航，不必把所有文字压缩到一屏（中文界面：分类总览 / 阅读明细）。

Native editable overview and detail: 9 categories, 40 terminal entries

这是从冻结的 ISO/IEC 25010:2023 Figure 2 分类导出的原生画布：50 个节点、49 条关系。它展示的是确定性渲染，并不代表整个 PDF 已自动转换。中文标签是工作翻译。

选择 /canvas-diagram 后，试试：

Create an editable classification overview and complete detail index from the content above.
Use diagram_create with kind: hierarchy and composition: atlas only if the source has
one root, categories and terminal entries. Preserve all labels, descriptions and relations.
If the structure has cross-links or more levels, choose another diagram type without dropping them.

适用范围： 干净、未分组的三层分类树。循环、多父节点、更深的路径、没有条目的分类都会被拒绝。手动修改重复的标签/计数不会自动同步；连接线可编辑，但不会自动重新布局。已保存的画布保留原有内容。

为什么把图留在 DSH 里？

- 复用文章上下文。 让智能体整理对话里已有的内容。插件本身不抓取网页。
- 生成后继续编辑。 在 Excalidraw 里改标签、节点和布局，当前会话自动保存。
- 把结果带走。 导出 PNG/SVG 用于分享，或导出 .excalidraw 继续编辑。想让智能体纳入你的手动修改时，让它读取画布。

一个真实的导出结果

这块报告板来自一次真实的发布复盘。用已发布的 0.5.0 生成，在画布里手动打磨，然后导出；这不是 UI 效果图。点击查看大图。

Release-checkpoint report exported by 0.5.0

快速安装

DeepSeek Harness Desktop（推荐）

要求：
- DeepSeek Harness 官方桌面应用，版本 0.1.7-rc.2。已在 macOS Apple Silicon 上验证；Windows x64 尚未测试。桌面版 0.1.7-rc.1 会拒绝这个插件，所以先接受应用内更新，升到 0.1.7-rc.2。
- 不需要其他东西：桌面版自带 Node.js 和包管理器。

官方应用由杭州深度求索人工智能有限公司签名。见 DeepSeek Harness 官方仓库。社区的「DSH desktop」套壳是另外的应用，没有和这个插件一起测试过。

1. 在侧边栏打开 Plugins，然后点 Add plugin。
2. 输入 dsh-diagram@0.6.1，点 Install。名字里要带版本号：DSH 的包管理器会跳过发布不到 24 小时的版本，所以只写 dsh-diagram 可能选到旧版本，然后报错「dsh-diagram@0.6.0 is incompatible with DSH 0.1.7-rc.2」。
3. 点 Enable now。插件会出现在 Installed 下，版本为 0.6.1。
4. 打开会话，找到 Canvas 标签页。

桌面版把插件放在自己的配置档里。在 Plugins 页面管理它们；本 README 里的终端命令只适用于 DSH Web。

DSH Web（终端）

要求：

- DeepSeek Harness 0.1.7-rc.2（最新）；也在 0.1.5-rc.1 和 0.1.5-rc.2 上验证过。0.1.2-rc.1 仍在支持范围内，但目前全新安装这个 DSH 版本后，即使不装插件也启动不了 dsh web，所以无法重新验证。DSH 0.1.1-rc.2 及更早版本需要 dsh-diagram 0.4.0
- Node.js ^22.19.0 或 >=24.0.0
- PATH 里有 pnpm >=10（DSH 插件命令把包管理交给 pnpm）
- DSH Web 绑定到 127.0.0.1

DeepSeek Harness 默认不安装全局 dsh 命令；官方启动方式是走 npx。下面的命令在任何满足要求的机器上都能用：

npx -y @deepseek-ai/dsh@0.1.7-rc.2 plugin --profile web add dsh-diagram@0.6.1
npx -y @deepseek-ai/dsh@0.1.7-rc.2 --profile web --dump-config
npx -y @deepseek-ai/dsh@0.1.7-rc.2 web

配置导出里应该包含这一段：

== dsh-diagram
- id: diagram
name: dsh-diagram

如果 DSH Web 已经在运行，添加或更新插件后重启它。然后打开已有会话，找到 Canvas 标签页。

其他启动方式：源码检出或全局 dsh 命令

从源码运行 DSH

在匹配受支持版本的 DeepSeek Harness 检出目录里运行同样的命令，前缀用 pnpm dsh：

pnpm dsh plugin --profile web add dsh-diagram@0.6.1
pnpm dsh --profile web --dump-config
pnpm dsh web

如果 dsh 已在 PATH 里

如果你全局安装了命令行，或者建了 shell 别名，简写形式用法一样：

dsh plugin --profile web add dsh-diagram@0.6.1
dsh --profile web --dump-config
dsh web
后文都用这个简写形式 dsh；按你运行 DSH 的方式，替换成对应的 npx -y @deepseek-ai/dsh@0.1.7-rc.2 或 pnpm dsh 前缀。

画出你的第一张图

1. 打开一个 DSH 会话，里面已经有那篇文章；或者让智能体用 DSH 现有的文件工具或 Web 工具去读。
2. 在输入框里输入 /，选 canvas-diagram —— 插件注册了这个技能，你不用再记工具名。像「把这篇文章画成架构图」这样的普通请求，也会自动走同一个技能。显式写提示词也行：

Create one clear diagram for this article. Choose the most suitable diagram type, call diagram_create, and keep the title and node labels concise.

想要可选的手绘编辑风格，就明确说出来：

Turn this article into an editable sketchnote diagram. Use semantic icons only for the key concepts.

3. 工具跑完后，在对话顶部选 Canvas。
4. 直接改图。Saved 表示 Host 已完成持久化写入。
5. 导出结果；或者在你手动改动之后，让智能体先调用 diagram_read，再继续往下做。

支持的布局有报告、流程图、架构图、时间线、层级图、对比图和关系图。想要可选的手绘风格就点名 sketchnote，否则保持默认的 clean 风格。

它带来了什么

| 界面 | 行为 |
| diagram_create | 根据一份紧凑的语义规格，为当前智能体会话创建图表。visualStyle: "sketchnote" 会选用可选的手绘编译器；受控的 icon 值会编译成可编辑的原生图元，而不是图片。 |
| diagram_read | 把当前可编辑场景的有界摘要读进对话记录。 |
| canvas-diagram 技能 | 内置的双语路由入口：可以从输入框的 / 菜单里选，也能匹配通用的画图请求，这样智能体不用写精确的工具名提示词就能走到 diagram_create。 |
| 对话内预览 | diagram_create 之后，对话流里会出现一张预览卡片，始终渲染图表当前的内容 —— 包括之后在画布上的改动 —— 以静态 SVG 呈现。 |
| Canvas 标签页 | 只有选中时才打开 Excalidraw 编辑器，不占用正常的聊天启动路径。 |
| 图表列表 | 在多张图表之间切换；桌面端可折叠，窄屏下变成选择器。 |
| 自动保存 | 防抖的持久化写入，带版本冲突保护和标签页本地的草稿恢复。 |
| 导出 | 下载 .excalidraw、SVG 或 PNG 文件。 |

插件不抓取文章，也不会往任意网站里注入 UI。文章获取仍然交给 DSH 对话、文件工具或 Web 工具。

兼容性

| 项目 | 在 0.6.1 中支持 |
| DeepSeek Harness Desktop | 0.1.7-rc.2（已验证 macOS Apple Silicon；Windows x64 尚未测试） |
| DeepSeek Harness Web | 0.1.7-rc.2、0.1.5-rc.1、0.1.5-rc.2、0.1.2-rc.1（更早的 DSH：请用 dsh-diagram@0.4.0） |
| 配置档 | desktop（在 Plugins 页面管理）或 web |
| Web 绑定地址 | 仅 127.0.0.1（Desktop 自带的 Host 已经使用回环地址） |
| Node.js | ^22.19.0 或 >=24.0.0 |
| 编辑器 | Excalidraw 0.18.1 |
| 存储 | 插件自有的 DSH 存储域 sidecar |
| 安装产物 | 预构建的 npm 包，或带 SHA-256 校验和的 GitHub Release tarball |

npm 包没有安装生命周期脚本。安装只是往选定的 DSH 配置档里加一个 bundle，不会编译代码，也不会改动 DeepSeek Harness 源码树。

管理安装

在 Desktop 里用 Plugins 页面。下面的命令适用于 DSH Web。

更新

npx -y @deepseek-ai/dsh@0.1.7-rc.2 plugin --profile web update dsh-diagram@0.6.1

更新后重启 DSH Web。

安装 GitHub Release 上最新的公开产物（精确版本）

Release 页面发布的预构建 tarball 与上面相同，并附带 SHA-256 校验和：

dsh plugin --profile web add \
https://github.com/hanzhangzzz/dsh-diagram/releases/download/v0.6.1/dsh-diagram-0.6.1.tgz

校验和与发布说明见 v0.6.1。

移除

dsh plugin --profile web remove dsh-diagram

移除 bundle 不会删除已保存的图表 sidecar 数据。重新安装插件后，同一 Session 身份又能读到这些数据。

数据、安全与限制

- Excalidraw 场景就是当前文档。原始语义规范只作为它的创建来源保留。
- 图表绑定到它的 Session id 和 {createdAt, cwd} 生命周期指纹。复用的 Session id 读不到更早的数据。
- Session fork 和 Session export 不会复制或包含图表 sidecar 数据。
- 编辑器资源和字体由 bundle 自托管；画布不依赖外部 CDN。
- 静态路径、RPC 请求体、请求来源、Session 归属和场景内容，都在持久化之前由 Host 校验。
- 本版本拒绝图片、iframe、可嵌入对象、外部链接和非空二进制文件。
- 默认限制每个场景 1 MiB，所有已存图表记录合计 64 MiB。元素、文本、图表数量和字节上限都在 cordis.patch.yml 里明确写出。
- DSH Web 绑定到 0.0.0.0 时，插件会主动拒绝加载；本版本不把画布 RPC 暴露到局域网。

故障排查

Desktop 提示「dsh-diagram@0.6.0 is incompatible with DSH 0.1.7-rc.2」

包管理器选到了更旧的版本。重新添加插件时带上版本号，写成 dsh-diagram@0.6.1。如果你的 Desktop 是 0.1.7-rc.1，先把应用更新到 0.1.7-rc.2。

新发布的版本没有装上

pnpm 11 默认的 minimumReleaseAge 会排除发布不足 24 小时的版本。发布当天请锁定确切版本，不要依赖 @latest；上面的试用命令已经锁定了 0.6.1。

Canvas 标签页不见了

在 Desktop 中，确认插件在 Installed 下显示版本 0.6.1，并且你点过 Enable now。在 DSH Web 中，确认你把插件装进了 web 配置档，--dump-config 里包含上面显示的 dsh-diagram 块，并且安装后重启过 DSH Web。

智能体写了一个 SVG 或 Mermaid 文件，没有用 Canvas

模型会在会话中所有工具和工作区技能之间自由选择。插件注册了自己的 canvas-diagram 技能，所以一般的图表请求通常会走 Canvas；如果某个工作区技能的描述匹配度更高、仍然胜出，就从 / 菜单里选 canvas-diagram，或者明确提到 Canvas——比如「调用 diagram_create，这样我就能在 Canvas 标签页里编辑结果」。

智能体不知道我手动做的修改

手动修改不会悄悄注入模型上下文。让智能体调用 diagram_read；结果会记录到正常的对话记录里。

插件能从 URL 抓取文章吗？

不能。先让 DSH 通过对话、文件工具或 Web 工具拿到内容，然后再让它画图。

为什么用 0.0.0.0 启动会失败？

本版本的 canvas RPC 不支持暴露到局域网。除非 DSH Web 实际绑定到 127.0.0.1，否则插件会直接失败关闭。

修订冲突之后我该做什么？

编辑器会保留本地草稿。如果你需要同时保留两个版本，先导出草稿，再选择 Reload server version。

为什么 SVG 导出会记录字体回退警告？

在严格的内容安全策略下，Excalidraw 可能从字形子集化回退到嵌入完整的自托管字体。导出的 SVG 仍然是自包含的；插件不会为了压掉这条警告而启用 unsafe-eval。

源码预览：结构化图表

源码版本新增了带编号、可编辑的辅助说明、决策菱形、显式的并行架构区域（composition: regions），以及对齐的比较标准。主图阅读和整篇文档概览是两个独立的视口操作；所有导出都保留当前完整场景。这些改动不包含在上面公开的 0.6.1 包里。构建这份源码即可试用预发布版。

把会改变决策的条件放在主节点里。辅助说明不会自动同步到对其引用标签的手动修改。共享的比较标签必须代表同一个标准；渲染器对齐的是匹配的标签，不是它们的含义。

从源码构建

git clone https://github.com/hanzhangzzz/dsh-diagram.git
cd dsh-diagram
pnpm install --frozen-lockfile
pnpm run bundle
pnpm pack

从 DeepSeek Harness 检出目录安装生成的 tarball：
cd /path/to/deepseek-harness
pnpm dsh plugin --profile web add /absolute/path/to/dsh-diagram-VERSION.tgz
pnpm dsh --profile web --dump-config
pnpm dsh web

开发者自检：

pnpm run typecheck
pnpm run test
pnpm run bundle
pnpm pack --json
pnpm run smoke:dsh-install

每个可安装的开发提交都必须用新的预发布版本号；绝不要在已有版本号下重新打包改动过的代码。公开发布之前，先打包一次，然后走一遍和 DSH 配置档更新相同的路径，从上一个公开版本升级到这个 tarball：

pnpm run smoke:dsh-install -- \
--tarball /absolute/path/to/dsh-diagram-VERSION.tgz \
--upgrade-from PREVIOUS_PUBLIC_VERSION

这样能在不发布候选版本的前提下，验证客户端侧的更新机制，以及更新前后两次 Web 启动。通过 @latest 做注册表发现，要等版本公开发布之后再单独验证。

产品和实现上的决策见 DESIGN.md。

参与贡献

欢迎到 GitHub Issues 提 bug 报告和聚焦的 pull request。如果这个插件改善了你从文章到图表的工作流，给个 GitHub star 能帮更多 DSH 用户发现它。

许可证

插件自身的代码采用 MIT 许可。打包进来的 JavaScript 和自托管字体的许可证列在 THIRD_PARTY_NOTICES.md 和 third_party_licenses/ 里。

给贡献者：pnpm review:atlas 会打开确定性对比工具；用 /tests/visual/atlas.html，或者加上 ?case=release 看第二个对象。