xsl
9e7a886863
多 agent 并行批次的协调提交（消除全部共享文件冲突面）： - 迁移 0004：id_session + ob_event 两表（T3/T4 用，任务不再写迁移） - ORM：UserSession / ObEvent；错误码：九个新码（40xxx/60006，含 meta） - 配置：四档 tiers / refresh TTL / 任务奖励注册表 / 埋点上限 / COS 直传全套 - 骨架：packages/analytics + packages/storage + events/uploads 空路由（已注册） - deps：AnalyticsServiceDep / StorageServiceDep；DailyBudgetGuard 接收 tiers - uv add cos-python-sdk-v5；import-linter/CI/Makefile 纳入两个新包
migrations/ — Alembic
异步引擎（asyncpg）+ pgvector。Base.metadata 来自 packages/shared/models.py。
make migrate # upgrade head
make makemigration m="add kb tables" # autogenerate
uv run alembic downgrade -1 # 回滚一步
规矩
- 迁移必须向后兼容（架构 §14.3）：加列不删列、先双写后切读。发布流程是 「先迁移，后发布」，所以新迁移必须能和旧版应用代码共存，否则回滚时数据 不兼容。
- 必须可逆，或在文件头明确标注不可逆并说明原因（§16.2 迁移检查清单）。
CI 会跑
upgrade → downgrade base → upgrade。 - 表名必须带域前缀：
id_/pf_/rp_/kb_/ag_/tr_/bl_/tk_/cp_/ob_。单库多域，前缀就是将来拆库的边界（§6.1）。 - 主键用雪花 ID（bigint），不用自增（枚举攻击 + 分库冲突），不用 UUID 作主键（索引局部性差）。
- 不要存人脸原图，也不要存可反推生物特征的数据（TD-20 / CR-02）。诊断结果 只存分类标签与色值等派生量。
- 需要过滤的字段一律提升为列；JSONB 只用于「结构会演进且不需要索引全部字段」 的场景（§6.1 原则 6）。
- 配置类数据（配额规则、色板、路由）用迁移种子进表，不要硬编码进代码 （NFR-MAINT-05）。
已有迁移
| 版本 | 内容 |
|---|---|
0001 |
pgvector 扩展；id_user id_user_identity id_consent；bl_quota_rule bl_quota bl_ledger；tk_task；ob_ai_call；配额规则种子数据 |
§6.2 里其余的表（pf_ 画像与记忆、rp_ 报告、kb_ 知识库、ag_ 会话、
tr_ 换装、cp_ 合规）尚未创建，属于 M2~M4。