Archify开源架构图工具登GitHub热榜第一:一句话生成可验证架构图,支持Before/Delta/After三视图对比

会飞的荧 @feitu
Archify:一句话生成可验证架构图,GitHub热榜第一,专升本前端做的开源项目火了 8月底,一个叫Archify的开源项目冲上了GitHub Trending全球第一,单日涨星超过4000,一周内从1.5万星飙到3.8万星。作者在X上发帖说"一觉醒来我做的开源项目冲上了GitHubTrending全球第一",收获了大量开发者关注。 更让人意外的是作者背景——一位专升本前端开发者,基于已停更的Cocoon-AI项目做了完整重构,从零开始做出了这个工具。 【它解决什么问题】 接手一个陌生项目时,最耗时的往往不是写代码,而是搞清楚服务怎么调用、数据从哪来、改动会影响谁。传统画图工具画出来的图"看起来合理",但没法证明节点是否对应真实模块、箭头是否代表代码中存在的关系。 Archify的切入点不是画更好看的图,而是给AI生成的技术图加上工程化交付链。你说一句"分析这个代码仓库,生成一张高层运行时架构图",它输出的不是一张图片,而是一个可搜索、可追踪调用路径、可切换深浅主题的HTML文件。 【核心设计】 工作流分五步:Agent根据描述生成Typed JSON IR → 校验Schema、布局、路由、标签净空 → 可选桌面预览 → 通过门禁后原子替换目标文件 → 迭代阶段只改源文件,无关结构保持稳定。 中间格式选JSON而非YAML是刻意的——作者发现LLM生成YAML时"看着对、解析错"的比例很高,缩进敏感、行内坐标容易撞上引号陷阱。 【真正让它出圈的功能:Architecture Delta】 合并PR前,它可以把两份已校验的快照对比成Before/Delta/After三视图,精确标注新增、删除、语义变更、移动、重路由的节点与边。架构评审第一次有了"diff"——你不用再靠肉眼在两张图里找不同。 compare命令同时算字节哈希和语义哈希,只改缩进不会进diff,输出的是"新增1个组件、删除1条连线"这种精确变更。 【边界在哪】 校验通过≠事实正确。Archify验证的是"这张图自洽",不是"这张图等于线上"。如果Agent读代码时漏了一个服务、或者把一条链路理解错了,Archify只会把错误画得更整齐。所以正确用法是:让它先去仓库里找证据(支持节点回溯到特定commit的文件与行号),出图后仍要拿关键链路跟代码对一遍。 它不是测谎仪,是放大镜。 【安装方式】 npx skills add tt-a1i/archify -g,然后对你的Agent说"用archify梳理这个仓库的运行时架构"即可。支持Claude Code、Codex CLI、Cursor、OpenCode、Raven等主流Agent。 MIT协议,零运行时依赖。
341 浏览 0 评论 0 反应
登录 后参与评论
还没有评论,来抢沙发。
查看完整榜单
查看完整榜单
查看完整榜单