不再手动点击 Xcode 的 Organizer。一次性配置 App Store Connect API 密钥，然后在聊天中说"把这个发布到 TestFlight"——智能体会自动完成归档、导出、签名和上传。
将 iOS 构建发布到 TestFlight，本质上是一连串重复的小步骤：为正式发布归档应用，使用 App Store 分发设置导出 IPA，针对描述文件进行验证，上传到 App Store Connect，等待处理，再确认构建是否出现在列表中。每个步骤都有自己的对话框或命令，而且每次都一模一样——这种事不应该由人来手动完成。
Xcode 的 Organizer 通过向导将这些步骤串联起来，稍微减轻了痛苦，但仍然需要你来驱动：点击"分发"，选择目标，等待，点击"下一步"，等待，点击"上传"。如果中途有任何失败——缺少某项能力、构建版本号重复、描述文件过期——你就得从头再来。
LingCode 智能体已经具备驱动每个步骤所需的工具（xcodebuild archive、xcodebuild -exportArchive、xcrun altool --upload-app）以及所需的上下文（你的项目、Bundle ID、Keychain 中的签名身份）。要实现端到端的"一键发布"，缺少的只有一个凭据：用于签署上传请求的 App Store Connect API 密钥。注册好该密钥后，只需在聊天中说"把这个构建上传到 TestFlight"，即可触发完整流程——实时输出各阶段日志，并在构建就绪后通知你。本教程涵盖凭据配置和实际发布两部分。
以账号持有人或管理员角色登录 App Store Connect，前往 用户和访问 → 集成 → App Store Connect API → 团队密钥，点击 生成 API 密钥（如果你已有用于 TestFlight 上传的密钥，也可直接使用现有密钥）。
为密钥赋予 App 管理员角色——这对 TestFlight 上传已足够，且避免了权限过度授予。在提示时下载 .p8 文件。该文件只有一次下载机会，请像对待其他凭据一样妥善保管。
记下接下来需要用到的三个值：发行人 ID（页面顶部显示）、密钥 ID（紧邻你刚创建的密钥旁边），以及 .p8 文件的路径。
打开 AI 聊天面板，输入：
Set my App Store Connect API key. Issuer ID is <your-issuer-id>, Key ID is <your-key-id>, p8 is at /Users/me/Downloads/AuthKey_<key-id>.p8
智能体将调用内部的 set_asc_api_key 工具，将凭据存入 LingCode Keychain（服务名为 LingCode）。存储的是 .p8 文件的内容，而非文件路径，因此原始文件删除后不影响使用。
在涉及网络和 Apple 之前，先验证归档在本地是否成功。在聊天中输入：Archive the app for release. 智能体会以 Release 配置运行 xcodebuild archive，将构建日志实时输出到运行控制台，并报告归档路径。
如果此步骤失败，请先修复根本原因（签名问题、缺少能力、Info.plist 错误等），再继续后续步骤。许多上传在第一次就止步于此，而公证服务的错误比本地归档失败更难调试。
归档成功后，输入：
Upload this build to TestFlight.
智能体将调用 archive_and_upload_testflight（如果你已有归档，则调用其仅上传的变体）。内部流程为：从归档导出使用 App Store 分发设置的 IPA → 通过 xcrun altool --upload-app 上传至 App Store Connect → 轮询处理状态 → 报告可在 TestFlight 中找到的构建版本号。
智能体会将各阶段日志实时输出到运行控制台：归档中 → 导出 IPA → 验证中 → 上传中 → 处理中。每个阶段都有计时。上传中阶段绝对耗时最长（IPA 文件可达数 GB）；处理中阶段在 Apple 服务器端异步执行，可能需要 5 到 30 分钟。
你可以离开聊天标签页，智能体会在构建可用于 TestFlight 或处理失败时推送通知。
CFBundleVersion 的重复上传。在构建设置中递增 CURRENT_PROJECT_VERSION，重新归档即可。（向智能体说："Bump build number and re-archive."）.entitlements 文件中声明的某项权限。如果你怀疑是智能体的编辑导致了此问题，请参阅撤销智能体的错误编辑。UIDeviceFamily 中缺少必需的设备系列。在 Info.plist 中修复后重新归档即可。