Archify 免安装试用指南：一条命令生成可交互的 AI 架构图
项目地址: https://gitcode.com/GitHub_Trending/arch/archify Archify 是一个免费的 AI 架构图工具：一句自然语言丢给它，就能产出可交互、可校验的架构图、时序图和工作流图。想先看效果又懒得折腾环境？用 npx skills use 把它临时挂进当前会话就行——不装包、不写配置，会话结束一切照旧。
先看清两条路：临时挂载和常驻安装
Archify 以 Agent Skill（技能包）的形式交付，底层是一个零依赖的 Node.js 渲染与校验器，要求 Node ≥ 18。它给两条体验路径，差别只在技能包挂在哪：
| 路径 | 命令 | 适合谁 |
|---|---|---|
| 临时挂载 | npx skills use tt-a1i/archify@archify --agent codex | 只想看看效果，不想动全局环境 |
| 常驻安装 | npx skills add tt-a1i/archify -g | 确定要长期反复用 |
说白了，skills use 在运行时把技能包拉下来、只挂给当前会话，你不解压、不配目录，关掉终端就没有任何残留。注意一点：这条命令目前只支持 codex 和 claude-code 两个 Agent，用 Cursor 的话直接走常驻安装更省事。
动手：从一句话到一张图
跟 Agent 说什么
先在终端执行：
npx skills use tt-a1i/archify@archify --agent codex
进入对话后，把需求用大白话说出来就行。官方推荐这么写：
先分析当前仓库，再用 archify 出一张高层运行时架构图：
核心组件只留 8–12 个，突出一条主路径，外部依赖和信任边界单独标出来；
辅助信息写进说明卡片，别再往图上加连线。
不想画全局图，给一条调用链也成：比如让它画登录流程，浏览器 → Web App → API → JWT 校验 → Redis 查询 → PostgreSQL 回源。
中间发生了什么
你说的是自然语言，Archify 内部会先把它转成一份带类型的 JSON 中间表示，再确定性地编译成 HTML 和 SVG。换句话说，同一份描述每次编译结果都一样，图不是碰运气画出来的。
最后拿到什么
产出是一个自包含的单文件 HTML：样式、脚本、图形全打在一个文件里。双击就能在浏览器打开，转给同事，对方不装任何东西也能看。
生成的结果能做什么
- 右上角一键切换深浅主题
- 画布缩放、平移
- 节点搜索
- 按
R或点 PATH 按钮，探测任意两个节点之间的精确路径 - 导出 PNG、JPEG、WebP、SVG，外加一张 1200×630 的社交分享卡片，贴 README 或技术博客正合适
路径探针值得单独提一下：在一张缓存未命中的时序图里，Web App → API → Postgres 的完整路由被逐段高亮，请求走了哪条路一眼看清。
画之前：五种图型怎么挑
| 典型场景 | 对应类型 |
|---|---|
| 组件、服务、存储与信任边界 | Architecture |
| CI/CD、审批、工具调用、Runbook | Workflow |
| API 调用链、缓存回源、鉴权时序 | Sequence |
| 数据管线、血缘、下游消费者 | Data Flow |
| 状态机、重试、等待与终态 | Lifecycle |
拿不准就交给 Agent 自己判断。每种图型都有对应的 JSON Schema 和示例，仓库里的 archify/schemas/ 和 archify/examples/ 可以对照着学，中文写作手册在 docs/authoring-cookbook.zh-CN.md。
觉得值得留？一条命令转正
npx skills add tt-a1i/archify -g
装完跑两条自检，环境没问题、图能正常生成，就可以放心用：
node bin/archify.mjs doctor
node bin/archify.mjs demo /tmp/archify-demo
场景拿不准时，还有内置的场景指南：node bin/archify.mjs guide "展示 CI/CD 检查、审批、部署和回滚"。
图凭什么可信
Archify 追的是"对"而不是"漂亮"：每张图交付前都要过 Schema、布局、SVG 与线路净空等多重校验，哪道不过就返回一份结构化的修复回执，而不是塞给你一张"看起来挺像那么回事"的假图。这些门禁规则都写在 archify/SKILL.md 这份技能契约里。
所以建议很直接：先用临时模式拿自己的仓库跑一遍，跑顺了再决定要不要把它装进日常工具箱。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
