用途：为原生 iOS 项目接入 fastlane，实现一键 TestFlight 发布。执行 fastlane beta（或可选的 pnpm ios:testflight 别名）即可归档 Release 构建、计算并写入下一个构建号、签名、导出 IPA 并上传 TestFlight。仅面向单个 App、仅 TestFlight，不涉及 App Store 审核提交与 CI；默认假定使用 XcodeGen 项目，若已提交 .xcodeproj 则删除对应生成行即可。
主要能力与用法：references/ 下提供三个可直接复制的工作文件：Fastfile（含 beta 与 upload 两条 lane）、Appfile（app id 与 team id）、env.testflight.local.example（密钥模板，需加入 .gitignore）；完整说明见 references/setup-and-gotchas.md。用 Homebrew 安装 fastlane：brew install fastlane（系统 Ruby 过旧，勿用 gem install）。在 App Store Connect 创建 API 密钥（Users and Access → Integrations → App Store Connect API，App Manager 角色），记录 Key ID、Issuer ID 与一次性 .p8。设置 Fastfile 中 SCHEME、BUNDLE_ID、TEAM_ID、PLISTS（每个发布目标一个 Info.plist，含所有内嵌扩展），并保持 Appfile 与之一致；按项目实际位置调整 IOS_DIR/ROOT_DIR。填入 .env.testflight.local：ASC_API_KEY_ID、ASC_API_ISSUER_ID、ASC_API_KEY_PATH、ASC_APPLE_ID 为必填，TESTFLIGHT_SIGNING_AUTH_MODE 可选。先 dry-run：fastlane beta skip_upload:true 仅归档导出，成功后再运行 fastlane beta。
注意事项：构建号自动为 max(最新 TestFlight, 本地 plist)+1 写入每个 plist，勿手改 CFBundleVersion；营销版本 CFBundleShortVersionString 需手动递增且各目标保持一致，否则 lane 终止。ASC_APPLE_ID 为数字 app id 而非邮箱，这是最常见的首次失败原因。签名使用自动签名与 -allowProvisioningUpdates，Mac 需具备 Apple Distribution 证书；export_method 为 "app-store"，签名 xcargs 需同时传给 archive 与 export 步骤。
限制：资料未提供收费、价格与平台兼容性等更多信息。