代码库自动画成架构图，archify 的图怎么验收才有用？

先分清描述图与代码依据图

Archify 可以直接接收系统描述，也可以让编程助手读取仓库后生成图。前一种方式适合讨论计划，图里的连接来自输入描述；后一种方式适合解释已有实现，需要逐项对应代码。README 中的交互演示不能证明任意仓库都能自动得到完整架构图，生成过程仍依赖助手读到的文件。

当前包提供架构图与时序图等类型，也支持把解释做成一页 HTML。选择类型时先确定任务：新成员定位功能入口可以用架构图，请求经过哪些调用则适合时序图。独立 HTML 方便传阅，团队仍需保留生成它的候选 JSON 和对应代码版本。

用固定提交检查节点与连接

仓库编写规则要求记录完整提交号及不含凭据的仓库地址，并为关键元素保留文件路径和行号。代码依据按提交中的文件核对，未提交修改不能冒充该提交的内容。读图时可以从一个入口开始，对照图中的下一步调用，直到实际读取或写入数据的位置。

例如图上画出“API 写数据库”，需要找到实际写入操作，只有配置文件里的数据库名称还不够。若代码通过队列交给另一个进程处理，图也应保留这个中间步骤。对照时记录遗漏与错误连接，不能只确认节点名字都在仓库里出现过。

复用官方命令查看自动检查

仓库的 package.json 声明 Node.js 18 或更新版本。以下是官方 finalize 用法的路径占位示例，需先由助手按 schema 编写 candidate.json，并把脚本路径换成实际安装位置。本文只核对命令与源码，没有执行它，也没有生成可供验收的架构图。

finalize 会串起验证、交付及浏览器检查，失败时停止并给出检查记录。自动通过只说明这些检查通过，视觉审查仍可能是 not-requested。验收时另外打开 HTML 检查文字是否遮挡、连线是否容易追踪，再请不熟悉模块的人用它找一次真实代码位置。

node /path/to/archify/bin/archify.mjs finalize architecture candidate.json architecture.html --repo-root /path/to/repo --quality showcase --json

更新代码后保留图的版本差异

把一次已知的小改动作为更新样本，例如新增缓存读取或改变异常分支，再让助手重新生成。对照前后候选，检查旧连接是否被删掉、新分支是否得到源码支持。验收记录写明代码提交和图的生成条件，避免同一文件名覆盖后无法解释变化。

Archify 自身采用 MIT 许可，助手所用模型与第三方服务的条件需要另行确认。首次处理内部仓库时应按实际助手的数据访问方式选择材料。只有图能帮助新成员找到入口，并且更新后仍能对上代码，才适合加入日常交接；本次文档核对没有测量这部分效果。