tt-a1i/archify

解决的问题

Archify 将技术描述或现有代码库转换为交互式、精美的系统图。它解决了静态、通用的图表缺乏精确性、验证能力，以及无法追踪复杂系统中组件间实际关系的问题。

工作原理

Archify 是一个为 AI 代理（如 Cursor、Claude Code 和 Codex CLI）设计的渲染和验证系统。其流程如下：

1. 生成：AI 代理基于系统描述生成带有类型的 JSON 中间表示（IR）。
2. 验证：系统运行内置的验证器和布局规则，确保 JSON 源正确且布局具有确定性。
3. 预览/交付：将验证后的 JSON 编译为自包含的 HTML/SVG 文件。该文件包含一个交互式查看器，允许用户探索地图、追踪路径并播放引导式故事。
4. 迭代：代理可在保持结构稳定性的前提下，通过更新 JSON 源来优化图表。

适用人群

需要使用 AI 辅助工具传达系统设计、在合并前审查架构变更，或为新团队成员文档化代码库的软件架构师、开发者和技术负责人。

核心亮点

• 五种图类型：支持架构图、工作流图、序列图、数据流图和生命周期图。
• 确定性渲染：使用带类型的 JSON IR，确保可复现且一致的布局，而非通用的自动布局。
• 架构差分：可对比两个验证后的快照，精确查看系统架构中新增、删除或移动的内容。
• 交互式探索：支持搜索节点、追踪上下游可达性、探测特定有向路径等功能。
• 可移植输出：生成单一 HTML 文件，可导出为 PNG、SVG、WebM 或分享卡片用于文档。
• 源码锚定：在请求时，可将架构节点链接到 Git 验证过的文件和行范围。