Observability

Observability 技能是專為 PAI (個人 AI 基礎架構) 設計的強大監控解決方案，能深入即時地監控複雜的多代理環境。透過整合 Bun、Express 和 Vue 的高效能技術堆疊，它能在不依賴沈重持久化資料庫的情況下，捕捉 AI 系統的運作脈動。它專為需要掌控瞬時代理工作階段、工具執行鏈及鉤子驅動事件流的開發人員與進階用戶量身打造。當代理自動執行任務時，此儀表板成為您觀察其決策過程的窗口，記錄從工作階段初始化到結束的每一個重要互動。

• 即時 WebSocket 串流提供代理活動的即時更新，確保您不會錯過任何關鍵轉換或工具呼叫執行。

• 無縫的檔案系統監控功能可自動追蹤主要的 raw-outputs 事件日誌，並在執行時顯示工作階段的時間軸與追蹤紀錄。

• 輕量級的瞬時架構避免了持久層，完全在記憶體中執行，確保系統快速啟動並將對效能的影響降至最低。

• 透過專屬管理腳本進行全面的狀態管理，只需一個指令即可對後端伺服器與前端 UI 進行啟動、停止、重啟與狀態檢查。

• 整合式鉤子支援確保 PAI 鉤子框架記錄的所有內部系統事件，都能在 http://localhost:5172 的直覺式瀏覽器介面中呈現。

• 當您需要除錯卡住的工作流程、識別重複呼叫的工具，或單純想監控代理合作效率時，請使用此技能。

• 系統會從 ~/.claude/history/raw-outputs/ 讀取 JSONL 檔案，並透過 4000 埠口的伺服器廣播事件資料。

• 請確保您的 PAI 鉤子已設定為將事件捕捉至每日 raw-outputs 檔案中；本技能依賴此日誌流來填充儀表板資訊。

• 非常適合運行多個並行代理的環境，對於了解操作順序或識別阻塞的工具呼叫以進行系統優化至關重要。