Markdown 版本

AI-translated from English; not yet reviewed by a fluent editor.

# 用 AgentsView 稽核一次程式設計代理工作階段

> 在 AgentsView 中找出已知的本機程式設計代理逐字紀錄，檢查已記錄的權杖與費用來源，並閱讀範圍明確的單日報表，避免把估算當成帳單。

By BIG CHANGE Editorial

Published: 2026-10-17T17:20:34.907Z
Updated: 2026-10-17T17:20:34.907Z
Canonical: https://bigchange.ai/blog/audit-coding-agent-session-agentsview

![Conceptual charcoal illustration of a local computer with one blank transcript line highlighted and an external drive beside it.](https://bigchange.ai/api/media/file/agentsview-local-session-audit-concept-v1.png)
AI-generated conceptual illustration by BIG CHANGE; no actual AgentsView interface, transcript, usage figure or billing result is depicted.

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

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

## 開始之前

你需要一個已完成且有權讀取的程式設計代理工作階段、該工作中特有的字句或工作階段 ID，以及讀取其本機日誌目錄的權限。[Quick Start](https://www.agentsview.io/docs/quickstart/)列出 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. 安裝並辨識執行檔

從[安裝指南](https://www.agentsview.io/docs/quickstart/)選擇一種方法。若使用獨立 CLI，文件列出的永久 Python 安裝方式如下：

```sh
pip install agentsview
agentsview --version
```

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

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

若在主機安裝 CLI 或桌面版，請將全新的資料目錄及其 `config.toml` **先準備好**，再啟動 AgentsView。[設定指南](https://www.agentsview.io/docs/configuration/#disabling-session-providers)說明如何使用 `disabled_agents` 排除本機檔案系統提供者，以及使用 `[agents.<id>].dirs` 取代某個提供者的預設根目錄。請找出**所有其他提供者的 ID**（見該指南的[Session Discovery 表格](https://www.agentsview.io/docs/configuration/#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 範例](https://www.agentsview.io/docs/quickstart/#docker)只在 `127.0.0.1` 發布介面，以唯讀方式掛載一個代理來源，並使用獨立資料磁碟區。請**只掛載**授權來源的根目錄，在全新容器內設定對應的目錄變數，並省略[專案的 Compose 範例](https://github.com/kenn-io/agentsview/blob/main/docker-compose.prod.yaml)中的其他掛載。容器只能看見明確掛載的主機工作階段目錄。已發布的 Docker 映像支援 Linux amd64 與 arm64；這條路徑需要可正常運作的 Docker 安裝。

## 3. 建立本機封存庫

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

```sh
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](https://www.agentsview.io/docs/quickstart/)。請記錄代理、工作階段 ID 與日期，以便將用量結果連到正確的對話。

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

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

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

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

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

## 6. 限定單日報表的範圍

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

```sh
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](https://www.agentsview.io/docs/quickstart/)指出，停止常駐程式會同時停止網頁介面與工作階段監看。

## 大改變

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

## 來源與延伸閱讀

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

## Sources

- [AgentsView v0.45.0 版本說明](https://github.com/kenn-io/agentsview/releases/tag/v0.45.0) — 具日期的版本與功能／支援範圍變更。
- [AgentsView Quick Start](https://www.agentsview.io/docs/quickstart/) — 安裝、執行、來源選擇與搜尋操作。
- [AgentsView 設定](https://www.agentsview.io/docs/configuration/) — 來源探索、提供者排除、資料目錄與控制限制。
- [AgentsView 權杖用量與費用](https://www.agentsview.io/docs/token-usage/) — 實驗性用量報告、價格來源與限制。
- [AgentsView 原始碼儲存庫](https://github.com/kenn-io/agentsview) — 原始碼、專案說明與 MIT 授權條款。