xsl
6c77ff4989
POST /auth/huawei：JWKS 验签（kid 缓存/轮换）+ claims 严格校验 + UnionID 映射 + T4 双令牌签发（FR-ACC-01；真实联调待 AGC 配置）。 - packages/identity/huawei.py（新建）：HuaweiIdTokenVerifier——RS256 验签， JWKS 内存缓存（TTL 可配 + 单调钟；kid 未命中强制刷新一次重试，锁内用 拉取代数防止强制刷新被新鲜缓存短路）；aud/iss/exp/iat 全查，audience 空配置直接拒绝而非跳过；union_id 缺失拒绝（降级 open_id 策略不做， 留联调期决定）；错误映射 40102/40101/60000，无新错误码。 HuaweiLoginRequest/HuaweiClaims 一并定义于此，未动 schemas.py。 - apps/api/routers/auth.py：追加 /huawei 端点；get_huawei_verifier 依赖 建于路由模块内（缓存到 app.state，可预注入替换），未动 deps.py； 复用 T4 的 get_or_create_by_external_identity + issue_session + TokenPairResponse 与既有 _token_pair/_access_token。 - tests/unit/test_huawei_verifier.py：cryptography 自造 RSA + 本地 JWKS （零外网），19 例覆盖合法 claims/错误签名/过期/aud/iss/iat 缺失/ audience 未配置/union_id 缺失/HS256 混淆/JWKS 拉取失败/kid 轮换/缓存 TTL。 - tests/integration/test_auth_huawei.py：FakeFetcher 预注入 app.state， 真实 PG 验证首次建用户 + 双令牌、同 union_id 复登同 user_id、新 access 调 /quota、refresh 可轮换、伪造 token 40102。 检查：ruff/format/mypy（T6 列表）/lint-imports 全绿；单测 257 passed （基线 238 + 新增 19）；集成 18 passed（含新增 2）。 偏差说明：无
meida_backend · 美搭服务端
「美搭」智能穿搭美学助手的服务端。当前状态是工程地基 + 一条打通的纵向切片
（登录取 token → 配额预扣 → 真实调用 DeepSeek → 记成本 → 提交配额），
业务域大多只有目录与 README，见各 packages/*/README.md。
技术选型与分层依据见仓库外的《技术架构文档》《技术选型与调研报告》，本文只讲怎么跑起来。
快速开始
cp .env.example .env # 填入 DEEPSEEK_API_KEY
make install # uv sync + 装 pre-commit
make up # PostgreSQL(pgvector) + Redis，端口 55432 / 56379
make migrate # 建表并创建 vector 扩展
make run # http://localhost:8000/api/v1/docs
验证真实链路（会产生真实 API 费用，是唯一花钱的入口）：
make smoke
它会起依赖、迁移、拉起 API、发一次真实对话，然后把 ob_ai_call
的成本行与 bl_ledger 的配额流水打出来。跑通即证明「计量 + 配额 + 大模型」三者串通。
目录结构
| 目录 | 职责 |
|---|---|
apps/api |
HTTP 入口。只做鉴权、校验、幂等、配额、统一响应，不放业务规则 |
apps/worker |
Celery 长耗时任务入口 |
packages/domain |
纯领域逻辑，不许 import 任何框架与 I/O |
packages/llm |
大模型网关：场景路由、Prompt 版本、结构化输出、成本计量、预算熔断 |
packages/shared |
配置、日志脱敏、DB、Redis、错误码、中间件 |
packages/<业务域> |
identity / billing / task / agent / kb / retrieval / report … |
services/ |
需要独立伸缩的重型服务（换装、抠图、视觉），V1 为占位 |
prompts/ |
按 <prompt_id>/<version>.txt 归档，与 ob_ai_call.prompt_version 对应 |
migrations/ |
Alembic；CI 强制 upgrade → downgrade → upgrade 往返可用 |
依赖方向由 lint-imports 强制（pyproject.toml 的 [tool.importlinter]）。
apps → packages → domain 是单向的，业务包也不得绕过网关直连 provider。
提交前
make check # lint + typecheck + imports + test + secrets，与 CI 同一套
单测不连库、不发网络请求。需要真实中间件的用例在 tests/integration，
默认跳过，用 make test-integration 显式开启。
两件容易踩的事
- Prompt 固定前缀不许含时间戳、随机值等易变内容。 命中缓存的输入单价只有未命中的
约 1/30，前缀被污染会让输入成本翻数十倍。
LLM_CACHE_PREFIX_MODE=strict下启动即失败。 - DeepSeek 自 2026-08-17 起峰谷定价，高峰（北京时间 09:00-12:00、14:00-18:00）
单价是空闲时段的 2 倍。单价配两套，由
packages/llm/cost.py按调用时刻选择； 成本在调用当时算好落库，事后不按当前价重算。