新项目代码看不懂？floorplan：3,249 星，让 Claude 画一张大白话代码地图

GitHub 仓库

haydenschmitty/floorplan

总 Stars

★ 3,249

主要语言

JavaScript

查看 GitHub 项目

结论先说：接手新项目先画一张地图，这个习惯能省很多时间。floorplan 能让 Claude 或 Codex 给你的代码库画一张交互式的大白话地图：应用是怎么拼起来的，一眼看明白。3,249 星，JavaScript，MIT，2026 年 10 月 27 日创建，11 月 2 日仍在推送。编辑精选。

它是什么

一个代码库可视化插件：用 Claude 或 Codex 读代码，输出一张交互式架构图，配大白话说明，定位是接手新项目的第一步。

能干嘛

快速摸清陌生项目：模块怎么分、数据怎么流、入口在哪儿，先看地图再读代码，比直接跳进源码省时间，新人入职也可以拿它当第一份材料。

适合谁

刚接手别人项目的人、带新人入职的技术负责人、代码库越来越大自己都快记不清的团队。

注意点

11 月 2 日之后没再推送，早期项目，后续更新以实时状态为准；地图是辅助读代码的，不能替代读关键模块，开放 issue 59 个。

地图画出来准吗？

大结构一般没问题，细节可能有出入。正确用法是拿地图当导航：先看全貌，再按图索骥去读关键模块，别把地图当成文档来背。

站长点评：每个人都经历过对着陌生代码库发呆的下午。一张大白话地图解决不了所有问题，但能让你少发呆一小时，这就值了。