ARTICLE · 1381508
AI 干活像黑盒?1008 星插件把每个动作画成实时地图

写代码这几年,我用 Claude Code 的频率越来越高,但我始终有个不踏实的地方:它干活的时候,我只看得见一行行文字命令滚过去。
它读了哪个文件、跑了几条 shell、有没有偷偷 spawn 出子 agent——这些全靠我盯着终端一行行读。有一次它改错了文件,我是提交之后才发现。不是它不告诉我,是文字流太长,我没那个耐心读完。
所以我找了一个东西:把 agent 的每一个动作,变成一张我看一眼就懂的图。装上的第一次,我直接让它跑了个真任务——在一个目录里放 4 个文件,让它「列出目录、读每个文件、写一个 summary.md 总结」。右边地图的 feed 实时滚出来:
● List directory… · Read 4 files, listed 1 directory ● Write(summary.md) ⎿ Wrote 8 lines to summary.md ✻ 71 Worked for 9s · done
4 个文件读完,summary.md 写了 8 行,整轮 9 秒。中间地图上 Files、Shell、Write 三个站点依次亮起,中心那个环是上下文占用,从 0 一路涨到 71%——它自己就带一个「上下文快满没满」的提醒。
真实产物是它写的这个 summary.md:
| 文件 | 用途 |
|------|------|
| app.py | Python 脚本,定义打印 hi 的 main 函数 |
| config.yaml | 配置文件,占位内容 |
| index.js | JS 文件,定义常量 x = 1 |
| readme.md | README 占位文件 |

一句话判断:它不改变 agent 干的结果,它只改变你「看见结果的方式」。
本文看点
01 怎么用:一条命令装上 02 原理:它凭什么看得见 03 适合谁:什么人该装,什么人别装
01 怎么用
lot-map(2026-11-19 GitHub 实时 1008 星,MIT 协议,仓库 github.com/alexeyw/lot-map)不是独立软件,是 Claude Code 的一个插件(mod)。它做的事一句话说清:在聊天旁边开一个实时地图,每一次工具调用、模型步进、hook、skill、subagent,都从地图中心往对应的站点飞一道脉冲。
装它一条命令:
claude plugin install lot-map --marketplace alexeyw/lot-map坑在包名:marketplace 名和插件名都叫 lot-map。装完如果想更新,得先 claude plugin marketplace update lot-map 再 claude plugin update lot-map@lot-map,少了第一条,它永远报「已是最新」。它跑在 Claude Code 2.1.321 及以上,本机 2.1.325 实测通过。
02 原理
它凭什么能「看见」agent 在干什么?靠的是 Claude Code 的 hook 接口。
Claude Code 会在几个关键节点回调:工具调用前(PreToolUse)、会话开始、用户提交、模型步进、skill 触发、subagent 启动。lot-map 挂在这些 hook 上,每来一个事件就分类,归到几个固定站点——Files(文件)、Shell(命令)、Web(网络)、Agents(子 agent)、Memory(记忆)。
关键在设计:它只记「名字」,不碰「内容」。
读一个文件,它记下文件路径的最后两段;跑一条命令,它记下命令名,不记命令行;访问一个网页,它只记主机名,不带路径和参数。分类逻辑在 hooks/classify.ts,一个字符都不改输入输出。所以它敢在 PRIVACY.md 里写:零网络请求、零遥测、不读内容、不写会话。
这跟你看 agent 日志是两回事。日志是文字列表,地图是空间图——几个站点哪边被频繁点亮、哪边一直黑着,扫一眼就知道活干到哪了。
03 适合谁
先说没解决的,这个我不会替它藏。
地图标签只支持 7 种语言(en / ru / es / fr / de / it / pt),没有中文。feed 里的命令描述还是中文的,但站点标签是英文。 想在地图里看图,终端得支持图形协议(iTerm2 3.5+、kitty、Ghostty),普通终端默认只显示文字 feed。 它显示的是「正在做什么」,不是「为什么这么做」——想看懂 agent 的决策理由,这图帮不上。
再说同类。Claude Code 自带的那串文字日志,是它的直接对手;再往上还有各种 agent 轨迹面板。lot-map 的差异在三点:纯本地、零网络、只读不改。对把敏感仓库交给 agent 的人来说,这三点比「图更好看」值钱。
适合谁:重度用 Claude Code / 跑多 subagent 编排的开发者,想一眼盯住 agent 在干嘛的人。
不适合谁:只用 GUI 编辑器不用终端的、要中文界面的人。
AI agent 越来越多了,看懂它「在干什么」,会像当年看懂 IDE 的断点和调用栈一样,变成基本功。lot-map 是把这件事做成了地图的那一个。
这里是鱼儿爱看科技。只写亲手跑过的工具——真数据、真坑、真结论。
觉得有用就点个关注,下次刷到直接看。















































































