如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .md 即可查看该页面的 Markdown 版本。
主导航
主题
Codex

Codex 使用场景

在 iOS 模拟器中调试

使用 Codex 和 XcodeBuildMCP 在 iOS 模拟器中操作应用,收集证据,逐步修复问题。

难度 Advanced
时间跨度 1h

让 Codex 找到合适的 Xcode 方案和模拟器,启动应用并检查 UI 层级结构。Codex 可以模拟轻点、输入和轻扫操作,截屏并收集日志,必要时还可以附加 LLDB 调试器。即使问题报告描述得不够清楚,Codex 也能据此排查问题,用少量代码改动完成修复并验证结果。

最适合

  • 只有在模拟器中按特定步骤轻点、滚动或填写表单才会出现的 UI 问题
  • 应用崩溃、卡死或导航异常,Codex 需要先查看日志、截图、视图层级状态和调试器中的调用栈,再修改代码
  • 希望由 Codex 负责复现、修复和验证全过程,省去人工逐一点击检查各个状态的团队

目录

    ← 所有使用场景

    在 iOS 模拟器中调试

    使用 Codex 和 XcodeBuildMCP 在 iOS 模拟器中操作应用,收集证据,逐步修复问题。

    让 Codex 找到合适的 Xcode 方案和模拟器,启动应用并检查 UI 层级结构。Codex 可以模拟轻点、输入和轻扫操作,截屏并收集日志,必要时还可以附加 LLDB 调试器。即使问题报告描述得不够清楚,Codex 也能据此排查问题,用少量代码改动完成修复并验证结果。

    Advanced
    1h

    让 Codex 找到合适的 Xcode 方案和模拟器,启动应用并检查 UI 层级结构。Codex 可以模拟轻点、输入和轻扫操作,截屏并收集日志,必要时还可以附加 LLDB 调试器。即使问题报告描述得不够清楚,Codex 也能据此排查问题,用少量代码改动完成修复并验证结果。

    Advanced
    1h

    最适合

    • 只有在模拟器中按特定步骤轻点、滚动或填写表单才会出现的 UI 问题
    • 应用崩溃、卡死或导航异常,Codex 需要先查看日志、截图、视图层级状态和调试器中的调用栈,再修改代码
    • 希望由 Codex 负责复现、修复和验证全过程,省去人工逐一点击检查各个状态的团队

    技能与插件

    • 让 iOS 调试智能体使用 XcodeBuildMCP 构建应用,并在模拟器中启动、检查和操作应用。随后,让智能体收集日志、截图和堆栈跟踪,供 Codex 逐步缩小排查范围。
    技能 使用理由
    Build iOS Apps 让 iOS 调试智能体使用 XcodeBuildMCP 构建应用,并在模拟器中启动、检查和操作应用。随后,让智能体收集日志、截图和堆栈跟踪,供 Codex 逐步缩小排查范围。

    起始提示词

    请使用 Build iOS Apps 插件和 XcodeBuildMCP,直接在模拟器中复现这个问题,查明根本原因,并用少量代码改动修复它。 问题报告: [Describe the expected behavior, the actual bug, and any known screen or account setup.] 要求: - 先检查是否已选定项目、方案和模拟器。如果尚未选定,请找到对应的 Xcode 项目或工作空间,选好应用的方案和模拟器,并在本次会话的后续操作中沿用这套配置。 - 构建应用并在模拟器中启动。开始操作前,先通过 UI 快照或截图确认当前显示的是目标界面。 - 请自行在模拟器中严格按照复现步骤执行轻点、输入、滚动和轻扫操作。定位元素时,优先使用辅助功能标签或 ID,尽量避免使用原始坐标。布局发生变化时,先重新读取 UI 层级结构,再执行下一步操作。 - 调试时,用截图记录界面状态,并收集故障发生前后的模拟器日志。如果应用疑似崩溃或卡死,还要用 LLDB 记录栈帧或变量值。 - 如果模拟器尚未启动,请启动一个,并告诉我选用的设备和操作系统。如果需要凭据或特定的测试夹具,请暂停,只向我索取缺少的内容。 - 用尽可能少的代码改动修复问题,然后在模拟器中重新执行复现步骤,并具体说明如何验证了修复结果。 请提供: - Codex 实际执行的复现步骤 - 能解释问题原因的关键截图、日志或调用栈信息 - 修复问题的代码改动,以及这些改动为何能解决问题 - 最终验证所用的模拟器和 Xcode 方案
    请使用 Build iOS Apps 插件和 XcodeBuildMCP,直接在模拟器中复现这个问题,查明根本原因,并用少量代码改动修复它。 问题报告: [Describe the expected behavior, the actual bug, and any known screen or account setup.] 要求: - 先检查是否已选定项目、方案和模拟器。如果尚未选定,请找到对应的 Xcode 项目或工作空间,选好应用的方案和模拟器,并在本次会话的后续操作中沿用这套配置。 - 构建应用并在模拟器中启动。开始操作前,先通过 UI 快照或截图确认当前显示的是目标界面。 - 请自行在模拟器中严格按照复现步骤执行轻点、输入、滚动和轻扫操作。定位元素时,优先使用辅助功能标签或 ID,尽量避免使用原始坐标。布局发生变化时,先重新读取 UI 层级结构,再执行下一步操作。 - 调试时,用截图记录界面状态,并收集故障发生前后的模拟器日志。如果应用疑似崩溃或卡死,还要用 LLDB 记录栈帧或变量值。 - 如果模拟器尚未启动,请启动一个,并告诉我选用的设备和操作系统。如果需要凭据或特定的测试夹具,请暂停,只向我索取缺少的内容。 - 用尽可能少的代码改动修复问题,然后在模拟器中重新执行复现步骤,并具体说明如何验证了修复结果。 请提供: - Codex 实际执行的复现步骤 - 能解释问题原因的关键截图、日志或调用栈信息 - 修复问题的代码改动,以及这些改动为何能解决问题 - 最终验证所用的模拟器和 Xcode 方案

    让 Codex 完成模拟器调试的全过程

    在这个用例中,让 Codex 负责整个调试流程效果最好。它先选择正确的应用构建目标,在模拟器中启动应用,检查当前界面,再按步骤复现问题,收集日志和截图,必要时查看堆栈跟踪。修复代码后,它会按相同步骤再操作一遍,确认问题已解决。

    如果您希望 Codex 自主完成这一流程,可以使用 Build iOS Apps 插件。该插件的 iOS 调试工作流基于 XcodeBuildMCP,Codex 可以操作已启动的模拟器,收集通常需要开发者手动获取的调试证据。

    为 XcodeBuildMCP 配置模拟器自动化、UI 自动化、调试和日志记录工作流后,Codex 就可以完成从复现、调试到验证的整个流程。如果 Codex 尚未选定项目、构建方案和模拟器,请让它先查找并选定这三项,然后在本次会话的后续操作中沿用这套配置。

    充分利用 XcodeBuildMCP 的功能

    您可以在提示词中要求 Codex 使用以下几类功能:

    • 查找项目和模拟器:检查 Codex 是否已经知道要使用哪个应用构建目标和模拟器,查找 Xcode 项目或工作空间,列出构建方案,找到或启动模拟器,并在后续构建和运行时沿用这套配置。
    • 构建和启动应用:构建当前选定的应用目标,将为模拟器构建的应用安装到模拟器中并启动。必要时重新启动应用并采集日志。如果 Codex 需要查看该应用的运行时日志,让它先确定应用的包标识符。
    • 检查和操作界面:读取当前屏幕的无障碍元素层级,截取屏幕画面,轻点控件,在输入框中输入文本,滚动列表,并在模拟器上执行从屏幕边缘滑动等手势。
    • 查看日志和调试器状态:实时查看模拟器日志,将 LLDB 附加到正在运行的应用,设置断点,检查栈帧和局部变量。如果需要深入排查崩溃或卡死问题,还可以运行调试器命令。

    养成一个习惯:让 Codex 在轻点控件前先检查视图树。XcodeBuildMCP 会提供无障碍元素的层级和坐标,因此 Codex 可以优先通过稳定的标签或元素 ID 定位控件,无须猜测屏幕坐标。

    把模糊的问题描述写成可复现的操作脚本

    使用 iOS 调试技能时,最好在提示词中说明一个具体问题和一个预期结果,然后让 Codex 自主操作应用并收集证据。如果复现问题需要登录、使用深层链接或准备测试夹具,请在提示词中一次说明,并要求 Codex 仅在缺少必要输入而无法继续时暂停。

    实用技巧

    要求 Codex 提供修复方案和调试证据

    请让 Codex 说明具体使用了哪个模拟器和构建方案,并提供用于解释问题的截图、日志片段和调用栈详情。有了这些信息,您在审查最终补丁时就比只看到一句“我觉得这样应该能修好”更容易判断修复是否有效。

    优先用无障碍标签定位控件

    如果控件没有稳定的标签或无障碍标识符,导致 Codex 只能按坐标轻点,请让它明确指出这一点。这通常意味着修复问题时还应对界面做一处小调整,让控件更易于测试。

    每次只调试一个问题

    通过模拟器调试可以排查多种问题,但每条提示词只针对一种故障,调试结果更容易验证,也更值得信赖。请让 Codex 先复现并修复一个问题,验证修复结果后再处理相关问题。

    技术栈

    需求

    模拟器自动化

    默认选项

    XcodeBuildMCP

    为什么需要

    现有工具可以配置模拟器、构建和启动应用、获取 UI 快照,还能模拟轻点、文本输入和手势操作,以及截屏、收集日志和附加调试器。

    需求

    智能体工作流

    为什么需要

    通过插件中的 iOS 调试智能体,Codex 可以先在模拟器中复现问题并收集证据,然后在每次改动后重新验证修复效果。

    需求

    应用可观测性

    默认选项

    Logger、OSLog、LLDB 和模拟器截图

    为什么需要

    Codex 可以根据日志和调试器状态解释哪里出了问题,再保存截图,准确记录修复前后的 UI 状态。

    需求 默认选项 为什么需要
    模拟器自动化 XcodeBuildMCP 现有工具可以配置模拟器、构建和启动应用、获取 UI 快照,还能模拟轻点、文本输入和手势操作,以及截屏、收集日志和附加调试器。
    智能体工作流 Build iOS Apps 插件 通过插件中的 iOS 调试智能体,Codex 可以先在模拟器中复现问题并收集证据,然后在每次改动后重新验证修复效果。
    应用可观测性 Logger 、 OSLog 、LLDB 和模拟器截图 Codex 可以根据日志和调试器状态解释哪里出了问题,再保存截图,准确记录修复前后的 UI 状态。

    相关使用场景