archify

让 AI 代理自动画出清晰可验证的架构图，告别手绘文档。

开源 free 开发框架

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 82980

维护状态活跃

是否开源是

定价模式 free

项目预览

项目数据

分类开发框架

开发团队tt-a1i

所属国家

官网地址https://archify.si

GitHubhttps://github.com/tt-a1i/archify

定价模式free

价格说明开源项目，免费使用，定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言JavaScript

技术栈/模型agent-skills,ai-agents,architecture-diagram,claude-code,claude-skills,codex,coding-agents,deepseek-harness,developer-tools,diagrams,diagrams-as-code,dsh-plugin,flowchart,llm,mermaid,opencode,sequence-diagram,software-architecture,system-design,visualization

GitHub 星标★ 82980

30天Star增速

HF 下载量

上线时间2026-04-15 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-30

浏览次数13

项目介绍

archify 是一个面向 AI 编程代理（如 Claude、Codex）的 Agent skill，用于生成美观且可验证的架构图、工作流图、时序图、数据流图和生命周期图。它解决的是开发者在 AI 辅助编码过程中，难以快速生成清晰、准确、可维护的架构文档的问题。其核心能力包括：通过自然语言描述自动生成自包含的 HTML 图表，支持动画效果和精准的 SVG/PNG 导出，确保图表与代码实现保持一致。它采用架构即代码的理念，让图表可版本化、可审查，并与 AI 代理的工作流无缝集成，从而提升团队协作效率和文档质量。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

可用的 Node.js 环境（需要能执行 npx）
已安装受支持的 AI 编程代理之一：Cursor、Claude Code、Codex CLI、opencode
DSH 社区集成需 Node ^22.19.0 || >=24.0.0，且面向开发者预览版 @deepseek-ai/dsh@0.1.0-rc.6
Claude.ai 上传方式依赖沙箱内是否具备 Node.js 访问权限

安装与启动步骤

1一键安装 skill

用 npx skills 全局安装 archify，安装后对应代理即可调用该 skill。
```
npx skills add tt-a1i/archify -g
```
2Cursor 非交互安装

需要显式指定代理与全局安装时使用这条命令，全程无需交互确认。
```
npx -y skills add tt-a1i/archify --skill archify --agent cursor --global --copy --yes
```
3免安装试用

不想先安装可直接试用，以 codex 代理运行 archify skill。
```
npx skills use tt-a1i/archify@archify --agent codex
```
4Raven 手动解压

Raven 不走 switcher，把 archify.zip 解压到 ~/.raven/workspace/skills，最终得到该目录下的 archify 文件夹。
5Claude.ai 手动上传

在 Settings → Capabilities → Skills 上传 archify.zip；也可把 zip 上传到 Project Knowledge 作为提示驱动的兜底方案。
6接入 DeepSeek Harness

社区可选集成，安装后可用自然语言让 archify 生成仓库运行时架构图。
```
dsh plugin --profile web add @tt-a1i/archify-dsh@0.1.0
```
7关闭更新检查

archify 可能会读取固定 manifest 显示更新提醒，设置该变量可禁用联网与提醒状态写入。
```
export ARCHIFY_UPDATE_CHECK_DISABLED=1
```

关键配置

配置项	必填	说明	示例
`ARCHIFY_UPDATE_CHECK_DISABLED`	否	设为 1 可完全禁用更新检查网络请求与提醒状态写入	`1`

如何确认成功

安装后在对应代理中确认 skill 已加载，向代理描述代码库或系统即可产出可验证的 HTML 架构图。

常见问题

Q：不安装可以试用吗？

A：可以。运行 npx skills use tt-a1i/archify@archify --agent codex，直接以 codex 代理试用 archify skill。

Q：支持哪些 AI 编程代理？

A：官方 switcher 覆盖 cursor、codex、claude-code、opencode；此外还有 Raven、Claude.ai、Project Knowledge、DeepSeek Harness 等安装方式。

Q：Claude.ai 上能正常渲染吗？

A：上传 archify.zip 到 Settings → Capabilities → Skills 即可，但能否完整渲染取决于沙箱是否允许访问 Node.js。

Q：archify 会自动更新自己吗？

A：不会。它只 GET 固定 stable manifest 用于显示可选提醒，从不下载或安装更新，是否升级由你决定。

Q：更新检查会泄露数据吗？

A：服务器只能看到常规 HTTP 元数据（IP 和时间），不会收到版本、Agent、项目数据、提示词、账号/设备 ID 或 ETag。

注意事项

更新检查成功后约 72 小时（±20%）再检查一次；失败会在 6 小时、24 小时后重试。
Archify 使用架构即代码思路：由代理生成带类型的 JSON IR，再确定性编译为 HTML/SVG，图表可版本化、可审查。
DeepSeek Harness 集成属社区集成，非 DeepSeek 官方产品，且不收集遥测。
输出为自包含 HTML，并支持 PNG、SVG、WebM 及 1200×630 分享卡片导出。

核心亮点

自包含 HTML 输出，无需额外依赖，打开即用，方便分享和嵌入。
支持动画和精准导出，图表生动且可直接用于文档或演示。
深度集成 Claude/Codex 等 AI 代理，自然语言即可生成专业图表。

不足之处

依赖 AI 代理环境，非 AI 场景下使用门槛较高。
文档/社区待观察

适用场景

AI 辅助开发中快速生成系统架构图
为代码库自动生成数据流和时序图用于技术文档
在团队协作中通过图表验证设计一致性

替代项目

Mermaid、PlantUML、Diagrams as Code (mingrammer)

上一篇：Open-WebUI-Functions

下一篇：chat-gun