Theme / v5.3.0

Oh My ClaudeCode

Claude Code 多代理編排系統

指令詳解

omc hud 指令詳解

如何使用 omc hud 啟動動態狀態監控面板,即時查看 AI 代理編排、任務進度與 Token 預算

指令用途

在啟動並行開發(Team Mode)或自主修復(Sisyphus Loop)時,多個代理人在背景默默工作。如果沒有直觀的介面,開發者只能在終端機中看到密密麻麻的捲動日誌,完全不知道當前各 Worker 的具體進度。更糟糕的是,如果 AI 卡在某個死鎖循環中,可能會在背景瘋狂調用 API,造成 Token 費用失控。

omc hud 是 OMC 中的 運行期儀表板配置指令。它會在終端機底部或獨立視窗中,固定渲染一個動態的 HUD 狀態列。這份狀態列會即時統計:

  • 每個背景 Worker 當前的任務狀態與步驟(如 Refactoring...)。
  • 當前會話累積消耗的 Input/Output Token 與實體美元花費。
  • 剩餘預算百分比,並在快超出限制時發出醒目的警報。

運作流程

  1. 終端機畫面分割:調用 tmux 的 split-window,在底部預留 3 行空間。
  2. 數據即時訂閱:與 OMC 本地的狀態 daemon 建立 IPC 連線,訂閱最新的 Token 統計與任務日誌。
  3. 動態更新:每 500 毫秒刷新一次 HUD 面板,以高質感的終端色彩(ANSI Colors)進行渲染。

實戰對話範例

範例:配置並啟動帶有 Token 預算警告的 HUD

  • You:
    /opsx:explore "我需要啟動 HUD 面板,並設定當前會話的最大預算為 5 美元。"
  • AI:

    好的,我將為您執行 omc hud 命令,設定預算上限並在背景啟動儀表板。

    OMC 呼叫: omc hud --enable --budget-limit=5.0
    OMC 回傳:

    [OMC] HUD panel enabled. Budget set to $5.00 USD.
    [OMC] Launching background monitor...

    終端機底部此時已渲染出動態 HUD: [OMC HUD] Active Workers: 0 | Total Spent: $0.12 / $5.00 (2.4%) | Status: Idle

    當您隨後開始執行複雜任務時,這裡的花費會即時更新。如果花費達到 $4.50(90%),HUD 會變為黃色並在終端發出警示音。您現在想開始大重構嗎?