dsh-mermaid-plugin
Manifest validRender mermaid code blocks in DSH chat as diagrams - Render mermaid code blocks in DSH chat as diagrams
dsh-mermaid-plugin
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"on a transparent background. - Incremental rendering — a debounced MutationObserver scans for changes; unchanged code is never re-rendered; stale surfaces are cleaned up when their code block disappears.
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.jsby hand — it is a build artifact; its source project is not part of this repository. - 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
Comments
Loading…
Similar plugins
by AKS1st
在 DSH Web 会话中把 Mermaid 代码围栏渲染为 SVG 图表 | Render Mermaid code fences as SVG diagrams in DSH Web messages
★ 10
↓ 2.2k/wk
MIT
TypeScript
Aug 18, 2026
dsh plugin --profile web add dsh-mermaidby zach-bworld
Renders mermaid fenced code blocks in the conversation as real diagrams, with the source one click away.
★ 0
MIT
JavaScript
Nov 2, 2026
dsh plugin --profile web add @dsh-external/dsh-mermaidby jakehemmerle
Renders mermaid code blocks in dsh web chat as diagrams. Each block gets a toggle in its header to switch between the diagram and the source; blocks still streaming stay as code until the message sett
★ 0
TypeScript
Nov 2, 2026
dsh plugin --profile web add dsh-mermaidby baconbao
Preview Mermaid diagrams as images via local rendering in DSH Web when the chat message contains a Mermaid fenced code block, and also allow integration with external rendering servers.
★ 4
MIT
JavaScript
Oct 3, 2026
dsh plugin --profile web add @baconbao/dsh-mermaid-image-previewby bosenok
Render mermaid fenced code blocks as diagrams in DeepSeek Harness.
★ 0
MIT
JavaScript
Nov 7, 2026
dsh plugin --profile web add dsh-mermaidby kjx-talesofai
Draws mermaid code blocks in DSH replies as diagrams, including while the reply is still streaming.
★ 0
MIT
JavaScript
Oct 18, 2026
dsh plugin --profile web add dsh-plugin-mermaid