前言¶
在 DeepSeek Harness（DSH）中做智能体开发时，往往需要生成流程图、架构图、数据流图等结构化可视化内容。直接使用通用绘图工具或让 agent 输出 Markdown、Mermaid 文本，再手动转换成图片，中间环节多、一致性难控。DSH 的理念是「一切皆插件」，一个插件可以在当前 DSH 进程中直接调用能力，而不依赖外部应用。dsh-diagram-design 就是这样一个插件，它把「教 agent 画图」的能力打包进了 DSH 生态，让智能体可以直接生成、校验并导出图表。
这是什么¶
dsh-diagram-design 是 DeepSeek Harness 的一个插件，由维护者 Shang-ZZ 开发，分类为「模型推理」。它把 diagram-design（v2.6，作者 Cathryn Lavery，MIT 许可）的能力适配为 DSH 插件，提供画图能力：将图表生成单文件 HTML + 内联 SVG，并内置一套 editorial 设计系统（1 个强调色、1px 细线、无阴影、4px 网格、密度 4/10）。插件内置 45 种图表类型，支持从 draw.io / Mermaid / Excalidraw 导入，以及 SVG / PNG 导出。
核心功能¶
插件包含四个 agent 工具和一个 Web 画廊面板：
diagram_export：把 diagram-design 的 HTML 文件导出为独立的 SVG 和/或 PNG。diagram_extract：解析 draw.io / Mermaid / Excalidraw 文件，提取归一化的结构化摘要，用于重绘。diagram_self_check：校验生成的图表 HTML 文件：检查可访问性 SVG、单文件安全性与 viewBox 是否正确。diagram_doctor：诊断运行环境：检查内置脚本、Python3、Playwright 是否可用。
画廊面板在 DSH 侧边栏显示「Diagram Gallery」，列出 45 种图表类型，提供实时预览。
安装与启用¶
在终端中执行以下命令安装插件：
dsh plugin add github:Shang-ZZ/dsh-diagram-design
安装后，插件会在当前 DSH 会话中可用，四个工具与画廊面板会随 DSH 启动自动加载。若要使用 PNG 导出功能，需要额外安装 Playwright，仅在需要时安装，不会自动安装：
pip install playwright && playwright install chromium
典型用法¶
- 在 DSH 中调用
diagram_export，传入 diagram-design 的 HTML 文件路径，即可生成 SVG 和/或 PNG 文件。 - 如果手头有 draw.io / Mermaid / Excalidraw 的源文件，调用
diagram_extract解析并返回结构化摘要，再由 agent 根据摘要重新生成图表 HTML。 - 生成图表后，执行
diagram_self_check对 HTML 文件做自检，确保 SVG 可访问、单文件无外部依赖、viewBox 正确。 - 如遇环境问题，运行
diagram_doctor，检查内置脚本、Python3 与 Playwright 的可用性。
画廊面板可用来浏览 45 种图表类型的示例，直观了解每种类型的适用场景。
适用场景与注意¶
适合在 DSH 中开发需要生成结构化图表的智能体：流程编排、系统架构、数据流梳理、测试用例编排等。使用前应检查插件源码与许可证，确保符合项目规范。插件以当前 DSH 进程的权限运行，不涉及跨进程文件系统隔离。
小结¶
dsh-diagram-design 把 diagram-design 的绘图能力集成到 DeepSeek Harness 生态中，提供从导入、生成、校验到导出的一整套工作流。配合 45 种图表类型与画廊预览，可以显著减少人工绘图与格式转换的开销。插件目录页与源码仓库如下：
