前言¶

在 DSH 会话里，Agent 通常已经能读取文章并给出理解。但有些工作不只要“看完”，还要把内容整理成可继续改的图：补充节点、调整连线、按报告或架构说明重新排版。dsh-diagram 面向这个需求：它把当前 Agent Session 中的文章内容转换为 Excalidraw 画布，之后你可以在 DSH 的 Canvas 中继续编辑、自动保存并导出。

这是什么¶

dsh-diagram 是由 hanzhangzzz 维护的 DSH 插件。当前资料给出的描述是：把 DeepSeek Harness 中的文章转成可编辑的 Excalidraw 画布。

它运行在 web profile，内置的编辑器是 Excalidraw 0.18.1，数据存储在插件拥有的 DSH storage-domain sidecar 中。插件不负责抓取文章，也不向任意网站注入 UI；文章获取仍由 DSH 会话、文件工具或 Web 工具完成。

核心功能¶

下面介绍它与会话、编辑和导出相关的几个入口。

图创建与读取¶

• diagram_create：根据一份紧凑的语义规格，为当前 Agent Session 创建图。
• diagram_read：把当前可编辑场景的有界摘要读入会话记录，便于 Agent 在你手动修改后继续工作。

路由与预览¶

• canvas-diagram 是内置的双语路由入口，可以从 composer 或菜单中选择，也能匹配通用的画图请求。
• diagram_create 完成后，会话中会出现内联预览卡片，把当前图内容渲染为静态 SVG。

编辑、保存与导出¶

• Canvas 标签页在被选中时才打开 Excalidraw 编辑器，避免进入普通聊天启动路径。
• 图列表用于在不同图之间切换；在窄屏上会成为选择器。
• 自动保存提供防抖的持久写入，并带 revision 冲突保护与标签页本地 pending-draft 恢复。
• 导出可下载 .excalidraw、SVG 或 PNG 文件。

支持的图类型¶

资料中列出的类型包括：报告看板、流程图、架构图、时间线、层级结构、对比图和关系图。

安装与启用¶

先确认环境满足以下要求：

• DeepSeek Harness：0.1.0-rc.6
• Node.js：^22.19.0 或 >=24.0.0
• pnpm：>=10 且在 PATH 中
• DSH Web：绑定到 127.0.0.1

资料给出的安装命令如下：

npx -y @deepseek-ai/dsh@0.1.0-rc.6 plugin --profile web add dsh-diagram@latest

这条命令会把插件添加到 web profile。添加或更新插件后，如果 DSH Web 已在运行，需要重启 DSH Web。

安装产物是预构建的 npm 包，或带 SHA-256 校验值的 GitHub Release tarball；npm 包没有 install 生命周期脚本。删除插件 bundle 不会删除已保存的图 sidecar 数据。

典型用法¶

下面是一个可复现的使用路径：

1、打开一个已经包含文章的 DSH 会话。

2、在 composer 中输入 /，选择 canvas-diagram。也可以使用自然语言请求，例如：

把这篇文章画成架构图

3、如果想让 Agent 明确执行创建动作，可以使用显式提示：

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

4、工具完成后，选择 Canvas 标签页。

5、在画布中编辑图，然后导出结果；如果希望 Agent 基于你修改后的场景继续工作，可以要求它调用 diagram_read。

适用场景与注意¶

适合在 DSH 会话中处理文章、报告、架构说明等长内容，并且希望把输出保留为可编辑画布的人。

安装和使用前需要注意：

• 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
• 图数据绑定到其 Session id 和 {createdAt, cwd} 生命周期指纹；复用 Session id 不能读取旧数据。
• Session fork 和 Session export 不会复制或包含图 sidecar 数据。
• 编辑器资产和字体由 bundle 自托管，画布不依赖外部 CDN。
• 社区插件目录是独立站点，与 DeepSeek / 幻方无官方从属关系，不要把它理解成官方应用商店。

结尾¶

经过上面的步骤，dsh-diagram 可以把 DSH 会话中的文章理解转成一张可继续维护的 Excalidraw 画布：创建、预览、编辑、保存和导出都在同一个会话工作流中完成。

项目链接：

• GitHub：https://github.com/hanzhangzzz/dsh-diagram
• 目录页（资料中给出，使用前请确认站点可用）：https://www.skillhub.cn/plugins/hanzhangzzz/dsh-diagram