我們會閱讀每一則回饋，並非常重視您的意見。
欲查看所有可用的限定條件，請參考我們的文件。
Agents Observe 是一款針對 Claude Code 與 Codex 代理的即時可觀察性儀表板。
它包含強大的過濾、搜尋功能，以及多代理會話的視覺化呈現，支援完整回放與代幣使用統計。
版本 0.9.7 新增了會話統計中的代幣使用與成本細目。
預設儀表板網址為：http://localhost:4981
預設情況下，SQLite 資料庫與日誌檔案存放於：
資料庫位於 <root>/data/observe.db，日誌則在 <root>/logs/。
若要將資料位置固定於其他路徑，例如外部磁碟，請在 ~/.claude/settings.json 中設定 AGENTS_OBSERVE_LOCAL_DATA_ROOT。
升級插件時會自動保留您的資料庫。若您從舊版本（≤ 0.9.8）升級，伺服器在首次啟動時會掃描舊版本安裝目錄下的資料庫並複製到穩定位置。相關紀錄可見於 <root>/data/.migrated-from.json。
若主機未安裝 docker、node 或 bash，插件將無法正常載入。
可使用 /observe debug claude 指令協助排查與修復安裝問題。
當 Claude Code 自主運行時，會產生子代理、呼叫工具、讀取檔案、執行指令，您無法得知實際發生了什麼。終端機只顯示部分活動，子代理不可見，工具呼叫混雜不清，當錯誤發生於多層代理並行執行時，您只能事後翻閱日誌。
Agents Observe 會捕捉每個事件掛鉤並即時串流至儀表板。您能清楚看到每個代理的行為、呼叫的工具、操作的檔案，以及子代理與父代理的關係，全部即時呈現。
若您未使用插件安裝，可參考此段說明。
請將 .claude/settings.json 中的掛鉤複製到您專案的設定中，並更新 $CLAUDE_PROJECT_DIR 路徑指向 agents-observe 的安裝位置。
環境變數設定詳見 docs/ENVIRONMENT.md。
開啟 http://localhost:5174（開發模式）或 http://localhost:4981（Docker 模式），您應該會看到測試事件出現。啟動 Claude Code 會話後，事件會自動串流進來。
掛鉤會在每個 Claude Code 事件（工具呼叫、提示、停止、子代理生命週期）觸發。observe_cli.mjs 從標準輸入讀取原始事件，並透過 hooks/scripts/lib/agents/<class>.mjs 分派，每個代理類別的 buildHookEvent() 會建立事件封包（包含專案元資料與代理類別相關標記如 meta.isNotification / meta.clearsNotification），CLI 再將其 POST 至伺服器。若伺服器需要額外資料（如會話的可讀別名），會回傳請求，掛鉤會從本地文字紀錄檔讀取並回傳。
客戶端初次載入時透過 REST API 取得事件，之後透過 WebSocket 接收即時更新（事件會附加至本地快取，無需重新抓取）。所有代理狀態（狀態、事件計數、時間）均由事件串流推導。工具事件在客戶端去重（PreToolUse 與 PostToolUse 合併為一列）。表情符號圖示映射與摘要產生為可編輯設定檔。
開發模式下，客戶端與伺服器分別運行於不同程序與埠口。
生產或 Docker 模式下，客戶端打包並由伺服器提供，API 與儀表板共用同一程序與埠口。
本地開發與 Docker 流程預設使用 ./data 中相同的 sqlite 資料庫，資料庫會自動建立。
插件需 Docker 執行伺服器，請確保 Docker Desktop（或 Docker 守護程序）正在運行，然後重新啟動 Claude Code。
若 4981 埠口被佔用，伺服器會自動分配空閒埠口。若要指定埠口，可在環境變數或 .env 檔案中設定 AGENTS_OBSERVE_SERVER_PORT=<port>。
使用 /observe debug 指令可診斷伺服器健康狀況、Docker 容器日誌、MCP 日誌與 CLI 日誌。也可用 /observe status 快速檢查健康狀態。
若事件未出現在儀表板，客戶端會每 3 秒自動重連 WebSocket，側邊欄底部會顯示「Disconnected」。重連期間接收到的事件會在連線恢復並重新抓取後顯示。
執行 just db-reset 可刪除 SQLite 資料庫並重新開始（會停止伺服器、刪除資料庫、重啟伺服器）。資料庫會在下一次伺服器啟動時自動建立。
Agents Observe 提供 Claude Code 會話與多代理系統的即時可觀察性。