dsh-plugin-mermaid-gb-svg

dsh plugin --profile web add dsh-plugin-mermaid-gb-svg

dsh-plugin-mermaid-gb-svg





把 Mermaid 流程图转换成符合 GB/T 1526-1989（等同采用 ISO 5807:1985）图形符号的 SVG，

并作为 DeepSeek Harness 插件向模型暴露一个工具。

说人话：你给模型一段 mermaid（或一个 .md），它给你一张黑白、正交走线、符号合规的国标流程图，

放不下 A4 还会自动拆成多张并画好换页连接符。

效果预览

GB/T 1526-1989 符号对照 · 生成的流程图

<img src="examples/gb-1526-symbols.svg" alt="GB/T 1526-1989 图形符号" width="240"> · <img src="examples/attribute-config.svg" alt="生成的流程图" width="300">

两张 SVG 都是本工具生成的，源 .mmd 在 [examples/](examples/) 里。

安装

# 1) 装进某个 profile（这里以 web 为例）
dsh plugin --profile web add dsh-plugin-mermaid-gb-svg

# 2) 让 loader 加载它：在 $DSH_HOME/profiles/web/cordis.patch.yml 里加一行

cordis.patch.yml 追加内容（见本包 cordis.patch.example.yml）：

- insert:
    - id: mermaid-gb-svg
      name: dsh-plugin-mermaid-gb-svg
      # 可选：覆盖默认值
      # config:
      #   fontSize: 14
      #   paper: none

本地开发可直接指向源码目录：dsh plugin --profile web add /path/to/dsh-plugin-mermaid-gb-svg。

工具：mermaid_to_gb_svg

参数 · 类型 · 说明

out · string，必填 · 输出路径。以 .svg 结尾＝文件名（多图自动加 -1/-2），否则作为输出目录/前缀

source · string · Mermaid 源码（与 path 二选一）

path · string · 输入文件：.mmd／.mermaid，或含 `mermaid 代码块的 .md（会抽取全部代码块，取上方最近标题作图题）

title · string · 图题

dir · td\ · lr\ · bt\ · rl · 强制流向，默认沿用图内声明

paper · none\ · auto\ · a4\ · a4l\ · a3\ · a3l · 幅面；none 默认只出一张大图，其余超幅面自动拆页

font_size · integer · 正文字号（px，14≈五号）

font_tu · boolean · 改用技术制图字体（GB/T 14691 长仿宋/仿宋）

caption · boolean · 是否画图题，默认 true

返回：files（写出的 SVG 路径）、diagrams、pages、summary、warnings。

调用示例（模型侧）：

mermaid_to_gb_svg({
  source: "graph TD\n A((开始)) --> B[创建配置对象]\n B --> C{遍历列表}\n C -- 是 --> D[追加路径]\n D --> C\n C -- 否 --> E((结束))",
  out: "docs/fig/配置流程.svg",
  title: "图 1  属性配置文件创建流程"
})

图形符号（GB/T 1526-1989）

符号 · 含义 · Mermaid 写法

圆角矩形 · 起止 · A([x]) A((x)) A(x)

矩形 · 处理 · A[x]

菱形 · 判断 · A{x}

平行四边形 · 数据（输入/输出） · A[/x/] A[\x\]

六边形 · 准备 · A{{x}}

双边矩形 · 预定义处理 · A[[x]]

圆柱 · 直接存取存储 · A[(x)]

梯形 · 人工操作 · A{/x/}

顶边倾斜四边形 · 人工输入 · A{\x\}

方括号 · 注释 · A>x]

圆 · 连接符（页内） · A@{ shape: connector, label: "A" }

五边形 · 换页连接符（异地） · A@{ shape: off-page, label: "B" }

— · 文档 / 多文档 · A@{ shape: doc, label: "报表" } / docs

— · 显示 / 延迟 · A@{ shape: display, label: "显示" } / delay

— · 内部存储 · A@{ shape: internal-storage, label: "内部存储" }

shape 同时接受 Mermaid v11 名称与中文名（处理/起止/判断/数据/准备/预定义处理/直接存取存储/

人工输入/人工操作/文档/多文档/显示/延迟/内部存储/注释/连接符/换页连接符）。

制图约定

• 流向自左而右、自上而下；流程线正交、末端实心箭头。
• 判断框分支：标注「是」从底顶点向下，标注「否」从右顶点出发（先向右再转向）。
• 所有入线从图形上中部垂直进入，不分散到两侧。
• 每根流程线最多 3 个转折：按 0→1→2→3 转折依次择优选路，取第一个不压节点的画法。
• 同层节点不重叠、流程线不穿越节点；生成后自动做几何自检并在 warnings 里返回问题。

分页（可选）

paper: a4（或 a3/auto）时，超出幅面会拆成多张：

• 按层间空隙切分（另一方向切在节点列之间的空隙），不会切断节点；
• 每张按真实幅面输出（width="210mm" height="297mm"），带图框、装订边与「第 n/N 页」图题；
• 断线处画 异地连接符（五边形），尖端朝流向；相邻两张图框内位置与编号一一对应。

配置

profile 补丁行的 config 可覆盖默认值：

键 · 默认 · 说明

font · SimSun, '宋体', 'Microsoft YaHei', sans-serif · 正文/图题字体族

fontSize · 14 · 正文字号 px

stroke · 1.6 · 图线宽度

paper · none · 默认幅面（none 不分页）

沙箱与安全

写文件走 Harness 的 ctx.fs seam，并沿用会话的沙箱策略；被沙箱拒绝时，模型可以带

sandbox_permissions + justification 做一次性升权重试（与内置 write 工具同一套语义）。

开发与测试

npm test        # test/engine.test.mjs + test/plugin.test.mjs

• lib/engine.js 是从命令行版 tools/mermaid2gb-svg.js 生成的（纯函数：解析→布局→画图→分页），

改引擎请改命令行版后重新生成，两端行为保持一致。

• 插件层测试用替身 ctx（tools.register / ctx.fs）直接跑工具，不需要 DSH 运行时；

但需要 @deepseek-ai/dsh-tools、@deepseek-ai/dsh-sandbox、@deepseek-ai/schemastery

这几个 peer 依赖可解析（本地开发在包内 node_modules/@deepseek-ai 联接到 dsh 安装目录即可）。

反馈 / 意见

这个工具往哪走，基本由反馈决定——尤其欢迎国标符号勘误，因为 GB/T 1526-1989 的细节很容易画得"差一点"。

渠道 · 适合提什么

Issues · 报错、符号勘误（有专门的"标准勘误"模板，请附条款或图号）、功能建议

Discussions · 用法提问、画法/排版讨论、还没想清楚的想法

sandyyst@hotmail.com · 不方便公开说的

提问题时请附上 mermaid 源码 —— 一句话描述 + 那段 .mmd 基本就能复现；再带上生成的图、工具返回的 warnings、插件版本号更好。

工具如果报了几何告警，返回信息里已经带上了 Issues 链接——那一刻的反馈最有价值。

许可

MIT