DSH Plugins Marketplace

DSH Plugins

Plugins

/

UI & Experience

/

dsh-mermaid-plugin

s

dsh-mermaid-plugin

Manifest valid

Render mermaid code blocks in DSH chat as diagrams - Render mermaid code blocks in DSH chat as diagrams

UI (client)hasBundlePatch

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 add this 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 empty apply() by protocol; all rendering lives on the client side.
  • UI strings resolve through the injected locale service with built-in zh/en fallback dictionaries.
  • Plugin disposal disconnects observers, removes the injected style sheet and every surface element.

Repository layout

FileKindPurpose
package.jsonhand-writtenplugin manifest: exports, dsh.bundle.patch, dsh.client options
index.jshand-writtenhost-half entry, empty apply()
client.jsprebuilt (~3.4 MB)mermaid 11.17.2 bundle + plugin logic (registration block at the end of file)
cordis.patch.ymlhand-writtenbundle patch inserting module mermaid-chat
locale/zh.json, locale/en.jsonhand-writtenplugin metadata (title/description)
icon.svghand-writtenplugin icon
AGENTS.mdhand-writtenrepository guide for agents and developers

Development

  • Do not reformat client.js by 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

MIT

Comments

Loading…

Similar plugins

dsh-mermaid

by AKS1st

在 DSH Web 会话中把 Mermaid 代码围栏渲染为 SVG 图表 | Render Mermaid code fences as SVG diagrams in DSH Web messages

UI & ExperienceManifest valid

★ 10

↓ 2.2k/wk

MIT

TypeScript

Aug 18, 2026

dsh plugin --profile web add dsh-mermaid

by zach-bworld

Renders mermaid fenced code blocks in the conversation as real diagrams, with the source one click away.

Development & InfrastructureManifest valid

★ 0

MIT

JavaScript

Nov 2, 2026

dsh plugin --profile web add @dsh-external/dsh-mermaid

by 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

UI & ExperienceManifest valid

★ 0

TypeScript

Nov 2, 2026

dsh plugin --profile web add dsh-mermaid

by 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.

Tools & CapabilitiesDevelopment & InfrastructureTerminal & ClientsManifest valid

★ 4

MIT

JavaScript

Oct 3, 2026

dsh plugin --profile web add @baconbao/dsh-mermaid-image-preview

by bosenok

Render mermaid fenced code blocks as diagrams in DeepSeek Harness.

Manifest valid

★ 0

MIT

JavaScript

Nov 7, 2026

dsh plugin --profile web add dsh-mermaid

by kjx-talesofai

Draws mermaid code blocks in DSH replies as diagrams, including while the reply is still streaming.

Manifest valid

★ 0

MIT

JavaScript

Oct 18, 2026

dsh plugin --profile web add dsh-plugin-mermaid