← 返回部落格
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,這對整個品類都是好建議,而在這裡格外好執行,因為作者把讓步和聲明寫在了同一段裡。

相關文章