Repository navigation
Diagramon 3.8.14
本页中英双语:中文在前,英文在后。 / Bilingual release notes: Chinese first, English below.
中文
Diagramon 3.8.14 修掉两个转换缺陷:带内联类名的 Mermaid 文件现在能正常转成 DOT / D2,带 subgraph 的图转 Excalidraw 也不再退化成一张不可编辑的图片。
下载
| 方式 | 文件 | 说明 |
|---|---|---|
| 安装版(推荐) | Diagramon_3.8.14_x64-setup.exe(约 62.93 MiB) |
装完可用内置自动更新;缺 WebView2 时安装器会自动下载运行时 |
| 便携版(免安装) | Diagramon-3.8.14-win-x64.zip(约 70.08 MB) |
解压到任意位置,双击 diagramon.exe 即用;卸载 = 删文件夹 |
便携版说明:包里是 diagramon.exe + WebView2Loader.dll + ui\ + assets\,必须放在一起
(ui\ 与 assets\ 是从磁盘读的,不在 exe 里)。它不依赖额外要装的东西:不需要 Node.js、
不需要 Chrome、不需要 VC++ 运行库(exe 已静态链接 CRT),只需要 Windows 10/11 自带的 WebView2 运行时。
便携版的「检查更新」照常能发现新版,但更新走的是安装包(不会就地替换便携目录)——
要继续用便携形态,就手动下载新的 ZIP 覆盖。
本次亮点
- 带分组的图转 Excalidraw 终于能编辑了:以前凡是图里用了
subgraph(分组框),转成 Excalidraw 后
整张图会变成一张静态图片 —— 看着对,但每个框、每条线都拖不动。现在会还原成真正的图形元素,
可以继续编辑。实测一份 148 行的部署图:修前 1 个图片元素,修后 181 个可编辑元素
(59 个框 + 34 条箭头 + 88 段文字)。 - 内联类名不再让整份文件转不出来:Mermaid 允许把样式类直接写在节点上(
A[文本]:::某类),
这种写法以前会让转 DOT / D2 直接报「第 N 行:语句尾部有没解析完的内容」而整份失败。
现在照常识别,样式也一并迁移过去。
修复
:::类名内联类名导致 Mermaid → DOT / D2 失败:解析器只认id[标签],不认节点后缀的
:::类名,于是把:::类名当成语句尾部的多余内容整份报错。现在两种写法等价处理:
遇到:::会读出类名(支持:::a,b多个),与单独的class A 类名语句效果一致;
类名对应的样式会迁移到目标格式(DOT 全挂上;D2 的.class只能挂一个,多类时取第一个并在
转换记录里如实说明)。- 带
subgraph的 Mermaid → Excalidraw 退化成位图:上游转换器用裸 id 去文档里找分组元素,
而实际渲染出来的 id 带有一段每次都会变的序号前缀,于是必然找不到、抛错后被兜底成整张图片。
现在转换期间会按 id 后缀再找一次,分组能正确还原;转换结束立刻撤掉这层兜底,不影响其它操作。
说明
- 转换器依赖的 Excalidraw 与它的 Mermaid 转换器一并升到了当前版本(
mermaid-to-excalidraw2.3.0)。 - 顺手给两个画布探针加了受限会话下的启动开关(
DGM_PROBE_NO_SANDBOX=1),
只影响开发与验收工具,不影响产品本身。
关于 Diagramon
Diagramon 是一款本地优先的多格式图表编辑器:Mermaid / Graphviz DOT / drawio / Excalidraw
都可编辑并实时预览,AI 可辅助生成、评审与识图。渲染与校验不联网也能用 ——
只有你主动使用 AI 时,相关代码或图片才会发往你选择的上游。
系统要求
- Windows 10 / 11 64 位
- WebView2 运行时(Windows 10/11 通常已预装;缺失时安装器会现场下载)
- 不需要 Node.js、Chrome 或 VC++ 运行库 —— 画布运行时与前端资源都随包分发
安装与更新
下载 Diagramon_3.8.14_x64-setup.exe 直接安装。已装旧版的用户可在
帮助 → 检查更新 里收到本版本(更新包即本安装包,签名见 latest.json)。
本安装包尚未做 Authenticode 代码签名,Windows SmartScreen 可能给出提示。
English
Diagramon 3.8.14 fixes two conversion defects: Mermaid files that assign style classes inline now convert to DOT / D2, and diagrams with subgraph blocks no longer collapse into a single non-editable image when converted to Excalidraw.
Downloads
| Type | File | Notes |
|---|---|---|
| Installer (recommended) | Diagramon_3.8.14_x64-setup.exe (~62.93 MiB) |
Enables the built-in auto-update; if WebView2 is missing the installer downloads the runtime |
| Portable (no install) | Diagramon-3.8.14-win-x64.zip (~70.08 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
- Diagrams with groups are finally editable in Excalidraw: any diagram using
subgraphblocks used to
convert into a single static image — it looked right, but nothing could be dragged. It now comes
through as real shapes. Measured on a 148-line deployment diagram: 1 image element before,
181 editable elements after (59 boxes + 34 arrows + 88 text runs). - Inline style classes no longer break a whole file: Mermaid lets you attach a class right on a node
(A[text]:::someClass). That used to make Mermaid → DOT / D2 fail outright with
"trailing unparsed content on line N". It is now understood, and the styling comes across too.
Fixes
:::classinline class made Mermaid → DOT / D2 fail: the parser only understoodid[label]and
treated the trailing:::classas leftover text, failing the whole file. Both spellings are now
equivalent::::is read (including:::a,bfor several classes) and behaves exactly like a separate
class A someClassstatement. The styling is migrated (DOT gets all of them; D2's.classholds one,
so the first is used and the conversion record says so).- Mermaid → Excalidraw with
subgraphdegraded to a bitmap: the upstream converter looked up the
group element by its bare id, while the rendered id carries a per-render numeric prefix — so the
lookup always missed, threw, and was caught into a whole-diagram image fallback. Conversion now retries
the lookup by id suffix, so groups come through correctly; the fallback is removed as soon as the
conversion finishes and does not affect anything else.
Notes
- The Excalidraw bundle and its Mermaid converter were bumped together (
mermaid-to-excalidraw2.3.0). - Two canvas probes gained an opt-in flag for restricted sessions (
DGM_PROBE_NO_SANDBOX=1).
Development and acceptance tooling only — the product itself is unaffected.
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.8.14_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.