Diagramon 3.13.2

Release 说明：v3.13.2

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

---

中文

Diagramon 3.13.2 是一个修复版本：只改预览的渲染调度，解决"源码是对的却不渲染"。

下载

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

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

修复

• 改完源码有时不渲染，切一下视图模式才出来。预览的渲染原先靠 60ms 防抖直接触发引擎，
  而一次 ELK 布局常常上百毫秒 —— 连续敲字就会叠出多个并发的引擎渲染。mermaid / graphviz / D2
  都不是并发安全的（mermaid.render() 用全局配置与共享的 DOM 暂存节点），叠在一起那一次可能
  什么都不出；而且被后来的渲染顶掉的那次改动不会再重来，于是停在空白，直到切一次视图模式
  （那会再排一次渲染）。现在：① 渲染入口串行化，同一时刻只有一轮在跑；② 跑的过程中又收到改动，
  就跑完再补一次（照最新正文画，不会挂旧图）。await DGM.preview.render() 的语义也保留了 ——
  忙时等的是"正在跑的那一轮"，仍然保证回来时已画到最新。

关于 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.13.2_x64-setup.exe 直接安装。已装旧版的用户可在
帮助 → 检查更新 里收到本版本（更新包即本安装包，签名见 latest.json）。

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

---

English

Diagramon 3.13.2 is a bug-fix release: it only changes how the preview schedules rendering,
fixing the case where valid source would not draw.

Downloads

Type	File	Notes
Installer (recommended)	Diagramon_3.13.2_x64-setup.exe (~62.29 MiB)	Enables the built-in auto-update; if WebView2 is missing the installer downloads the runtime
Portable (no install)	Diagramon-3.13.2-win-x64.zip (~70.41 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.

Fixes

• After editing the source, the diagram sometimes would not render until you switched the view mode.
  The preview used to fire the engine straight from a 60 ms debounce, while a single ELK layout often
  takes hundreds of milliseconds — so continuous typing stacked several concurrent engine renders.
  mermaid / graphviz / D2 are not concurrency-safe (mermaid.render() uses global config and a shared
  DOM scratch node), a stacked render can produce nothing at all, and the edit that got superseded
  was never retried — leaving a blank stage until a view-mode switch scheduled one more render.
  Now: (1) the render entry is serialized, only one round runs at a time; (2) if an edit arrives while
  rendering, one more round is queued after it and draws the latest source (never a stale diagram).
  await DGM.preview.render() keeps its meaning too — when busy it awaits the in-flight round, so it
  still resolves once the preview is up to date.

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.13.2_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.

Diagramon 3.13.1

Release 说明：v3.13.1

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

---

中文

Diagramon 3.13.1 是一个小版本：把 Mermaid 提到格式清单的第一位，其余只是内部修复。

下载

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

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

本次亮点

• 新建时 Mermaid 排第一：Ctrl+N / 标签条 ＋ / 文件 → 新建 里的格式卡片，
  第一张就是 Mermaid。顺序对四处同时生效 —— 新建对话框、标签条「转换」下拉、
  「转换能力一览」的方向清单与矩阵 —— 因为它们读的是同一份格式注册表，
  不存在"这里改了那里没改"。
• 新顺序：Mermaid → drawio → Excalidraw → DOT → D2（原先 drawio 在第一位）。

修复

• 内部：修掉一条会偶发失败的验收探针（画布「事件归属」那组断言等的是 120ms 轮询，
  在机器忙的时候会被计时器节流骗到）。用户无感，但我们的门禁从此不再时红时绿。
• 内部：浏览器原型的格式清单同步成同一顺序（它没有 Rust 后端，只能抄一份，
  这次两边的顺序不一致就是靠新加的断言发现的）。

关于 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.13.1_x64-setup.exe 直接安装。已装旧版的用户可在
帮助 → 检查更新 里收到本版本（更新包即本安装包，签名见 latest.json）。

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

---

English

Diagramon 3.13.1 is a small release: Mermaid moves to the top of the format list; the rest is
internal cleanup.

Downloads

Type	File	Notes
Installer (recommended)	Diagramon_3.13.1_x64-setup.exe (~62.29 MiB)	Enables the built-in auto-update; if WebView2 is missing the installer downloads the runtime
Portable (no install)	Diagramon-3.13.1-win-x64.zip (~70.40 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

• Mermaid is first when creating a document: in the Ctrl+N / tab + / File → New chooser, the
  first card is Mermaid. The order applies to four places at once — the New dialog, the tab strip's
  "Convert" menu, and both the direction list and the matrix of "Conversion capabilities" — because they
  all read the same format registry, so there is no "changed here, not there".
• New order: Mermaid → drawio → Excalidraw → DOT → D2 (drawio used to be first).

Fixes

• Internal: fixed an intermittently failing acceptance probe (the canvas "event ownership" assertions
  waited on a 120 ms poll and could be fooled by timer throttling on a busy machine). Invisible to users,
  but our gate no longer goes red at random.
• Internal: the browser prototype's format list now matches the same order (it has no Rust backend and has
  to keep a copy; the two lists differing is exactly what the new assertion caught).

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.13.1_x64-setup.exe and run it. Users on an older version
get this release through Help → Check for updates (the update package is this installer; the signature
is in latest.json).

The installer is not yet Authenticode-signed, so Windows SmartScreen may show a prompt.

Diagramon 3.13.0

Release 说明：v3.13.0

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

---

中文

Diagramon 3.13.0 是一次以「安全性 + 数据完整性」为主的维护版 —— 新增功能不多，但修掉了一批会悄悄改坏你的文档或让进程直接退出的问题。

下载

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

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

本次亮点

• 打开陌生图表文件更安全：图里渲染出来的链接会按协议白名单过滤（javascript: 一律剥掉，
  包括用制表符/换行拼出来的变形写法），动画改写链接的那类写法也被整类移除。内容安全策略现在覆盖到
  drawio / Excalidraw 画布本身，不再只有外壳窗口。
• 自动配色不再改坏 D2 文档：容器里的节点改成按 容器.节点 写样式（以前写在顶层，会在图上
  凭空多出一整套重复节点），带空格 / # / ; 的节点名会自动加引号；|md … | 块里的正文
  不再被当成节点写回源码。对任何用了容器的 D2 文档，「自动配色」现在是真的只上色。
• 切标签页不再串图：画布事件带上了「属于哪份文档」的标记，上一份文档迟到的自动保存会被丢掉，
  写不进新打开的那份文档。
• 超深嵌套的 .dot 不再拖崩：嵌套超过 256 层会明确报「第 N 行：subgraph 嵌套超过 256 层」，
  而不是栈溢出把整个进程带走；未闭合的 subgraph 也不会再让「格式化」产出几百 MB。
• CRLF 文件不再「一碰就永久脏」：Windows 换行格式的文件，改完再改回去脏标记会正确清掉，
  保存时也不会把整份文件静默改写成 LF。
• AI 上游更守规矩：Ollama 的工具调用参数能正确解析了（以前全被当成「没有参数」，
  于是工具循环对它形同虚设、每一步还照样计费）；上游返回超大响应会明确报错，而不是把内存吃满。
• 升级安装不再抹掉未保存内容：以前升级会强制结束进程，而未保存文档只写在草稿仓里、
  且受「自动保存」开关控制（默认是关）。现在脏文档一律先落草稿，重开就能找回。

修复

• 搜索含 İ / ẞ 这类字符时崩溃（panic 直接把整个进程带走）。
• 尾部注释里带 } 时，配色块被插到图外，整份 DOT 编译不过。
• 不带图名的 digraph { … } 第一个节点永远上不了色。
• DOT → D2 会静默丢掉孤立节点（图例、单点状态节点）。
• 同一份 Mermaid 源转两次 D2 结果不一样，导致脏标记常亮、diff 全是噪音。
• 非法的 stroke-width 会被原样写进 DOT（可能注入任意属性）。
• 圆角节点在「先配色再转 DOT」之后会丢圆角。
• 工作区里重命名文件后按 Ctrl+S，会把旧文件名在磁盘上复活。
• 云文档的版本号在切换标签后丢失，导致云端出现重复文档。
• 「在文件管理器中显示」从来没生效过（调用的接口不存在），现在是真正的「定位到这个文件」。
• 配置里的上游地址一改，旧密钥会继续沿用 —— 现在会要求重填，避免密钥被发到被改过的地址。
• 调试用的远程调试端口在正式版里也会生效 —— 现在只在开发构建里可用。

关于 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.13.0_x64-setup.exe 直接安装。已装旧版的用户可在
帮助 → 检查更新 里收到本版本（更新包即本安装包，签名见 latest.json）。

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

---

English

Diagramon 3.13.0 is a maintenance release focused on security and data integrity — few new
features, but a batch of fixes for problems that could silently corrupt your documents or take the
process down.

Downloads

Type	File	Notes
Installer (recommended)	Diagramon_3.13.0_x64-setup.exe (~62.29 MiB)	Enables the built-in auto-update; if WebView2 is missing the installer downloads the runtime
Portable (no install)	Diagramon-3.13.0-win-x64.zip (~70.40 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

• Safer to open a diagram you did not write: links rendered out of a diagram are filtered against a
  protocol allow-list (javascript: is stripped, including the tab/newline-mangled variants), and the
  animation-driven rewrite trick is removed outright. The content security policy now also covers the
  drawio / Excalidraw canvases themselves, not just the shell window.
• Auto-palette no longer corrupts D2 documents: styles for nodes inside a container are written as
  container.node (they used to land at the top level, which created a whole duplicate set of nodes);
  names with spaces, # or ; are quoted; and markdown inside |md … | blocks is no longer mistaken for
  nodes and written back into your source.
• Switching tabs no longer mixes diagrams: canvas events now carry which document they belong to, so a
  late autosave from the previous document is dropped instead of landing in the newly opened one.
• Deeply nested .dot files no longer take the process down: beyond 256 levels you get a clear
  "line N: subgraph nesting exceeds 256 levels" instead of a stack overflow, and an unclosed subgraph
  no longer makes "Format" produce hundreds of megabytes.
• CRLF files stop being "dirty forever after one edit": edit a Windows-newline file and undo it, and the
  dirty flag clears correctly; saving no longer silently rewrites the whole file to LF.
• Better behaved toward AI upstreams: Ollama tool-call arguments are parsed correctly (they used to be
  treated as empty, which made the tool loop useless there while still costing you tokens), and an
  oversized upstream response now fails with a clear error instead of eating all the memory.
• Upgrading no longer drops unsaved work: the installer terminates the app, and unsaved documents used to
  live only in the draft store behind the "auto-save" toggle (off by default). Dirty documents are now always
  drafted first, so they can be recovered.

Fixes

• Search crashed (the panic took the whole process down) on text containing İ / ẞ.
• A } inside a trailing comment pushed the palette block outside the graph, making the DOT invalid.
• The first node of an unnamed digraph { … } could never be coloured.
• DOT → D2 silently dropped isolated nodes (legends, single state nodes).
• Converting the same Mermaid source to D2 twice produced different bytes, leaving the document permanently
  dirty and filling diffs with noise.
• An invalid stroke-width was copied verbatim into DOT (potentially injecting arbitrary attributes).
• Rounded nodes lost their rounding through "colour, then convert to DOT".
• Renaming a file in the workspace and pressing Ctrl+S resurrected the old file name on disk.
• Cloud documents lost their version number after switching tabs, causing duplicate documents in the cloud.
• "Show in file manager" never worked (it called an API that does not exist); it now really reveals the file.
• Changing a provider's base URL kept reusing the old key — it now asks for the key again, so a key can no
  longer be sent to an address that was changed underneath it.
• The remote-debugging port was honoured in release builds too — it is now development-only.

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.13.0_x64-setup.exe and run it. Users on an older version
get this release through Help → Check for updates (the update package is this installer; the signature
is in latest.json).

The installer is not yet Authenticode-signed, so Windows SmartScreen may show a prompt.

Diagramon 3.12.6

Release 说明：v3.12.6

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

---

中文

Diagramon 3.12.6 把「关于」窗口从一张堆叠的表格整理成两段式：头部讲清这是什么、去哪找；下面只有一张清单。

下载

方式	文件	说明
安装版（推荐）	Diagramon_3.12.6_x64-setup.exe（约 62.27 MiB）	装完可用内置自动更新；缺 WebView2 时安装器会自动下载运行时
便携版（免安装）	Diagramon-3.12.6-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 覆盖。

本次亮点

• 头部两行：第一行产品名，第二行「版本 · 平台」+ 官方主页 + 源代码。两个入口与版本文字纵向居中，
  宽度不够时自动折到下一行并与版本左对齐。
• 入口不再带文字标签：www.diagramon.com、github.com/westsource/diagramon 本身就说清了去处；
  鼠标悬停仍会显示「官方主页：https://…」，读屏也能念出同样的名字。点击才用系统浏览器打开。
• 一张清单：格式表去掉「格式」标题与表头，六行数据直接读；编辑器（CodeMirror 6）作为最后一行
  与各格式并排 —— 名称列同样是胶囊，扩展名列写 -，说明列写「编辑器」。
• 去掉三处重复：标题与表头、清单上方重复的格式行与渲染行、底部的作者/许可行。

修复

• 「关于」里格式列了两次：顶部一行摘要 + 下方一整张表，同一个信息出现两遍；渲染技术与格式混在同一张表里，
  读起来像是在回答两个问题。本版合并成一张清单，编辑器也归位到它该在的那一行。

关于 Diagramon

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

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

系统要求

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

安装与更新

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

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

---

English

Diagramon 3.12.6 reorganises the About window into two parts: a header that says what this is and where to find it, and a single list underneath.

Downloads

Type	File	Notes
Installer (recommended)	Diagramon_3.12.6_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.6-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

• A two-line header: the first line is the product name, the second is "version · platform" plus the
  official site and source code. The two links sit vertically centred with the version text, and drop to
  their own line (left-aligned with the version) when the window is too narrow.
• No text labels on the links: www.diagramon.com and github.com/westsource/diagramon already say
  where they go; hovering still shows "Official site: https://…" and screen readers read the same name.
  The system browser opens only when you click.
• One list: the format table loses its "Formats" heading and header row — six rows read directly.
  The editor (CodeMirror 6) is the last row, side by side with the formats: same chip in the name column,
  - in the extension column, "Editor" in the note column.
• Three duplicates removed: the heading and header row, the repeated format/rendering rows above the
  list, and the author/licence line at the bottom.

Fixes

• Formats were listed twice in About: a one-line summary at the top and a full table below — the same
  information twice, with rendering technology mixed into the format table as if it answered two questions.
  They are now a single list, and the editor sits in the row where it belongs.

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.6_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.

Diagramon 3.12.5

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.

Diagramon 3.12.4

Release 说明：v3.12.4

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

---

中文

Diagramon 3.12.4 让「格式化源码」从一个空按钮变成真正可用的排版工具。

下载

方式	文件	说明
安装版（推荐）	Diagramon_3.12.4_x64-setup.exe（约 62.26 MiB）	装完可用内置自动更新；缺 WebView2 时安装器会自动下载运行时
便携版（免安装）	Diagramon-3.12.4-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 覆盖。

本次亮点

• 「格式化」按钮 / Shift+Alt+F 现在真的重排源码，不再只是抹掉行尾空格：
  • Mermaid：subgraph…end、序列图的 loop/alt/opt/par/rect/critical/break/box…end、
    else/and/option、class / state / er 的花括号，统一缩进到 4 空格；
  • Graphviz DOT：按词法重排 —— 一行一条语句、属性表内联、子图缩进，一行式
    digraph G{a->b;b->c} 会展开成可读的多行；
  • D2：花括号层级统一缩进到 2 空格。
• 只动空白，不动语义：字符串、HTML 标签、跨行引号标签、Mermaid 的 YAML frontmatter、
  D2 的 |md 块字符串都逐字节保留；DOT 的注释与 # 行也原样搬运。
• 不假装修了一遍：源码本来就规范时，状态栏会如实说「已是规范格式」，不会标脏。
• 可撤销：整块替换走编辑器的正常事务，Ctrl+Z 能退回格式化之前；落盘仍跟随你的自动保存设置。

修复

• 「格式化源码」此前没有真正实现：按钮与 Shift+Alt+F 都只做了一次行尾空白清理，
  多数文档点下去等于没反应（菜单里印着功能，实际是空壳）。本版补上了 Rust 侧的格式器，
  并把它接进按钮、快捷键与命令面板。

关于 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.4_x64-setup.exe 直接安装。已装旧版的用户可在
帮助 → 检查更新 里收到本版本（更新包即本安装包，签名见 latest.json）。

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

---

English

Diagramon 3.12.4 turns "Format source" from an empty button into a real formatter.

Downloads

Type	File	Notes
Installer (recommended)	Diagramon_3.12.4_x64-setup.exe (~62.26 MiB)	Enables the built-in auto-update; if WebView2 is missing the installer downloads the runtime
Portable (no install)	Diagramon-3.12.4-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

• The Format button / Shift+Alt+F now actually reformats the source, no longer just trimming
  trailing whitespace:
  • Mermaid: subgraph…end, sequence loop/alt/opt/par/rect/critical/break/box…end,
    else/and/option, and class / state / er braces are all indented to 4 spaces;
  • Graphviz DOT: lexer-level layout — one statement per line, attribute lists inlined,
    subgraphs indented; a one-liner like digraph G{a->b;b->c} expands into readable lines;
  • D2: brace levels are indented to 2 spaces.
• Whitespace only, semantics untouched: strings, HTML labels, multi-line quoted labels,
  Mermaid YAML frontmatter and D2 |md block strings are preserved byte for byte; DOT comments
  and # lines are carried over verbatim.
• No fake "formatted": when the source is already canonical, the status bar says so and the
  document is not marked dirty.
• Undoable: the whole-document replacement goes through the editor's normal transaction, so
  Ctrl+Z returns to the pre-format text; saving still follows your auto-save setting.

Fixes

• "Format source" was never really implemented: the button and Shift+Alt+F only trimmed
  trailing whitespace, so on most documents they did nothing. This release adds the Rust-side
  formatter and wires it to the button, the shortcut and the command palette.

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.4_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.

Diagramon 3.12.3

Release 说明：v3.12.3

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

---

中文

Diagramon 3.12.3 把配色从"看不见的视图状态"变成"看得见的源码内容"。

下载

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

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

本次亮点

• 选配色 = 改正文：在预览顶栏选一个色系，配色块立刻写进源码（%% dgm-palette:…），
  源码窗口和渲染看到的是同一份东西。落不落盘由「设置 → 编辑器 → 自动保存」决定，
  以前那条"颜色只是预览、要再点一次写入正文"的分叉没有了。
• 带得走：别的工具（mermaid live、GitHub、编辑器插件）打开这份源码就有颜色，
  不再依赖本应用的记录。
• 未保存的文档也记得住：配色不再是按文件路径记的外挂状态，新建文档选完就是它自己的内容。
• 打开文件不会变脏：按图内容推测的配色只作为建议提示，选了你才写进正文。
• 老文件迁移：以前记过色系但正文里还没有配色块的，首次打开时会把块补进缓冲区（不自动落盘，可撤销）。
• AI 应用结果、格式转换之后会自动按同一色系补回配色块，不会出现"应用完颜色没了"。

修复

• 「行底色」按钮看不出开关状态：按钮一直在切设置，但缺少按下态样式，点完只有 title 变了。
  现在关闭时是普通描边，打开时是强调色底 + 描边，并带 aria-pressed。
• 配色菜单少了一条分隔线：「无」和「按当前主题重排配色 / 让 AI 挑」挤在一起，
  看不出是"选择"与"动作"两类。

注意事项

• 切主题不会自动改色：配色块是选色系那一刻按当时明暗主题算出来的快照（块头会写「亮色」或「暗色」）。
  换主题后想重算，用配色菜单里新增的「按当前主题重排配色」。
• 「设置 → 默认配色」现在只作用于新建文档；已有文件各自在预览顶栏选，选完即写进它的正文。
• 升级后，之前只"跟随默认"而没有真正选过的文件会显示为无色，选一次即可（之后颜色会固定在文件里）。

关于 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.3_x64-setup.exe 直接安装。已装旧版的用户可在
帮助 → 检查更新 里收到本版本（更新包即本安装包，签名见 latest.json）。

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

---

English

Diagramon 3.12.3 turns palette colors from an invisible view state into visible source text.

Downloads

Type	File	Notes
Installer (recommended)	Diagramon_3.12.3_x64-setup.exe (~62.25 MiB)	Enables the built-in auto-update; if WebView2 is missing the installer downloads the runtime
Portable (no install)	Diagramon-3.12.3-win-x64.zip (~70.35 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

• Picking a palette edits the source: choosing a scheme in the preview toolbar writes the palette
  block into the source immediately, so the editor and the render show the same thing.
  Saving follows your auto-save setting — the old "colors are preview-only, bake them later" split is gone.
• Portable colors: mermaid live, GitHub rendering and editor plugins show the colors directly.
• Unsaved documents remember too: the choice is no longer sidecar state keyed by file path.
• Opening a file never dirties it: the palette guessed from the diagram is only a suggestion.
• Migration: documents that had a remembered scheme but no block get one written into the buffer on first open
  (unsaved, undoable).
• After AI apply or a format conversion the palette block is restored automatically, so colors never vanish.

Fixes

• The row-tint button gave no state feedback: it toggled the setting but had no pressed style.
  It now shows an accent background when on, with aria-pressed for accessibility.
• Missing separator in the palette menu between the scheme list (including "None") and the actions.

Notes

• Switching theme does not recolor: the block is a snapshot for the theme active when you picked it
  (its header says light or dark). Use the new "Regenerate for current theme" action after switching.
• "Default palette" in settings now only applies to new documents; existing files pick their own.
• Documents that only ever "followed the default" will show no colors after upgrading — pick a scheme once
  and it becomes part of the file.

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.3_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.

Diagramon 3.12.2

Release 说明：v3.12.2

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

---

中文

Diagramon 3.12.2 让自动配色不只认"节点是什么"（入口/判断/数据/外部/异常），也开始认"节点在哪一块"。

下载

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

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

本次亮点

• 按区块上色：Mermaid 的 subgraph、DOT 的 cluster、D2 的容器，现在都是分组依据 ——
  同一个区块里的节点同色相，不同区块不同色相（最多 9 档，22 个子图的图也不会糊成一片）。
• 框也跟着染色：区块自己的边框会铺同色相、但比节点浅一档的底色，
  一眼就能看出"这是哪一块"，节点也不会溶进背景。
• 语义角色优先：判断 / 入口 / 数据 / 外部 / 异常 这些角色仍然盖过分组色 ——
  "这里会出事"不会被区块色吃掉；只有没有语义特征的普通节点才按分组上色。
• 展平感消失：真实架构图里七八成节点是普通节点，以前会全部落到同一个主色；
  现在它们按所属子系统分开，色号不用再调。
• 只包着子分组的"外壳"区块也会分到自己的颜色，不再残留成默认的淡黄框。

修复

• 清掉颜色后仍然上不了色：以前只要节点上留着任何自定义类名就算"已有颜色"，
  于是删掉 classDef 行（最自然的清色方式）之后，残留的 :::目录 会让近八成节点被静默跳过。
  现在只有真的定义了填色的类才算手写颜色。
• D2 图多出假节点：classes: { … } 里的 fill: / stroke-width: / shape: 曾被当成节点，
  文末给它们各写三行样式；现在整块跳过，行内 {class: …} 也能正确识别。
• 标签猜词盖过分组：分层架构图几乎每个标签都带"数据"，会让整张图被染成同一个数据紫；
  优先级改为 显式角色 > 形状 > 分组 > 标签 > 主链路。

关于 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.2_x64-setup.exe 直接安装。已装旧版的用户可在
帮助 → 检查更新 里收到本版本（更新包即本安装包，签名见 latest.json）。

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

---

English

Diagramon 3.12.2 teaches auto-coloring where a node lives, not just what it is
(entry / decision / data / external / risk).

Downloads

Type	File	Notes
Installer (recommended)	Diagramon_3.12.2_x64-setup.exe (~62.25 MiB)	Enables the built-in auto-update; if WebView2 is missing the installer downloads the runtime
Portable (no install)	Diagramon-3.12.2-win-x64.zip (~70.35 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

• Color by region: Mermaid subgraphs, DOT clusters and D2 containers are now grouping keys —
  nodes inside a block share a hue, different blocks get different hues (up to nine, so a diagram
  with 22 subgraphs still reads clearly).
• Frames get tinted too: each block's border gets the same hue, one step lighter than its nodes,
  so the region is obvious and the nodes still stand out.
• Semantic roles win: decision / entry / data / external / risk still override the group color —
  "something goes wrong here" is never swallowed by a region tint. Grouping only colors plain nodes.
• No more flatness: in real architecture diagrams 70–80% of nodes are plain, and they all used to
  collapse into one color; now they separate by subsystem, without touching the palette itself.
• Wrapper blocks that only contain other blocks also get their own tint instead of staying default yellow.

Fixes

• Nothing got colored after clearing by hand: any leftover custom class name used to count as
  "already colored", so deleting the classDef lines (the most natural way to clear) left :::catalog
  markers behind and roughly 80% of nodes were silently skipped. Now only a class that actually sets
  a fill counts as a hand-picked color.
• Phantom nodes in D2 files: fill: / stroke-width: / shape: inside classes: { … } were parsed
  as nodes and styled at the end of the file; those blocks are skipped now, and inline {class: …} is parsed.
• Label guesses overriding structure: layered diagrams have "data" in almost every label, which
  painted a whole chart in one violet. Priority is now explicit role > shape > group > label > main.

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.2_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.

Diagramon 3.12.1

Release 说明：v3.12.1

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

---

中文

Diagramon 3.12.1 把"配色"从预览带进了源码窗格：不用切到图，也能看出哪几行会被染成什么色。

下载

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

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

本次亮点

• 源码窗格的行首色块：会被上色的节点，在它首次出现的那一行左侧点一个色块 —— 颜色就是它真会被
  染成的色（由后端按与渲染完全相同的判定给出，不是前端猜的）；同一个节点只标一次，长图不刷屏。
• 手写颜色看得见：带自己的 style / fillcolor（因此会被「仅未着色」跳过）的节点画虚框，
  悬停写明「手写色，保持」—— 不会让人以为它也会被上色。
• 悬停即查：A · 入口 加上 #d4e3ed / #4ab5a0，角色与色值都在，不用去预览里点。
• 行底色（默认关）：「格式化」旁边多了一个「行底色」按钮，开启后给会被上色的行铺一层极淡的角色色；
  设置 → 编辑器里也有同一个开关。它画在文字下面，不会给代码蒙色，也不改正文。
• 标注是只读的：色块与行底色都不进撤销栈、不改文件、不标脏。

修复

• 连线开关不再把颜色写进缓冲区：3.12.0 里切换「连线跟随配色」会把配色烘焙进正文并标脏，
  与"颜色只在预览里"的模型相悖；现在只重画预览（状态栏也从"已重跑当前文档"改成"预览已更新，正文未改"）。
• 设置 → 编辑器里「路径守卫」与「快捷键」两条说明贴在一起，已加缝隙。

关于 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.1_x64-setup.exe 直接安装。已装旧版的用户可在
帮助 → 检查更新 里收到本版本（更新包即本安装包，签名见 latest.json）。

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

---

English

Diagramon 3.12.1 brings the palette into the source pane: you can see which lines will be coloured, without switching to the diagram.

Downloads

Type	File	Notes
Installer (recommended)	Diagramon_3.12.1_x64-setup.exe (~62.24 MiB)	Enables the built-in auto-update; if WebView2 is missing the installer downloads the runtime
Portable (no install)	Diagramon-3.12.1-win-x64.zip (~70.33 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

• A swatch on the line where each node appears — every node that will be coloured gets a swatch on the
  left of its first line, in exactly the colour it will render with (computed by the backend with the same
  rules the renderer uses, not guessed in the front end). One swatch per node, so long diagrams stay readable.
• Hand-written colours are visible too — a node carrying its own style / fillcolor (and therefore
  skipped) gets a dashed frame and a "hand-written, kept" tooltip, so it never looks like it will be recoloured.
• Hover to inspect — A · entry plus #d4e3ed / #4ab5a0: role and value, without opening the preview.
• Row tint (off by default) — a new "Tint rows" button next to Format, and the same switch under
  Settings → Editor. It paints a very faint role colour behind the text, so code never looks washed out,
  and it never touches the document.
• The overlays are read-only — no undo entries, no file changes, no dirty flag.

Fixes

• The edge switch no longer bakes colours into the buffer — in 3.12.0 toggling "edges follow the palette"
  wrote the palette into the document body and marked it dirty, contradicting the preview-only model; it now
  only redraws (the status line says "preview updated, source untouched").
• Two adjacent notes in Settings → Editor were touching; they now have a gap.

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.1_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.

Diagramon 3.12.0

Release 说明：v3.12.0

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

---

中文

Diagramon 3.12.0 给图表加了一套"自动配色"：AI 不再随手写色值，而是只标角色；颜色由本地按色系展开，可复现、可一键换、也可以只留在预览里。

下载

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

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

本次亮点

• AI 只标角色，色值本地落地：模型写"主链路 / 入口 / 判断 / 数据 / 外部 / 异常 / 说明"，应用按色系把角色展开成色值 ——
  同一句话两次生成不会出现两套颜色，暗色主题也自动用更亮的一档。跨格式一致：Mermaid / DOT / D2 都能落地。
• 六种色系 + 线框档：松绿 / 黛蓝 / 藕紫 / 橄榄 / 赭石 / 钨灰（无彩，线框与打印）。预览顶栏第三颗按钮切换，
  按文件记住；连线一起跟随色系（设置里可关）。
• 打开即挑选：打开没有记过色系的文件时，按图里的角色占比与标签本地选一个（数据/存储多→黛蓝、异常多→赭石、
  外部接口多→橄榄、界面词→藕紫，否则松绿），状态栏写明依据。新建文档默认「无」。
• 颜色只留在预览里：换色系、换主题都不改正文；想固化给别人看，菜单里有「写入正文」。
  清除（「无」）也只改缓冲区 —— 磁盘要你自己保存。
• 「无」会尽量清干净：先删程序生成的那一段；如果正文里还有手写/外来颜色，且配置了模型，
  就让模型只删颜色（结构一改就放弃这次清理）。
• 更安静的资料：连线默认跟随色系但压低饱和度；色系之间按可辨识度重新排过（同一色系内七个角色
  填充最小色差从 1.2 提到 3.6–5.9，换色系的差异从 2 提到 17）。

修复

• Mermaid 里带连字符的类名（A[开始]:::my-class --> B）不再让整份文件解析失败。
• 节点在边上被再次提及时，形状不再被覆盖成方框（判断/圆柱节点之前会被当成主链路）。
• 自动配色失败不再挡住渲染：出图照常，原因写在状态栏。
• 便携版的 README 截图在缺少 ELK 离线包时会显示"加载失败"，已修（截图脚本补上挂载点）。

关于 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.0_x64-setup.exe 直接安装。已装旧版的用户可在
帮助 → 检查更新 里收到本版本（更新包即本安装包，签名见 latest.json）。

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

---

English

Diagramon 3.12.0 adds automatic colouring: the AI no longer invents hex values, it only tags roles; the app expands them into a palette — reproducible, swappable in one click, and optionally preview-only.

Downloads

Type	File	Notes
Installer (recommended)	Diagramon_3.12.0_x64-setup.exe (~62.23 MiB)	Enables the built-in auto-update; if WebView2 is missing the installer downloads the runtime
Portable (no install)	Diagramon-3.12.0-win-x64.zip (~70.33 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

• The AI tags roles, the app picks the colours — the model writes main / entry / decision / data /
  external / failure / note, and the palette expands those into values: the same sentence never yields two
  different palettes, and dark themes get the brighter ladder automatically. The same tags work in Mermaid,
  DOT and D2.
• Six schemes plus a wireframe one — Pine / Indigo / Lotus / Olive / Ochre / Tungsten (achromatic, for
  wireframes and print). Switch from the third control in the preview toolbar; the choice is remembered per
  file, and edges follow the scheme too (switchable in Settings).
• Picked on open — a file with no remembered scheme gets one chosen locally from its role mix and labels
  (data-heavy → Indigo, failures → Ochre, many external calls → Olive, UI wording → Lotus, otherwise Pine),
  with the reason shown in the status bar. New documents start with None.
• Colours live in the preview — switching scheme or theme never rewrites the source; 「Bake into source」
  is there when you want the colours in the file. Clearing (「None」) only touches the buffer, too — saving
  stays your call.
• 「None」 tries to leave nothing behind — our own block goes first; if hand-written or foreign colours
  remain and a model is configured, the model strips colours only (and the cleanup is discarded if it
  changes the structure).
• Quieter diagrams — edges follow the scheme at reduced saturation, and the schemes were re-spaced by
  measured distance (role fills went from ΔE 1.2 to 3.6–5.9, scheme-to-scheme from 2 to 17).

Fixes

• Mermaid class names containing hyphens (A[开始]:::my-class --> B) no longer break the whole file.
• A node mentioned again on an edge keeps its shape (decision/cylinder nodes were being treated as main path).
• A failed palette expansion no longer blocks rendering: the diagram still draws and the reason lands in the
  status bar.
• The README screenshots no longer show an ELK "failed to load" message (the capture script now serves the
  bundled ELK chunk).

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.0_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.