← 返回博客
Ai预计阅读 9 分钟

把一次 Claude Code 会话画成地图,活儿干在哪,辐条就磨在哪

发布于 2026年11月15日
把一次 Claude Code 会话画成地图,活儿干在哪,辐条就磨在哪

编程 agent 自己的输出就是一份流水账。它会滚动,是线性的,等到第四十次工具调用的时候,你已经看不出这次会话的形状了。你知道它读了六个文件,跑了一次测试。你不知道大部分活儿是花在 shell 上还是 grep 上,memory 文件夹到底有没有被碰过,上下文窗口还剩多少。

lot-map 是个 Claude Code 插件,在聊天窗口旁边开一块面板回答这些问题。每一次工具调用、每一步模型请求、每个 hook 和 skill,都会从面板中心向某个站点发出一次脉冲。东西开始的时候,脉冲飞出去;结束的时候,它飞回来。被拒绝的调用和报错会变红。

想法很小,但它在「该画什么、该省掉什么」上花的心思多得不太寻常。

站点

十一个站点,每个对应一类工作。

You,放你的消息、发给你的文件、任务列表、计划,以及需要你点头的任何东西。Model,放每次模型请求和上下文压缩。Memory,放 Claude Code 的 memory 文件夹,加上你在 options 里点过名的任何东西。Files,放 Read、Write、Edit、Grep、Glob、语言服务器的代码智能,以及只碰文件的 shell 命令。Shell,放其余所有命令。Network,放 web fetch 和搜索、MCP 服务器、存在 claude.ai 上的内容,以及已知会联网的 shell 命令。Browser,放浏览器工具。Agents,放子 agent、workflow、定时任务,以及等待后台任务。Skills,放 skill、tool search,还有 skill、插件和连接器的目录。Hooks,放那些会拒绝调用、询问权限、补充上下文或者稍微卡一下的 settings hook。

shell 命令的分类是工程量最大的地方,而且做得比需要的还细。用完整路径跑的程序按名字识别,带空格的引号路径也算,所以 CURL.EXE 就是 curl。挂在 sudo、env、timeout、nohup 或 xargs 后面的命令,按它实际执行的那条来读。find -exec 按它被告知要执行的东西来读。放在 for、if、while、! 或花括号组里的命令也一样,交给 bash -c 或 eval 的那一行也一样。npx 只有带 -y 才算 Network,理由是不带的时候你多半只是在跑已经装好的东西。

在 Windows 上,PowerShell 工具用 PowerShell 自己的名字按同样的规则读。Get-Content 和 Select-String 点亮 Files。Invoke-WebRequest 点亮 Network。

怎么读这张图

路线是主循环刚经过的最近几个站点,按顺序连起来,最新的一段自己画出来。一段停留 40 秒,在 20 秒里淡出,所以活儿停下之后一分钟,只剩辐条还在。

辐条用得越多就越粗越亮。整件事的意义就在这儿:一次会话结束时,地图告诉你活儿都去哪儿了。一次看着很忙、但 Files 上只有一根细辐条、Shell 上却有一根粗辐条的会话,本身就在说明问题。

调用进行中,站点周围会长出两根指针,一根一分钟转一圈,一根十分钟转一圈。被送到后台的活儿,比如一个 monitor、一个后台子 agent、一个 workflow,在启动它的那一轮结束之后还亮着,指针继续长,直到任务报告完成。失败的任务会留下红点。

同时开始的调用会并排飞出去,站点上带一个计数,比如 ×3。

Memory 有自己的颜色。实心脉冲是 Claude 主动要的记忆。虚线加上空心,是 hook 没被要求就带进来的。站点下面的数字数的是前者,↓ 数的是后者。如果你曾经怀疑 memory 文件夹到底有没有在干活,这是一个直接的读法。

中心那圈随着会话推进逐渐填满,百分比写在名字上方。70%转琥珀色,90%转红。切换模型会让中心和 Model 站点亮几秒,消息流里多一行,像 opus 5.5 → fable 5.2。同一个文件夹里,这次会话的起始模型和上次不同时也会触发,这是个抓自己悄悄换模型的巧妙办法。

隐私那条线,以及它让了什么

README 里那句话值得整句引:它在你的机器上跑,什么都不往外发,然后,本地不等于看不见。

紧接着的一段解释了原因。像任何跟着工具调用的 mod 一样,每次调用都是整个交给它的,它只从里面取名字,别的都不碰。有个 PRIVACY.md 写它读什么、留什么,还有个 PRINCIPLES.md 写把它约束在那些条款上的检查。

我喜欢这个说法,因为它拒绝了这个品类太容易做出的一个承诺。本地工具照样看得见你交给它的全部东西。「私密」的诚实版本,一半是声明什么会离开这台机器,一半是声明什么会被读到,这个插件两样都说了。

这也意味着这张图只能算行为摘要,当不了审计日志。一个在 python -c 里开连接的脚本会显示成 Shell,因为分类看的是命令名。here document 的正文不会被读,所以通过它写出来的文件显示成 Files,不管正文写了什么。一行只读到前 8,000 个字符。对可视化来说这些限制很合理,对合规记录来说则直接不合格。看清楚你在看的是哪一个。

安装

在 Claude Code 的提示符里:

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

加 marketplace 时回答 y,然后选一个作用域。在 shell 里:

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

如果它说在哪个 marketplace 里都找不到这个插件,先加 marketplace:

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

在桌面应用里,点输入框旁边的加号,选 Plugins,用 alexeyw/lot-map 加上 marketplace,然后加插件。

会话开始时面板会自己打开。在终端里它至少要 144 列;少于这个宽度,就输入 /lot-map,它只画文字,除非你要它把地图画成图片或者用盲文点。更新要两条命令,第一条不是可选的:claude plugin marketplace update lot-map,然后 claude plugin update lot-map@lot-map,然后开一个新会话。少了第一条,第二条会把已装版本报成最新版。

在 macOS 上基于 Claude Code 2.1.321 构建并测试,有用户反馈在 Windows 上也能用。

为什么是地图,不是表格

表格能装更多信息。你可以按站点排序、把时长加总、把计数导出去。但它同时会变成一个 dashboard,而 dashboard 只会被打开一次。

地图之所以成立,是因为它是背景式的。它在聊天旁边待着,有事情发生时动一下,慢慢积出一个你不用读也能看的形状。一小时之后那几根磨出来的辐条,是给一件本来不可见的事做的记忆辅助:一次会话在注意力和上下文上到底花了多少,一个站点一个站点地。

它解决的就是这个具体问题。上下文管理是 agent 工作里没人能看见自己在做的那项技能。有一个在 70%转琥珀色的环,有一根告诉你 shell 把这次会话吞掉一半的辐条,能让那部分不可见的东西稍微可见一点。

插件在 alexeyw/lot-map。装之前读一下 PRIVACY.md,这对整个品类都是好建议,而在这里格外好执行,因为作者把让步和声明写在了同一段里。

相关文章