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 环境。