ClaudeMap

Floorplan

一个 Claude Code 插件:读懂你的代码库,画出一张说人话、可交互的应用结构地图。

插件与代理claude-codepluginvisualizationlocal-first

说一句「画张 floorplan」,零依赖的纯 Node 脚本会扫描你的文件、import、路由与网络请求,Claude 或 Codex 则负责给各部分起名、用平实的英文描述每个文件。产物是本地的 floorplan/index.html:从整个应用双击下钻到部分、文件、端点,可以直接向地图提问(答案附带迷你地图与分步讲解),干活途中随时刷新——更新只重读变动的部分,刚碰过的卡片会在「近期工作」里亮绿灯。健康检查会标出写进代码的密钥、无需登录即可调用的端点、闲置文件与大到不宜安全编辑的文件,并各配一条可直接粘贴的修复提示。全程本地运行;floorplan/ 目录自己在 git 里忽略自己,你纳入版本管理的文件永远不会被改动。

它做什么

  • 每一层缩放都有地图——从整个应用开始,双击进入某个部分、一组文件、单个文件及其端点;每层都显示「谁在用它」与「它在用什么」,也可以从一个你熟悉的页面出发,看页面背后的一切,直到数据库与外部服务
  • 跨仓库的真实连接——沿 import 追踪,把前端的每个网络请求对上应答它的服务端端点;monorepo、其子目录或并排放多个仓库的普通文件夹都能连起来
  • 向地图提问与引导式流程——「退款如何到达客户的卡里?」会返回答案,外加一张只含相关环节的迷你地图与分步讲解;还能用平实的语言请求追踪新的流程
  • 健康检查与近期工作——找出写进代码的密码、无需登录即可调用的端点、闲置文件与大到不宜安全编辑的文件,各配可直接粘贴的修复提示;AI 刚改过的卡片亮绿灯,并注明这次改动如何服务你的要求

什么时候用

给重度靠 AI 搭起来的应用补上「没人画过的那张图」:开发者想不读代码就用大白话理解自己的应用,团队想几分钟内带新人从全局看到具体文件,或者改完想立刻看到 AI 碰了哪些部分。代码解析覆盖 TypeScript、JavaScript、Python、Go、Rust、Java、Kotlin、Scala 以及 Vue、Svelte、Astro 文件(其他语言为轻量支持);端点识别覆盖 Express、Next.js、Flask、FastAPI、Django、Spring 等;屏幕识别覆盖 Next.js、React Router、SvelteKit、Expo 等。

如何上手

claude plugin marketplace add haydenschmitty/floorplan
claude plugin install floorplan@floorplan

需要 Node.js 18+ 与 Claude Code(或 Codex——同一插件:codex plugin marketplace add haydenschmitty/floorplan,再 codex plugin add floorplan@floorplan)。跑在你已有的套餐上,无需 API key。

注意事项

还很早期——版本 0.2.1。首张地图对小应用也要几分钟、大应用更久(大项目会拆给并行 helper),且与其他任务一样消耗你已有的 Claude 或 ChatGPT 套餐。地图的提问栏靠 Claude Code CLI 或 Codex 读取真实代码;没有 CLI 时仍可在 Claude 应用里只凭地图提问。它只写自己的 floorplan/ 目录(Claude Code 下另在 CLAUDE.local.md 加一小节),两者都不进 git;README 会一次性询问是否想在 Floorplan Cloud 上线时收邮件——不登记就什么都不发。

代码仓库

haydenschmitty/floorplan

收录日期

地图上的相关资源

  • clawd-conduit

    插件 / 代理

    把全部 15 个 Claude Code hook 事件接进 Clawd on Desk 桌面宠物,权限请求变成可等待的桌面卡片。

    • hooks
    • desktop
    • notifications
    • claude-code
  • CometixCode

    插件 / 代理

    非官方的 Claude Code 终端 UI 复刻:用 Rust 按 1:1 逐文件移植到 iocraft 这套 React 风格 TUI 框架上。

    • terminal-ui
    • rust
    • reimplementation
    • unofficial
  • Abide

    插件 / 代理

    把 AGENTS.md、CLAUDE.md 里的自然语言规则变成钩子级强制:每次编辑都被评审,违规当场修复。

    • hooks
    • code-review
    • rules
    • agents-md