ios-debugger-agent

ios-debugger-agent 是一款專為工程師設計的助手，旨在連接 AI 代理與本地 iOS 開發環境。透過 XcodeBuildMCP 協議，開發者可以直接與運作中的 iOS 模擬器互動，大幅加速開發迭代週期。此代理專為需要快速驗證 UI、診斷執行時期錯誤或將控制台日誌串流至代理環境的 iOS 工程師打造。

• 使用 XcodeBuildMCP 在已啟動的模擬器上編譯並執行應用程式。

• 執行自動化 UI 互動，包括點擊按鈕、在欄位中輸入文字，以及執行滑動或滾動等常用手勢。

• 檢視當前螢幕狀態並截圖，以驗證 UI 佈局與元件的可見性。

• 即時管理並擷取模擬器日誌與控制台輸出，以便高效診斷執行時期行為與堆疊追蹤。

• 動態識別並配置應用程式的 Bundle ID、專案 Scheme 以及模擬器環境。

• 在呼叫編譯或執行指令前，請確保模擬器已啟動；若未啟動，代理會引導您完成設定。

• 在嘗試任何互動手勢前，請優先使用 describe_ui 工具，以確保能精確鎖定 UI 元素。

• 利用日誌捕獲功能將複雜的診斷數據傳送至對話介面進行深入分析。

• 本代理適用於 Xcode 專案或工作區路徑，請確保在會話預設中正確映射相關路徑。

• 若遇編譯失敗，可指示代理使用 preferXcodebuild: true 進行更穩健的編譯嘗試。

• 此工具僅適用於本地模擬工作流程，並需要配置正確的 Xcode 環境。