xsl
9c1802130d
第三批（T12 后台/T13 黄金集/T14 检索缓存）协调提交： - kb：KbAssetService（登记/审核，tryon_ready 只能随 approved 打开）+ Asset 模型与 repo - retrieval：list_gaps 缺口看板查询 + invalidate_cache() 钩子（T14 背后实现真缓存） - 配置：ADMIN_TOKEN（空=后台 404）+ 检索缓存三参数 - pytest golden marker（默认跳过，CI 强制跑）+ Makefile golden + CI 防线 5c - 测试隔离修复：test_auth_sms 加 autouse 清 sms:* 键夹具（频控计数跨运行 累积会毒化后续运行——随机 IP 空间仅 254 且部分用例固定 device_id）
packages/kb/ — 美学知识库
职责（架构 §4.1）：知识实体/关系/规则/素材的读写与发布。
不负责：检索算法（调 packages/retrieval）。
本批已落地（T6，T-P2-01/05）
schemas.py：12 类EntityTypeLiteral、EntityStatus、CRUD 与图谱 响应模型（雪花 ID 一律字符串出参，防 JS 精度丢失）repo.py：kb_entity/kb_relation/kb_color数据访问；traverse为递归 CTE 1~3 跳有界遍历（防环：path数组 +NOT @>）service.py：状态机（draft→reviewing→published→archived，撤稿支线 draft/reviewing→archived，非法跃迁 40900）、内容修改 version+1 且 published 只读（要改必须撤稿归档后重录新草稿）、关系写入（自环/重复/ 端点缺失校验）、色板 role/hex（#RRGGBB）校验- 路由
apps/api/routers/kb.py：GET/POST /kb/items、GET/PATCH /kb/items/{id}、GET /kb/items/{id}/graph?max_hops=1..3
待实现（后续批次）
kb_rule决策表 CRUD（T7 规则引擎）kb_chunk向量+全文混合检索（T8）kb_asset白底图流水线、kb_gap知识缺口埋点（T-P2-06+）- 关系/色板的运营 HTTP 入口（后台角色 T-P2-09 就绪后挂路由）
为什么它是数据不是代码
架构 §1.1：知识库是持续演进的资产，更新频率远高于代码。规则、色板、单品
必须是数据，配顾问能独立使用的运营入口（FR-ADM-02），改内容不发版。
任何时候想把规则写成 if 分支，都是错的。
知识库版本号
所有检索缓存键都带全局 kb_version，发布时 +1，旧缓存自然失效
（架构 §10）。不要试图精确追踪哪些缓存受影响。