ccch1mneyyy/working-activity

解決的問題

本專案解決了 AI 代理在執行過程中內部狀態缺乏可視性的問題。與使用通用的載入旋轉圖示不同，它提供一個動態的「工作狀態列」，即時顯示代理正在執行的具體操作，包括工具使用、進度以及內部推理摘要。

工作原理

此工具作為兩個平台的擴展/外掛程式運作：pi CLI 與 DeepSeek Harness (DSH)。它監控代理事件（如工具執行開始、更新與結束），並解析模型的串流輸出，以提取並顯示狀態更新。

主要機制包括：

• 事件監聽：追蹤 tool_execution_start 與 tool_execution_update，即時顯示工具名稱與進度百分比。
• 模型敘述：注入系統提示指令，要求模型在每個步驟開始時以簡短描述（例如 ⏵ 檢查錯誤日誌）進行說明，擴展功能隨後提取並顯示該描述。
• 狀態管理：管理快速執行工具的佇列，確保其對使用者可見，並透過監控使用門檻來處理上下文視窗警告。

適用對象

希望在 AI 代理執行複雜任務時獲得更高透明度、沉浸感與資訊量的 pi CLI 與 DeepSeek Harness 使用者。

主要亮點

• 即時工具追蹤：顯示實際工具活動與進度（百分比／階段），而非虛假動畫。
• 上下文警告：當上下文使用量超過 80%（黃色）或 95%（紅色）時向使用者發出警告。
• 模型自我描述：強制模型在 20 個詞以內描述當前操作，以便即時顯示。
• 動態內容：包含 95+ 種口語化表達、時間感知問候語（夜間／週末），以及稀有的「彩虹」彩蛋，讓代理感覺更生動。
• 性能指標：提供任務結束後總結，包括總耗時、工具數量、成本（透過官方 API 使用量）、以及 token 數量。
• Git 整合：在 Git 相關操作期間自動偵測並顯示目前 Git 分支。
• 可客製化：包含可搜尋的設定面板、28 種動畫預設，以及用於設定健康檢查的「Doctor」工具。