ARTICLE · 1370776
又一个神级 Agent 插件,开源了!
现在每个人都可以用 Claude Code、Codex 等 Agent 工具,按自己的想法做出一个产品来。
可做出来之后,要是有人问一句,这个功能背后到底是怎么做出来,相信很多人都答不上。
因为代码全是 AI 写的,一般人都不会去阅读它,当然我们也可以直接去问 AI。
但每次的回答都是一段长长的文字,看着就头疼,而且问完就散,下次再遇到又得从头问一遍。
偶然在 GitHub 上发现一个名叫 Floorplan 的项目,正好能帮我们把项目看清搞懂。
把它装进 Agent 工具后,它能把我们用 AI 做出来的应用,画成一张看得懂的地图。

地图会在浏览器里打开,可以放大、缩小,先看看整个应用都有些什么。
想看哪一块,双击就能接着往里面看,从一块功能一直看到具体的文件,还有文件里的接口。
卡片上也没堆一堆技术名词,像收款这块,就写成「结账时收银行卡付款」,不用先搞懂 Stripe 是什么。
碰到技术词,鼠标停上去也有解释,懂行的朋友切一下开关,就能换回开发者视角。

光知道有哪几块还不够,块和块之间是怎么连起来的,才是我们最想知道的。
前端页面发出去的每个请求,它都会对上后端接手的那段代码,就算前后端分在两个仓库里,也能串到一张图上。
也可以反过来,从一个熟悉的页面出发,看它背后有哪些组件、发了哪些请求、用到了哪段服务端代码和数据,又调用了哪些外部服务。

还能在页面底部的对话框里,直接对着项目进行提问。
它会给出回答,并配一张只含相关部分的小地图,一步步讲清楚。
比如在一个咖啡订阅应用里,问它礼品订阅是怎么一路送到朋友邮箱里的。
从填表一路追到收件箱,跨了两个仓库,顺带还揪出了两个 Bug。

另外我觉得比较有用的,是它还能把应用里的一些问题找出来,也就是健康检查。
像代码里放着密钥,或者把密钥发到了浏览器里,这些比较容易出事的地方,它会帮我们找出来。
还有用 Supabase 存数据,表是不是谁都能读,Firebase 的权限规则有没有设好,这些也会一块检查。
收款如果用了 Stripe,会看付款通知能不能被伪造,另外还会找出那些不用登录就能调的接口。
发现了问题,点开旁边的修复提示,直接复制给 AI,让 AI 按照提示去改就可以。

平时让 AI 改代码,除了听它说自己改了什么,我们还可以直接去看地图。
最近动过的那些卡片,会变成绿色,卡片上还会解释一下,这个地方为什么要改,和我们说的需求有什么关系。
地图后面也可以接着更新,它只会去读改过的部分,用不着每次把整个项目再读一遍。

项目还没写也能用,把需求文档给它就可以先画张「蓝图」,看看要做出这个应用得有哪些东西。
地图画好还可以导出成一个网页文件,发给同事,对方用浏览器打开就能看。
看到这里,可能有朋友会想起之前介绍过的 Archify 和 Understand-Anything,它们也能把代码画成图。
这三个工具画出来的图有什么区别,可以看看下面这张对比图。

Floorplan 回答的是「我做的这个应用到底是怎么跑的,哪里需要担心」,是给用 AI 做应用、自己不读代码的人用的。
健康检查和最近改动这两个功能,也只有它有。
Archify 回答的是「怎么把它讲清楚」,架构图、时序图这些一共有十种图可以画。
就算不是代码,一段描述也能画出来,还能导出图片和视频。
Understand-Anything 回答的则是「这么大的代码库是怎么跑的」,一直细到每个函数,更适合开发者去啃一个陌生的大项目。
三个也能搭着用,先用 Floorplan 把整个应用画出来。
要给团队讲解项目时或者写技术文档的时候,再用 Archify 把其中一条流程单独画成图。
想要使用的话,在 Claude Code 里跑下面两行命令,把插件装上就行。
claude plugin marketplace add haydenschmitty/floorplanclaude plugin install floorplan@floorplan
Codex 则不用开终端,在插件页面添加 marketplace,填上 haydenschmitty/floorplan,找到 Floorplan 点一下加号就装好了。

装好后新开一个会话,打开自己的项目,跟它说一句「给这个应用画一张 floorplan 地图」。
等上几分钟,地图会自己在浏览器里打开,还带一段一分钟的导览。
之后若是应用新增了功能,说一句「更新一下 floorplan」就能更新原来的图。
想先看看效果的话,项目有提供一个在线演示 Demo,可以先在浏览器上打开试试。
写在最后
用 AI 做出来的东西,我觉得最先要看懂它的是自己,接下来是跟我们一起做事的人。
有了这张地图,自己想弄清哪一块,对着它问就行,AI 改了哪里也能一眼看到。
当要邀请朋友进来一起做时,把地图导出成一个网页,对方能快速了解项目,比问 AI 更省事。
一个人做也好,一群人做也好,项目一旦交给 AI 来写,先画一张地图再往下走,会踏实很多。
GitHub 项目地址:https://github.com/haydenschmitty/floorplan
今天的分享到此结束,感谢大家抽空阅读,我们下期再见,Respect!














































































