xsl
120bbeceff
- meida_backend 收为 git submodule（git.xiangsilian.com/xsl/meida_backend.git），含 PDF 导出管线提交 - WSL Ubuntu-22.04 镜像网络模式跑 PG(pgvector)@55432 + Redis@56379 + uvicorn@8666 + celery，Windows/Hyper-V 防火墙已放行 - app 默认后端地址 192.168.3.25→192.168.3.19:8666（宿主机） - docs/本地联调指南.md 全面更新到本机拓扑；.gitignore 增补本地素材/调研产物与 graphify 本机文件
美搭 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 包（保持零依赖，后续按需评估）