将 DSH 会话消息中的 mermaid 代码块渲染为 SVG 图形,支持图形与源码切换、跟随深浅色主题,渲染失败时保留源码并显示错误。
安装
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:shinelon/dsh-mermaid-plugin
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
该插件的 README 只有英文版本。
English | 中文
A DeepSeek Harness (DSH) client plugin that renders ```mermaid code blocks in chat messages as diagrams — with a diagram/source toggle, light/dark theme following, and source-preserving error fallback.
Features
- Auto detection — finds mermaid code blocks in the chat transcript by code-block banner or first-effective-line matching (leading blank lines,
%%comments and YAML frontmatter are skipped). - 20 diagram types —
flowchart,graph TB/TD/BT/RL/LR,sequenceDiagram,classDiagram,stateDiagram(-v2),erDiagram,journey,gantt,pie,mindmap,timeline,gitGraph,quadrantChart,requirementDiagram,c4Context,sankey-beta,xychart-beta,block-beta,packet-beta,architecture-beta. - Diagram / source toggle — the original code block stays reachable; the host source is hidden by CSS
:has()only while a rendered diagram stands in. - Theme following — re-initializes mermaid (
dark/default) and re-renders when the DSH dark-theme attribute changes. - Error fallback — a broken diagram keeps the source visible and shows the mermaid error message instead of swallowing content.
- Strict sanitization — mermaid runs with
securityLevel: "strict"andhtmlLabels: false; diagram links open throughwindow.open(..., "noopener,noreferrer")and form submission is blocked. - Streaming-safe rendering — while the host assistant message is still streaming (
[data-streaming]ancestor), the source block is left untouched; the diagram is rendered once the message settles.
Install
- One-click from the dsh-market plugin market (Settings → Plugin Market), or
dsh plugin addthis repository from GitHub.
Requires DSH Web. No build step and no npm dependencies are needed — client.js is a prebuilt bundle (mermaid 11.17.2 plus the plugin glue).
How it works
package.json (dsh.bundle.patch) ──► cordis.patch.yml ──► module "mermaid-chat" in host bundle
│
└─ dsh.client: platform web · immediately · inject conversation UI + locale
│
└─ client.js ──► window.__ModuleLoader__.load({ id, factory })
│
└─ apply(ctx): MutationObserver ──► detect ──► lazy-load mermaid ──► render SVG
- The host half (
index.js) is an emptyapply()by protocol; all rendering lives on the client side. - UI strings resolve through the injected
localeservice with built-in zh/en fallback dictionaries. - Plugin disposal disconnects observers, removes the injected style sheet and every surface element.
Repository layout
| File | Kind | Purpose |
|---|---|---|
package.json |
hand-written | plugin manifest: exports, dsh.bundle.patch, dsh.client options |
index.js |
hand-written | host-half entry, empty apply() |
client.js |
prebuilt (~3.4 MB) | mermaid 11.17.2 bundle + plugin logic (registration block at the end of file) |
cordis.patch.yml |
hand-written | bundle patch inserting module mermaid-chat |
locale/zh.json, locale/en.json |
hand-written | plugin metadata (title/description) |
icon.svg |
hand-written | plugin icon |
AGENTS.md |
hand-written | repository guide for agents and developers |
Development
- Do not reformat
client.js— it is a prebuilt mermaid bundle plus the plugin registration block at the end (the maintained source for this repository). Edit only that block and keep the minified style. - Static check (no test/lint scripts exist):
node --check index.js && node --check client.js - See AGENTS.md for architecture notes, conventions and the manual verification checklist.
License
链接
同类插件
zhu1090093659/dsh-web#packages/dsh-task-board★ 10562
侧边栏多列任务看板:卡片交给真实 DSH 智能体会话执行,支持 cron 定时(Host 侧到点执行,关浏览器也生效)。
zhu1090093659/dsh-web#packages/dsh-web-all★ 10562
DSH Web UI 插件与皮肤合集:任务看板、git 图、右侧面板、远程移动端 UI、桌宠、实时 token 统计与皮肤中心。
ccch1mneyyy/dsh-TUI★ 8043
Claude Code 风格全屏终端 UI:像素鲸鱼顶栏、实时工作状态行、思考流式展开。
MeteorNOX/DeepSeek-Balance-Whale-Widget★ 7387
右下角常驻的小鲸鱼挂件:余额、今日已用与每轮对话消耗(含峰谷价),余额预警与今日预算的泡泡内容都可编辑;泡泡点击序列模块化自定义,支持并列加权 A/B、随机台词与随机图片;内置 30+ 厂商模板(OpenAI / OpenRouter / Kimi / 硅基流动 / 方舟 / 智谱 / MiniMax 等),按模型查余额与订阅额度;另有任务结束音效、导入音频、自定义角色与资源管理。数据全在本机,无遥测。
omdsh-dev/DSH-better-sidebar★ 5269
侧边栏完整工作台:内置文件渲染编辑、终端、Git 与子代理,支持三方插件注册新 Tab。
omdsh-dev/dsh-genui★ 1040
助手回复内渲染交互式 UI 组件:布局、图表、表单、测验、mermaid、3D 场景与回传事件循环。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。