新增完整 UI Test 回归套件，并完善启动隔离逻辑。

按模块拆分 XCUITest 用例与 Support 基础设施，UI Test 运行时跳过推送与排队 WebSocket，并将 Podfile 最低版本对齐 iOS 16。

Co-authored-by: Cursor <cursoragent@cursor.com>

suixinkanUITests/README.md

@@ -0,0 +1,88 @@
+# suixinkan UI Tests
+
+本目录包含 App 的 XCUITest 回归套件，通过 **api-test 真实接口** 验证页面可达性与关键业务流程。
+
+## 约束
+
+- 测试代码仅位于 `suixinkanUITests/`，App 侧仅扩展 `suixinkan/App/` 基础设施（如 `AppUITestLaunchState`）。
+- **不修改** `Features/`、`Core/` 业务代码，不在 App 内注入 Mock 网络。
+- DEBUG 构建下通过「我的 → 首页调试」批量覆盖首页路由。
+
+## 环境变量
+
+在 Scheme **Environment Variables** 或 `xcodebuild` 中配置：
+
+| 变量 | 必填 | 说明 |
+| --- | --- | --- |
+| `SUI_TEST_PHONE` | 是 | 登录手机号 |
+| `SUI_TEST_PASSWORD` | 是 | 登录密码 |
+| `SUI_TEST_ACCOUNT_NAME` | 否 | 多账号选择页要点的账号展示名 |
+
+**本机快捷配置（推荐）：** 在 `suixinkanUITests/UITestCredentials.local.plist` 中配置 `SUI_TEST_PHONE`、`SUI_TEST_PASSWORD` 和可选的 `SUI_TEST_ACCOUNT_NAME`。该文件已加入 `.gitignore`，不会提交到 Git。环境变量优先级高于本地 plist。
+
+缺少账号时，需要登录的用例会自动 `XCTSkip`。
+
+已登录用例默认复用 Keychain 会话，每个测试类只完整登录一次；仅 `LoginSmokeUITests` 会显式清空本地状态。
+
+## 测试数据约定（api-test）
+
+以下数据建议为 UI Test 专用账号预置，否则部分「列表 → 详情」用例会跳过：
+
+- 至少 1 条门店订单、1 条核销订单
+- 至少 1 条任务、项目、打卡点、押金订单（可选）
+- 账号需有景区/门店上下文
+
+## 运行命令
+
+```bash
+# 仅跑 UI Tests（需先配置环境变量）
+xcodebuild test \
+  -workspace suixinkan.xcworkspace \
+  -scheme suixinkan \
+  -destination 'platform=iOS Simulator,name=iPhone 17' \
+  -only-testing:suixinkanUITests
+
+# 带环境变量示例
+SUI_TEST_PHONE=13800138000 \
+SUI_TEST_PASSWORD='your-password' \
+xcodebuild test \
+  -workspace suixinkan.xcworkspace \
+  -scheme suixinkan \
+  -destination 'platform=iOS Simulator,name=iPhone 17' \
+  -only-testing:suixinkanUITests
+```
+
+## 启动参数
+
+UI Test 进程会自动传入：
+
+- `-suixinkan-ui-tests`：主开关，App 侧跳过推送注册与排队 WebSocket
+- `-suixinkan-ui-tests-reset-state`：冷启动清理 Keychain / UserDefaults
+
+## 目录结构
+
+```
+suixinkanUITests/
+  Support/          # 启动配置、登录、导航、断言
+  Auth/             # 登录冒烟与完整登录流
+  Shell/            # 主 Tab
+  Home/             # 首页调试菜单全路由
+  Profile/          # 我的二级页
+  Orders/           # 订单深层流
+  Modules/          # 各业务模块交互
+```
+
+## 降级 / 跳过项
+
+以下场景在模拟器 UI Test 中仅验证「可打开 / 可关闭」，不做完整硬件或上传闭环：
+
+- 真机摄像头扫码内容识别
+- 直播推流预览与音视频专项
+- 高德地图完整选点
+- OSS 真实文件上传（可选只验证选图 Sheet）
+
+## 新增页面时
+
+1. 在 `Support/UITestHomeMenuCatalog.swift` 补充调试菜单覆盖项（如有首页入口）。
+2. 在对应 `Modules/*UITests.swift` 增加关键交互用例。
+3. 优先使用已有 `accessibilityIdentifier`、导航栏标题和稳定文案定位，不修改 Features 视图。