haydenschmitty GitHub avatar

floorplan

JavaScript
代码库架构地图haydenschmitty最近推送 2026年11月17日
AI 开发工具MIT4,73338932 issues7 天 +1,279

AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月17日

让 Claude 或 Codex 读取代码库,生成可交互的纯英文应用结构地图。

Floorplan 是一个 Claude Code / Codex 插件,用 AI 读取你的代码库,把每个部分、文件和网络请求用平实英文命名,并画出它们之间的连接。它面向用 AI 构建应用但不读代码的人,帮助理解应用如何运作、改动会影响什么。

推荐指数

4.0

适合 AI 辅助开发者的代码库可视化工具,能快速看懂应用结构并发现常见安全问题。

近 7 天

+1,279

新增 Star

总 Star 排名

#1309

雷达追踪的 3,931 个 AI 仓库中

创建于

2026

2026年10月27日

核心亮点

  • 1多层级地图

    从整个应用下钻到部件、文件组、文件和端点,每层显示依赖关系。

  • 2平实英文命名

    用业务语言描述功能,技术术语悬停解释,可切换开发者视图。

  • 3跨仓库连接

    跟随 import,并把前端请求匹配到后端端点,支持跨仓库。

  • 4健康检查

    检测硬编码密钥、开放数据库表、可伪造的 webhook 等常见问题。

  • 5最近改动

    高亮 AI 刚改动的卡片,并说明改动如何服务于你的需求。

适用场景

  • 理解 AI 生成的应用

    例如:用 AI 做了一个咖啡订阅应用,想知道结账时发生了什么,直接问地图。

  • 团队新人上手

    例如:新成员从首页开始,逐层查看页面背后的部件、请求和服务端代码。

  • 检查 AI 改动影响

    例如:每次 Claude 改完代码,查看哪些部分被点亮以及改动原因。

  • 排查安全隐患

    例如:运行健康检查,发现 Stripe webhook 可被伪造并获取修复建议。

它是怎么工作的

  1. 第 1 步

    AI 读取代码库

    Claude 或 Codex 分析代码结构、文件和网络请求。

  2. 第 2 步

    生成命名与连接

    为每个部分赋予平实英文名,并识别 import 和前后端请求匹配。

  3. 第 3 步

    渲染交互地图

    输出可缩放、可点击的地图,支持从屏幕或部件下钻。

  4. 第 4 步

    增量更新

    重新读取时只分析变化部分,打开的地图自动刷新。

快速上手

  1. 1

    安装插件

    在 Claude Code 或 Codex 中安装 Floorplan 插件。

  2. 2

    请求地图

    向 Claude 或 Codex 说“给我画一个 floorplan”。

  3. 3

    浏览地图

    打开生成的地图,从整体开始逐层下钻查看。

适合谁

  • 用 AI 构建应用但不读代码的开发者
  • 需要快速理解现有代码库的团队成员
  • 想检查 AI 生成应用安全问题的开发者

不太适合

  • 需要逐函数分析大型代码库的资深开发者
  • 不使用 Claude Code 或 Codex 的用户

成熟度

  • 活跃度创建于 2026 年 10 月,最近更新在 2026 年 11 月,版本 0.11.0,活跃度较高。
  • 文档README 详细,含对比表格、功能说明、演示视频和文档链接。
  • 社区4658 星、383 分支、32 个开放 issue,有一定社区基础。
  • 上手难度作为插件安装,零依赖,Node 18+,上手步骤简单。

同类项目怎么选

  • Archify侧重生成多种类型的精美图表,适合展示和文档,而非理解自有应用。
  • Understand Anything面向大型代码库的逐函数知识图谱,适合深入学习代码细节。

使用前注意

  • · 需要 Claude Code 或 Codex 环境才能使用。
  • · 健康检查是基础检查而非完整安全审计。
  • · 地图生成依赖 AI 读取代码,结果可能受模型能力影响。
  • · MIT 许可证,可自由使用和修改。

主题标签

ai-codingarchitecture-diagramclaudeclaude-codeclaude-code-plugincodebase-visualizationdeveloper-toolsonboardingvibe-codingcodexcodex-pluginopenai