Archify

Archify 是一个面向 AI Coding Agent（如 Cursor、Claude Code、Codex CLI 等）的开源 Agent Skill。它能将代码库或自然语言描述，直接编译并生成漂亮、可验证且带动态交互的架构与流程图。

1. 平台介绍

1. 定位明确：并非普通的绘图工具或可视化拖拽软件，而是专为 AI Agent 设计的架构图/流程图 渲染与验证引擎。
2. 工作机制独特：AI Agent 负责生成类型安全的 JSON IR（中间表示），Archify 则负责严格的布局计算与校验，将其编译为独立的 HTML/SVG。
3. 特色效果显著：生成的 HTML 自带单文件离线交互能力，支持 暗黑/亮色主题切换、线路追踪（Route Probe）、上下游影响分析、finite 动画播放以及一键导出高分辨率 PNG/SVG/WebM 等。

2. 主要功能

1. 5 种核心图表类型：
2. Architecture（架构图）：展示系统组件、服务、存储、部署边界与信任域。
3. Workflow（工作流图）：展示 CI/CD、工具调用、审批流及分支异常处理。
4. Sequence（时序图）：展示 API 交互、缓存回退、异步消息传递等时间序列。
5. Data Flow（数据流图）：展示数据管道、数据源/转换/存储及 PII 敏感边界。
6. Lifecycle（生命周期图）：展示状态机、重试逻辑、等待状态及最终状态。
7. Architecture Delta（变更对比）：支持对比两个版本，高亮显示组件和关系的新增、删除、移动与重定向（Before / Delta / After）。
8. 强校验与自动修补：包含自动布局、重叠检测与语义校验。如果 JSON 生成有误，Archify 会输出具名的错误代码与精确的修补指令（Repair Receipt），供 Agent 自动修复。
9. 高质量单文件输出：无需依赖外部 CSS/JS 库，直接打包为单一 HTML，支持导出社交/文档分享卡片格式（如 1200×630）。

3. 适用人群

1. 软件架构师 / 全栈开发者：快速梳理现有代码库架构、绘制 API 时序图 或系统数据流。
2. 重度 AI Agent 用户：使用 Cursor、Claude Code 等工具写代码，希望 Agent 在 Chat 界面中直接生成高质量可交互架构图。
3. 开源项目维护者 / 技术文档撰写者：需要为 README、release note 或 PR 审查 提供统一风格且精确的架构展示图。

4. 免费/付费情况

1. 免费模式：完全免费且开源（开源许可证为 MIT License）。开发者可以自由下载、修改和商业化使用，无需支付任何费用。
2. 付费方案：项目无任何付费/订阅方案（官方仓库没有付费页面）。

5. 如何使用

第一步：安装 Skill

在你的终端运行 npx 命令，直接将 Archify 作为全局 Skill 添加到对应的 Agent 中：

bash

# 通用安装
npx skills add tt-a1i/archify -g

# 如果使用 Cursor，可以使用非交互式安装命令：
npx -y skills add tt-a1i/archify --skill archify --agent cursor --global --copy --yes

第二步：在 Agent 对话中发起请求

安装完成后，在 Agent（Cursor / Claude Code 等）对话框里直接描述需求或分析代码：

• 零代码库生成：

"Use Archify to draw: Browser -> API -> Redis cache -> PostgreSQL fallback."

• 结合代码库分析：

"分析当前项目代码库，使用 archify 生成一个高层级运行时架构图，包含核心组件、主要链路和外部依赖。"

第三步：迭代与调整

生成的 HTML 会保存在本地，你可以直接在对话中通过自然语言微调，例如：

• "加上 Redis 缓存节点"
• "把 Auth 服务移到左侧"
• "高亮回滚路径"

6. 注意事项

1. 不是拖拽画板：它不提供 WYSIWYG（所见即所得） 的拖拽前端，也不支持直接解析 Mermaid 语法；它是为 AI Agent 输出“确定性与验证性图表”而设计的。
2. 控制节点数量：为了保证图形的可读性，建议单张图的核心节点控制在 8–12 个，较次要的上下文细节可通过 Card（卡片） 展开，而非一股脑连线。
3. 隐私与网络：Archify 生成过程完全在本地（Node.js）进行，不上传你的代码或 Prompt。默认只会每隔 72 小时 发起一次简单的 Stable Manifest GET 请求（用于检测更新），不会上传任何版本、Agent 或项目数据。
4. 禁用网络更新：若想完全禁用网络，设置环境变量即可：
5. bash

ARCHIFY_UPDATE_CHECK_DISABLED=1