lot-map

在对话旁的实时地图上,看清 Claude Code 正在调用什么工具、经过哪些模型步骤。

Star 数
★ 1k
最近更新
1 天前
License
MIT
主语言
TypeScript

30 秒速览

可在哪里用
平台专用Claude CodeClaude.ai(部分支持)
开始前需要
Claude Code 2.1.321(构建与测试所用版本)至少 144 列的终端(用于侧边面板)图形终端如 kitty、Ghostty,或 iTerm2 3.7.8+(用于图片视图)Shell / 命令行本地文件系统
典型场景
想在长会话中直观看到 Claude Code 究竟在工作目录、Shell、网络和子代理之间如何分配时间的开发者。
主要局限
核心功能依赖 Claude Code 的插件与钩子机制,不能独立运行,也不支持其他代理运行时。
官网
alexeyw.github.io/lot-map ↗ 来自 GitHub 仓库设置
维护状态
近 30 天有提交最近提交 2026-11-19最新版本 v0.12.0(2026-11-19)

这个 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 数估算每次调用让上下文增长多少,标在行和站点上。

  1. 想在长会话中直观看到 Claude Code 究竟在工作目录、Shell、网络和子代理之间如何分配时间的开发者。
  2. 在桌面应用或 VS Code 里并排运行 Claude Code,希望有一块不干扰对话的可视化侧栏的人。
  3. 使用 kitty、Ghostty 或 iTerm2 3.7.8+ 的终端用户,想要地图图片而不是滚动日志。
  4. Windows Terminal 或 Linux 终端用户,无法显示图片但可以通过 braille 模式看到地图。
  5. 需要排查钩子拒绝、上下文快满或模型切换等异常情况的人。
  6. 对插件源码和隐私边界有要求的团队,需要确认插件不向外发送数据。

如何安装或部署这个 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?

FollowAgents 源码审查 · FARS-2.1
存在缺口
72/ 100 五分制 3.6 / 5
信任安全 18/29
可靠稳定 8/14
适用触发 16/18
规范维护 15/18
有效结果 10/13
证据核验 5/8
查看各维度的扣分理由
信任安全18 / 29 · 3.1/5

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。

可靠稳定8 / 14 · 2.9/5

README 对行为描述详尽且内部一致(如 contextCost 一步延迟、braille 限制),但依赖可用性方面未展示 package.json 或运行时依赖,CI 依赖 @anthropic-ai/claude-code 特定版本 2.1.321,给 1。失败信息方面有错误/拒绝的红点、✕ 标记与 hook 拒绝首行显示,但未展示具体错误文案,给 2。

适用触发16 / 18 · 4.4/5

受众与场景覆盖桌面、终端、VS Code、Windows/Linux/macOS,7 种语言,给 3。能力边界描述非常清楚(哪些不画、哪些不读、here-document 不解析等),给 3。触发精度:shell 命令按名称分类,存在已知误判(python -c 显示为 Shell),给 2。环境适配:iTerm2 版本检测、tmux 配置、终端宽度要求均有说明,给 3。

规范维护15 / 18 · 4.2/5

信息架构优秀,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。

有效结果10 / 13 · 3.8/5

输出可用性高:地图、行列表、上下文环、token 估算等多维可视化,给 3。边际价值:相比 Claude Code 自带状态行提供更丰富的空间化视图,但属于锦上添花,给 2。成本效益:终端需 144 列、fullscreen、iTerm2 3.7.8+ 等门槛较高,给 2。

证据核验5 / 8 · 3.1/5

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+),部分环境功能受限。
证据充分度:低 评估于 2026年11月19日 审查版本 e3a93ec01f72
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/lot-map.svg?lang=zh)](https://followagents.com/zh/agents/lot-map)
<a href="https://followagents.com/zh/agents/lot-map"><img src="https://followagents.com/badge/lot-map.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. 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 查看 ↗
  2. 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 查看 ↗
  3. 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 查看 ↗

常见问题

它会把我的代码或命令发给外部服务吗?
不会。插件声明不发起任何网络请求、不读取文件、不运行进程、不调用模型,也不向对话添加内容。它从工具调用中只提取文件名最后两段、URL 主机名、命令描述等名称类标签,不保留命令原文、搜索结果或记忆内容。唯一的跨会话存储是每个文件夹最后使用的模型名,保存在 Claude Code 自己的插件存储中。
不用桌面应用,在终端里能看到地图吗?
可以,但有条件。默认终端只显示日志行;把 terminalView 设为 picture 需要支持图片的终端(如 kitty、Ghostty、iTerm2 3.7.8+)和全屏渲染;设为 braille 则在任何带盲文字体的终端(如 Windows Terminal、多数 Linux 终端)中可用。此外面板需位于对话旁边,地图需要至少 50×25 的字符面板。
我的团队使用 Team 或 Enterprise 登录,能安装吗?
可以安装,但组织的安全策略会跳过五类钩子事件,日志里会出现类似 lot-map: its classic.PreToolUse hook was skipped 的提示。把 guardedHooks 设为 false 可以消除提示,代价是地图失去 Hooks 站点、钩子添加的记录、斜杠命令行和压缩标记。
contextCost 显示的 token 数准确吗?
是估算值。插件只看到模型步骤之间上下文增长了多少,因此一个调用的数字要等下一个模型步骤完成后才出现,同一模型步骤内的多个调用会平分增长量并标记 ~。子代理拥有独立上下文,不显示该数字。
它支持 Claude Code 之外的代理吗?
不支持。这是 Claude Code 的插件,依赖其插件市场和钩子事件(会话、提示、工具调用、压缩等),仓库没有提供其他代理或模型提供方的适配。
lot-map 官网是什么?
lot-map 的 GitHub 仓库填写的官网是 https://alexeyw.github.io/lot-map/。这个链接由仓库作者设置;源码在 GitHub(alexeyw/lot-map)。
lot-map 开源吗?
开源。源码在 GitHub(alexeyw/lot-map),许可证是 MIT。
lot-map 安全吗?
FollowAgents 的 FARS 评审(2026年11月19日)给 lot-map 的“信任与安全”打了 18/29 分。评审检查的 8 项安全措施没有完全缺失的。
lot-map 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-19,在最近 30 天内。最新版本是 v0.12.0(2026-11-19)。
lot-map 是谁开发的?
lot-map 由 GitHub 账号 alexeyw 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

所属宿主生态

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念