Renders ```mermaid code blocks in DSH Web chat as SVG diagrams, with a diagram/source toggle, light/dark theme following and source-preserving error fallback.
Install
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:shinelon/dsh-mermaid-plugin
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
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
Links
More in this category
zhu1090093659/dsh-web#packages/dsh-task-board★ 10562
Task board for the dsh web GUI: a sidebar multi-column kanban whose cards run in real DSH agent sessions and can also be scheduled with cron expressions, executed host-side even with the browser closed.
zhu1090093659/dsh-web#packages/dsh-web-all★ 10562
Plugin and skin collection for the DSH Web UI: task board, Git graph, right-side panel, remote mobile UI, pet, live token stats, and a skin center.
ccch1mneyyy/dsh-TUI★ 8043
Claude Code-style full-screen terminal UI: pixel-whale header, live status line, and streaming thought expansion.
MeteorNOX/DeepSeek-Balance-Whale-Widget★ 7387
A fixed-corner whale widget for the DSH web GUI — balance, today's usage and per-turn cost with peak/off-peak pricing, editable balance-alert and daily-budget bubbles, a module-based custom bubble queue with A/B weighted choices and random lines or images, 30+ vendor templates (OpenAI, OpenRouter, Kimi, SiliconFlow, Ark, Zhipu, MiniMax and more) with per-model balance and subscription quota, plus task-end sound, imported audio, custom roles and a resource manager. Local-only, no telemetry.
omdsh-dev/DSH-better-sidebar★ 5269
Full sidebar workbench with file rendering and editing, terminal, Git, and subagents; third-party plugins can register new tabs.
omdsh-dev/dsh-genui★ 1040
Interactive UI components rendered inline in replies: layout, charts, forms, quizzes, mermaid, 3D scenes, and an action event loop back to the model.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.