Eraser 架构图教程：事实清单、节点连线与系统边界核验

这篇教程把一份系统说明变成可验收的架构图：先整理事实清单，用 Eraser 生成，逐项核对节点、连接和边界，最后保存源文件、审核记录和导出版本。示例使用虚构的通知服务，操作入口依据官方文档；本文未连接真实仓库或 Eraser 账号进行在线生成。

开始前准备

准备账号、可使用的 AI 额度和一份已脱敏的系统说明。内部主机名、地址、客户数据、凭证和完整网络配置先按组织要求处理。在 Share File 中检查团队访问与 Link access；官方文档列出的默认团队文件链接允许持链接并有账号的人编辑。Private File 仅创建者与受邀协作者可访问，且禁用链接访问；Eraser 价格页当前将该功能放在 Starter 及以上，Free 试点适合公开或虚构资料。

先决定图的用途：这次画“当前组件与连接”，不把部署方案、业务流程和所有错误细节挤进同一张图。对方需要看请求时间顺序时，再生成一张独立时序图。

第一步：整理可追溯的事实

以下来源名称是虚构样例；实际工作替换成自己的设计文档、代码路径、schema 或部署清单，并记录版本。不要把未经确认的口头猜测列为现状。

共有六个节点与六条有向连接：Browser→API、API→Postgres、API→Queue、Queue→Worker、Worker→Postgres、Worker→Mail Provider。F8 作为说明注释，不额外虚构节点。真实系统的幂等实现必须测试，图上写出规则不能证明已经实现。

第二步：生成第一版

在 Eraser 的画布插入菜单中进入 AI Diagram，或按官方文档的 ⌘/Ctrl+J 入口；输入自然语言资料并选择架构图类型。界面名称可能随版本调整，按当前账号的 AI 图表入口操作。

复制这个提示模板，再附上事实表：

为虚构的通知服务绘制“当前架构”组件图，只使用 F1–F8。
必须恰好包含以下六个节点：
Browser、API、Postgres、Queue、Worker、Mail Provider。

必须包含六条有向连接并标注含义：
Browser -> API：HTTPS，提交通知请求
API -> Postgres：SQL，保存任务与收件人
API -> Queue：只发送 task_id
Queue -> Worker：消费 task_id
Worker -> Postgres：SQL，读取收件人与更新状态
Worker -> Mail Provider：SMTP/TLS，发送通知

服务端边界内只包含 API、Postgres、Queue、Worker。
Browser 与 Mail Provider 放在边界外。
F8 写成故障处理注释，不增加组件或连接。
不添加缓存、负载均衡器、网关或部署平台。
不足的信息列入待核查清单，不补成现状。
节点名称与协议标签必须清晰可读，优先减少连线交叉。

当前 Eraser 架构图与流程图通常是 freeform；若团队设为 Code (DSL)，则使用图表代码。检查生成后的实际格式，再选择手动改画布或改代码。Eraser DSL 与 Mermaid 不同，别把另一种工具的语法直接当成这里的格式。

第三步：逐项验收

先打开原始资料，按下面的表检查；暂时不要用配色或布局掩盖事实问题。

还要让维护者检查容易漏掉的语义：浏览器是否被画成直接访问数据库、Worker 是否绕过队列、外部邮件服务是否被放进内部信任边界。若原文自己冲突，先修正资料并标注疑点，再生成；不要让 AI 替团队决定真实架构。

第四步：小范围修正并复核

每次只修一类错误。例如：“保留六个节点，将 Worker 到 Postgres 的标签改为读写任务状态，不增加连接。”修改后重新按 F1–F8 检查全部关系，尤其是 AI 自动重排时可能移动的边界和标签。人工移动节点也要检查连接是否仍附着到正确端点。

需要进一步解释时，再用同一事实表生成时序图，分别标出入队、消费、数据库访问、发送和失败处理。组件图和时序图要保持同名组件与相同事实版本。新增建议如缓存或新队列，放入独立的“拟议方案”，不要修改当前架构的事实清单。

第五步：发布、导出与后续更新

邀请有权限的维护者审核，再按交付需求导出 PNG/SVG/PDF。用实际阅读尺寸检查文字、线条、图例和裁切；图片导出不会自动保留全部编辑源码或平台交互，另存原始画布、图表代码/结构数据以及审核记录。公开分享前核对链接权限，并用未登录环境检查预期可见范围。

文档记录系统范围、来源版本、生成日期、审核人和待核查项。下次代码或配置变化时，先更新事实清单，只比较受影响的组件与关系。若后来接入 Git、云数据源或 Eraserbot，还要检查读取范围、同步时间、AI/API 用量和预算；一次连接成功不代表图已覆盖所有事实。

常见问题

图能渲染但关系错，应先改事实与语义；导出文字太小，先减少单图信息量再调整布局；免费额度不足，先核对账号余额和刷新规则；需要在 Git 中审阅 Mermaid 源码，可比较 Mermaid 平台；需要自建渲染，单独评估 Eraser 开源库及模型/编辑工作流。厂商案例中的提效比例不能替代你们的同资料试点。

资料：AI 图表入口与格式、diagram-as-code、文件分享、当前价格、用量计费、开源范围。