Archify

Archify 是智能体技能，把类型化 JSON IR 编译成架构、工作流、时序、数据流和生命周期图，输出一份 HTML。仓库 tt-a1i/archify 是 JavaScript，MIT，创建于 2026-04-15。2026-09-18 GitHub 显示 65,850 star、4,399 fork。项目页是 tt-a1i.github.io/archify。65,850 star 是热度信号，不是访问量。当天 README 写开发版 v2.17.0-dev.1。

智能体写 JSON。Archify 校验 schema、布局、路径和标签间隙，再原子替换上一份合格 HTML。它不是 Mermaid 主题，也不是绘图编辑器。若只要 Markdown 图，对照 Mermaid Visualizer；若要手绘草图，对照 Excalidraw Diagram。宿主包括 Claude Code、Codex CLI、Cursor 和 OpenCode。

安装：npx skills add tt-a1i/archify -g。不必有仓库，聊天里描述系统即可。

核心功能

• 五种图：架构、工作流、时序、数据流、生命周期。可选架构 deployment-ownership 在缺少 owner 或区域时失败关闭。
• 确定性 HTML/SVG：四种视觉预设、深/浅色、有限动画并尊重 prefers-reduced-motion。导出 PNG、SVG、WebM 和 1200x630 分享卡。
• Architecture Delta：两份校验快照做 Before / Delta / After，含新增、删除、变更、移动、改线。node archify/bin/archify.mjs compare ...
• 有根据的查看器：搜节点、沿作者写的上下游和精确路径追踪、比较角色、播放具名故事。不发明拓扑，也不声称运行时影响。
• 按需源码证据：架构节点可打开钉在某个公开 commit 的 Git 校验文件和行号。普通产物默认不带源码。
• Last-good 预览：可选本机 loopback 监视，全部门通过才刷新。

限制：自动解析 Mermaid、通用自动布局、托管分享、所见即所得编辑都不在范围内。Claude.ai 上传取决于沙箱里有没有 Node。可选更新检查会 GET 一份稳定 manifest（README 称只有 IP 和时间）；ARCHIFY_UPDATE_CHECK_DISABLED=1 可关。

适用场景

• 从仓库讲清运行时路径：8–12 个组件、一条主路径、信任边界。
• PR 架构评审：合并前看 Delta，但不声称合并安全。
• 缓存未命中或鉴权时序，必须忠实于作者写的调用。

只要 README 里一张 Mermaid 流程图，就不必上它。

定价方案

快速开始

1. npx skills add tt-a1i/archify -g
2. 聊天：Use Archify to draw: Browser -> API -> Redis cache -> PostgreSQL fallback.
3. 再改：add Redis、highlight the rollback path。
4. 对仓库：要 8–12 个核心组件和一条主路径，细节放卡片，不要加边。

第一手入口：项目页、SKILL.md、Proof Lab。

常见问题

这是 Mermaid 吗？

不是。类型化 JSON IR 加渲染器。刻意不做 Mermaid 解析。

查看器会发明多余的边吗？

README 写 focus、reach、routes、lenses、stories 都复用作者写的节点和关系。

没有智能体也能跑吗？

可以。克隆后 node archify/bin/archify.mjs validate|preview|deliver ...。DeepSeek Harness 插件写 Node ^22.19.0 || >=24.0.0；核心 CLI 以当前 README 为准。

替代方案

• Mermaid Visualizer：文本转 Mermaid，适合 Obsidian/GitHub。
• Excalidraw Diagram：手绘板，不是校验过的 IR。
• Claude Code：可加载 Archify 的宿主。
• OpenCode：agent switcher 里的另一个宿主。

使用技巧

1. 细节放卡片。多加边会把布局弄糟。
2. 用 validate --json / deliver --json，只应用 supportedFixes。
3. 不想要提醒 GET，就关掉更新检查。

总结

Archify 适合能拿去讲、还能信的图：类型化源、替换前门禁、一份 HTML。Mermaid 草图不够时用它。只要 README 流程图，留在 Mermaid。