dsh-mermaid-preview
在每个 DeepSeek Harness (dsh) Web Markdown 界面中，将 Mermaid 围栏代码块渲染为图表。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:realguan/dsh-mermaid-preview#aae1e8e97fef722e07992cfb62c03228cc74b278
Mermaid Preview 以 dsh-mermaid-preview 发布，当前版本为 0.4.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
在 DeepSeek Harness（dsh）Web
界面中，把 Markdown 的 mermaid 围栏代码块渲染为图表的 Cordis 插件。
对话、轨迹、计划评审、摘要 —— 所有走 MarkdownText 渲染的视图，一处接入，
处处生效。
English README: README.en.md
⚠️ 0.3.0 起安装方式变了。
dsh plugin --profile web add <pkg>只是 pnpm 透传，只装依赖、不注册 bundle 层。装了依赖却没把包名写进dsh.profile.bundles，插件就是死的——这是旧版本「装了没反应」的根因。 详见 docs/install.md。
在 dsh 会话里让模型调用 plugin_manager：
action: install_bundle
target: <包目录绝对路径> # 或 github:realguan/dsh-mermaid-preview
安装 + 注册 bundle + HMR 生效一步完成。
dsh plugin --profile web add github:realguan/dsh-mermaid-preview
然后必须把包注册成 bundle 层——编辑 ~/.dsh/profiles/web/package.json，
在 dsh.profile.bundles 里追加 "dsh-mermaid-preview"，再 pnpm install；
或在 profile 的用户 patch 层 ~/.dsh/profiles/web/cordis.patch.yml 里：
- insert:
- id: mermaid-preview
name: dsh-mermaid-preview
把 dist/dsh-mermaid-preview.client.js 的内容作为 code.client 交给
cordis_define，再 cordis_run 并允许。详见 docs/install.md。
dsh --profile web --dump-config | grep -A2 mermaid-preview
再用一条带 ```mermaid 围栏的消息确认出图。完整清单见 docs/install.md § 验证。
Esc 关闭（见 architecture.md §7）npm run check 校验语法、manifest、产物一致性、识别用例与版本一致npm run demo # → http://localhost:8090
左侧编辑 Mermaid 源码（内置 11+ 种图型预设），右侧实时渲染，主题可切换。
dsh 的 Markdown 渲染器把围栏渲染成 .md-code-block：头部是
[data-code-block-banner]，正文是 [data-code-block-content]。对 shiki 不认识的
语言（含 mermaid），头部只显示通用「代码」文案，正文是纯 <pre>。
插件用 MutationObserver 找到「正文首元素是 <pre>」的块，再看围栏首条语句是不是
mermaid 语句；命中后按需加载 Mermaid 11（jsDelivr CDN），把渲染好的 SVG 放进
追加在块尾部的 .dsh-mermaid 容器，并用一个属性隐藏原正文——从不替换或删除
React 拥有的节点。
flowchart LR
A[Markdown 渲染器<br/>输出 .md-code-block] -->|MutationObserver + 250ms 静默| B{未高亮围栏<br/>且首条语句是 mermaid?}
B -->|是| C[按需加载 Mermaid 11]
C --> D[mermaid.render<br/>securityLevel strict]
D --> E[SVG 注入块尾容器<br/>原正文按属性隐藏]
E --> F[保留横幅 + 复制按钮<br/>可切换 图表/源码]
F -->|点击图表| G[全窗口查看器<br/>缩放 / 平移 / 适应窗口]
完整原理、DOM 契约、清理策略与已知边界见 docs/architecture.md。
index.js Host 半侧（空 apply，仅为可挂载的 bundle 行）
cordis.patch.yml bundle 层（dsh.bundle.patch 指向它）
src/client.js 插件唯一逻辑源码（ES module，export default）
scripts/build.mjs 生成 dist/client.js 与 dist/dsh-mermaid-preview.client.js
scripts/check.mjs 自检：语法 / manifest / 产物一致性 / 识别用例 / 版本一致
dist/client.js 原生 bundle（exports["./client"]，client-modules 加载）
dist/dsh-mermaid-preview.client.js 动态插件载荷（cordis_define 粘贴用）
locale/{en,zh}.json 插件展示标题与描述
icon.svg 插件图标
demo/ 零依赖独立演示页
examples/showcase.md 图型示例合集
docs/install.md 安装 / 卸载 / 更新 / 验证 / FAQ
docs/architecture.md 实现原理与安全说明
docs/compatibility.md DSH 版本兼容性声明与逐版本证据
| 项 | 值 |
|---|---|
| 平台 | dsh Web（Client 半侧）+ 空 Host 半侧 |
| 插件形态 | dsh bundle 客户端插件（dsh.bundle.patch + dsh.client） |
| DSH 兼容 | 逐版本声明在 dsh.compatibility.dshReleases，依据见 docs/compatibility.md |
| Mermaid | 11.17.2（UMD，jsDelivr CDN，可按需改镜像） |
| 依赖 | 无运行时依赖；工具脚本仅用 Node 内置模块 |
| 安全 | securityLevel: 'strict'；suppressErrorRendering；不采集任何数据 |
| 许可证 | MIT |
dsh.profile.bundles 里，并且
dsh --profile web --dump-config 能看到 mermaid-preview 行。只装依赖不注册
bundle 是最常见的原因。client-modules: 开头的错：错误信息会指出是哪个包的哪个声明有问题
（缺 ./client 导出、模块图成环等）。src/client.js 顶部的
MERMAID_CDN 后 npm run build。graph TD 之类语句
的围栏会被接管；把首行改成非 mermaid 语句即可。0 复位，Esc 关闭。查看器是 SVG 的副本，原代码块不受影响。<html lang> 选内置字典）。若仍是英文，说明 dsh
既没提供 locale 服务也没设置文档语言，可把 DICT 里的键补进自己的语言或提 issue。更多见 docs/install.md。
见 CONTRIBUTING.md。改 src/client.js 后请
npm run build 并同步提交 dist/（npm run check 会拦住忘记 build 的情况）。
MIT © 2026 realguan