xsl/meida
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

收尾两批并行开发的文档回写与任务包

Browse Source 
- Sprint 执行计划 v1.1：§1.1 补第一批交付实据；T9 SPIKE 结论回写 Sprint 1 表
  （T-P0-16 通过 2.8ms；T-P0-12 有条件；T-P0-10 原型 6/6 + 真实照片重验前置）；
  Sprint 2 表标注 T-P2-01~06 交付；新增 §9 两批交付记录
- 开发任务拆解 v1.5：交付回写 + 新风险登记（RTMPose 域差异、BiRefNet 异步化）
- 新增 开发任务包/：三批多 agent 并行的协作规程与 14 份任务契约
- 新增 前置开通清单-云资源与资质.md
- 清理已用毕的评审报告（文档评审 2026-08-13、项目整体评审 2026-08-14），
  README 中相应引用改为留痕表述
This commit is contained in:
xsl
2026-08-14 21:07:20 +08:00
parent 2934954eb2
commit e511b6a66f
22 changed files with 1407 additions and 461 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/Sprint执行计划.md
+38 -15
View File
@@ -44,7 +44,13 @@
| `T-P1-19` 任务中心 | 🟡（仅骨架任务） | `tk_task` + 状态机（非法跃迁有测试）+ 幂等键；`POST /tasks/ping`、`GET /tasks/{id}`、列表可用 |
| `T-P1-24` **LLM 网关** | ✅ | 场景路由、主备故障转移、熔断器、结构化输出重试、Prompt 版本、成本归因，共 28 个单测 |
| `T-P1-25` 成本归因表 | ✅ | `ob_ai_call` 每次调用（含失败）落一行；实测行：`tokens_in=240 / cached=128 / cost_cents=0.10744` |
| `T-P1-26` 配额账本 | 🟡（缺周期重置与后台） | 预扣三段式 + `bl_ledger` 幂等；实测 DeepSeek 超时时**自动退还**、成功时 `committed` |
| `T-P1-26` 配额账本 | ✅ | 预扣三段式 + `bl_ledger` 幂等；DeepSeek 超时**自动退还**；**任务奖励 claim 已并入**（`POST /quota/tasks/{task_key}/claim`，幂等 40910 + 封顶 40310）；周期重置靠 `period_key` 自然滚动（无后台任务＝设计如此，非缺口） |
| `T-P1-25b` 四档熔断 | ✅（阈值待重算） | 60/80/90/100% 四档降级 + critical 豁免 + Redis 手动 override + Prometheus 指标；**"被拒请求配额净扣减 = 0"有集成断言**；⚠️ `LLM_DAILY_BUDGET_CENTS=100000` 仍是旧价占位，8-17 后按实测重算 |
| `T-P1-13` 双令牌会话 | ✅ | refresh 一次性轮换（FOR UPDATE 行锁）+ 服务端撤销 + 重放检测告警；dev-token 向后兼容 |
| `T-P1-10` 埋点通道（服务端） | ✅ | `POST /events/batch` fail-close 整批校验 + PII 剔除；事件字典校验待 `TD-23` 定稿后收紧 |
| `T-P1-27` 直传预签名 | ✅（联调待 COS） | 场景/类型/大小三重校验 + 可审计 key 布局；SDK 隔离在 Protocol 后，16 单测零网络；真实桶联调归《前置开通清单》§2 |
| `T-P1-12` 华为账号登录（代码） | ✅（联调待 AGC） | OIDC JWKS 验签（kid 轮换、alg 锁定、audience 空配置拒绝）+ UnionID 映射；自造密钥全测，19 单测 |
| `T-P1-12b/12c` 短信登录（代码） | ✅（发送待签名审核） | 验证码哈希存储/一次性/5 次作废 + 三重频控（脚本化刷量 11 次断言拦截）+ 掩码纪律；fake/tencent 双通道可切 |
### 1.2 本 Sprint 待补（BE）
@@ -85,12 +91,12 @@
| 任务 | 轨道 | 验证门槛（`Phase 0` 档，非上线档） | 不达标的处置 |
| --- | --- | --- | --- |
| `T-P0-10` 🔴 | ALG | 体型测算与人工标注一致率 **≥ 80%** | 换方案（引入关键点比例法或第三方） |
| `T-P0-10` 🔴 | ALG | 体型测算与人工标注一致率 **≥ 80%** | 换方案（引入关键点比例法或第三方）。**2026-08-14 SPIKE（`scripts/spikes/REPORT.md`）：原型通过**——合成图 6/6 体型变体（H/A/V/O/X+中性）分类正确，测宽与真值偏差 ±1px；正式 ≥80% 一致率需顾问轨 ≥100 体标注。⚠️ **RTMPose 在合成剪影上置信度极低（0.003，域差异）——真实照片重验是本项的前置** |
| `T-P0-11` 🔴 | ALG | 色彩季型一致率 **≥ 75%** | 降级为「色彩倾向」而非「季型结论」 |
| `T-P0-12` | ALG | BiRefNet 抠图质检通过 **≥ 90%** | 调参或改用商业抠图 API |
| `T-P0-12` | ALG | BiRefNet 抠图质检通过 **≥ 90%** | 调参或改用商业抠图 API。**SPIKE 初步：有条件通过**——管线与代理指标全绿（前景占比 0.244 / 连通域 1.0 / 羽化 ~1px）；⚠️ CPU 单张 **3.1s**，同步接口不可接受，需异步化（走任务中心）；≥90% 质检率必须真实素材验证 |
| `T-P0-13` | BE | 换装单次 `gpu_seconds` 与成功率基线 | 数据直接填入成本模型，**并按 §1.3 的新单价重算** |
| `T-P0-14` | BE | 发型接口可用性与耗时基线 | — |
| `T-P0-16` | ALG | RTMPose ONNX CPU 单张耗时可接受 | 上 GPU 或降采样 |
| `T-P0-16` | ALG | RTMPose ONNX CPU 单张耗时可接受 | ~~上 GPU 或降采样~~ **✅ 2026-08-14 SPIKE 通过：rtmpose-s 全链路 2.8ms/张（P95 3.3ms），rtmpose-m 5.9ms——CPU 完全够用** |
| `T-P0-17` 🔴 | FE | 鸿蒙骨架打通登录/拍照/直传/轮询/展示 | **结论决定 FE 能否铺量**，不通则先解决工程链路 |
| `T-P0-18` | BE | AI 标识元数据经水印/COS/CDN/保存后仍存活 | 改用不可剥离的显式水印 |
| `T-P0-19` | BE | LLM 缓存命中率与成本降幅 | 已有初步实测：固定前缀命中 128/240 输入 token |
@@ -113,17 +119,17 @@
| 任务 | 轨道 | 验收标准 |
| --- | --- | --- |
| `T-P2-01` | BE | 12 类实体可存取；`tryon_ready` 标志可用 |
| `T-P2-02` | BE | 规则求值 p95 < 50ms；**硬约束可拦截** |
| `T-P2-03` | BE | BGE-M3 向量化可重跑，模型版本可切换 |
| `T-P2-04` 🔴 | BE | 检索 p95 < 200ms；**硬过滤零漏** |
| `T-P2-05` | BE | 1~3 跳返回可解释路径 |
| `T-P2-07` | ALG | 抠图批处理 + 白底规格校验拦截不合格图 |
| `T-P2-01` | BE | ✅ 2026-08-14：12 类实体 CRUD + 状态机（16 组跃迁全覆盖）+ `kb_asset`（`tryon_ready` 标志 + partial 索引） |
| `T-P2-02` | BE | ✅ 2026-08-14：规则引擎 p95 **0.412ms**（400 条规则，预算 50ms 的 1/120）；硬约束 `hard_blocks` + 用户禁忌压过专业推荐，黄金集 11 组固化 |
| `T-P2-03` | BE | ✅（接口位）：`EmbeddingProvider` 可插拔 + `embedding_model/version` 随行写入（可重跑判据）；当前为确定性假实现，**真实 BGE-M3 ONNX 待接入** |
| `T-P2-04` 🔴 | BE | ✅ 2026-08-14：硬过滤→向量→关键词→RRF 重排；**硬过滤零漏有红线用例**（禁忌实体向量距离 0 仍零出现 + 对照组）；顺带修复 jsonb NULL 语义真 bug |
| `T-P2-05` | BE | ✅ 2026-08-14：递归 CTE 1~3 跳可解释路径（`path` 数组防环） |
| `T-P2-07` | ALG | 抠图批处理 + 白底规格校验拦截不合格图（SPIKE 代理指标已就绪，批处理待素材） |
| `T-P2-08` | ALG | 属性预标注准确率 ≥ 70%，人工可修正 |
| `T-P2-09` 🔴 | BE | **顾问可独立完成内容维护、审核、发布与回滚，全程无工程介入** |
| `T-P2-10` | BE | 发布后检索缓存自然失效 |
| `T-P2-11` 🔴 | BE | 黄金集框架接入 CI，**指标退化即阻断合并** |
| `T-P2-06` | BE | 无结果 query 全量记录并可排序 |
| `T-P2-09` 🔴 | BE | **顾问可独立完成内容维护、审核、发布与回滚，全程无工程介入**（极简后台，第三批开发中） |
| `T-P2-10` | BE | 发布后检索缓存自然失效（第三批开发中） |
| `T-P2-11` 🔴 | BE | 黄金集框架接入 CI，**指标退化即阻断合并**（第三批开发中） |
| `T-P2-06` | BE | ✅ 2026-08-14：无结果 query 落 `kb_gap`（同 query+filter 聚合 `hit_count`），列表/排序接口随后台交付 |
**内容轨（CONT，本 Sprint 的真实瓶颈）**：`T-P2-12` 色板、`T-P2-13` 规则库冷启动（**V1 硬指标 400 条**）、
`T-P2-14` 实体录入、`T-P2-15` 单品 300 件 `tryon_ready`、`T-P2-16` 黄金集标注（**四个子集共 330 例**）。
@@ -227,8 +233,25 @@
---
**文档版本**：v1.0
## 9. 多 Agent 并行开发交付记录（2026-08-14）
两批共 11 个任务（T1~T11）以「协调提交消除共享文件冲突面 + 每 task 独立 worktree/分支 + 逐分支合并跑全量门禁」的方式并行交付。**零合并冲突**；任务契约与协作规程见 `开发任务包/`。
| 批次 | 任务 → WBS 映射 | 单测增量 | 集成增量 |
| --- | --- | --- | --- |
| 第一批（5 任务） | T1 四档熔断→`T-P1-25b`；T2 任务奖励→`T-P1-26` 收尾；T3 埋点→`T-P1-10`；T4 刷新令牌→`T-P1-13`；T5 直传预签名→`T-P1-27` | +69 | +12 |
| 第二批（6 任务） | T6 实体图谱→`T-P2-01/05`；T7 规则引擎→`T-P2-02`；T8 混合检索→`T-P2-03/04/06`；T9 视觉 SPIKE→`T-P0-10/12/16`（结论已回写 §2）；T10 华为登录→`T-P1-12`；T11 短信登录→`T-P1-12b/12c` | +235 | +22 |
| **累计** | 单测 169→**473**，集成 3→**38** | | |
**待联调清单**（代码就绪、等外部凭证）：华为登录（AGC 配置）、短信真实发送（签名审核）、COS 直传（四桶创建）——对应《前置开通清单》。
**遗留提醒**：8-17 峰谷新价生效后重算 `LLM_DAILY_BUDGET_CENTS` 与四档阈值；RTMPose 真实照片重验；BiRefNet CPU 3.1s/张需异步化接入任务中心。
---
**文档版本**：v1.1
**创建日期**：2026-08-13
**最后更新**：2026-08-14
**状态**：待评审
**关联文档**：《开发任务拆解》（任务定义与依赖）、《需求规格说明》（验收指标唯一事实源）、
《技术架构文档》（token 预算与成本模型）、《技术选型与调研报告》（`TD-00`~`TD-33`）