AgentsView 能把多種工具的程式設計代理工作階段日誌，彙整成一個可搜尋的本機封存庫。本指南面向需要找出一項已知工作、檢視代理實際記錄的用量欄位，並確認每個費用數字來自何處的工程主管。

這份操作說明以 AgentsView 於 2026 年 10 月 9 日發布的 v0.45.0 版本，以及目前的快速入門與權杖用量指南為依據；文件於 10 月 17 日查閱。BIG CHANGE 並未安裝 AgentsView、匯入逐字紀錄或測試這些步驟。請確認實際安裝的版本，因為文件與版本列表可能變更。

開始之前

你需要一個已完成且有權讀取的程式設計代理工作階段、該工作中特有的字句或工作階段 ID，以及讀取其本機日誌目錄的權限。Quick Start列出 macOS、Windows 與 Linux 的桌面版下載，CLI wheel 則支援 Linux x86_64 與 aarch64、macOS x86_64 與 arm64，以及 Windows x86_64 與 arm64。桌面應用程式已封裝；從原始碼建置另有 Go、Node 與 CGO 需求。依快速入門文件，基本的本機封存作業不需要託管服務帳戶或 API 金鑰。

工作階段日誌可能包含提示、原始碼、工具輸入與機密。只選擇團隊允許你檢查的目錄。請先決定封存庫可擷取哪些提供者與根目錄，並在首次啟動之前完成設定：直接執行 agentsview serve 便會立即探索並同步預設支援的來源。這次操作請讓網頁介面維持在文件指定的本機迴路位址。不要只為回答這個問題，就啟用託管原始資料同步、推送至 PostgreSQL 或 ClickHouse、發布至 Gist、產生洞察或託管嵌入向量端點。語意搜尋是選用功能；一般全文搜尋使用本機索引即可。

1. 安裝並辨識執行檔

從安裝指南選擇一種方法。若使用獨立 CLI，文件列出的永久 Python 安裝方式如下：

Terminal
pip install agentsview
agentsview --version

指南也提供 uvx agentsview，可在不永久安裝的情況下執行，另有各平台的安裝程式與桌面套件。在 macOS 上，Homebrew cask 會連結應用程式內附的 CLI；透過 DMG 安裝的應用程式，可能需要將其 CLI 目錄加入 PATH。相信版本資訊之前，先確認命令殼層找到的是哪個執行檔。GitHub 將 v0.45.0 標示為 10 月 9 日的版本，但解讀畫面與報表結構時，請以自己執行 --version 所得的結果為準。

2. 在第一次同步之前限制來源

若在主機安裝 CLI 或桌面版，請將全新的資料目錄及其 config.toml 先準備好，再啟動 AgentsView。設定指南說明如何使用 disabled_agents 排除本機檔案系統提供者，以及使用 [agents.<id>].dirs 取代某個提供者的預設根目錄。請找出所有其他提供者的 ID（見該指南的Session Discovery 表格），並將它們列入 disabled_agents，再把唯一授權提供者的 dirs 設為核准的根目錄。例如，[agents.codex] 搭配 dirs = ["/approved/codex/sessions"] 會取代 Codex 的預設目錄；請依自己的系統調整路徑。如果還沒有完整的排除清單，先不要啟動主機上的常駐程式。單獨覆寫 CODEX_SESSIONS_DIR 或 CLAUDE_PROJECTS_DIR 只會改變該提供者的根目錄，其他提供者仍可透過自己的預設方式被探索。

如果既有封存庫可能已包含無關的工作階段，這次稽核請使用全新的 AGENTSVIEW_DATA_DIR。設定指南指出，已停用提供者先前封存的工作階段仍可存取，因此變更設定不會清除舊封存庫。指南也指出，disabled_agents 管理的是本機探索與監看，不涵蓋遠端匯入或匯出；這項本機工作請不要設定遠端主機與匯出目的地。

如果維護排除所有其他提供者的清單並不切實際，可以改用隔離的容器。Quick Start 的 Docker 範例只在 127.0.0.1 發布介面，以唯讀方式掛載一個代理來源，並使用獨立資料磁碟區。請只掛載授權來源的根目錄，在全新容器內設定對應的目錄變數，並省略專案的 Compose 範例中的其他掛載。容器只能看見明確掛載的主機工作階段目錄。已發布的 Docker 映像支援 Linux amd64 與 arm64；這條路徑需要可正常運作的 Docker 安裝。

3. 建立本機封存庫

若使用已限制來源範圍的主機 CLI，啟動文件中的前景伺服器：

Terminal
agentsview serve

在第 2 步套用並檢查來源範圍之後，這會初始化 ~/.agentsview/sessions.db（或選定的資料目錄），探索已啟用代理的日誌、同步、監看變更，並開啟 http://127.0.0.1:8080。請保持該終端機開啟。如果偏好背景程序，可使用 agentsview daemon start 與 agentsview daemon status；桌面應用程式會管理自己的後端。如果已經有相容的伺服器在運作，可能只會回報其 URL，因此請先檢查有沒有執行中的常駐程式，再判定新設定是否控制了資料擷取。

若選用隔離容器，先檢查其唯一的唯讀來源掛載與全新資料磁碟區，再使用文件中的 Docker 指令啟動。請使用該容器的本機迴路介面，並在同一個容器內執行後續的 agentsview CLI 報表，確保讀取同一份封存庫。不要同時在主機執行未限制來源範圍的 serve。

確認已知工作的來源有出現，且非預期提供者沒有出現。若找不到工作階段，請先檢查核准的路徑、提供者設定與同步狀態，再推斷工作階段不存在。如果報表需要納入剛變更的檔案，請執行 agentsview sync；伺服器也會監看變更。任何完整重新同步之前，都要再次檢查設定的範圍。

4. 找出工作並驗證逐字紀錄

在網頁介面使用 Ctrl/Cmd+K 搜尋已知工作中的特有原文詞句。依專案、代理或日期縮小列表範圍，開啟候選結果並檢查訊息與工具呼叫。如果已有完整的工作階段 ID 或 UUID，Ctrl/Cmd+G 可直接開啟。這些操作方式記載於 Quick Start。請記錄代理、工作階段 ID 與日期，以便將用量結果連到正確的對話。

若原文字句搜尋找不到工作，試試較短的字句，並確認原本的代理確實將本機逐字紀錄寫入 AgentsView 可讀取的目錄。只存在於遠端服務、不支援的格式，或設定根目錄以外的工作，並不會因為加強搜尋就被找回。不要把啟用語意索引或上傳逐字紀錄，當作本機來源缺失的例行修正方式。

5. 檢查工作階段的用量欄位

開啟找到的工作階段用量檢視，辨識其中已記錄且存在的模型、輸入、輸出、快取建立與快取讀取欄位。權杖用量指南將費用報告標示為實驗性且仍在發展中。AgentsView 會從來源日誌擷取模型與權杖中繼資料，並在訊息資料列保留原始權杖用量。如果來源明確回報費用，就使用該數字；否則以可用的權杖與模型費率計算費用。JSON 的來源標記將其稱為 reported、computed 或 mixed。

如果想儲存該單一工作階段的機器可讀紀錄，專案的 CLI 範例使用 agentsview session usage SESSION_ID --format json。請把 SESSION_ID 換成在逐字紀錄中確認的 ID，並將 JSON 與工作筆記一併保存。引用任何總額之前，先檢查輸出中回報的模型、權杖分類與費用來源。

空白欄位或缺少的模型應視為未知。AgentsView 無法重建代理從未寫下的用量。版本說明指出，Junie CLI 擷取不包含只存在於 IDE 的對話與工具呼叫，而 Antigravity 的純文字備援只有逐字紀錄內容，沒有權杖用量或費用。這些具體例子說明，可搜尋的工作階段不一定有完整的支出數字。來源回報的金額也可能是整個工作階段的總額，而依模型分配的金額仍是估算。

6. 限定單日報表的範圍

使用 Usage 頁面的日期、專案與代理篩選器，檢查工作階段所在的那一天。該頁也有 Top Sessions by Cost 表格，可連回個別逐字紀錄。若要取得可稽核的終端機報表，請在下列指令代入工作階段的本地日期與代理名稱：

Terminal
agentsview usage daily --since YYYY-MM-DD --until YYYY-MM-DD --agent codex --breakdown

單日表格會分開顯示未快取輸入、輸出、快取建立與快取讀取；設定 --breakdown 時會出現各模型的資料列。日期預設依系統時區歸類，除非提供 --timezone。單日總額可能包含該代理的其他工作階段；這只能用來檢查範圍與量級，不是那一項工作的費用。請在單日報表旁保留工作階段 ID，並檢查哪些資料列實際屬於它。

若要產生不抓取價格目錄的報表，請加入 --offline。AgentsView 指出，這會讀取既有封存庫，不會同步來源或啟動常駐程式，並使用內建的備援價格。如果近期工作階段變更很重要，請先更新封存庫；離線報表無法探索新日誌。一般用量指令可能抓取 LiteLLM 與 OpenRouter 價格，內建目錄則會隨安裝版本逐漸過時。

7. 解讀數字並停止服務

請依各數字的來源加上標示。Computed 表示 AgentsView 將已記錄的權杖乘以選定費率。Reported 表示來源提供了明確費用。Mixed 表示報表混合了不同種類。即使是來源回報的數字，也不代表已完成整個帳戶的供應商帳單核對。請獨立比對相關供應商的實際帳務或方案紀錄，尤其在服務等級、折扣或訂閱額度很重要時。AgentsView 文件指出，若儲存的用量沒有記載該等級，就無法推斷 Batch、Flex、Priority、地區或一小時快取費率。部分工具端權杖不會出現在本機逐字紀錄中。

成功的檢查結果，是找到的逐字紀錄在代理、ID 與日期上都和選定用量檢視一致，並記錄可取得的模型與權杖欄位，把無法取得的欄位標成未知。結果是一份可搜尋的本機封存庫與範圍明確的工作／單日用量筆記，不是帳單。要停止前景 agentsview serve，請按 Ctrl+C；要停止背景伺服器，請使用 agentsview daemon stop。Quick Start指出，停止常駐程式會同時停止網頁介面與工作階段監看。

大改變

本機逐字紀錄為費用討論提供了可追溯的起點。工程主管可以把數字追溯到特定已記錄的工作，並看出它來自代理還是價格目錄。當日誌不完整時，報表應保留這個缺口。

來源與延伸閱讀

  • AgentsView v0.45.0 版本說明：具日期的代理支援範圍、Usage 卡片、同步與價格行為變更。版本說明是供應商的紀錄，不是 BIG CHANGE 的測試。
  • AgentsView Quick Start：支援的安裝方式、伺服器與常駐程式指令、來源設定與本機搜尋操作。
  • AgentsView 設定：來源探索、提供者排除、封存位置與這些控制的限制。
  • AgentsView 權杖用量與費用：來源支援範圍、用量報表、價格來源、離線模式與已知報告限制。
  • AgentsView 儲存庫：原始碼與 MIT 授權條款；儲存庫將預設封存庫描述為本機封存。