DeepSeek Harness 插件

shinelon/dsh-mermaid-plugin

Star 数 ★ 0 分类 UI 增强 收录于 2026-10-08

将 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" and htmlLabels: false; diagram links open through window.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 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

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

MIT

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。