ByteNoteByteNote
你的代码库长什么样,Claude 画张平面图给你看
字

字节笔记本

2026年11月6日 · 约 2 分钟读完

你的代码库长什么样,Claude 画张平面图给你看

API中转
¥120

vibe coding 三个月后再打开自己的项目,最常见的感受是「这是谁写的、为什么要这么写」。floorplan(MIT,3,019 星,10 天涨到 3,019)解决的就是这个:让 Claude 或 Codex 读你的代码库,画一张可交互的平面图,每个模块、文件与网络请求都有大白话名字,连接关系一目了然。

floorplan 仓库

分工设计聪明:脚本干机械活(找仓库、解析十几种语言、把网络请求匹配到接口、排版地图,纯 Node 零依赖),Claude 或 Codex 只负责起名和写描述。产出是一份 floorplan/index.html,浏览器打开即可;问一句「Update the floorplan」,只重读改动的部分,刚改过的地方在 Recent work 里高亮。地图自带 Ask 栏,可以直接问「下单时会发生什么」「哪里在跟 Stripe 打交道」「改了 users 表会坏什么」;健康检查把重要问题列出来,可直接让 agent 修;没有代码也能用——给它一份 PRD,它先画一张明确标为「计划」的蓝图。

安装三条命令:Claude Code 走插件市场加安装,Codex 加 marketplace 或两行终端命令,需要 Node.js 18 以上与已有订阅(不用 API key)。

对照着定位最清楚:同为「画图」,一句话描述技术栈出架构图的 skill 是「描述到画图」,floorplan 是「代码到地图」;和 spec-kit 的「开工前规格」相比,它画的是「开工后的现状图」。适用场景也就明白了:接手自己三个月前的项目、给新人 onboarding、改动前先看「改这里会坏什么」。两句话的期望管理:地图质量取决于模型对代码的理解,大仓库第一次生成要几分钟,不是秒出;它画的是现在长什么样,不是应该长什么样,健康检查提的问题仍要人来判断修不修。

相关文章

分享: