Archify

概览

GitHub

Archify 是一个采用 MIT 许可证的开源 AI Agent 技能（Skill），用于将系统架构、业务流程或日常计划转化为可交互的图表。它支持 Claude Code、Codex、Cursor、OpenCode 和 GitHub Copilot 等 AI Agent。 ### 它是什么 Archify 的工作流程是：用户通过自然语言描述需求，AI Agent 将其转换为类型化 JSON，再由 Archify 渲染、校验并交付为独立的 HTML 文件。生成的图表零运行时依赖，无需服务器或构建工具，可在任意浏览器中直接打开。 ### 解决什么问题 传统的画图工具需要学习特定语法或进行繁琐的手动操作。Archify 允许用户用大白话描述步骤、角色、组成或状态，由 Agent 自动完成绘图。同时，它解决了图表交付与分享的问题——所有样式、脚本和数据都打包在一个 HTML 文件中，可直接作为邮件附件发送或贴在 PR 评论中。 ### 主要能力 - **多图表类型**：支持架构图、工作流、时序图、数据流、生命周期、实体关系图、类图、树图、时间线和瀑布图等十类图表。 - **对话式迭代**：生成图表后，可通过自然语言指令继续修改，例如「加一个 Redis」或「把截止日标红」。 - **双主题输出**：内置浅色与深色主题变量集，HTML 与 SVG 同步切换，自动跟随读者系统主题。 - **多格式导出**：在浏览器内原生渲染并导出 PNG、JPEG、WebP、SVG、WebM 动图，或直接复制到剪贴板。位图格式支持最高 4 倍分辨率导出。 - **路径检查与播放**：保留完整作者路径，支持逐站检查或沿入向关系播放有限旅程。 - **语义设计系统**：提供七种节点颜色，深浅主题下保持一致，图例名称可按业务场景自定义。 ### 输入方式 支持从自然语言描述、计划、已有 Mermaid 文本或代码库证据开始。需要注意的是，Archify 不承诺自动解析全部 Mermaid 语法。 ### 适合谁 适合需要通过 AI Agent 快速生成架构图、流程图或生活规划图的开发者与非技术人员。当前版本为 v3.1.0 稳定版。

Q&A

Archify 是什么？由 AI 生成

Archify 是一个开源 Agent Skill，把系统、流程或计划变成图表。Agent 编写类型化 JSON，再由 Archify 渲染、校验并交付独立的交互 HTML 成品。Skill 和渲染器采用 MIT 许可证。

可以提供哪些输入？由 AI 生成

可以从自然语言描述、计划、已有 Mermaid 文本或代码库证据开始，代码库并非必需。Agent 理解输入后创建 Archify JSON；Archify 不承诺自动解析全部 Mermaid 语法。缺失的事实应标明或进一步确认。

哪些 Agent 可以使用 Archify？由 AI 生成

安装示例覆盖 Claude Code、Codex、Cursor、OpenCode 和 GitHub Copilot，它们使用同一份 Archify Skill。Agent 的文件权限、本地 Node.js 运行时以及所选导出功能需要的工具，由你的使用环境提供。

会得到什么？有哪些边界？由 AI 生成

主要交付物是内含 SVG 的 HTML 文件和类型化 JSON 源。在浏览器里可以检查、搜索、追踪路径、切换主题和导出。校验检查的是编写出的图表，不证明系统的实际运行行为。Archify 不提供托管协作服务，也不是通用的所见即所得编辑器。

如何安装 Archify？由 AI 生成

可以通过命令行安装。例如全局安装命令为 `npx -y skills add tt-a1i/archify --skill archify --agent claude-code --global --copy --yes`，也可使用 `npx skills use` 临时试用。默认安装命令使用稳定版 main 源码。

支持导出哪些格式？由 AI 生成

导出格式包含 PNG、JPEG、WebP、SVG 和 WebM。具体可用性取决于格式、浏览器或本地工具；选择交付格式前，可先打开成品检查导出菜单。