首页 / AI Trending / tt-a1i/archify

archify 是什么？

Archify 是 tt-a1i 维护的 agent skill：让编码代理根据描述或仓库证据生成带类型约束的 JSON 图数据，再编译成可交互、可离线打开的单文件 HTML。它覆盖架构、工作流、时序、数据流和生命周期五类图。

⭐ 82,314 Stars 🍴 5,553 Forks JavaScript MIT 作者: tt-a1i
来源：github.com/tt-a1i/archify/blob/main/README_EN.md 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

旧稿仍停在 v2.6.0，并把 Archify 写成 Claude 专属工具；当前稳定版已到 v2.16.0，也支持 Cursor、Codex、Claude Code 和 OpenCode，因此需要重写。

来源：github.com/tt-a1i/archify/releases/tag/v2.16.0

核心功能

类型化图数据

代理先写 architecture、workflow、sequence、data-flow 或 lifecycle 对应的 JSON；schema 与验证器检查节点、边、路径和版面约束，再生成 HTML。

来源：github.com/tt-a1i/archify/blob/main/README_EN.md
验证后交付

validate 用于检查源数据，preview 生成候选预览；deliver 只在检查通过后原子替换目标文件，并可输出机器可读 receipt。

来源：github.com/tt-a1i/archify/blob/main/README_EN.md
交互式单文件输出

生成的 HTML 可切换明暗主题、搜索节点、追踪路径与上下游关系，并导出 PNG、SVG、WebM 或分享卡片。

来源：github.com/tt-a1i/archify/blob/main/README_EN.md
架构变更对比

Architecture Delta 对比经过验证的 Before、Delta、After 三组已写入事实；它不会自行推断运行时影响、风险或合并安全性。

来源：github.com/tt-a1i/archify/blob/main/README_EN.md

技术架构

Archify 的输入不是图片，而是代理生成的类型化 JSON 中间表示。仓库内的 schema、验证规则与布局约束先检查这份数据，渲染器再写出自包含 HTML/SVG。代理负责选择节点与布局；验证器只核对已写入图中的事实和约束，不连接线上基础设施，也不判断代码变更是否安全。

来源：github.com/tt-a1i/archify/blob/main/README_EN.md

项目知识图谱

知识图谱：项目核心节点（中心）+ 核心功能（内环六边形）+ 关键技术依赖（外环 chip） Node.js 与 npx，用于 skills 安装和仓库内 CLINode.js 与 npx… 受支持的 AI 编码代理受支持的 AI 编… 可选的源码仓库上下文；仅凭描述作图时不需要仓库可选的源码仓库上… 类型化图数据 验证后交付 交互式单文件输出 架构变更对比 archify 项目本体 核心功能 关键依赖

技术栈

语言JavaScript、HTML、CSS 与 JSON schema框架面向 Cursor、Codex、Claude Code、OpenCode 等宿主的 Agent Skill
关键依赖
Node.js 与 npx，用于 skills 安装和仓库内 CLI受支持的 AI 编码代理可选的源码仓库上下文；仅凭描述作图时不需要仓库
基础设施 / 部署
生成结果是自包含 HTML；稳定更新检查只请求固定 manifest，可用 ARCHIFY_UPDATE_CHECK_DISABLED=1 关闭
来源：github.com/tt-a1i/archify/blob/main/README_EN.md

快速上手

全局安装运行 npx skills add tt-a1i/archify -g；不安装试用可运行 npx skills use tt-a1i/archify@archify --agent codex。随后让代理用 Archify 画一条明确链路，例如 Browser → API → Redis → PostgreSQL。若从源码仓库操作，可依次用 doctor 检查环境、validate 检查 JSON、preview 生成候选、deliver 交付通过验证的 HTML。
来源：github.com/tt-a1i/archify/blob/main/README_EN.md

使用场景

适合把系统组件、CI/CD 审批、API 调用、数据血缘或重试状态整理成可审查的交互图。第一次应限制在 8 到 12 个核心组件和一条主路径，核对节点与连线后再补边界、异常和说明卡片；复杂仓库若没有可靠证据，不应让代理凭名称补全架构。

来源：github.com/tt-a1i/archify/blob/main/README_EN.md

优势与局限

优势

  • 五类图各有 schema 和验证规则
  • 产物为可离线分享的单文件 HTML
  • validate、preview、deliver 把草稿与正式交付分开
  • 更新检查不上传版本、代理、项目、提示词或设备标识

局限

  • 不自动解析 Mermaid
  • 不是通用自动布局器，布局仍由代理写入
  • 没有托管分享或所见即所得编辑器
  • 验证器不查看真实基础设施，也不推断变更影响或合并安全性
来源：github.com/tt-a1i/archify/blob/main/README_EN.md

最新版本

截至 2026-09-23，最新稳定版是 v2.16.0，发布于 2026-08-30。该版本包含 constraint-driven Workflow Compiler、schema v2 readable-v2、带 layout JSON 的验证 receipt、schema 迁移命令与有限的查看器本地化；main 分支已进入 v2.17.0-dev.1 开发。

来源：github.com/tt-a1i/archify/releases/tag/v2.16.0

实测与证据

status: docs-only  |  checked_at: 2026-09-23  |  environment: 只核对 tt-a1i/archify 官方 README、CHANGELOG 与 GitHub Releases  |  limitations: 未执行 npx 安装，未运行 doctor、demo、validate、preview 或 deliver，也未实际生成或导出图表  |  observed_output: 官方最新稳定版为 v2.16.0，发布于 2026-08-30；main README 标出的 v2.17.0-dev.1 是当前开发版本，不应当作稳定安装版本

来源：github.com/tt-a1i/archify/releases/tag/v2.16.0

同类项目对比

Mermaid 用接近 Markdown 的文本语法在文档中渲染 20 多类图，适合手写、版本控制和 GitHub 原生展示。Archify 面向代理生成的类型化 JSON，并把验证、交互式查看器和验证后交付放在同一流程；需要简短、广泛兼容的图表源码时优先 Mermaid，需要检查节点关系并交付单文件交互图时再考虑 Archify。

来源：github.com/mermaid-js/mermaid

总结评价

Archify 更适合需要把代理产图纳入验证和交付流程的团队。先从小图开始，保留 JSON 源文件并核对每条边；若目标只是 README 里的一张简单图，Mermaid 通常更省步骤。

来源：github.com/tt-a1i/archify/blob/main/README_EN.md

常见问题

Archify 现在应该使用 2.16.0 还是 2.17.0-dev.1？

2.16.0 是截至 2026-09-23 的最新稳定 release；2.17.0-dev.1 是 main 分支开发版本。

使用 Archify 必须先打开代码仓库吗？

不必。仅凭描述也能生成图；涉及真实系统时，应打开仓库并要求代理引用源码证据。

Archify 能把现有 Mermaid 图自动导入吗？

不能。官方明确把 automatic Mermaid parsing 列为当前不支持的能力，需要重建成类型化 JSON。

Archify 的更新检查会上传项目或提示词吗？

官方说明不会上传项目数据或提示词。可设置 ARCHIFY_UPDATE_CHECK_DISABLED=1 关闭检查。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新，请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料：README、GitHub API、依赖文件