feat(mobile-app): prepare native app packaging

docs/MOBILE_APP_DEVICE_ACCEPTANCE.md

@@ -0,0 +1,31 @@
+# 原生 App 真机验收清单
+
+此清单用于 Android/iOS 自定义基座或签名包验收。`npm --prefix mobile-uni run verify:app-assets` 只校验静态资源和 manifest 映射，不能替代本清单。
+
+## 预条件
+
+1. 已执行 `npm --prefix mobile-uni run build:app`，并使用 HBuilderX 的**自定义运行基座**运行当前资源。
+2. Android 首次上机前，复制 `mobile-uni/androidPrivacy.json.example` 为 `mobile-uni/androidPrivacy.json`，替换两个法务确认的 HTTPS 链接；再执行 `npm --prefix mobile-uni run verify:app-release`。
+3. 使用有效的移动端测试账号；不得把管理员 Web 登录态当作 App 登录验证。
+4. 每台设备保留系统版本、App `versionName/versionCode`、基座/包哈希、录屏或截图和失败日志。
+
+## Android（最低 Android 10 + 一台当前主流机型）
+
+- [ ] 首次启动先显示原生隐私弹窗；两个协议链接可打开，拒绝后退出，同意后才进入登录。
+- [ ] 手机号登录、短信验证码错误、登录失效重登均符合预期。
+- [ ] 首次录音允许麦克风后，可完成转写；拒绝麦克风后不循环申请，能选择本地音频继续。
+- [ ] 图片、视频、文档和音频可选择并上传；受控附件下载后可打开，不泄露 OSS 地址。
+- [ ] 前后台切换、网络断开/恢复、窄屏和底部手势区无白屏、遮挡或重复提交。
+- [ ] 再次安装同版本后，桌面图标、启动图和 Android 导航栏不闪白。
+
+## iPhone（iOS 15 + 一台当前刘海或灵动岛机型）
+
+- [ ] 初次访问录音时，系统麦克风说明与功能一致；拒绝后可选择音频且不崩溃。
+- [ ] 选择图片/视频/文件时，系统照片/文件访问说明与功能一致；取消选择不会残留上传状态。
+- [ ] 登录、录音转写、TTS 播放、上传、受控下载、前后台切换均通过。
+- [ ] 启动图全屏，无黑边；状态栏、刘海、底部安全区和键盘不遮挡主要操作。
+- [ ] App Store 图标无透明通道、未预制圆角；真机图标更新后重启设备复核 iOS 缓存。
+
+## 通过口径
+
+每个平台的必测项全部通过，且录音拒绝、媒体取消、登录失效和离线恢复四种反例均留有证据，才可进入签名包或 TestFlight/企业 APK 测试。任何 App 壳、权限、原生插件或证书变更都必须重新云打包并重跑本清单。

docs/MOBILE_APP_PACKAGING.md

@@ -0,0 +1,42 @@
+# mobile-uni 原生 App 打包
+
+`mobile-uni/` 采用 uni-app Vue 3 的 App-Plus 目标，同时保留 H5。App 不是将线上 H5 包进 WebView；前端资源通过 `npm --prefix mobile-uni run build:app` 编译，再由 HBuilderX 的自定义基座或云端打包生成 Android/iOS 原生安装包。
+
+## 当前约定
+
+- Android applicationId 与 iOS Bundle ID 预设为 `com.yincheng.wygj`。在首次签名或注册 App ID 前，发布负责人必须确认企业实际拥有该标识；变更时 Android、iOS 必须同步修改。
+- App 直接请求 `https://peilian.njzhmj.top/dev-api`。不依赖 H5 开发服务器的 `/dev-api` proxy；地址是公开配置，不得在 App 包中放入短信、模型、签名或任何服务端密钥。
+- `manifest.json` 只保留不含秘密的发布配置。`.keystore`、`.p12`、`.mobileprovision` 与证书密码只能由发布负责人在 HBuilderX 云打包界面或受控 CI 秘密变量中提供，绝不能提交 Git。
+- Android 最低试点设备为 Android 10，iOS 最低试点设备为 iOS 15；每次发版提升 `versionCode`，再更新 `versionName`。
+
+## 本地验证与出包
+
+```bash
+npm --prefix mobile-uni run generate:app-assets
+npm --prefix mobile-uni run verify:app-assets
+npm --prefix mobile-uni run typecheck
+npm --prefix mobile-uni run build:h5
+npm --prefix mobile-uni run build:app
+```
+
+1. 用 HBuilderX 打开 `mobile-uni`，先生成 Android/iOS **自定义运行基座**。标准基座不会加载当前的包名、权限、启动图或原生配置。
+2. 在真实 Android 与 iPhone 上验证手机号登录、录音并转写、TTS 播放、图片/视频/文件上传、附件下载、拒绝权限、前后台切换、刘海和底部安全区。
+3. Android 试点使用企业签名的正式 APK；上架渠道按渠道要求导出相应制品。iOS 使用企业 Apple Developer 账号的 Distribution 证书和 provisioning profile，先走 TestFlight。
+
+## 发布前尚需提供的资产
+
+- 经法务确认并已可公开访问的《服务协议》《隐私政策》；Android 必须用该实际链接配置原生 template 隐私弹窗，iOS 需提供相应的麦克风、相机、相册/文件用途说明。
+- 无透明通道的 1024×1024 App Store 图标，以及 Android 自适应图标/启动图。
+- 企业持有的 Android 签名证书、Apple Team、Bundle ID 注册与 iOS 发布证书。上述资产缺失时可以完成代码与真机调试，不能声称已具备商店上架条件。
+
+## 已接入的资产与隐私模板
+
+- 图标和启动图由 `scripts/generate-app-assets.sh` 从现有 `src/static/brand-logo.png` 生成，输出位于 `src/static/app/`，并由 `manifest.json` 显式关联。iOS App Store 图标为 1024×1024、无 alpha、未预制圆角；生成后可用 `npm --prefix mobile-uni run verify:app-assets` 校验尺寸和映射。
+- 现有品牌源图仅为 64×64，因此这里生成的是**可用于自定义基座和测试包的派生资产**。正式提交商店前应替换为品牌方提供的高分辨率母版，再重新执行生成和预检。
+- `androidPrivacy.json.example` 是**未启用的法务模板**，其中 `__TERMS_URL__` 与 `__PRIVACY_URL__` 必须替换为法务确认的 HTTPS 地址。复制为被 Git 忽略的 `androidPrivacy.json` 后，`npm --prefix mobile-uni run verify:app-release` 才会通过。
+- iOS 已按实际功能填写麦克风和照片库用途说明；不申请相机、定位、通讯录、蓝牙或广告追踪权限。
+- 真机步骤和证据口径见 `docs/MOBILE_APP_DEVICE_ACCEPTANCE.md`。资源预检通过不等于 Android/iOS 真机或应用商店验收通过。
+
+## 更新策略
+
+涉及原生权限、插件、证书或 App 壳的改动必须重新云打包并通过应用商店/TestFlight 发布。仅 JavaScript/CSS/静态资源的热更新（WGT）不作为首个试点版本的发布方式；如后续启用，须有版本兼容、完整性校验、灰度与回滚方案。