tt-a1i/archify
# 技术雷达学习卡：Archify
一、一句话定位
Archify 是一个 Node.js 渲染与验证系统，能将代码库或自然语言描述转化为交互式系统地图（HTML/SVG），嵌入 Cursor、Claude Code、Codex CLI 等 AI 编码助手，实现“聊天即出图”。
二、核心技术/架构亮点
- 类型化 JSON IR + 确定性编译：Agent 生成结构化中间表示，系统编译为自包含 HTML/SVG，无运行时歧义。
- 五种图表类型：架构图、工作流、时序图、数据流图、生命周期图，配合四种预设主题和深色/浅色切换。
- 架构变更对比：支持“Before / Delta / After”三视图对比，精确标注新增、删除、移动、重路由等变更。
- 交互式导航：节点搜索、上下游路由追踪、角色镜头、引导故事，无需假想拓扑。
- 一键导出：自包含 HTML、PNG、SVG、WebM 及 1200×630 分享卡片，适合 README/幻灯片/社交传播。
三、适用场景与目标用户
- 场景：架构设计讨论、代码审查前的架构对比、技术文档生成、演示汇报。
- 目标用户：使用 AI 编码助手（Cursor/Codex/Claude Code）的开发者、架构师、技术负责人；希望快速可视化系统且无需手动绘图的人群。
四、可动手动作
1. 安装：`npx skills add tt-a1i/archify -g`
2. 立即尝试：在聊天中输入 “Archify: Browser → API → Redis → PostgreSQL”
3. 分析真实仓库：`npx skills use tt-a1i/archify@archify --agent codex`，然后输入 “Analyze this repository and create a high-level architecture diagram”
4. 借鉴思路：学习其类型化 JSON 中间表示 + 确定性编译设计，可用于构建自有的代码可视化或文档生成管线。
五、学习优先级
P1（排期）
理由：工具成熟（v2.17.0-dev.1，MIT 协议，有生产案例），安装简单，能显著提升架构沟通效率；但需要 Node.js 环境和 AI 助手基础，建议本周抽 30 分钟安装并生成一个简单示例。⌂