软件工程
Editorial 架构差异图设计工具 — 无阴影,告别 Mermaid 杂乱
使用同步的 Before、Changes 与 After 三栏解释系统变化。十节点示例以持久队列替代直接分发器,同时保留前台、工作进程和存储的稳定身份。
导出图表
免费 PNG 包含 EditorialDiagram 角标。
排版规则与常见反模式
该图表的四条排版规则
- 01
只使用两个拓扑快照,中间放变更清单。两侧快照共享尺寸、网格间距与垂直原点。
- 02
保留组件沿用相同局部坐标。只有迁移故事明确包含 MOVED 条目时,才移动组件。
- 03
组件与关系使用稳定 ID。CHANGED 表示语义签名改变;REWIRED 表示有向关系的端点改变。
- 04
ADDED、REMOVED 与 CHANGED 同时使用文字及形状或线型编码。带身份信息的关系路径绘制在组件之前。
应避免的三种错误
- 两侧独立自动布局,会制造系统并未发生的移动。
- 清单只写“已更新”,会掩盖具体对象与变化内容。
- 把两个快照当成部署顺序,会凭空暗示时间、因果关系或回滚保障。
Engineer 与 Executive 密度对比
两种渲染基于同一个说明性示例。Executive 模式有意合并细节;在技术评审中使用总览前,请先阅读图注。
十个快照节点对应六个稳定组件身份;六项清单覆盖语义与端点变化。
六个快照节点概括订单入口和履约能力,同时保留前后对照。
何时应换用其他图表
关于该图表的常见问题
为什么保留的组件在前后快照中位置不变?
差异图通过位置稳定区分真实变化与绘图变化。示例让前台、API、工作进程与存储的坐标保持同步;位置改变必须明确声明 MOVED,否则读者可能把重新排版误认为系统迁移。
CHANGED 与 REWIRED 有何区别?
CHANGED 表示同一对象的语义改变,例如订单 API 从直接分发切换为入队。REWIRED 表示同一关系的来源或目标改变,例如提交请求从旧分发器改连队列。如果两种变化都成立,一条关系可以同时标记二者。
架构差异图能证明队列迁移可以安全部署吗?
不能。它描述两个拓扑状态及其声明的差异。部署顺序、回滚、可用性与数据一致性需要单独规划。Engineer 模式可检查包含六项组件和连线变化的清单;实施时序应另用带日期的计划表达。
示例使用说明性数据。编辑后的新布局需要 AI 服务;缓存预览可立即查看。
缓存示例可免费试用。Starter Pack 为 US$9.9 一次性购买;Pro Pass 为每月 US$8.9。每次生成固定消耗 10 积分,包含一次自动几何修正。 价格
EditorialDiagram