收口文档评审冲突并补齐 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
@@ -34,17 +34,17 @@
 | 维度 | 初级报告「形象速测」 | 全面报告「形象深度诊断」 |
 |------|---------------------|------------------------|
 | **上线版本** | V1（第一版即上线） | V2（第一版**不做**，仅做占位与意愿收集） |
-| **价格** | 免费 | 付费（V2 起，单次 ¥29.9，会员优惠价见 §2.5） |
+| **价格** | 免费 | **付费（V2 起，定价待定）** —— 原「单次 ¥29.9」为改版前残留，已废弃。V1 全线不出现任何价格（`FR-BILL-07`），V2 按 V1 实测数据定价（`T-P6-16`） |
 | **输入** | 1 张正面全身照 + 4 项基础问卷 | 全身正/侧面 + 面部特写 + 完整问卷（12~15 项） |
-| **诊断维度** | 8 项核心维度 | 40+ 项完整维度 |
+| **诊断维度** | **覆盖 21 项**（10 项完整输出 + 11 项粗判/部分），**首屏突出展示 8 项核心结论** | **覆盖全部 32 项** |
 | **色彩精度** | 四季粗判（春/夏/秋/冬）+ 8 色色板 | 十二季细分（如柔夏型）+ 完整色板（最佳色 24+/中性色/避雷色） |
 | **发型内容** | 3 条要点建议 | 独立发型专项报告（约 8 小节） |
 | **场景方案** | 1 个主场景 | 4+ 场景配色公式与完整搭配 |
 | **推荐搭配** | 1 套（可一键试穿） | 8~12 套（含单品清单与试穿入口） |
 | **篇幅** | 1~2 屏 | 15~25 屏 |
-| **生成时长** | ≤ 60s（前台等待） | ≤ 5min（异步任务 + 完成推送） |
+| **生成时长** | p95 < 90s（`NFR-PERF-03`，p50 < 45s） | p95 < 180s（`NFR-PERF-04`，V2 指标） |
 | **导出** | 分享长图（1 屏） | 分享长图 + PDF 完整版 |
-| **免费额度** | 首次不限 + 每 30 天可重新生成 1 次 | 按次购买 / 会员权益 |
+| **免费额度** | **首次 1 次（终身）+ 每 30 天可重新生成 1 次**（配额表见产品方案 §3.2，为唯一事实源；原「首次不限」表述有歧义，已更正） | V2 起按次购买 / 会员权益 |
 | **核心目的** | 拿到画像、建立信任、驱动首次试穿 | 交付专业价值、完成付费转化 |

 ### 2.2 初级报告内容（V1 交付范围）
@@ -171,10 +171,11 @@
 **第一版（V1）明确不做支付**，但要做**付费意愿验证**，这是本节最重要的产品决策：

 - V1 上线内容：仅初级报告，完全免费，无支付、无订单、无发票链路
- V1 保留入口：初级报告结果页底部展示「全面报告」预览卡片（模糊化目录截图 + 内容清单 + 预计价格），点击后：
+- V1 保留入口：初级报告结果页底部展示「全面报告」预览卡片（**模糊化目录截图 + 内容清单，不含价格**），点击后：
  - 弹出「即将上线，抢先预约」→ 用户点击即**留资 + 埋点**
-  - 记录：预约用户数 / 预约率 / 停留时长 / 点击价格档位
- 决策门槛：若预约率 ≥ 8%，V2 立即开发付费全面报告；若 < 3%，重新评估定价与内容形态
+  - 记录：预约用户数 / 预约率 / 卡片停留时长 / 目录各章节的点击分布（**不含任何价格相关埋点**）
+- 决策门槛：若预约率 ≥ 8%，V2 立即开发付费全面报告；若 < 3%，重新评估内容形态
+- ⚠️ **预约率不等于付费意愿**，预约到实付的衰减通常很大。因此 V2 定价前必须先做**小范围真实收费灰度**（`T-P6-03b`），不得仅凭预约率全量定价

 > ⚠️ **V1 的预览卡片不得展示具体价格**。原设计中的「预计价格 / 点击价格档位」已移除 —— V1 全产品线不出现任何价格与购买字样（产品方案 §3.2 纪律二），否则会污染 V2 的定价空间，也会让用户形成"处处收费"的第一印象。预约卡片只展示**内容清单与模糊化目录截图**，收集"想要"的意愿，不收集"愿意付多少"。
 >
@@ -359,6 +360,15 @@

 > ~~`#33 五行分布`、`#34 幸运色`~~ 已于 2026-08-13 移除（`TD-31`），维度总数由 34 项减为 **32 项**。编号 33/34 **不再复用**，避免历史数据与文档交叉引用错位。

+**按上表逐列统计（§2.1 分级表与 `FR-RPT-06` 的口径来源）**：
+
+| 分级 | 完整输出 | 粗判 / 部分 / 仅标签 | 不输出 | 覆盖合计 |
+|------|:------:|:-----------------:|:-----:|:------:|
+| 初级报告 | 10 项 | 11 项 | 11 项 | **21 / 32** |
+| 全面报告（V2） | 32 项 | 0 | 0 | **32 / 32** |
+
+> ⚠️ **原「初级 8 项核心 / 全面 40+ 项」的口径已废弃**：字典总共只有 32 项，不存在 40+；「8 项」指的是**结果页首屏突出展示的核心结论数**，不是覆盖的维度数，两者不是一回事，此前被混用。
+
 > 每个维度的输出必须携带 `confidence`（0~1）与 `source`（`vision` / `self_reported` / `rule` / `llm`），低置信维度在报告中以"参考"语气呈现，并允许用户手动修正。用户修正后置信度置为 1.0 且标记 `user_confirmed`。

 ---
@@ -427,12 +437,12 @@
 - **⑤ 规则引擎先于 ⑦ LLM 生成**：硬结论（体型策略、色板、避雷项）由规则引擎产出，LLM 只负责组织语言与解释，不允许 LLM 自由发挥核心结论。这是保证专业准确性、避免幻觉的关键设计。
 - **⑧ 一致性校验不可省**：至少校验三项——推荐色是否在最佳色板内、推荐单品是否命中用户禁忌项、结论之间是否自相矛盾（如同时推荐"紧身"与"避免紧身"）。校验失败则重试该章节生成。
 - **⑪ 素材绑定是闭环前提**：报告推荐的每套搭配必须绑定知识库中 `tryon_ready = true` 的白底单品图，否则"一键试穿"按钮不展示（详见 [知识库方案](./美学知识库-建设方案.md) 素材规范）。
- **全面报告必须异步**：生成时长 ≤ 5min，采用任务中心 + 完成推送，用户可退出 App。初级报告可前台等待，但同样进任务队列，避免页面销毁导致任务丢失。
+- **全面报告必须异步**：生成时长按 `NFR-PERF-04`，采用任务中心 + 完成推送，用户可退出 App。初级报告可前台等待，但同样进任务队列，避免页面销毁导致任务丢失。
 - **失败降级**：视觉分析部分失败时（如面部照缺失），跳过相关维度而非整体失败，报告中标注"该维度暂未诊断，补充照片可解锁"。

 ### 6.3 生成中的等待体验

-换装接口最长 320s、发型 120s、全面报告 ≤ 5min，长耗时是本产品的固有特征，必须产品化处理：
+换装与发型的现状耗时可达数十秒到数分钟（现状基线待 `T-P0-13`/`T-P0-14` 实测，见需求规格 §4.1.1），报告生成按 `NFR-PERF-03`/`04`。**长耗时是本产品的固有特征，必须产品化处理**：

 - 分析步骤可视化：`识别人像 → 测算体型 → 分析面部 → 采样色彩 → 匹配色板 → 生成方案`，逐步点亮
 - 展示已等待秒数 + 预计剩余
@@ -498,7 +508,7 @@
 ### 9.1 隐私与数据安全（人脸属敏感个人信息，最高优先级）

 - **单独授权**：人脸信息处理必须独立于通用隐私协议单独弹窗授权，不可默认勾选
- **最小化**：只存储派生特征与结论，**原始人脸照片处理完即删**（保留期 ≤ 24h 仅用于任务重试），报告中展示的分析图为脱敏处理版本
+- **最小化**：只存储派生特征与结论，**原始人脸照片处理完即显式删除，临时桶生命周期 ≤ 2 小时兜底**（唯一事实源：`CR-02` 与《合规与安全方案》§2.1.2；本节原写「≤ 24h 仅用于任务重试」已废弃 —— 2 小时已覆盖重试窗口，24h 只是白担合规风险），报告中展示的分析图为脱敏处理版本
 - **不用于训练**：明确承诺用户照片不用于模型训练，并在协议中写明
 - **加密**：传输 HTTPS，存储加密，OSS 签名链接短时效
 - **可删除可导出**：用户可一键删除全部报告与画像数据，可导出个人数据副本
@@ -522,10 +532,27 @@
 - **`birthday` 字段用途收窄**：仅用于生日权益与年龄段判断（影响风格建议的适龄性），**不得用于任何命理推算**。字段本身保留，但推算逻辑不实现

 ### 9.4 准确性保障
- 建立 **100 例黄金评测集**（由专业形象顾问标注体型/脸型/季型/风格），每次算法或知识库更新回归测试
- 目标准确率：体型 ≥ 85%、脸型 ≥ 80%、四季季型 ≥ 80%、十二季细分 ≥ 65%（细分季型本身专业争议大，需通过话术弱化绝对性）
+
+> 🔒 **本节是诊断准确率门槛的唯一定义位置**。产品方案 §8.3.3、`FR-RPT-05`、`T-P0-10`/`T-P0-11` 一律引用本表。
+
+- 建立 **100 例黄金评测集**（由全职形象顾问标注体型/脸型/季型/风格），每次算法或知识库更新回归测试
+
+**准确率门槛分两档，此前文档间的数值冲突全部源于没有区分这两档**：
+
+| 维度 | ① Phase 0 验证门槛 | ② 上线质量门槛 | 十二季细分 |
+|------|-----------------|-------------|----------|
+| 体型识别 | ≥ 80% | ≥ 85% | — |
+| 四季季型 | ≥ 75% | ≥ 80% | 上线门槛 ≥ 65% |
+| 脸型识别 | ≥ 75% | ≥ 80% | — |
+
+**两档的判定后果完全不同，这是必须分开的原因**：
+
+- **① 验证门槛（`T-P0-10`/`T-P0-11`，小样本）**：回答"这条技术路线走不走得通"。**不达标 → 切换技术方案**（`TD-05` 关键点方案、`TD-06` 色彩方案的备选路径），而不是继续调参。
+- **② 上线门槛（黄金集全量回归）**：回答"这个结论能不能给用户看"。**不达标 → 该维度降级**为「仅供参考」话术或直接不展示，**而不是延期上线** —— 单一维度不应阻塞整个产品。
+- **十二季细分 ≥ 65% 只有上线门槛，没有验证门槛**：它本身专业争议就大，不作为技术路线的判据，且必须通过话术弱化绝对性。
+
 - 用户修正数据作为长期评测样本回流
- 报告内提供「结论不准反馈」入口，反馈进入人工抽查
+- 报告内提供「结论不准反馈」入口，反馈进入人工抽查（对应 `FR-RPT-19`，见需求规格 §2.2）

 ### 9.5 成本控制
 - 单份初级报告成本目标 ≤ ¥0.30（视觉分析 + LLM 生成），全面报告 ≤ ¥2.00
@@ -553,8 +580,8 @@

 ### 10.2 质量指标
 - 报告生成成功率 > 97%
- 初级报告 P95 生成时长 < 60s，全面报告 P95 < 5min
- 结论修正率 < 15%（用户主动修正维度数 / 总维度数）
+- 生成时长：**初级 p95 < 90s（`NFR-PERF-03`）、全面 p95 < 180s（`NFR-PERF-04`）** —— 性能指标的唯一定义位置是《需求规格说明》§4.1，原「初级 < 60s / 全面 < 5min」已废弃
+- 结论修正率 < 15%（用户主动修正维度数 / 总维度数）—— **数据来源是 `FR-RPT-19` 的修正入口埋点，缺它则本指标无法计算**
 - 报告满意度评分 > 4.2/5
 - 首屏结论"有用"投票率 > 70%

@@ -606,6 +633,13 @@
 **作者**：产品团队
 **状态**：待评审
 **变更说明**：
+- v1.2 rev.2（2026-08-13）：文档一致性评审修订
+  - **§9.4 升为诊断准确率门槛的唯一事实源，并拆为「Phase 0 验证门槛 / 上线质量门槛」两档**。此前文档间的数值冲突（体型 80 vs 85、季型 75 vs 80）全部源于没区分这两档 —— 两者的**判定后果完全不同**：验证门槛不达标 → 切换技术方案；上线门槛不达标 → 该维度降级为「仅供参考」或不展示，**而不是延期上线**（单一维度不应阻塞整个产品）
+  - **清除全部价格残留**：§2.1 分级表的「单次 ¥29.9」、§2.5 正文的「预计价格」与埋点「点击价格档位」全部删除 —— 这三处与紧随其后的 ⚠️ 注释（说明该项"已移除"）自相矛盾
+  - **§2.1 与 §4 维度覆盖改为准确口径**：初级覆盖 **21/32 项**（10 项完整 + 11 项粗判），全面覆盖 **32 项**；原「初级 8 项核心 / 全面 40+ 项」中的 40+ 在字典里根本不存在，「8 项」实指首屏突出展示的核心结论数，两者此前被混用。§4 新增逐列统计表
+  - **§9.1 人脸原图保留期由「≤ 24h 仅用于任务重试」改为「处理完即删 + 临时桶 2 小时兜底」**，以 `CR-02` 与合规方案 §2.1.2 为准
+  - §2.1 与 §10.2 生成时长改为引用 `NFR-PERF-03/04`（初级 90s、全面 180s），原「60s / 5min」废弃；§2.1 免费额度「首次不限」改为「首次 1 次（终身）」消除歧义
+  - §2.5 补充「预约率 ≠ 付费意愿」的提醒与 V2 收费灰度前置要求；§9.4 反馈入口关联到新增的 `FR-RPT-19`
 - v1.2（2026-08-13）：业务决策收口，§11 已无遗留待确认项
  - **五行/幸运色模块整体移除**（`TD-31`）：诊断维度由 34 项减为 **32 项**，编号 33/34 不再复用；§9.3 由「命理模块的合规处理」改为「不做 + 越界拒答」；`birthday` 用途收窄为生日权益与年龄段判断
  - **§2.5 移除价格展示**：V1 预约卡片不得出现任何价格与档位（原设计含「预计价格」「点击价格档位」），价格敏感度改用线下访谈采集；V2 定价表全部改为占位，并列明定价的三个前提