前言¶
在 DeepSeek Harness（DSH）里写流程图、时序图时，习惯用 Markdown 的 ```mermaid 围栏。默认情况下，会话里只会显示源码：flowchart TD、节点和箭头都要自己在脑子里还原，区域又窄，复杂图很难看清；要把源码拷出去，也只能手动框选。
dsh-mermaid 是社区维护的客户端（Web）插件，装好后会把会话里的 mermaid 代码块画成图，并在工具条里提供源码切换、全屏与复制。下面介绍它做什么、怎么装、用起来长什么样。
这是什么¶
- 名称：dsh-mermaid（npm 包名
@dsh-external/dsh-mermaid，当前资料版本0.1.0） - 维护者：zach-bworld
- 分类：DSH 客户端插件（
dsh.client.platform为web） - 许可证：MIT
- 目录页：skillhub.cn/plugins/zach-bworld/dsh-mermaid
- 源码：github.com/zach-bworld/dsh-mermaid
一句话：把会话内 Markdown 里 ```mermaid 围栏直接渲染成图，源码仍一键可看、可拷。
DSH 生态强调「一切皆插件」；SkillHub 等目录是社区站点，与 DeepSeek / 幻方无官方从属关系，安装前建议自行查看仓库源码与许可证。
核心功能¶
以下能力均来自项目 README 说明：
- 自动渲染：进入会话即可看到流程图等图示，无需额外点击「渲染」按钮。
- 图 ↔ 源码切换：工具条提供「查看源码」「查看图示」，在同一代码块上切换。
- 放大全屏：工具条「放大」，支持滚轮缩放、拖动平移，便于看细节。
- 复制源码：工具条「复制源码」，一键复制 mermaid 原文。
实现原理、调试与已知限制见仓库内 docs/implementation.md。
安装与启用¶
插件以当前 DSH 进程权限运行；安装前请确认你信任该仓库与 MIT 许可条款。
桌面端 App（推荐）¶
桌面端的 profile 由 Electron 应用独占管理，不要在 PowerShell 里对 desktop profile 执行 dsh plugin add，否则会报 profile "desktop" is managed exclusively by the Electron application。
- 打开左侧栏最下方的 插件。
- 点 安装，粘贴安装地址（这是地址，不是 shell 命令）：
https://github.com/zach-bworld/dsh-mermaid
以下写法效果相同：github:zach-bworld/dsh-mermaid、git@github.com:zach-bworld/dsh-mermaid.git，或本地 clone 后的目录绝对路径。
- 在列表中 启用 插件。
- 刷新页面（Ctrl+R）或重开窗口；客户端 bundle 需刷新后才会加载。
命令行 / Web 端¶
将 web 换成你实际使用的 profile 名（常见为 web、tui、headless）：
dsh plugin --profile web add github:zach-bworld/dsh-mermaid
装完后刷新页面。
指定版本示例：
dsh plugin --profile web add github:zach-bworld/dsh-mermaid#v1.0.0
卸载（命令行）：
dsh plugin --profile web remove @…/dsh-mermaid
桌面端也可在 App 插件页直接移除。
装不上时的对照¶
| 现象 | 处理 |
|---|---|
命令行报 managed exclusively |
改用 App 内插件页安装 |
| 装完没反应 | 刷新页面或重开窗口 |
| 提示找不到包 | 检查拼写：github:zach-bworld/dsh-mermaid（冒号、斜杠均不可少） |
典型用法¶
无需单独配置项：在 DSH 会话的 Markdown 里照常写 mermaid 围栏即可。例如：
```mermaid
flowchart TD
A[开始] --> B{判断}
B -->|是| C[结束]
B -->|否| A
```
启用插件并刷新客户端后，该块会显示为图；需要改语法时用工具条切回源码，改完仍可再看图示。复杂图用「放大」在全屏里缩放、平移查看。
适用场景与注意¶
适合谁：经常在 DSH 里让模型输出或自己粘贴 Mermaid 流程图、序列图、类图等，希望会话内即看即改的开发者或智能体使用者。
注意：
- 插件类型为 Web 客户端，行为与会话 UI 绑定；非服务端逻辑插件。
- 资料中未列出额外配置文件字段，主要依赖 Cordis patch 注入客户端；细节见 implementation 文档。
- 社区目录星标等统计会变动，以 GitHub 与目录页为准。
结尾¶
dsh-mermaid 解决的是 DSH 会话里 Mermaid 只显示源码、难放大、难复制的问题：装上并刷新后，围栏自动成图，工具条负责源码、全屏与复制。
- 目录页：https://www.skillhub.cn/plugins/zach-bworld/dsh-mermaid
- GitHub：https://github.com/zach-bworld/dsh-mermaid
