前言¶
在 DeepSeek Harness (dsh) Web 界面中，Markdown 是主要的文本渲染格式。开发者常在对话、轨迹、计划评审或摘要中使用 Mermaid 语法来绘制图表，但在未修改 dsh 源码的情况下，这些围栏代码块通常只显示为纯文本。dsh-mermaid-preview 插件通过 Cordis 机制接管了渲染过程，将静态的代码块转换为可视化的 SVG 图表。
插件概览¶
这是一个由 realguan 维护的 Cordis 客户端插件。它的核心作用是在 dsh Web 界面中，将 Markdown 中的 mermaid 围栏代码块渲染为可视化的图表。
安装与启用¶
插件支持一条命令安装，并自动注册为 web profile 的 bundle 层。
dsh plugin --profile web add github:realguan/dsh-mermaid-preview
安装后，重启 dsh web 即可生效。
核心功能¶
- 免改壳层：不修改 dsh 源码，通过 DOM 观察器自动接管
mermaid围栏。 - 一条命令安装：
dsh plugin add自动完成注册与依赖管理。 - 跟随主题：自动适配 dsh 的明/暗主题，切换时实时重绘。
- 保留交互：原代码块的复制按钮继续可用，并增加“显示源码/显示图表”切换功能。
- 失败兜底：当 CDN 不可达或语法错误时，保留代码块并给出提示。
- 干净卸载：停止插件即移除注入的样式与 DOM 观察器。
- 独立演示：提供零依赖的纯 HTML 演示页。
- 多图型：支持 flowchart、sequenceDiagram、classDiagram、stateDiagram-v2、gantt、pie、erDiagram、journey、mindmap、gitGraph、timeline 等。
使用说明¶
安装后，在所有走 MarkdownText 渲染的视图中（包括对话、轨迹、计划评审、摘要等），直接使用 mermaid 围栏代码块即可。
注意：流式输出过程中不渲染，消息结束后才进行渲染。
安全与依赖¶
插件的安全级别为 strict，不采集任何数据，无运行时依赖。它通过 jsDelivr CDN 加载 Mermaid 11。
独立演示¶
如果想在本地体验 Mermaid 的渲染效果，无需启动 dsh，直接运行演示命令：
npm run demo
结尾¶
该插件解决了在 dsh Web 界面中直接查看 Mermaid 图表的需求，且不侵入 dsh 核心代码。
