让智能体帮忙写完整套应用,跑起来没问题,可一旦被问「下单之后到底发生了什么」「改这张表会牵连哪里」,就只能一头扎进目录里翻文件。前后端分在两个仓库时更麻烦:前端发出去的请求,究竟落到哪个接口,靠肉眼对路径很容易对错。代码能跑,不等于人能看懂,这中间的落差往往在第一次交接或第一次线上故障时才暴露出来。

Floorplan 官网演示页,整张应用地图把前端、服务端与外部服务连成一张图
Floorplan 是 10 月 27 日新建的开源仓库,到 11 月 10 日有 3321 颗星,JavaScript 编写,采用 MIT 许可,当前版本 0.6.3。它不是一个独立软件,而是给命令行编码智能体用的插件:需要 Node.js 18 以上,装好之后在项目里说一句「给这个应用画张平面图」,几分钟后会得到一个本地网页地图。地图把应用拆成部件、文件、页面与接口,每一张卡片都用日常语言命名,比如「结账时收卡款」,而不是直接抛一个封装类名;从整库双击进去,能一路下钻到某个文件被谁调用、又依赖谁。扫描与布局由零依赖的脚本完成,命名和解释交给智能体,生成的地图连同本地服务都留在本机,不写进版本库。

总览视图,右侧列出 59 个文件、718 行与 22 个接口,改动过的卡片标成绿色
它把「连起来」这件事做得比画图更细。脚本会顺着导入关系找模块,把前端每个网络请求和负责应答的服务端接口对上,跨仓库也能对;从任意一张页面出发,能看到它背后的表单、请求、服务端代码、数据与外部服务。地图里可以直接提问,例如「一笔退款怎么回到顾客卡里」,回答会附一张只含相关卡片的小图与分步说明。另有两张很实用的看板:健康检查会指出写在代码里的密钥、任何人都能读的数据表、没有登录校验的接口,并给一段可直接使用的修复提示;最近改动会把刚被改过的卡片点亮,逐条注明为什么改。说明里特意写了,健康检查只是一次检查,不是完整审计。

从一张礼品页面下钻,表单、请求、服务端代码与外部服务逐层展开
第一,补的是「说人话」这一层。同类工具多半给开发者画调用图或知识图谱,节点名照抄代码;这里把部件名写成业务动作,悬停才展开技术细节,还能一键切回开发者视角。对不逐行读代码、却要负责这个应用的人来说,这一层比多一张架构图更有用。
第二,跨仓库的请求匹配是它真正难被替代的地方。说明页列了支持的框架与语言:TypeScript、JavaScript、Python、Go、Rust、Java、Kotlin、Scala 等十余种,以及常见的服务端路由与前端路由写法。前端仓库与后端仓库并排放在一个目录里,它会把两边都找出来并连上。代价也很清楚:命名依赖智能体,第一次生成小项目要几分钟、大项目更久,按你原有的调用额度计费;更新时只重读变化的部分,成本才降下来。
第三,边界得先看清。它要装在能跑命令的编码智能体里,不是双击就出窗口的软件;支持列表之外的框架和语言只能得到较粗的结果;地图里的问题会经过你自己的智能体账户去读代码,虽然地图本身是本地文件,但「谁来读」这件事并没有消失。想拿它替代代码评审或安全审计,会失望;想让一个新人在半小时内搞清整套应用怎么串起来,它给得挺足。

一张地图能回答的三类问题,以及项目的规模与许可信息
有个细节挺克制:它只在项目里新增一个自身忽略的目录,不改已有代码,也不碰版本忽略配置;地图可导出成单个网页文件发给别人看,离线也能打开。把「看得见」做成一个不会污染仓库的副产品,比塞进构建流程更容易被人长期用下去。
你接手一套自己没逐行读过的代码时,最想先弄清的是请求落到哪个接口、改动会牵连哪几个文件,还是哪些地方压根没做校验?