收口文档评审冲突并补齐 Sprint 执行计划

统一性能、token、配额与成本口径，补齐短信登录等缺口任务，并回写脚手架实测暴露的思考模式与峰谷计价约束。 Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-14 09:40:50 +08:00
parent e31755e343
commit f4075f6827
13 changed files with 1200 additions and 290 deletions
@@ -1,6 +1,6 @@
 # 「美搭」开发任务拆解（WBS）

-> 版本：v1.0　｜　更新日期：2026-08-13　｜　状态：待评审
+> 版本：**v1.3**　｜　更新日期：2026-08-13　｜　状态：待评审
 >
 > **本文的定位**：把需求与架构翻译成可指派、可验收的任务清单，并明确任务之间的依赖与关键路径。
 >
@@ -23,7 +23,7 @@
 | **M1** | 工程地基可用 | 骨架跑通：登录 → 上传 → 提交任务 → 查状态 → 拿到带标识的产物 | 阻塞所有业务功能 |
 | **M2** | 知识库可运营 | 顾问能在后台独立录入规则与素材并发布，检索链路返回可解释结果 | 阻塞报告与 Agent 的质量 |
 | **M3** | 报告闭环打通 | 用户能完整走通初级报告并产出画像与记忆 | 阻塞 Agent 与换装的个性化 |
-| **M4** | 三大功能闭环 | 报告 + Agent + 换装/发型均可用且互相联动 | — |
+| **M4** | 三大功能闭环 | 报告 + Agent + 换装/发型均可用且互相联动。拆为 **M4-a 换装/发型**（可与 M3 并行）与 **M4-b Agent 对话**（须等 M2+M3） | M4-b 是 Phase 4 的关键路径 |
 | **M5** | 上线就绪 | 合规检查清单全绿、压测通过、监控齐备、**备案编号公示位实机验证通过** | 依赖 M0 的编号公示实现 |
 | **M6** | V2 能力 | 全面报告付费、IAP 接入、衣橱、多端评估 | **依赖 V1 的成本与频次数据** |

@@ -48,7 +48,7 @@ M1 工程地基                       │   │              │
      │                           │   │              │
      ├──────────────┬────────────┼───┼──────┐       │
      ▼              ▼            ▼   ▼      ▼       │
-M2 知识库        M3 报告闭环         M4 换装/发型     │
+M2 知识库        M3 报告闭环        M4-a 换装/发型    │
 ├─ 本体与色板    ├─ 视觉分析         ├─ 换装服务改造  │
 ├─ 规则引擎 ◀────┤ 诊断生成          ├─ 素材入库 ◀───┘
 ├─ 混合检索      ├─ 文案生成         └─ 发型打标与推荐
@@ -57,13 +57,15 @@ M2 知识库        M3 报告闭环         M4 换装/发型     │
      │              │              │
      └──────────────┴──────────────┘
                     ▼
-              M4 Agent 对话
+              M4-b Agent 对话（依赖 M2 检索 + M3 画像）
                     ▼
              M5 上线就绪
                     ▼
                  M6 V2（含 IAP 与付费报告）
 ```

+> **M4 拆为 a/b 两块**（原图两处都标 M4，易误读为同一批工作）：`M4-a` 换装/发型只依赖 M1 与素材入库，**可与 M3 报告并行**；`M4-b` Agent 对话必须等 M2 检索与 M3 画像就绪，**是 M4 的关键路径**。两者同属 Phase 4，但可并行度完全不同。
+
 **关键路径已经改变（这是本轮最重要的变化）**：

 | | 原关键路径 | 现关键路径 |
@@ -164,7 +166,10 @@ M2 知识库        M3 报告闭环         M4 换装/发型     │
 | T-P1-11 | DEV | 用户数据模型与身份映射 | 表 + 迁移 | UnionID 映射唯一；预留 `profile_id` | FR-ACC-01、FR-ACC-12 |
 | T-P1-12 | DEV | 华为账号登录（服务端） | 接口 | 登录成功率 ≥ 99%（联调环境） | FR-ACC-01 |
 | T-P1-13 | DEV | 双令牌会话与撤销 | 接口 | 登出后旧令牌立即失效 | FR-ACC-05 |
-| T-P1-14 | DEV | 游客模式与数据合并 | 接口 | 合并幂等；多设备场景有确定策略 | FR-ACC-02/03 |
+| T-P1-12b | DEV | **短信验证码登录**（下发 + 校验 + 腾讯云 SMS 接入） | 接口 | 6 位码、5 分钟有效、一次性、失败 5 次作废；**华为侧异常时本通道仍可登录**（须有断开华为依赖的测试） | FR-ACC-04、**TD-32** |
+| T-P1-12c | DEV | **短信防刷**（号码/IP/设备三重频控 + 人机校验 + 发送量告警） | 中间件 + 告警 | **脚本化刷量测试证明拦截有效**；号码在日志与后台全部掩码 | FR-ACC-14、NFR-SEC-03/05 |
+| T-P1-14 | DEV | 游客模式与数据合并 | 接口 | 合并幂等；多设备场景有确定策略；**游客配额按设备维度终身计量**（非每日），用尽引导登录而非报错 | FR-ACC-02/03 |
+| T-P1-16b | DEV | **清空我的照片**（保留账号） | 接口 + 页面 | COS 对象与 DB 引用同步清除；签名 URL 立即失效；二次确认 + 回执 + 审计日志 | **FR-ACC-15**、CR-02 |
 | T-P1-15 | DEV | 同意授权记录（含人脸单独同意） | 表 + 接口 | 记录含版本与时间，可查询 | CR-01、FR-ACC-08 |
 | T-P1-16 | DEV | 账号注销与数据删除任务 | 接口 + 定时任务 | 7 日内彻底删除，含 COS 对象；有执行记录 | CR-03、FR-ACC-09 |
 | T-P1-17 | DEV | 未成年人判定与功能限制 | 中间件 | 未成年账号禁用付费与外观评价 | CR-04、FR-ACC-11 |
@@ -180,7 +185,10 @@ M2 知识库        M3 报告闭环         M4 换装/发型     │
 | T-P1-22 | DEV | **统一合规出口**（审核 + 水印 + 元数据 + 内容编号登记） | 模块 | 所有产物必经；元数据全链路存活测试通过 | CR-05、CR-06 |
 | T-P1-23 | DEV | 内容审核接入（IMS + TMS + 关键词库） | 模块 | 六类审核对象全覆盖；fail-close 生效 | CR-06/07 |
 | T-P1-24 | DEV | **LLM 网关**（路由/降级/熔断/结构化输出/Prompt 版本/成本记录） | 模块 | 主备切换 < 3s；成本 100% 记录 | FR-SYS-04 |
+| **T-P1-24a** | DEV | **思考模式按场景显式配置** | 场景配置 + provider 参数 | 每个场景**显式**给出 `thinking` 值，不依赖供应商默认；对话与结构化抽取场景一律关闭；单独记录 `tokens_reasoning` | `NFR-PERF-02b`、`NFR-COST-01`、TD-04 |
 | T-P1-25 | DEV | 成本归因表与日成本预警 | 表 + 告警 | 可按功能/模型/用户聚合；突增告警生效。**不允许后置到上线后补**（V2 定价的唯一数据来源） | FR-BILL-08、NFR-COST-01、FR-SYS-07 |
+| T-P1-25b | DEV | **全局日成本熔断**（四档自动降级） | 模块 + 后台开关 | 注入成本可复现 60/80/90/100% 四档降级；**在途任务放行**；**被熔断拒绝的请求配额净扣减 = 0**；后台可查状态并手动解除 | NFR-COST-02、架构 §13.3 |
+| **T-P1-25c** | DEV | **峰谷单价按调用时刻计价** | 两套价目表 + 时段判定 | 高峰（北京时间 09:00-12:00、14:00-18:00）与空闲各一套单价；成本在**调用当时**算好落库，事后不按当前价重算；跨时段有测试 | `NFR-COST-01`、TD-04 |
 | T-P1-26 | DEV | **配额账本**（余额、流水、预扣三段式、周期重置、规则配置化） | 模块 + 接口 | 余额可由流水重算；失败自动退还；**表结构含 `tx_type` 字段，V2 上支付无需迁移**；服务端硬校验不可绕过 | FR-BILL-01/02/04/05/06 |
 | T-P1-26b | DEV | 额度耗尽文案与提示 | 端侧组件 | **不出现任何价格、购买、会员、升级字样**；消耗前提示剩余量 | FR-BILL-07 |
 | T-P1-27 | DEV | 图片直传（预签名 URL）与临时桶生命周期 | 接口 + 桶策略 | 图片不经应用服务器；2 小时自动清理 | FR-SYS-03、CR-02 |
@@ -247,12 +255,16 @@ M2 知识库        M3 报告闭环         M4 换装/发型     │
 | T-P3-14 | DEV | 报告分享（长图 + 可失效链接） | 功能 | 分享图含显式标识；链接可撤回 | FR-RPT-12 |
 | T-P3-15 | DEV | 画像与记忆写入（L0~L2 + 冲突消解 + 审计） | 模块 | 报告完成后 L1 记忆同步生成 | FR-MEM-01/02/07/12 |
 | T-P3-16 | DEV | 「我的记忆」页面（可见可编辑可删除） | 页面 | 删除后不再注入；编辑优先级最高 | FR-MEM-05、CR-02 |
-| T-P3-17 | DEV | 记忆快照与注入（token 预算裁剪 + 缓存） | 模块 | 注入 ≤ 500 token；记忆变更即失效缓存 | FR-MEM-04 |
+| T-P3-17 | DEV | 记忆快照与注入（token 预算裁剪 + 缓存） | 模块 | **注入 ≤ 1400 token**（V1 实际 ≤ 1200）；记忆变更即失效缓存；**裁剪时硬禁忌不丢失**（须有单测） | FR-MEM-04、架构 §7.2 |
 | T-P3-18 | DEV | 记忆衰减定时任务 | 任务 | 未强化记忆置信度按规则下降 | FR-MEM-06 |
 | T-P3-19 | DEV | 无照片/拒绝授权的降级路径 | 功能 | 问卷可生成简版画像，明确告知差异 | FR-RPT-11 |
 | T-P3-20 | DEV | 报告引导流程（首次进入核心功能前） | 功能 | 可跳过；跳过后有降级说明 | FR-RPT-02 |
+| **T-P3-21** | DEV | **报告结论认同/修正入口 + 埋点** | 功能 + 埋点 | 每个可修正维度均有入口；修正后置信度置 1.0 并即时写 L1；**认同率与修正率两项指标可从埋点直接算出** | **FR-RPT-19** |
+| **T-P3-22** | DEV | **全面报告预约留资卡片 + 埋点** | 页面 + 埋点 | 卡片**不含任何价格字样**；预约率、停留时长、目录章节点击分布可查 | **FR-RPT-20** |

-**M3 出口条件**：真实用户（内部 10 人）走完报告流程，人工评审报告质量：结论准确、无禁忌违反、无贬损表述、术语可理解；画像正确写入并能被 Agent 读到。
+> ⚠️ **`T-P3-21`/`T-P3-22` 不是"锦上添花"，缺了会让 V1 白跑一遍**：前者是「结论认同率 > 70%、修正率 < 15%」两项核心质量指标的唯一数据来源；后者是 V1 唯一的商业化验证数据来源（预约率 ≥ 8% 是 V2 立项门槛）。**指标没有数据来源就等于没有指标。**
+
+**M3 出口条件**：真实用户（内部 10 人）走完报告流程，人工评审报告质量：结论准确、无禁忌违反、无贬损表述、术语可理解；画像正确写入并能被 Agent 读到；**认同/修正埋点与预约留资埋点均可查到数据**。

 ---

@@ -264,7 +276,7 @@ M2 知识库        M3 报告闭环         M4 换装/发型     │
 | --- | --- | --- | --- | --- | --- |
 | T-P4-01 | DEV | 会话与消息模型（含检索轨迹与规则命中） | 表 + 迁移 | 每条回答可复盘 | FR-AGT-09 |
 | T-P4-02 | DEV | 意图识别（含越界意图拒答） | 模块 | 主要意图准确率 ≥ 85%；越界正确拒答 | FR-AGT-02、CR-12 |
-| T-P4-03 | DEV | 上下文组装与 token 预算控制 | 模块 | 输入 ≤ 3700 token；超限按优先级裁剪 | FR-AGT-03 |
+| T-P4-03 | DEV | 上下文组装与 token 预算控制 | 模块 | **输入 ≤ 4200 token**（V1 实际 ≤ 4000）；超限按既定优先级裁剪而非报错 | FR-AGT-03、架构 §7.2 |
 | T-P4-04 | DEV | 流式对话接口（SSE） | 接口 | 首字 p95 < 2s | FR-AGT-01 |
 | T-P4-05 | DEV | 生成后校验（复用 T-P3-11） | 模块 | 黄金集违反数 = 0 | FR-AGT-05 |
 | T-P4-06 | DEV | 搭配方案结构化输出与卡片渲染 | 功能 | 可解析为单品组合，字段完整 | FR-AGT-06 |
@@ -280,7 +292,7 @@ M2 知识库        M3 报告闭环         M4 换装/发型     │
 | --- | --- | --- | --- | --- | --- |
 | T-P4-12 | DEV | **换装服务改造**（鉴权/异步回调/幂等/并发上报/成本埋点/COS 迁移） | 改造后服务 | 架构 §4.4 全部改造项完成 | FR-TRY-01 |
 | T-P4-13 | DEV | 换装任务编排（三工作流） | 模块 | 成功率 ≥ 90%（排除输入不合格） | FR-TRY-01 |
-| T-P4-14 | DEV | 输入前置校验（人像质量 + 单品白底图规格） | 模块 | 不合格输入在扣点前拦截 | FR-TRY-02 |
+| T-P4-14 | DEV | 输入前置校验（人像质量 + 单品白底图规格） | 模块 | 不合格输入**在预扣配额前**拦截（顺序错了会白扣用户额度） | FR-TRY-02 |
 | T-P4-15 | DEV | GPU 队列容量保护与排队体验 | 机制 + 页面 | 展示位次与预估；超阈值拒绝新任务 | FR-TRY-04 |
 | T-P4-16 | DEV | 结果审核 + 合规标识 + 存储 | 流程 | 100% 经统一合规出口 | FR-TRY-03、CR-05 |
 | T-P4-17 | DEV | 结果收藏与管理（含删除清理对象） | 功能 | 删除后 COS 对象同步清理 | FR-TRY-06 |
@@ -314,6 +326,9 @@ M2 知识库        M3 报告闭环         M4 换装/发型     │
 | T-P5-14 | BIZ | 内部测试与用户测试（种子用户） | 测试报告 | 核心链路无 P0 缺陷；报告质量人工评审通过 | — |
 | T-P5-15 | DEV | **配额对账任务与告警** | 定时任务 | 每日校验余额与流水一致性，不一致告警。V1 就要做，否则 V2 上支付时对账逻辑无历史数据可验证 | FR-BILL-02 |
 | T-P5-16 | BIZ | 全文案价格字样扫描 | 扫描报告 | 全端文案不含价格、购买、会员、升级字样（`FR-BILL-07`） | TD-28 |
+| **T-P5-17** | DEV | **会员页静态权益展示 + 「上线提醒我」留资** | 页面 + 埋点 | **无价格、无购买按钮**；曝光数与留资率可查。验证**订阅意愿**（与 `T-P3-22` 验证的单次付费意愿是两件事） | **FR-BILL-12** |
+| **T-P5-18** | OPS | **CLS 日志留存周期配置为 ≥ 6 个月** | 配置 + 截图 | 实际配置值可核验，非仅文档声明 | **CR-11** |
+| **T-P5-19** | OPS | **熔断降级四档演练** | 演练记录 | 注入成本触发 60/80/90/100% 四档；在途任务未被中断；**配额净扣减 = 0** | **NFR-COST-02** |

 **M5 出口条件**：合规清单全绿 + **编号公示实机验证通过** + 压测达标 + 恢复演练完成 + 无 P0 缺陷。

@@ -414,5 +429,7 @@ M2 知识库        M3 报告闭环         M4 换装/发型     │

 | 日期 | 版本 | 变更 |
 | --- | --- | --- |
+| 2026-08-13 | v1.3 | **后端脚手架落地后的回写**。新增两项由真机实测暴露、原 WBS 完全未覆盖的任务：**`T-P1-24a` 思考模式按场景显式配置** —— `deepseek-v4-flash` **默认开启**思考模式，实测同一单句问答开启 13.5s、关闭 1.8s，思考 token 还按输出价计费，漏配会同时打破 `NFR-PERF-02b` 与成本模型；**`T-P1-25c` 峰谷单价按调用时刻计价** —— DeepSeek 自 2026-08-17 起高峰单价为空闲时段 2 倍，用单一均价记账会让 `ob_ai_call` 与真实账单差出近一倍，而它是 V2 定价的唯一依据。另：`T-P1-01`/`02`/`06`/`07`/`24`/`25` 已在 `meida_backend` 仓库交付并实测通过，各任务的完成状态见《Sprint 执行计划》§1.1 |
+| 2026-08-13 | v1.2 | **文档一致性评审修订，补齐 9 项"需求已定但无任务认领"的缺口**。新增任务：`T-P1-12b` 短信验证码登录、`T-P1-12c` 短信防刷、`T-P1-16b` 清空我的照片、`T-P1-25b` **全局日成本熔断**（四档降级，验收含「配额净扣减 = 0」）、`T-P3-21` **报告结论认同/修正入口**、`T-P3-22` **全面报告预约留资**、`T-P5-17` 会员页留资、`T-P5-18` CLS 日志留存 ≥6 个月（`CR-11` 此前无人认领）、`T-P5-19` 熔断四档演练。其中 `T-P3-21`/`T-P3-22` 尤其关键 —— 前者是「结论认同率 > 70%、修正率 < 15%」的唯一数据来源，后者是 V1 唯一的商业化验证数据来源，**缺了会让 V1 白跑一遍**。另：**依赖图中的 M4 拆为 `M4-a` 换装/发型（可与 M3 并行）与 `M4-b` Agent 对话（须等 M2+M3）**，原图两处都标 M4 易误读为同一批工作；`T-P3-17` 注入预算 500→1400、`T-P4-03` 总输入 3700→4200；`T-P4-14` 明确输入校验须在预扣配额之前 |
 | 2026-08-13 | v1.1 | **关键路径转移**。备案已完成，原 `T-P0-01`~`T-P0-08` 申报类任务关闭，替换为备案后的落地与核实任务（模型清单核实、编号公示位实现、公示与网关路由同源校验）。§2.3 内容与素材生产升为新的关键路径，`T-P0-20` 顾问到岗与 `T-P0-21` 自采流水线成为全项目最优先任务，并要求输出**每周产能数据**用于倒排。配额相关任务去除支付语义（`T-P1-26` 强调 `tx_type` 字段使 V2 免迁移，新增 `T-P1-26b` 文案约束、`T-P5-15` 对账、`T-P5-16` 价格字样扫描）。诊断维度改 32。Phase 6 新增企业开发者认证、一键登录、**小范围真实收费灰度**，并明确 `T-P6-16` 定价的四项前置输入 |
 | 2026-08-13 | v1.0 | 首次输出。六个里程碑（M0~M5 为 V1，M6 为 V2+），Phase 0 定为备案与前置验证阶段并与开发并行 |