cmux-diagnostics

cmux 診斷

使用此技能來收集並解讀支援安全的 cmux 診斷資訊，供終端使用者使用。預設為唯讀檢查。請勿傾印鉤子設定檔、工作階段儲存區、提示記錄、權杖或環境機密。

快速報告

先執行內建的唯讀診斷腳本：

# 從 cmux 儲存庫
skills/cmux-diagnostics/scripts/cmux-diagnostics

# 從已安裝的技能
~/.agents/skills/cmux-diagnostics/scripts/cmux-diagnostics

# 從僅安裝 skills.sh 的 Codex
~/.codex/skills/cmux-diagnostics/scripts/cmux-diagnostics

僅當工作區名稱、目前工作目錄路徑和目前 cmux 識別碼與使用者回報的問題相關時，才使用 --include-context：

skills/cmux-diagnostics/scripts/cmux-diagnostics --include-context

檢查項目

1. CLI 與 socket 健康狀態：

   command -v cmux
   cmux ping
   cmux capabilities --json
   

   如果 socket 指令失敗，請檢查代理程式是否在 cmux 終端機內執行，以及 socket 自動化是否已啟用。

2. 設定健康狀態：

   ~/.agents/skills/cmux-settings/scripts/cmux-settings validate
   ~/.agents/skills/cmux-settings/scripts/cmux-settings get terminal.autoResumeAgentSessions
   

   如果使用者是透過 skills.sh 安裝，請改用 ~/.codex/skills/cmux-settings/scripts/cmux-settings。
   如果 terminal.autoResumeAgentSessions 為 false，cmux 會還原窗格，但不會自動恢復已儲存的代理程式工作階段。

3. 鉤子安裝：

   cmux hooks setup --agent codex
   cmux hooks setup --agent opencode
   cmux hooks setup
   

   僅在使用者同意後才執行安裝或解除安裝指令。cmux hooks setup 會安裝 PATH 上找到的受支援代理程式，並跳過遺失的代理程式。

4. 工作階段還原證據：

   ls -lh ~/.cmuxterm/*-hook-sessions.json 2>/dev/null
   

   缺少工作階段儲存區通常表示自安裝鉤子以來代理程式尚未在 cmux 內執行、鉤子已停用，或代理程式整合不支援恢復擷取。

5. 通知路徑：

   cmux notify "cmux 診斷測試"
   

   僅在使用者準備好接收可見測試通知時使用。

解讀

• cmux 找不到：CLI 未安裝或未在此 shell 的 PATH 中。
• cmux ping 失敗：應用程式無法透過目前的 socket 路徑連線、應用程式已關閉，或自動化存取已停用。
• 沒有 CMUX_WORKSPACE_ID 或 CMUX_SURFACE_ID：指令可能是在 cmux 終端機外部執行。某些鉤子在 cmux 外部會故意不執行任何操作。
• 鉤子設定存在但無工作階段儲存區：在安裝鉤子後，在 cmux 內執行一個受支援的代理程式，然後重新檢查。
• 工作階段儲存區存在但還原未啟動代理程式：檢查 terminal.autoResumeAgentSessions 以及儲存的可執行檔是否仍在 PATH 上。
• 設定驗證失敗：先修正設定。無效的設定可能導致後續症狀誤導。

規則

• 在使用者要求修正之前，保持唯讀。
• 絕不列印原始鉤子檔案、工作階段 JSON、提示記錄、shell 歷史記錄、權杖或 API 金鑰。
• 總結檔案存在與否、大小、修改時間和標記存在與否，而非內容。
• 偏好狹義的修正，例如 cmux hooks setup --agent codex，而非重新安裝所有整合。
• 修正後，重新執行診斷腳本並報告變更的行數。