在 DeepSeek Harness (DSH) 的 Web 端中直接预览 Mermaid 流程图、时序图等图表，是开发者目前需要通过插件扩展实现的功能。dsh-mermaid 插件由 MrmoLabs 维护，其核心价值在于将 Markdown 中的 Mermaid fenced code blocks 直接渲染为 SVG 格式的可视化图表，并提供代码与图表的切换视图。
该插件内置了 Mermaid 11.17.0 运行时，无需依赖外部 CDN，支持流式响应、暗黑模式、全屏查看（支持缩放、平移、重置及适应窗口）以及 SVG 导出。它采用严格的 Mermaid 安全模式，并在渲染失败时自动回退到源代码显示，确保页面稳定性。
核心功能¶
- 图表渲染：支持
mermaid、mermaidjs和mmd三种 fenced code block 标记的渲染。 - 交互控制：提供“代码/图表”切换按钮。图表支持全屏查看，内置缩放、平移、重置及适应窗口功能。
- 导出与本地化：支持将渲染后的 SVG 图表导出为独立文件。界面文本支持简体中文或英文自动跟随页面语言。
- 容错机制：采用 Mermaid 的
securityLevel: strict模式。若渲染失败，会自动回退显示源代码，并抑制 Mermaid 内置的错误 SVG 图标。 - 性能与安全：渲染通过串行队列执行，避免阻塞页面。单个图表大小限制在 50,000 字符或 2,000 行以内。
安装与启用¶
在终端中执行以下命令安装插件。安装完成后需要重启 DSH Web 或刷新页面。
dsh plugin --profile web add -w dsh-mermaid
如果本地未配置全局 dsh 命令，可以使用 npx 调用：
npx.cmd --yes @deepseek-ai/dsh plugin --profile web add -w dsh-mermaid
典型用法¶
在对话中输入包含 Mermaid 代码块的 Markdown 文本。插件会自动识别并注入渲染控制栏，默认以图表视图打开。
```mermaid
flowchart LR
A[Code] --> B[Diagram]
```
注意事项与适用场景¶
- DSH 开发者预览状态：DSH 目前处于开发者预览阶段，插件可能与未来版本存在兼容性破坏性变更。
- 安全限制：插件使用 Mermaid 的
securityLevel: strict，这意味着部分非标准的 Mermaid 语法可能会被拒绝渲染。 - 单图限制：单个图表如果超过 50,000 字符或 2,000 行，插件将拒绝渲染。
- 开发依赖：插件开发环境需要 Node.js 22.19 或更高版本，但普通用户安装不需要此环境。
该插件适合需要在 Web 界面中直观展示架构图、流程图、时序图等静态图表的场景。它增强了技术文档的可读性，同时保持了与 DeepSeek Harness Web 现有界面的融合。
