Archify 实测:交付校验与离线交互图
用 18 次 CLI 调用和 11 项浏览器检查测试 Archify 3.2.0,核对无效候选、来源记录、离线 HTML、有向路径和浏览器检查跳过后的文件状态。
AgentIndex · 发布于 2026-11-08 · 更新于 2026-11-08
Archify 把本次给定的 JSON 生成为可读、可交互的流程图,交付的 HTML 单独复制后也能离线打开。所测无效候选被拒绝,文件改动也能被严格校验发现。但一个操作边界很重要:浏览器不可用时,finalize 可以在已经替换目标 HTML 之后返回非零状态。“文件已交付”和“全部验收通过”是两件事。
本次使用发布版 3.2.0 Skill 包,记录 18 次 CLI 调用和 11 项独立浏览器检查。评测助手阅读随包 Skill 后,直接提供六节点、五条边的合成 JSON;执行脚本没有额外调用模型服务。这验证渲染、校验与交付行为,没有建立自然语言理解或自动梳理代码库的准确率。
固定发布包与源码指纹
从 v3.2.0 发布页 下载 archify.zip,共 5,271,959 字节,与 GitHub 声明的 SHA-256 一致:70e210265c59f24dcbdf2a502ff671104b5454e7ee7d3554aecd86bad32384f5。标签对应提交 208acba8d412335185b2056fedf54b3405df43fb。
选定的 Skill、CLI、finalizer、workflow 渲染器、workflow schema 和随包 LICENSE 六个文件,均与该提交逐字节一致。发布包的 package.json 去掉了仅供仓库开发的脚本与开发依赖。我们直接运行发布包,没有装入用户的全局智能体配置,也没有运行包的生命周期安装脚本。固定源码
环境为 Apple M1 Pro、macOS 26.6.2、Node.js 26.3.0、Chrome 157.0.8103.38。独立浏览器脚本使用 Playwright 1.65.0-alpha-2026-10-30。发布包声明需要 Node.js 18 或更新版本;本次完成全流程验收还依赖浏览器。
复现脚本、来源指纹与原始结果 保留输入 JSON、命令参数、退出码、收据和产物哈希。执行时关闭更新检查,CLI 运行附加 Node HTTP 拦截,独立页面测试使用离线浏览器上下文。这些控制不代表已经审计浏览器进程全部操作系统网络请求。
给定流程图通过了四道自动检查
样例描述一条虚构的双语稿件处理流程及失败分支,使用中文标签、meta.locale: "zh-CN"、两条泳道,以及明确声明根节点、终点、必需边和必需有向路径的 semanticChecks。它不描述也不执行本站真实部署流程。
node bin/archify.mjs finalize workflow candidate.json workflow.html --quality showcase --json
首份候选通过 validate、deliver、严格 check 和 browser-check。收据仍标记 visualReview: "not-requested",自动验收没有声称已经有人看过成图。我们另行目视检查了四张浏览器截图和 PNG 导出。

这是给定测试图的实际浏览器截图,不是自然语言画图准确率的证据。默认桌面视图显示了六个选定标签与失败分支,没有观察到标签或箭头被裁切。
无效输入:这些用例保留了旧 HTML
修改候选后,再让 finalize 使用同一目标路径。下列六种情况均以退出码 1 拒绝,旧 HTML 的 SHA-256 保持不变。
| 负向输入 | 实际拒绝结果 |
|---|---|
| 连线指向未定义节点 | 结构及路径检查失败 |
| 节点 ID 重复 | 结构及路径检查失败 |
| 两节点占用同泳道、同列 | workflow/node-overlap |
| 显式声明的必需直连边不存在 | workflow/required-edge |
持久化 meta.output 包含 ../ | output/meta-path-syntax |
| JSON 未写完整 | input/json-parse |
另一次故意传入错误的预期候选哈希,返回 finalize/candidate-changed,旧 HTML 同样未变。这测的是给定摘要的检查,没有执行并发写入或竞争条件实验。
校验也不等于业务事实正确。我们将发布节点的标签改为“无需审阅”,其余拓扑不变,所测校验仍通过。这些契约约束作者明确写入的内容,不会独立知道实际审批政策,也不能据此确认系统图符合运行代码。
来源记录校验需要明确启用
成功交付后,我们在 HTML 末尾追加注释,严格检查返回 delivery/provenance-mismatch;恢复先前保存的精确字节后,同一严格检查再次通过。恢复操作由测试脚本完成,不是 Archify 自动修复。
随后用较底层的 render 生成一份没有交付 sidecar 的产物。普通 check 成功,但报告 provenance: "unknown";加上 --require-provenance 后,返回 delivery/provenance-required 并失败。
这有助于发现未经注意的文件改动及交付证据缺失,却不能独立认证图中事实。普通检查成功不能被写成“交付来源已验证”;正常 finalize 流程则为我们选择了严格检查。交付契约
浏览器检查跳过时,新文件可能已经写入
后段负向用例使用有效候选,只修改标题,并把 ARCHIFY_CHROME 指向不存在的可执行文件。Archify 没有偷偷改用其他已安装浏览器。收据状态如下:
| 阶段 | 状态 |
|---|---|
validate | pass |
deliver | pass |
check | pass |
browser-check | skipped |
| 整体命令 | ok=false,退出码 2 |
此时目标 HTML 的 SHA-256 已从 419842bf… 变成 3c9b0faa…。它与前面“无效输入保留旧文件”的结果并不冲突:这次有效候选已经完成交付,随后才检查浏览器是否可用。所测 finalizer 并不是只要后段检查没完成,就把旧文件恢复的整体事务。
接着换回真实浏览器,并指定新的证据目录,四道检查再次通过。使用者应看退出码与逐阶段状态,不能只因文件存在就发布。如果业务要求全部验收完成前保留已接受的公开文件,可以先生成到独立候选路径,成功后再提升为公开产物。本次没有验证崩溃恢复、断电持久性或并发交付。
离线交互和导出也实际操作了
我们只将 813,485 字节的 HTML 复制进新目录,旁边没有 Archify 包文件或交付 sidecar。在离线 Chrome 上下文中,六个中文节点标签和本地化查找按钮仍正常显示;搜索检查节点可以聚焦,带聚焦状态的网址也能恢复选择。
从检查节点查询下游,恰好选中它自身和三个已定义后继。草稿到归档的正向路径包含预期五个节点;反向查询则说明“归档结果走不到双语草稿”,没有虚构箭头或当作无向关系。这是对给定图的查询,不是运行时影响分析。
保持下游聚焦时,通过真实导出菜单下载 SVG 和 PNG。SVG 保留全部六个标签,并去掉当前可达高亮、选择与语义护照面板;两次导出后,实时查看器仍保持节点选择。PNG 为 3576×2232 像素,目视可见完整图形。主题切换与 Live/Still 偏好的保存也在所测上下文中生效。该次页面运行没有记录到 HTTP 请求或 JavaScript 页面异常。
在 390×844 视口下,文档宽度仍为 390 像素,但图在所测 100% 比例下被自身容器裁切,右侧节点不在可见范围。页面不横向溢出,比“完整手机阅读体验”窄得多;随包运行时文档也只将窄屏描述为容纳页面,而非手机产品能力。

怎样判断是否适合采用
如果团队希望审查 JSON 源文件、获取明确的校验收据,再交付可交互 HTML,Archify 值得小范围试用。应把事实编写、候选校验、文件交付、浏览器验收和目视审图分开判断。需要来源记录时,把 JSON 和收据与产物一起保留;只复制 HTML 仍可阅读,但那与保留验收证据不是同一个承诺。
未测其他图类型、解释页面、仓库证据验证、自然语言准确率、全局 Skill 安装、大图、其他浏览器与操作系统、WebM/分享卡片、无障碍规范符合性或相对速度。固定发布包内的 Skill 使用 MIT 许可,其记录与目录当前仓库元数据分开保存。
Archify 工具详情 汇总安装与选型条件。若需要另一种编辑方式,可以看 Next AI Draw.io 可编辑交付评测;两篇是独立用例,不构成性能对比。FastMCP 评测 还展示了另一类边界:调用返回错误和已经完成的工作,需要分别检查。