tt-a1i/archify

面向 AI 编程代理的架构图生成与校验技能,产出可验证的技术图。

面向 AI 编程代理的架构图生成与校验技能,产出可验证的技术图。

产品定位

Archify 的定位是把技术意图转化为可沟通、可验证的产物,而不是通用绘图编辑器或 Mermaid 主题:Mermaid 自动解析、通用自动布局、托管分享和 WYSIWYG 编辑均明确在范围之外。选型时需注意,Architecture Delta 只呈现新增、删除、变更、移动和改线等具体事实,不推断影响、风险或合并安全性。项目本地运行,更新检查仅获取固定清单用于可选提醒,可用 ARCHIFY_UPDATE_CHECK_DISABLED=1 禁用联网。

适合用户

  • 使用 Cursor / Claude Code / Codex CLI / OpenCode 的开发者
  • 需要进行架构评审与 PR 审查的工程团队
  • 关注 diagrams-as-code 与系统设计的工程师

功能亮点

  • 五类技术图生成

    从代码库或系统描述生成 Architecture、Workflow、Sequence、Data Flow、Lifecycle 五种图,含四种预设、明暗主题与有限动效。

  • 架构变更对比

    Architecture Delta 以 Before / Delta / After 对比两个已校验快照,列出精确的新增、删除、变更、移动与改线事实。

  • 多格式导出

    导出自包含 HTML 及 PNG、SVG、WebM,并可生成 1200×630 的分享卡片。

  • 校验与 CLI 工具链

    CLI 提供 doctor、demo、guide、validate、preview、deliver 命令;交付前执行 schema、布局、HTML/SVG、路由及标签与路由间距校验,全部通过后才替换上一次有效产物。

使用步骤

从描述生成图

  1. 在任意 Agent 对话中描述系统(无需仓库)
  2. Agent 生成 typed JSON IR
  3. Archify 校验并编译为自包含 HTML
  4. 在对话中继续细化(如 add Redis、highlight the rollback path)

从仓库生成架构图

  1. 打开仓库并要求 Agent 分析
  2. Agent 使用 archify 生成高层运行时架构图
  3. 可选生成带 Git 校验源码证据(SRC n)的节点

架构变更评审

  1. 生成基线快照 base.
  2. 生成变更后快照 head.
  3. 运行 compare 命令产出 Architecture Delta HTML

适用场景

系统架构沟通

开发者与工程团队

把代码库或系统描述转化为可交互、可分享的架构图,用于团队沟通与文档。

合并前架构变更审查

工程团队

用 Architecture Delta 对比合并前后的已校验快照,审查具体变更事实。

调用链与数据流说明

后端与平台工程师

用 Sequence 与 Data Flow 图解释 API 调用、缓存回退、数据血缘与敏感边界。

访问与价格

可用状态: 当前可用

价格信息: 开源

支持平台: 自托管

价格说明: MIT 开源许可证,可自由使用、修改和分发,无付费条件。

官方入口

常见问题

使用 Archify 需要一个代码仓库吗?

不需要。可以直接在任意 Agent 对话中描述系统来生成图;打开仓库则可获得源码证据支持的节点。

如何安装 Archify?

运行 `npx skills add tt-a1i/archify -g`,或免安装试用 `npx skills use tt-a1i/archify@archify --agent codex`;也支持 Claude Code、opencode、Raven 等多种安装面。

Archify 是免费开源的吗?

是。项目采用 MIT 许可证,可自由使用、修改和分发。

Archify 能解析 Mermaid 或做通用自动布局吗?

不能。Mermaid 自动解析、通用自动布局、托管分享和 WYSIWYG 编辑明确在当前范围之外;它是把技术意图转化为沟通产物的工具。

Archify 会自动下载更新或上传数据吗?

不会。更新检查仅获取固定稳定清单用于可选提醒,从不下载或安装更新,服务器只见普通 HTTP 元数据;可用 ARCHIFY_UPDATE_CHECK_DISABLED=1 完全禁用联网。

来源核验

资料核验于 2026-09-05