xsl
fcc506920f
- ReportCreatePage：必选照片卡（人脸授权→相册/拍照→预览/重选），未选红字+汇总条拦截；提交先上传拿真 object_key 再建报告（上传失败不碰配额可重试）；删除 buildMockPhotoKey 模拟链路；照片引导按需求文档 §3.4/§5.1（正面全身照） - core/UploadApi.ets：POST /uploads/direct 原始字节上传（绕开真机 multiFormDataList 0 字节 bug），带鉴权信封解包 - FacePhotoConsent：加可选 usageText（诊断页传报告口径文案，试穿/发型页零影响）；处理方/保存两行按本地磁盘降级路线改属实（去「第三方」「生成后即删除」），CONSENT_VERSION v1→v2 全体重询一次 - 后端配套：meida_backend a1d0171（本地直传+存在性校验）；联调 E2E 已验证（真 key 全链路 succeeded / 假 key 404 零流水）
美搭 HarmonyOS App（ArkTS）
- 模板：DevEco Studio 6.1 空 Ability 工程；API
6.1.1(24)，runtimeOS: HarmonyOS，bundleName: com.xiangsilian.app - 后端：
meida_backend（WSL）。本地开发默认http://127.0.0.1:8000（模拟器可用；真机连开发机要在登录页改成局域网 IP） - 登录通道（V1 骨架）：dev-token（后端
DEV_AUTH_ENABLED=true本地可用）；华为账号/短信为后续任务
命令行构建（Agent/CI 用的门禁）
工程配了真机调试签名（
.ohos/config下证书）后，PackageHap/SignHap 需要 java： PATH 里须有 DevEco 自带 JBR（jbr/bin），且不能有带旧环境的 hvigor 守护进程残留 （守护进程会缓存启动时的 PATH，报spawn java ENOENT时先taskkill /F /PID <hvigor daemon的node进程>再重试）。
（等价于仓库根的 app/.build-gate.bat）
set "PATH=C:\Program Files\Huawei\DevEco Studio\jbr\bin;%PATH%"
set "DEVECO_SDK_HOME=C:\Program Files\Huawei\DevEco Studio\sdk"
cd /d <repo>\app
"C:\Program Files\Huawei\DevEco Studio\tools\node\node.exe" ^
"C:\Program Files\Huawei\DevEco Studio\tools\hvigor\bin\hvigorw.js" ^
--mode module -p module=entry@default assembleHap --analyze=false --daemon=false
BUILD SUCCESSFUL 即门禁通过；产物 entry/build/default/outputs/default/entry-default-signed.hap
（已用调试证书签名，可直接 hdc install 到真机）。
代码约定
ets/core/：网络与会话地基（ApiClient/AuthStore/ContextHolder/ApiTypes）——共享层，改动需全量构建验证ets/pages/：页面。页面间跳转一律router.pushUrl({url: 'pages/Xxx'})路径方式，禁止 import 其它页面（并行开发的冲突隔离约定）- 组件级复用放
ets/components/（各自任务目录内自建子目录） - 文案：骨架期中文硬编码即可（i18n 后置）；错误提示只 catch
ApiError，用其message/hint（后端文案已保证无价格字样） - 状态管理：页面内
@State；跨页少量状态走AppStorage - 不引第三方 ohpm 包（保持零依赖，后续按需评估）