Archify
把想法、方案或代码库交给 AI Agent，生成可交互、可分享的单文件 HTML 架构图。
- Star 数
- ★ 87k
- 最近更新
- 今天
- License
- MIT
- 主语言
- JavaScript
- FA 评分
- 77/100 · 表现良好
30 秒速览
- 可在哪里用
- 通用 · 跨平台Codex · Claude CodeClaude.ai（部分支持）ChatGPT（不支持）
- 开始前需要
- 典型场景
- 中级开发者在接手陌生仓库时，让 Agent 读代码并生成标注来源行号的高层运行时架构图
- 主要局限
- 明确不提供 Mermaid 自动解析、通用自动排版、托管分享与 WYSIWYG 编辑，习惯这些工作流的人需要改变方式
- 源码审查
- 77/100 · 表现良好
这个 Agent 能做什么，适合哪些场景？
Archify 是一个面向编码 Agent 的 Skill：它让 Claude Code、Codex CLI、Cursor、opencode 等 Agent 先把需求写成带类型的 JSON IR，再渲染成一个自带交互的单 HTML 文件。仓库自带渲染器与校验器（archify/bin/archify.mjs），提供 validate、deliver、preview、guide、compare 等子命令，支持架构图、流程图、时序图、数据流、生命周期等十种图类型。交付前会依次通过 schema、布局、HTML/SVG、路由与标签避让检查，只有全部通过才原子替换上一份可用产物，失败时返回结构化的修复回执。产物无需安装即可在浏览器打开，支持主题切换、聚焦、上下游追踪、路径探测与导出分享卡片。
Agent 依据描述或仓库内容生成 typed JSON IR；node bin/archify.mjs validate <mode> <file> --quality showcase --json 运行捆绑的校验与布局规则；preview 以仅回环地址的桌面模式监听单个 JSON 文件，只刷新通过全部检查的版本，失败时保留上一份已确认产物；deliver 在目标同目录渲染候选文件，校验通过后原子替换目标并可 --open 打开；guide 根据自然语言场景推荐图类型；compare architecture base.json head.json 生成带机器回执的 Architecture Delta 对比。渲染出的 HTML 提供 #focus=、#reach=、#route=、#lens= 等稳定链接状态，以及 PNG、WebP、JPG、Route/Reach Share Card 导出。
- 中级开发者在接手陌生仓库时，让 Agent 读代码并生成标注来源行号的高层运行时架构图
- 后端团队在排查缓存未命中或鉴权链路时，用序列图并高亮从 Web App 到 Postgres 的具体路径
- 做设计或 PR 评审的工程师用 Architecture Delta 对比改动前后的架构快照，得到可核对的差异回执
- 需要向非技术同事解释一个请求耗时构成时，用 Waterfall 或 Timeline 生成带说明的交互页面
- 需要把图表发给外部合作方时，直接发送自包含 HTML 或导出 1200×630 的路径分享卡片
如何安装或部署这个 Agent？
通过 skills CLI 全局安装（需 Node.js 环境）：
npx skills add tt-a1i/archify -g如需非交互的 Cursor 明确安装：
npx -y skills add tt-a1i/archify --skill archify --agent cursor --global --copy --yes不安装直接试用：
npx skills use tt-a1i/archify@archify --agent codexClaude.ai 用户可上传 archify.zip 至 Settings → Capabilities → Skills，但是否可用取决于沙箱内能否访问 Node.js。
如何使用这个 Agent？
安装后在对话中直接调用 Skill：
Use Archify to diagram a web request: Browser calls the API,
the API checks Redis, and a cache miss queries PostgreSQL and fills the cache.追加 add authentication 或 highlight the cache-miss path 迭代。若要在仓库内直接使用 CLI：
cd archify
node bin/archify.mjs doctor
node bin/archify.mjs guide "Show an API request with Redis cache miss"
node bin/archify.mjs validate workflow examples/agent-tool-call.workflow.json --quality showcase --json
node bin/archify.mjs deliver workflow examples/agent-tool-call.workflow.json /tmp/workflow.html --quality showcase --open --json设置语言与动效：
{
"meta": {
"locale": "zh-CN",
"animation": "trace",
"visual_preset": "signal-flow"
}
}这个 Agent 有哪些优点和局限？
- 交付链路是原子化的：schema、布局、路由、标签避让全部通过才替换旧文件，失败以稳定规则码和实测证据返回，不是一句“重试”
- 产物是单文件 HTML，无需安装即可打开，交互状态（聚焦、上下游、路径）随文件一起传播
- typed JSON IR 可复现、可 diff，配合
compare architecture能为设计评审提供带机器回执的前后快照 - 覆盖十种图类型，包括 3.1 新增的 ERD、Class、Tree、Timeline、Waterfall，而不是只画架构框线
- 支持 Claude Code、Codex CLI、Cursor、opencode 多个宿主，MIT 许可，源码与渲染器都在仓库内
- 明确不提供 Mermaid 自动解析、通用自动排版、托管分享与 WYSIWYG 编辑，习惯这些工作流的人需要改变方式
- 依赖 Agent 自行判断层级与连线，生成质量受宿主模型能力影响，仍需要人做视觉审阅
- 更新检查默认可选地发起网络请求，开源团队需要设置
ARCHIFY_UPDATE_CHECK_DISABLED=1才能完全禁网 - Claude.ai 与 Project Knowledge 的可用性取决于沙箱是否提供 Node.js，属于弱能力路径
- README 未给出 Windows 或非 Node 环境的替代运行方式，CLI 路径实际要求能执行 Node
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Archify 当前 | 77 · 表现良好 | — | ★ 87k | 今天 | JavaScript | Codex · Claude Code |
| 御舆：解码 Agent Harness | 63 · 存在缺口 | 网页应用免费 | ★ 4.3k | 5 天前 | Python | — |
| Claude-Codex 技能市场 | 54 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 582 | 3 天前 | Shell | Codex · Claude Code |
| AWS Agent Skills | 27 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 1.2k | 1 个月前 | Python | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示更新检查仅 GET 固定清单、不自动安装，可用 ARCHIFY_UPDATE_CHECK_DISABLED=1 关闭，且明确声明不上传版本/提示词/项目数据；deliver 采用候选文件+门禁通过后才替换目标，具备回滚式安全写入；测量文档声明无 fetch/sendBeacon/XHR 且仅存 sessionStorage。扣分点：安装依赖 npx skills add 与第三方 skills 工具链，权限边界未在仓库内说明；赞助商与第三方服务链接众多，外部效应与数据流向第三方未逐一披露；依赖安全仅见 package.json 少量 devDependencies 与 fast-uri override，未见审计或漏洞处置记录；发布者身份未验证，来源归属仅靠 README 自述。
CI 工作流结构完整（多 Node 版本矩阵、浏览器回归、Windows 可移植性、zip 新鲜度、发布清单校验），失败信息在 cookbook 中说明含 stage/diagnostics/supportedFixes 且非零退出码不得视为成功。扣分点：这些是静态配置，未执行验证；依赖可用性依赖 Node>=18 与 Chrome/Chromium 可选路径，未说明缺失时的降级行为；README 与 cookbook 对命令路径（archify/bin 与 bin）表述不完全一致，存在轻微自洽风险。
README 明确面向 Claude Code、Codex、Cursor、OpenCode 等多 Agent，提供十种图表类型、场景指南与无仓库起步方式，受众与场景覆盖充分；capability_boundaries 明确 deployment-ownership 失败即关闭、Delta 不推断影响/风险、inspect 仅支持 Architecture、visual-check 不批准视觉质量，边界清晰。扣分点：触发精度依赖自然语言提示，未见触发/不触发的判定规则或反例；环境适配要求 Node 18+ 与可选 Chrome，未给出无浏览器环境的完整替代路径。
信息架构清晰（README 分区、cookbook、schema 引用、多语言 README），安装说明详尽含非交互命令与更新检查细节，示例与 FAQ 丰富（11 个场景、Proof Lab、社区案例），MIT 许可证文件完整，CHANGELOG 与版本徽章 3.2.0 存在。扣分点：命名稳定性存在 bin 路径与包名 archify-repository 的不一致；known_limitations 分散在文档中而非集中列出；维护责任仅指向未验证的个人发布者与邮箱，无治理或维护者名单，故 maintenance_responsibility 低分。
输出为自包含 HTML，可离线打开、导出 PNG/WebP/JPG/PDF、分享卡片，输出可用性高；对需要图示的 Agent 用户有明确边际价值。扣分点：边际价值部分依赖 Agent 自身生成能力，README 中大量营销性声明（Trending 第一、13 万安装）无法从源码核实；成本收益方面需 Node 运行时与可选 Chrome，且图表质量依赖提示词，未给出量化对比。
claim_traceability 方面提供 SHA-256 回执、revision 固定、源码范围校验与编号引用，可追溯性较好；cross_source_corroboration 有 CI 配置、cookbook、测量文档相互印证。扣分点：README 的排名、安装量、媒体报道等外部声明仅链接第三方，仓库内无佐证；fact_inference_separation 表现良好，测量文档明确区分意图信号与激活/成功，Delta 不推断影响，故该项高分。
- 发布者身份未经 FollowAgents 验证，维护责任与更新路径仅由个人自述，企业采用前应独立核实。
- 安装依赖 npx skills add 与第三方 skills 工具链，仓库内未说明其权限范围与供应链风险。
- README 含大量赞助商与第三方服务链接及推荐码，可能带来外部数据流与商业激励，需自行评估。
- README 中的排名、安装量、媒体报道等声明无法从仓库源码核实，不应作为可靠性依据。
- 依赖安全仅见少量 devDependencies 与 fast-uri override，未见依赖审计或漏洞处置记录。
- 本评估为静态源码审阅，未执行任何命令或测试，CI 配置的有效性未经运行验证。
常见问题
Archify 自己会调用大模型吗？
生成失败会覆盖上一份好的图吗？
deliver 先在目标同目录渲染候选并检查，只有通过的产物才原子替换目标；preview 也只刷新通过全部检查的版本，失败时保留上一份已确认图。图里的时间线与耗时是真实数据吗？
它会联网或上传我的项目内容吗？
支持哪些 Agent 宿主？
npx skills add，并列出 Claude Code、Codex CLI、opencode、Claude.ai、Project Knowledge 的安装位置，以及 Hermes Agent 与 DeepSeek Harness 的社区可选集成。