按交叉评审对齐文档与代码口径,并挡住 reference 下的密钥文件

表名、配额种子和字段名以产品方案与架构为准;文档仓库补 .gitignore,避免 git add -A 把 API Key 推进远端。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
xsl
2026-08-14 11:28:35 +08:00
co-authored by Cursor
parent f4075f6827
commit 2934954eb2
9 changed files with 310 additions and 43 deletions
+4 -3
View File
@@ -1,6 +1,6 @@
# 「美搭」开发任务拆解(WBS)
> 版本:**v1.3** | 更新日期:2026-08-13 | 状态:待评审
> 版本:**v1.4** | 更新日期:2026-08-14 | 状态:待评审
>
> **本文的定位**:把需求与架构翻译成可指派、可验收的任务清单,并明确任务之间的依赖与关键路径。
>
@@ -187,9 +187,9 @@ M2 知识库 M3 报告闭环 M4-a 换装/发型 │
| 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-25b | DEV | **全局日成本熔断**(四档自动降级) | 模块 + 后台开关 | 注入成本可复现 60/80/90/100% 四档降级;**在途任务放行**;**被熔断拒绝的请求配额净扣减 = 0**(须有集成断言覆盖「reserve 之后才触发熔断」这条路径,不能只测「熔断在 reserve 之前」);后台可查状态并手动解除;**日预算阈值须按 8-17 峰谷新价 + 实测 token 分布重算**,`.env` 里的 `100000` 分是占位不是验收值 | 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-26 | DEV | **配额账本**(余额、流水、预扣三段式、周期重置、规则配置化) | 模块 + 接口 | 余额可由流水重算;失败自动退还;**表结构含 `tx_type` 字段,V2 上支付无需迁移**;服务端硬校验不可绕过;**`bl_quota_rule` 种子必须与产品方案 §3.2 一致**(含 `hairstyle` / `hd_export` / `report_basic` / `report_regen`),禁止开发期另写一套数字 | 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 |
| T-P1-28 | DEV | 推送接入(Push Kit + Token 管理) | 模块 | 到达率 ≥ 90%;文案无敏感结论 | FR-TASK-04 |
@@ -429,6 +429,7 @@ M2 知识库 M3 报告闭环 M4-a 换装/发型 │
| 日期 | 版本 | 变更 |
| --- | --- | --- |
| 2026-08-14 | v1.4 | 交叉评审回写:`T-P1-25b` 验收补「reserve 之后熔断」集成断言与日预算按新价重算;`T-P1-26` 明确种子必须与产品方案 §3.2 一致 |
| 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` 定价的四项前置输入 |