Skip to content

Diagramon 3.12.2

Choose a tag to compare

View all tags
@westsource westsource released this 31 Oct 08:18
· 19 commits to main since this release
v3.12.2
510e746

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.

Assets 6
Loading