dsh-tool-mermaid

仓库名 dsh-plugin-mermaid，npm 包名 dsh-tool-mermaid。

DeepSeek Harness (dsh) 插件：提供一个 mermaid_render 工具，让 agent 把 Mermaid 图源码渲染成 SVG 图片。

完全在进程内完成（mermaid 11 + jsdom），不需要浏览器、不需要联网。

它解决什么问题

dsh 目前没有 Mermaid 渲染工具。模型的回答里只能贴 Mermaid 源码，用户看不到图。 装上这个插件后，agent 写完图会调用 mermaid_render，拿到一张可直接嵌进回答的 data:image/svg+xml 图片（以及原始 SVG 文本）。

工具：mermaid_render

参数	类型	必填	说明
code	string	是	Mermaid 图源码（flowchart / sequenceDiagram / classDiagram / pie / stateDiagram / erDiagram ...）
title	string	否	图的标题，会带进返回结果

返回（canonical value）：

{
  "format": "svg",
  "title": "可选标题",
  "svg": "...",
  "width": 127,
  "height": 77
}

width/height 来自最终 viewBox（像素）。渲染失败时工具以 isError 返回， 错误消息包含 Mermaid 解析器给出的行号和期望 token，方便模型自己修图重试。

模型看到的内容（render）：一行摘要 + 可直接粘贴的 ![title](data:image/svg+xml;base64,...) 图片 + 原始 SVG（便于保存到文件）。

安装

插件是标准 dsh bundle（npm 包 + dsh.bundle 声明 + cordis.patch.yml 配置层）。 构建产物在 lib/（TypeScript 源码在 src/），prepare 脚本会从源码构建。

从 GitHub 安装（推荐）

dsh plugin --profile web add github:sijidoubi/dsh-plugin-mermaid
dsh web

pnpm ≥10 默认拒绝执行 git 依赖的 prepare 构建脚本。首次 add 失败时， 把 pnpm 提示的包 key 加入 profile 的 pnpm-workspace.yaml 的 allowBuilds 一节（参考本仓库 README 的 dsh-side-panel 示例），再重试 add。 只对源码可信的包授权，并可用 # 锁定版本。

从本地目录安装

git clone git@github.com:sijidoubi/dsh-plugin-mermaid.git
cd dsh-plugin-mermaid
pnpm install   # 运行 prepare，构建 lib/
dsh plugin --profile web add .
dsh web

卸载

dsh plugin --profile web remove dsh-tool-mermaid

配置

bundle 默认启用以下配置（可在 profile 的 覆盖整行）：