sijidoubi/dsh-plugin-mermaid
sijidoubi★ 1TypeScriptLast synced: 2026-08-15
DeepSeek Harness (dsh) plugin: mermaid_render tool renders Mermaid source to SVG in-process (mermaid 11 + jsdom, no browser needed)
README excerpt
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): width / height 来自最终 viewBox(像素)。 url 是 dsh Web 服务器托管的 绝对 http 地址(Web 聊天的 markdown 渲染器只显示 http(s) 图片,模型把这张 图嵌进回答后用户就能直接看到);无 Web 服务器时(headless 运行) url 缺失, 用 dataUri 作为兜底。渲染失败时工具以 isError 返回,错误消息包含 Mermaid 解析器给出的行号和期望 token,方便模型自己修图重试。 模型看到的内容 (render):一行摘要 + 可嵌入回答的图片 (优先 ,无 url 时退回 data URI)+ 原始 SVG(便于保存到文件)。 安装 插件是标准 dsh bundle(npm 包 + dsh.bundle 声明 + cordis.patch.yml 配置层)。 构建产物在 lib/ (TypeScript 源码在 src/ ), prepare 脚本会从源码构建。 从 GitHub 安装(推荐) pnpm ≥10 默认拒绝执行 git 依赖的 prepare 构建脚本。首次 add 失败时, 把 pnpm 提示的包 key 加入 profile 的 pnpm-workspace.yaml 的 allowBuilds 一节(参考本仓库 README 的 dsh-side-panel 示例),再重试 add 。 只对源码可信的包授权,并可用 锁定版本。 从本地目录安装 卸载 配置 bundle 默认启用以下配置(可在 profile 的 cord…
View full README on GitHub →