lot-map
在对话旁的实时地图上,看清 Claude Code 正在调用什么工具、经过哪些模型步骤。
- Star 数
- ★ 1k
- 最近更新
- 1 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 72/100 · 存在缺口
30 秒速览
- 可在哪里用
- 平台专用Claude CodeClaude.ai(部分支持)
- 开始前需要
- 典型场景
- 想在长会话中直观看到 Claude Code 究竟在工作目录、Shell、网络和子代理之间如何分配时间的开发者。
- 主要局限
- 核心功能依赖 Claude Code 的插件与钩子机制,不能独立运行,也不支持其他代理运行时。
- 官网
- alexeyw.github.io/lot-map ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-19最新版本 v0.12.0(2026-11-19)
- 源码审查
- 72/100 · 存在缺口
这个 Agent 能做什么,适合哪些场景?
lot-map 是 Claude Code 的一个插件,在聊天面板旁边开出一块实时地图,把工具调用、模型步骤、钩子、技能和子代理显示为从中心飞向各站点(You、Model、Memory、Files、Shell、Network、Browser、Agents、Skills、Hooks)的脉冲。它用 SVG 绘制地图并做动画,支持桌面应用、VS Code 扩展和终端三种呈现;终端里可以只显示日志行,也可以在 kitty、Ghostty、iTerm2 等终端中显示像素图片,或用盲文字符画出同样的板面。地图完全在本机运行,不发起网络请求、不读文件、不运行进程、不调用模型,也不向对话写入内容;它从工具调用中只提取名称类标签,不保留命令原文或文件内容。提供 7 种界面语言(en、ru、es、fr、de、it、pt)和二十多个可配置选项,例如主题、配色、布局、动效、上下文占用估算、MCP 服务器归类等。它是 MIT 许可的开源项目,通过 Claude Code 插件市场安装,用 /plugin install 或 claude plugin install 即可使用。
插件监听 Claude Code 会话的启动、提示、回合、模型步骤、工具调用、技能、上下文压缩等事件,以及设置钩子的 PreToolUse、UserPromptSubmit、SessionStart 事件;钩子把事件原样传递,只根据 classify(hooks/classify.ts)从工具调用的输入中取出站点名称。地图用 drawMap 绘制,脉冲在调用开始时飞向站点、结束时返回,错误和拒绝变红;中心圆环显示上下文窗口占用,70% 变琥珀色、90% 变红。地图下方显示当前进行的调用和最近 16 行日志(logRows 可设为 fill),带状态符号 ●、·、✕、◆ 和耗时。终端图片模式由 hooks/scene.ts、hooks/raster.ts、hooks/png.ts 三个文件把同一份绘图栅格化成 PNG 帧,使用 X.Org misc-fixed 位图字体,最多每秒五帧;盲文模式由 hooks/braille.ts 用盲文字符重绘板面。可选 contextCost 会用模型步骤返回的 token 数估算每次调用让上下文增长多少,标在行和站点上。
- 想在长会话中直观看到 Claude Code 究竟在工作目录、Shell、网络和子代理之间如何分配时间的开发者。
- 在桌面应用或 VS Code 里并排运行 Claude Code,希望有一块不干扰对话的可视化侧栏的人。
- 使用 kitty、Ghostty 或 iTerm2 3.7.8+ 的终端用户,想要地图图片而不是滚动日志。
- Windows Terminal 或 Linux 终端用户,无法显示图片但可以通过 braille 模式看到地图。
- 需要排查钩子拒绝、上下文快满或模型切换等异常情况的人。
- 对插件源码和隐私边界有要求的团队,需要确认插件不向外发送数据。
如何安装或部署这个 Agent?
在 Claude Code 终端会话的提示符下执行:
/plugin install lot-map --marketplace alexeyw/lot-map对添加市场回答 y,然后选择安装范围。也可以从 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、Add marketplace,填入 alexeyw/lot-map,再 Add plugin。更新时先刷新市场再更新插件:
claude plugin marketplace update lot-map
claude plugin update lot-map@lot-map之后需要开启新会话。
如何使用这个 Agent?
会话开始时侧栏会自动打开(openAtStart 设为 false 时要输入 /lot-map)。地图上每个站点代表一类工作,脉冲表示一次调用的开始和结束,红色表示错误或拒绝。在终端中默认只显示日志行;要显示地图需使用全屏渲染,并设置 terminalView:
claude plugin configure lot-map@lot-map --values-stdin <<'EOF'
{"terminalView":"braille"}
EOF或在支持图片的终端中:
claude plugin configure lot-map@lot-map --values-stdin <<'EOF'
{"terminalView":"picture"}
EOF终端地图要求面板位于对话旁边,可输入 /tui fullscreen 或以 CLAUDE_CODE_NO_FLICKER=1 claude 启动;tmux 内需设置 allow-passthrough on 和 focus-events on。在 Team/Enterprise 登录下若出现 lot-map: its classic.PreToolUse hook was skipped 提示,可关闭 guardedHooks:
claude plugin configure lot-map@lot-map --values-stdin <<'EOF'
{"guardedHooks":"false"}
EOF所有选项值都写成字符串,列表用逗号分隔。
这个 Agent 有哪些优点和局限?
- 在同一份绘图代码上同时实现桌面、VS Code、终端图片和盲文四种呈现,可覆盖大多数 Claude Code 运行环境。
- 插件明确声明不联网、不读文件、不运行进程、不调用模型,并只从工具调用中提取名称类标签,隐私边界写得很细。
- 通过 Claude Code 插件市场一条命令安装,选项有默认值,无需额外配置即可使用。
- 支持 7 种界面语言和大量外观选项(主题、配色、布局、动效、字号),可按团队偏好定制。
- contextCost 能按模型步骤估算每次调用带来的上下文增长,帮助识别上下文膨胀来源。
- 核心功能依赖 Claude Code 的插件与钩子机制,不能独立运行,也不支持其他代理运行时。
- 终端地图需要全屏渲染模式和足够宽的窗口(至少 144 列),否则只能看到文本日志行。
- 图片模式对终端有额外要求:iTerm2 需 3.7.8 以上,早期版本存在约 17 GB 内存累积问题(#81)。
- 在 Team/Enterprise 登录下,组织安全策略会跳过部分钩子事件,地图会丢失 Hooks 站点等信息,需要手动关闭 guardedHooks。
- 仅构建并测试于 Claude Code 2.1.321 与 macOS;Windows 和 Linux 只有用户反馈可用,官方未做验证。
- 市场从仓库 main 分支拉取,更新即代表接收最新代码,需要自行审阅 diff。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| lot-map 当前 | 72 · 存在缺口 | — | ★ 1k | 1 天前 | TypeScript | Claude Code |
| 我有ADHD(i-have-adhd)技能 | 54 · 缺口较多 | Agent 插件 / 技能免费 | ★ 62k | 1 个月前 | Python | Claude Code |
| OSS Autopilot | 80 · 表现良好 | Agent 插件 / 技能免费 | ★ 30 | 今天 | TypeScript | Claude Code · Claude.ai |
| Jev Review | 62 · 存在缺口 | Agent 插件 / 技能免费 + 模型费 | ★ 253 | 2 个月前 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
README 与 SECURITY.md 明确声明该 mod 只观察不改动、不发网络请求、不读文件、不起进程,并列出何为漏洞;PRIVACY.md 与 PRINCIPLES.md 被引用但未在包内,无法核验其内容,故数据流透明度给 3 但敏感数据处理只给 2。最小权限方面有 guardedHooks 开关与 CI 的 surface 检查脚本,但实际 hook 清单与权限范围未在包内展示,扣分。用户确认方面未见安装或启用时的显式确认流程,仅靠 /plugin install 与配置屏,给 1。外部效应与回滚:无破坏性默认,但缺少卸载/回滚说明,给 1。依赖安全:CI 固定了 actions 的 commit SHA 与 Node 22,但运行时依赖清单未在包内,给 2。来源归属:plugin.json 有 author、homepage、repository、supportUrl,但发布者未经 FollowAgents 验证,给 2。
README 对行为描述详尽且内部一致(如 contextCost 一步延迟、braille 限制),但依赖可用性方面未展示 package.json 或运行时依赖,CI 依赖 @anthropic-ai/claude-code 特定版本 2.1.321,给 1。失败信息方面有错误/拒绝的红点、✕ 标记与 hook 拒绝首行显示,但未展示具体错误文案,给 2。
受众与场景覆盖桌面、终端、VS Code、Windows/Linux/macOS,7 种语言,给 3。能力边界描述非常清楚(哪些不画、哪些不读、here-document 不解析等),给 3。触发精度:shell 命令按名称分类,存在已知误判(python -c 显示为 Shell),给 2。环境适配:iTerm2 版本检测、tmux 配置、终端宽度要求均有说明,给 3。
信息架构优秀,README 分节清晰,给 3。安装说明覆盖终端、shell、桌面应用与更新流程,给 3。命名稳定性:plugin 名与 marketplace 名一致,但版本 0.12.0 处于 0.x,给 2。示例与 FAQ:有配置示例与截图,但无独立 FAQ,给 2。已知限制详尽(braille 不画什么、iTerm2 3.7.7 问题 #81),给 3。许可证 MIT 完整,给 3。版本与变更:有 CHANGELOG.md 引用但未在包内,给 2。维护责任:SECURITY.md 说明单人维护、仅最新版修复,但发布者身份未验证,给 2。
输出可用性高:地图、行列表、上下文环、token 估算等多维可视化,给 3。边际价值:相比 Claude Code 自带状态行提供更丰富的空间化视图,但属于锦上添花,给 2。成本效益:终端需 144 列、fullscreen、iTerm2 3.7.8+ 等门槛较高,给 2。
claim_traceability:README 引用 PRIVACY.md、PRINCIPLES.md、FONTS.md、CHANGELOG.md 但均未在包内,无法追溯,给 2。cross_source_corroboration:README、plugin.json、SECURITY.md、CI 之间描述一致,给 2。fact_inference_separation:README 明确区分估算(contextCost 为估计)与事实,给 2。
- PRIVACY.md、PRINCIPLES.md、FONTS.md、CHANGELOG.md 被引用但未在包内,无法核验隐私与安全声明。
- 发布者未经 FollowAgents 验证,身份未知,不应据此推断可靠性。
- 运行时依赖清单与 hook 实际清单未展示,最小权限与依赖安全无法完全确认。
- 缺少卸载/回滚说明,且仅最新版获得修复。
- 终端使用门槛较高(144 列、fullscreen、iTerm2 3.7.8+),部分环境功能受限。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v0.12.0 lot-map 0.12.0
发布说明摘录
- New option openAtStart: with false the pane stays closed when a session starts and opens on /lot-map alone. The map is kept from the session's first call all the same, so it is whole when it is opened. true, as before, stays the default. Suggested by Thombutter. (#116, #117) - The terminal picture is back in iTerm2, from iTerm2 3.7.8 on. iTerm2 3.7.7 kept every picture it was sent, so since 0.9.0 the mod drew none there; iTerm2 fixed that on its side. Measured in 3.7.8: 1466 frames in four and a half minutes left its memory between 327 and 351 MB. An earlier iTerm2, or one that does …在 GitHub 查看 ↗ -
v0.11.0 lot-map 0.11.0
发布说明摘录
- New option contextWindow: with compaction the ring and its percentage measure the context against the auto-compact window, such as one set with autoCompactWindow, where it is smaller than the model's; at 450k tokens of a 1M model with compaction at 600k it reads 75%, not 45%. model, as before, stays the default. For this the mod asks Claude Code how the context divides up, at a session's first model step and again after a compaction or a change of model, and takes only the window's size from the answer; PRIVACY.md says so. Contributed by philarete173. (#97, #101) …在 GitHub 查看 ↗ -
v0.10.0 lot-map 0.10.0
发布说明摘录
- New option serverStations: put an MCP server's tools on a station of your choice, each as server=station, with files, shell, web, browser, agents, skills or you. The row still reads server: tool. Memory keeps memoryServers, which wins if a server is in both. Contributed by arandevcode. (#55, #86) …在 GitHub 查看 ↗
常见问题
它会把我的代码或命令发给外部服务吗?
不用桌面应用,在终端里能看到地图吗?
我的团队使用 Team 或 Enterprise 登录,能安装吗?
lot-map: its classic.PreToolUse hook was skipped 的提示。把 guardedHooks 设为 false 可以消除提示,代价是地图失去 Hooks 站点、钩子添加的记录、斜杠命令行和压缩标记。contextCost 显示的 token 数准确吗?
它支持 Claude Code 之外的代理吗?
lot-map 官网是什么?
lot-map 开源吗?
lot-map 安全吗?
lot-map 还在维护吗?
lot-map 是谁开发的?
谢谢反馈,我们会据此改进页面。