从一个真实任务开始：把登录流程画清楚
假设你手上有一个登录流程：浏览器请求 Web App，Web App 调 API，API 做 JWT 校验，再查 Redis 会话，Redis 没命中时回落到 PostgreSQL。普通人用画图工具能画，但很容易越画越乱；用 Mermaid 之类文本画图也能做，但交互和视觉完成度有限。
Archify 推荐的使用方式不是先打开画布拖来拖去，而是先把任务边界说清楚。比如告诉智能体：这是登录流程，主路径是什么，哪些路径是次要的，组件数量不要太多，缓存未命中只作为辅助路径出现。
我的判断是，Archify 更适合“先讲清楚结构，再生成一张能展示的图”。如果你还没有想清楚系统边界，只是想边拖边试，它未必是最快的入口。
输入是什么，输出又是什么
Archify 的输入可以是系统描述，也可以是一个代码仓库。项目说明里明确提到，它可以让智能体从 description 或 repository 生成图，这对不会画图的人很关键：你不必先掌握专业绘图语法，而是用自然语言描述你想表达的系统。
输出不是一张死图，而是一个自包含 HTML。这个说法很重要，因为它意味着你可以把生成结果作为文件打开、演示和分享，不一定依赖某个在线服务一直存在。官方还写到可以导出 PNG、SVG、WebM 和 1200×630 分享卡。
- 输入素材：系统说明、流程描述、代码仓库都在官方描述范围内。
- 中间结构：它会生成 typed JSON IR，也就是一种带结构约束的图表数据。
- 最终结果：自包含 HTML，并支持静态图片、矢量图、WebM 和分享卡导出。
- 可控重点：你可以要求高层架构、某条主路径、外部依赖、信任边界，避免一股脑把所有细节塞进图里。
可画的图不只一种：先选对图型
Archify 目前主打五类技术图：Architecture、Workflow、Sequence、Data Flow、Lifecycle。它们不是换个皮肤那么简单，而是分别适合不同问题。比如架构图回答“系统由哪些部分组成”，时序图回答“一次调用按什么顺序发生”。
对普通读者来说，可以这样理解：如果你要向别人解释一个产品后端怎么分层，用 Architecture；如果你要讲审批、CI/CD、工具调用，用 Workflow；如果你要讲 API 请求、缓存回退、鉴权链路，用 Sequence；如果你关心数据从哪来到哪去，用 Data Flow；如果你要描述任务状态、重试、等待和终止，用 Lifecycle。
| 图类型 | 适合解释的问题 | 对使用者意味着什么 |
|---|---|---|
| Architecture | 组件、服务、存储、边界 | 适合做系统总览，不用陷进每一次调用细节 |
| Workflow | 流程、审批、工具调用、运行手册 | 适合讲“谁先做什么，失败后怎么办” |
| Sequence | API 调用、缓存回退、认证流程 | 适合把一次请求按时间顺序讲清楚 |
| Data Flow | 数据源、转换、存储、消费者 | 适合检查数据流向、敏感数据边界和上下游关系 |
| Lifecycle | 状态、事件、重试、取消和终止 | 适合讲任务、会话、订单这类状态变化 |
交互能力：不是只能看，还能顺着关系查
Archify 值得看的地方在交互。它支持搜索节点、检查关系、追踪已写入的路径、比较语义角色，还能播放 guided story。对非开发者来说，这些词可能有点抽象，可以理解成：你不只是看一张复杂图，而是能顺着图里的线索一步步问问题。
比如一张生产架构图里，你可以聚焦到某个服务，查看它和数据库的关系；也可以查从 Web App 到 Postgres 的路径。项目说明强调这些交互基于已经写入的节点和关系，不会临时编造拓扑，这点对技术沟通很重要。
- 搜索节点：图很大时，不用靠眼睛满屏找某个组件。
- 路径探查：适合回答“这个请求从哪里走到哪里”。
- 角色比较：可以比较后端、数据库等语义角色之间的真实流量关系。
- 演示模式：适合会议里按章节讲，而不是让观众自己在大图里迷路。
画风和导出：更偏“拿去讲”的成品感
这是绘图工具，所以画风和导出不能略过。Archify 提供三种视觉预设，并支持深色和浅色主题。官方资料里还提到 motion 是可选且有限的，不会默认把每张图都做成一直动的动画。
导出方面，资料里明确有 PNG、SVG、WebM 和 1200×630 share cards。对日常工作来说，PNG 适合塞进文档，SVG 适合保持清晰，WebM 适合展示动态过程，1200×630 分享卡则适合 README、发布说明或社交预览图。
| 项目 | 已核实信息 | 使用时怎么理解 |
|---|---|---|
| 视觉预设 | 官方写到 five technical diagram types, three visual presets | 不是只有一种固定风格，可以按展示场景换外观 |
| 主题 | 支持 dark/light themes | 适合深色演示屏，也适合浅色文档 |
| 导出 | 支持 PNG、SVG、WebM、1200×630 share cards | 能覆盖文档、演示、分享等常见用途 |
| 许可证 | MIT | 代码层面是 MIT 许可；具体业务素材和生成内容的合规使用仍要看你的输入来源 |
| 价格 | 官方未披露 | 资料里没有看到收费方案，不能据此断言所有使用场景都永久免费 |
安装和工作流：需要智能体环境，不是网页登录即用
Archify 的上手门槛主要在安装环境。官方给出的快速安装命令是 npx skills add tt-a1i/archify -g，并说明它面向 Claude、Codex CLI 和 opencode。也就是说，它不是那种打开网页、上传文件、点按钮就生成的消费级工具。
如果让我自己现在上手，我会先从一个很小的目标开始：只让它画 8 到 12 个核心组件，要求一个主路径和少量外部依赖。这样更容易判断它是否理解了系统，而不是一开始就要求它“把整个项目都画出来”。
- 适合的人：需要解释软件架构的开发者、技术负责人、解决方案顾问、写技术文档的人。
- 也适合：想把复杂流程讲给非工程同事的人，尤其是登录、支付、审批、部署、数据管道这类流程。
- 不太适合：只想画海报、插画、社交媒体配图，或者完全不想碰命令行和智能体工具的人。
限制要先说清：它不是万能画板，也不是 Mermaid 皮肤
官方资料直接说明，Archify 不是 general-purpose drawing editor，也不是 Mermaid theme。这句话很实在：它的目标不是替代 Figma、draw.io 或各种白板工具，而是把技术意图变成可沟通的图表成品。
还有一些范围需要注意。资料里写明，Automatic Mermaid parsing、general-purpose auto-layout、hosted sharing、WYSIWYG editing 都不在当前范围内。也就是说，如果你的预期是“丢一段 Mermaid 自动美化”“网页托管分享”“像设计软件一样拖拽编辑”，那现在公开信息并不支持这种期待。
版权和商用方面，目前能确认的是项目采用 MIT License。至于你用它生成的具体图里包含哪些代码结构、业务名称或内部信息，是否可以公开发布，要由你的输入内容和公司规则决定，不能只因为工具开源就默认所有输出都适合公开。
尝试优先级：适合把复杂系统讲清楚的人先看
Archify 的推荐优先级，我会给到“有明确技术沟通任务的人优先尝试”。它不是最轻的画图入口，但它解决的是更具体的问题：把仓库、系统说明或流程描述，变成可以检查、演示、导出的架构图和流程图。
如果你只是偶尔画一张简单框图，用普通画图工具可能更快；如果你经常面对“系统太复杂，别人听不懂，图又不好维护”的问题，Archify 值得放进候选工具里认真看一遍。尤其是它把 typed source、验证、交互和导出放在一起，这比单纯生成一张漂亮截图更接近实际工作需要。
AIPG AI导航专注于收录和解读 AI 工具、AI 网站与智能体资源。
