Skip to content

Diagramon 3.12.5

Choose a tag to compare

View all tags
@westsource westsource released this 02 Nov 04:50
· 11 commits to main since this release
v3.12.5
cc7da17

Release 说明：v3.12.5

本页中英双语：中文在前，英文在后。 / Bilingual release notes: Chinese first, English below.

中文

Diagramon 3.12.5 把 Mermaid 12 的泳道图接进了编辑、渲染、大纲、AI 与转换。

下载

方式 文件 说明
安装版（推荐） Diagramon_3.12.5_x64-setup.exe（约 62.27 MiB） 装完可用内置自动更新；缺 WebView2 时安装器会自动下载运行时
便携版（免安装） Diagramon-3.12.5-win-x64.zip（约 70.37 MB） 解压到任意位置，双击 diagramon.exe 即用；卸载 = 删文件夹

便携版说明：包里是 diagramon.exe + WebView2Loader.dll + ui\ + assets\，必须放在一起
（ui\ 与 assets\ 是从磁盘读的，不在 exe 里）。它不依赖额外要装的东西：不需要 Node.js、
不需要 Chrome、不需要 VC++ 运行库（exe 已静态链接 CRT），只需要 Windows 10/11 自带的 WebView2 运行时。
便携版的「检查更新」照常能发现新版，但更新走的是安装包（不会就地替换便携目录）——
要继续用便携形态，就手动下载新的 ZIP 覆盖。

本次亮点

  • 泳道图能画出来了：源码用 swimlane-beta LR（或 TB）开头，顶层每个 subgraph 就是一条泳道，
    节点与连线的写法与 flowchart 完全一致。此前的预览会把泳道压成一张普通流程图 —— 节点还在，
    泳道框与泳道名全没了，现在按泳道图的布局渲染。
  • 不再给你一个切不动的「布局」按钮：泳道图的布局固定是 swimlane，预览顶栏只留「外观 / 配色」，
    副标题写明这一点；状态栏、命令面板、布局弹窗三处也都不再提供这个选项。
  • 大纲按图类型说话：同一份数据，泳道图的顶层分组叫「泳道」而不是「子图」。
  • 转换：泳道图可转 DOT（泳道 → cluster）与 D2（泳道 → 容器），Excalidraw 照常交给引擎；
    drawio 方向明确不支持 —— 它随包的 Mermaid 导入器认不出 swimlane-beta，转换对话框会把这一格
    标成不可用并写清原因，而不是让你等一次引擎失败。
  • AI 会写泳道图：你说「画一张按角色分道的泳道图」时，模型会得到 swimlane-beta 的语法与语义说明；
    它返回的整段泳道源码也能被正确识别为代码（此前会被当成一段散文丢掉）。
  • 顺带修好了带 front matter 的 Mermaid：--- config: … --- 与跨行的 %%{init: …}%%
    不再被当成图头部/语句 —— 这类文档现在能正常转 DOT / D2；flowchart 不带方向也按 TB 处理
    （Mermaid 自己接受这种写法，旧实现会报「缺方向」）。

修复

  • 泳道图退化成普通流程图：预览层把全局布局（默认 ELK）传给 Mermaid，覆盖了泳道图自己的
    swimlane 布局。现在泳道图文档不传全局布局，只钉住泳道布局。
  • 带配置头的 Mermaid 转不出去：转换器把 front matter 的 --- 当成头部报错；多行
    %%{init}%% 的尾巴被当成一条语句。两处都已跳过。

关于 Diagramon

Diagramon 是一款本地优先的多格式图表编辑器：Mermaid / Graphviz DOT / drawio / Excalidraw
都可编辑并实时预览，AI 可辅助生成、评审与识图。渲染与校验不联网也能用 ——
只有你主动使用 AI 时，相关代码或图片才会发往你选择的上游。

官网：https://www.diagramon.com

系统要求

  • Windows 10 / 11 64 位
  • WebView2 运行时（Windows 10/11 通常已预装；缺失时安装器会现场下载）
  • 不需要 Node.js、Chrome 或 VC++ 运行库 —— 画布运行时与前端资源都随包分发

安装与更新

下载 Diagramon_3.12.5_x64-setup.exe 直接安装。已装旧版的用户可在
帮助 → 检查更新 里收到本版本（更新包即本安装包，签名见 latest.json）。

本安装包尚未做 Authenticode 代码签名，Windows SmartScreen 可能给出提示。

English

Diagramon 3.12.5 brings Mermaid 12's swimlane diagrams into editing, preview, outline, AI and conversion.

Downloads

Type File Notes
Installer (recommended) Diagramon_3.12.5_x64-setup.exe (~62.27 MiB) Enables the built-in auto-update; if WebView2 is missing the installer downloads the runtime
Portable (no install) Diagramon-3.12.5-win-x64.zip (~70.37 MB) Unzip anywhere and run diagramon.exe; uninstall = delete the folder

About the portable build: it ships diagramon.exe + WebView2Loader.dll + ui\ + assets\, and those
must stay together (the ui\ and assets\ trees are read from disk, not embedded in the exe).
It needs nothing extra installed: no Node.js, no Chrome, no VC++ redistributable (the CRT is
statically linked) — only the system WebView2 runtime that comes with Windows 10/11.
"Check for updates" still finds new versions, but updating downloads the installer
(it does not replace the portable folder in place) — to stay portable, grab the new ZIP manually.

Highlights

  • Swimlanes actually render now. Start the source with swimlane-beta LR (or TB); every top-level
    subgraph is a lane, and nodes and edges keep exactly the flowchart syntax. The preview used to flatten
    them into an ordinary flowchart — nodes were there, the lane frames and lane titles were not.
  • No dead "Layout" button. A swimlane diagram's layout is fixed to swimlane, so the preview top bar
    keeps only Look / Colours and the subtitle says so; the status bar, command palette and layout pop-up
    no longer offer it either.
  • Outline speaks the diagram's language: the top-level groups of a swimlane document are called
    "lanes" rather than "subgraphs".
  • Conversion: swimlane diagrams convert to DOT (lane → cluster) and D2 (lane → container),
    and Excalidraw still goes through its engine; drawio is explicitly unsupported — the Mermaid
    importer bundled with drawio does not recognise swimlane-beta, so the dialog marks that target
    unavailable and says why instead of letting you wait for an engine failure.
  • The AI can write swimlanes: ask for "a swimlane diagram split by team" and the model gets the
    swimlane-beta syntax and semantics; a returned swimlane source is now recognised as code
    (it used to be discarded as prose).
  • Fixed along the way: Mermaid with front matter. --- config: … --- and multi-line %%{init: …}%%
    are no longer mistaken for the diagram header / a statement — such files now convert to DOT and D2;
    a flowchart header without a direction is treated as TB (Mermaid accepts it; the old code said
    "missing direction").

Fixes

  • Swimlanes degraded to a plain flowchart: the preview passed the global layout (ELK by default) to
    Mermaid, overriding the diagram's own swimlane layout. Swimlane documents now skip the global layout
    and pin the swimlane one.
  • Mermaid with a config header could not be converted: the converter treated the front matter's ---
    as the header and the tail of a multi-line %%{init}%% as a statement. Both are skipped now.

About Diagramon

Diagramon is a local-first multi-format diagram editor: Mermaid, Graphviz DOT, drawio and Excalidraw
can all be edited with live preview, with AI assistance for generation, review and image recognition.
Rendering and validation work with no network at all — code or images reach a model only when you
actively use AI, and then only the endpoint you chose.

Official website: https://www.diagramon.com

Requirements

  • Windows 10 / 11 64-bit
  • WebView2 runtime (normally pre-installed on Windows 10/11; the installer downloads it if missing)
  • No Node.js, Chrome or VC++ redistributable needed — the canvas runtimes and front-end assets all
    ship inside the installer

Install and update

Download Diagramon_3.12.5_x64-setup.exe and run it. Users on an older version
will be offered this release via Help → Check for updates (the update package is this same
installer; its signature is in latest.json).

This installer is not yet Authenticode-signed, so Windows SmartScreen may show a warning.

Assets 6
Loading