核心概念

读懂 DiagramZu 的六个理念

DiagramZu 刻意做得很小。掌握这六个理念,你就清楚该让 AI 做什么、团队会拿到什么。

为三种工作流而生

审阅 AI 提案

你的 AI 提出一套架构,把图放在这里。你几秒内就能拍板,不用读 600 行文字。

交接给团队

用一条链接分享架构。版本历史记下改了什么、何时改的——现在给人看,以后给下一个 AI 看。

复用到演示中

工程师审过的那张图,就是 CEO 放进 PPT 里的那张。可信来源只有一份,而不是三份过时的副本。

描述就是简报

每张图都带着一段描述,走到哪跟到哪——看的人看得到,下一个 AI 也读得到。

让 AI 在创建或更新图表时,先写一两句描述。它会成为公开分享链接上的副标题,也是下一个 AI 获取图表时最先读到的内容。描述回答「为什么」和「是什么」,代码负责「怎么做」。

一等公民
双向流转
AI 的简报

分享链接,而非截图

把任意图表变成一条不用登录、也猜不出来的只读链接。

AI 画的图要给外面的人看,走的就是分享链接。它是 22 位随机字符,不用登录,任何人都能打开。看得到渲染好的图,也能查看 Mermaid 源码,但进不了编辑器。演示和页面也有自己的分享链接,可以直接播放幻灯片,或阅读带图的页面。在分享菜单里一撤销,链接立刻失效。放进上手文档、评审讨论,或 README 里的「看个示例」,都正合适。

只读
可撤销
无需登录

由你决定的版本

快照都是有意为之——只在你主动存档,或 AI 做出实质改动之后才记录,绝不会每敲一下键就存。

AI 在更新时传入 createVersion: true,你在工具栏点「保存版本」。不会有一堆自动存档的噪声要翻。恢复旧版本前会先给当前状态留一份快照,工作永远不会丢;「另存为新图表」会把某个版本提取成独立的图,原图不动。

有意为之
安全恢复
另存为新图表

是提案,不是覆盖

为空间开启审阅后,AI 对现有图的改动会先作为提案等待 —— 由团队批准后才落地。

它是可选项,一个人用的时候照样即时生效。开启审阅后,AI 对现有图的更新不再直接覆盖,而是变成一条待处理的提案。你打开图,对照线上版本看 diff,然后批准或驳回。批准时会先把原状态存为版本——版本管事后恢复,提案管事前把关。

可选开启
看差异再批准
覆盖之前

布局,替你决定

把 layout 设为 auto,确定性的分类器会根据图自身的形状选择合适的布局。

树形结构归到整洁的树布局,稠密的环状图归到力导向布局,干净的 DAG 归到 dagre——六种具体布局,保存时一次选定并固定下来,图永远可复现。不喜欢这个选择?在工具栏里一键换掉。

一次定型
六种布局
可复现

永不过时的嵌入

用一个 iframe 把图嵌进任意页面——跟随主题、可交互、始终最新。

嵌入指向一条分享链接,所以显示的永远是线上那张图——在 DiagramZu 里一改,每处嵌入都跟着更新。iframe 里没有编辑器外壳,支持平移缩放,还会匹配宿主页面的浅色或深色主题。一枚低调的徽标链接回主页,嵌入标签页能看到 7 天加载次数。凡是支持 iframe 的地方都能用——文档站、Notion、博客、Wiki。

始终实时
跟随主题
加载统计