xsl
d9868fb4f7
- TryonApi.ets：直连 meida.xiangsilian.com——换装 /change_cloth_base64（JSON+Base64，超时 320s）、发型 /hair/api/*（multipart，实测 5~10s） - ImageCodec.ets：相册选图→解码→缩放→Base64 的公共链路 - TryonPage（模特/服装双图换装）+ HairDesignPage（60 款发型试戴/换发色），首页两张入口卡 - docs/试衣间与发型设计-产品方案.md：Phase A 直连内测 / Phase B 服务端代理 + 合规纳管的分工结论 - 待补：真机实测耗时（T-P0-13/14 基线）；Phase B 迁服务端时代码改动集中在 TryonApi 一处
美搭 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 包（保持零依赖，后续按需评估）