AB
AiBoss
project

lot-map - 在聊天窗口旁实时绘制 Claude Code 工作地图的插件

lot-map 是维护者 alexeyw 开发的 Claude Code 插件,在对话面板旁开出一块实时地图,把工具调用、模型步骤、钩子与技能画成从中心飞向各站点的脉冲。本文依据官方接口与项目自述,介绍它的维护状态、主要能力、安装入口与已知限制。

lot-map 是一个面向 Claude Code 的插件,由维护者 alexeyw 开发。按项目自述,它在聊天面板旁边开出一块实时地图:每一次工具调用、模型步骤、钩子和技能,都会从中心向对应的「站点」发出一次脉冲,于是使用者看到的是记忆、文件、Shell、网络和子代理在工作,而不是一行行滚过去的命令列表。它适合已经在日常使用 Claude Code、希望直观掌握一次会话里工作流向的人,也适合想看清某次任务究竟把时间花在哪些环节上的开发者。

维护者与状态

仓库为 alexeyw/lot-map,维护者是 alexeyw,许可证为 MIT。仓库创建于 2026-11-09,最后提交时间为 2026-11-13,最新正式版本为 v0.6.0,发布于 2026-11-12。截至 2026-11-13 读取数据时,仓库获得 682 个星标。从创建到最新提交只有数天,属于非常年轻的项目,版本号也仍处在 0.x 阶段。

主要能力

以下能力均据项目自述整理,未做独立验证。

  • 站点式可视化。地图把工作分成若干站点:You(你的消息、提问与发给你的文件)、Model(每次模型请求与上下文压缩)、Memory(Claude Code 的记忆目录,以及选项里指定的对象)、Files(Read、Write、Edit、Grep、Glob,以及只对文件做事的 shell 命令)、Shell(其余 shell 命令)、Network(网页抓取与搜索、MCP 服务器,以及 curl、gh、ssh、rsync、git push、npm install、docker pull 等已知联网的命令)、Browser(浏览器工具)、Agents(子代理与工作流)、Skills(技能与工具搜索)、Hooks(拒绝调用、请求权限、补充上下文或耗时较久的设置钩子)。
  • 脉冲与状态颜色。据项目说明,事情开始时脉冲飞出,结束时返回;被拒绝和出错会变红。
  • 路线与辐条。一条细线按顺序连接主循环最近经过的几个站点,最新一段会自己画出来;某段保留 40 秒后在 20 秒内淡出。站点被用得越多,对应辐条越粗越亮,会话结束时地图能显示工作去了哪里。
  • 耗时与并发。调用进行时,站点周围长出两根「时针」,内圈一分钟一圈,外圈十分钟一圈。同时开始的调用并排飞出,站点上标出数量,例如 ×3。
  • 后台任务。发到后台的命令、监视器、后台子代理或工作流,在启动它的回合结束后仍在该站点保持点亮,直到任务报告结束;失败的任务留下红点。
  • 上下文窗口。中心周围的环随会话推进而填充,上方显示百分比,70% 转琥珀色,90% 转红色。
  • 模型切换。切换模型时中心与 Model 站点会亮几秒,信息流里出现一行类似 opus 5.5 → fable 5.2 的记录。
  • 信息流。地图下方有一行说明当前在跑什么,以及最近 16 行记录,用 ● 表示运行中、· 表示完成、✕ 表示失败或被阻止、◆ 表示模型变更;连续完成的同类调用会折叠成一行并标注 +2 之类的数量。

使用入口

仓库地址:alexeyw/lot-map。

据项目说明,在终端会话的提示符下可以这样安装:

/plugin install lot-map --marketplace alexeyw/lot-map

确认添加市场后选择安装范围。也可以从 shell 安装:

claude plugin install lot-map --marketplace alexeyw/lot-map

如果提示在任何市场中找不到该插件,先添加市场再安装:

claude plugin marketplace add alexeyw/lot-map
claude plugin install lot-map@lot-map

在桌面应用中,则是点击提示框旁的 +,进入 Plugins,用 alexeyw/lot-map 添加市场,再添加插件。会话开始时面板会自动打开。更新时先执行 claude plugin marketplace update lot-map,再执行 claude plugin update lot-map@lot-map,然后开一个新会话;项目说明强调第一条命令不能省,否则第二条会把已安装版本报成最新。安装时会在一个界面上提供选项,之后可在终端用 /config 或 claude plugin configure 修改,并重启会话。

许可与限制

许可证为 MIT。项目自述中列出的限制与前置条件包括:

  • 终端里至少需要 144 列宽,否则要手动输入 /lot-map;终端默认只画文字行,要看到地图图像需把 terminalView 设为 picture,且终端本身支持显示图片,例如 iTerm2 3.5 及以后、kitty 或 Ghostty。
  • 显示图片时,Claude Code 需以全屏方式绘制;在 tmux 内需设置 allow-passthrough on 与 focus-events on。窄于 24 列的面板只显示文字行。
  • 终端不会告知自己是深色还是浅色,theme 为 auto 时图像按深色绘制,浅色终端需手动设为 light;终端也不告知单元格高度,需用 cellShape 调整,默认 2.4。
  • 项目自述称在 macOS 上的 Claude Code 2.1.321 构建并测试,有用户报告在 Windows 上也能工作,但这属于用户反馈而非官方测试结论。
  • Shell 站点按命令名而非实际行为归类,例如 python -c "…" 这类自己建立连接的脚本会显示为 Shell;npx 只有带 -y 时才计入 Network。

以上能力与行为均来自项目自述,实际表现请以仓库与 LICENSE 文件为准。