DeepSeek Harness 的理念是「一切皆插件」。在智能体开发或调试过程中，对话中经常出现 Markdown 代码块形式的 Mermaid 流程图。如果仅以文本展示，难以直观理解逻辑结构。dsh-mermaid 插件解决了这个问题，它将对话中的 Mermaid 代码渲染为 SVG 流程图。
这是一个 DeepSeek Harness 的客户端插件，由 GongYuanCaiJi 维护。其核心逻辑逐行移植自 pi-mermaid@0.3.0，将原本用于 TUI 的渲染逻辑适配到了 DSH 的 Web 客户端中。
核心功能¶
- 自动渲染与校验：对话中出现 mermaid 围栏（无论用户还是助手发送）时自动渲染为 SVG。使用 Mermaid 官方 parser 做语法校验，出错时在图下方显示 warning 或 error。
- 类型支持：支持 graph / flowchart、sequenceDiagram、classDiagram、erDiagram、stateDiagram(-v2)。
- 性能与限制：代码块超过 400 行或 20000 字符时自动跳过并提示。按 (session, turn) 缓存渲染结果，避免重复计算。
- 交互功能：每张图附带可折叠的源码块，支持
/mermaid命令手动重渲染最后一条助手消息。
安装与启用¶
插件尚未发布到 npm，需通过 GitHub 源码安装。安装时需要开启 allowBuilds 以允许 prepare 脚本构建。
dsh plugin add github:GongYuanCaiJi/dsh-mermaid
安装后，在 DeepSeek Harness 的 Web 客户端中，对话中的 Mermaid 代码将自动被渲染为图表。
典型用法¶
在对话中发送包含 Mermaid 围栏的消息，系统会自动将其渲染为 SVG 图表。
```mermaid
graph TD
Start --> End
```
发送 /mermaid 命令可手动重渲染最后一条助手消息中的图表。
注意事项¶
插件以当前 DSH 进程权限运行，安装前请检查源码与许可证（MIT）。更多细节与源码，请查看 GitHub 仓库：https://github.com/GongYuanCaiJi/dsh-mermaid
