用途
setup-mac2 用于在 macOS 上准备并验证 Appium Mac2 驱动，以便进行原生 macOS 应用自动化。它只负责 Mac2 这条路线；如果设置通过后仍出现运行时故障，应改用驱动专属的官方指引。
主要能力
该技能覆盖以下检查与验证环节：
- 确认 macOS 作为主机和目标。
- 确认使用全局 appium 模式，或显式请求的本地 npx appium 模式。
- 检查 Xcode 工具链状态、权限以及所需的隐私授权状态。
- 加载 macOS 与 Mac2 配置、共享的 Appium 设置基础、Xcode 命令行工具上下文，以及 Mac2 决策、doctor 和冒烟测试参考。
- 运行环境检查脚本，要求顶层 summary.requiredOk 为 true。
- 按技术依赖顺序应用必需修复，并重新运行受影响的检查。
- 验证 doctor 输出报告 0 个必需修复。
- 运行冒烟测试脚本，要求服务器就绪、驱动证据和清理的 summary.requiredOk 为 true。
使用方式
默认加载全局命令配置；仅在显式请求时加载本地配置。
运行环境检查：
node tools/appium/setup/scripts/check-mac2-env.mjs --format summary --report auto
仅在显式请求本地模式时追加 --appium-mode local。要求顶层 summary.requiredOk: true。
验证 doctor 输出：
appium driver doctor mac2
本地模式下使用：
npx --no-install appium driver doctor mac2
运行冒烟测试：
node tools/appium/setup/scripts/smoke-appium-server.mjs --driver mac2 --report auto
本地模式下追加 --appium-mode local。要求服务器就绪、驱动证据和清理的 summary.requiredOk: true。冒烟测试参考文档记录了目标专属选项。
适用场景
适用于需要在 macOS 上搭建 Appium Mac2 驱动、进行原生 macOS 应用自动化的场景。要求以 macOS 作为主机和目标。
安全与审批约束
- 要求 macOS。
- 在执行特权命令、更改 Xcode 许可或首次启动设置、更改隐私设置之前，必须先询问用户。
- 保留所选的命令模式，以及可正常工作的 Xcode 和驱动安装。
完成标准
xcodebuild -version和xcode-select -p成功。- Xcode 许可和首次启动要求已处理。
- Appium 在所选命令模式下成功，且已安装列表包含 mac2。
appium driver doctor mac2报告 0 个必需修复。- 会话启动需要时，所需隐私权限已获用户批准。
/status成功，且日志列出 mac2。
证据边界
报告内容应涵盖：Xcode 工具链、Appium 与驱动版本、辅助工具与 doctor 摘要、隐私授权阻塞项、/status、服务器驱动证据以及清理情况。
自我改进提示
在最终回复之前，报告任何缺失、含糊、过时或导致重试的 Mac2 设置指令，并附上其资产路径和建议措辞。无关资产保持不变。
限制
资料未提供该技能的具体收费、价格、平台支持范围（除 macOS 外）、效果保证或额外使用步骤。