14 KiB
14 KiB
「美搭」文档索引
智能穿搭美学助手 · 文档体系导航 最后更新：2026-08-13
0. 当前状态（先看这里）
0.1 已经定下来的关键前提
| 项 | 结论 | 影响 |
|---|---|---|
| 备案 | ✅ 已完成 | 原本 2~4 个月的上线瓶颈解除，开发进度即上线进度 |
| V1 商业化 | 完全不收费，用配额限制控成本 | 无 IAP、无会员、无点数购买、无广告；billing 域降级为配额与计量 |
| 客户端 | 鸿蒙原生 ArkTS（V1 单端） | 可触达基数是 HarmonyOS NEXT+ 设备，非全部鸿蒙生态设备 |
| 单品素材 | 全部自采实拍 | 版权干净，但成为项目新的关键路径 |
| 形象顾问 | 全职编制 | 规则库产能可控，但到岗时间决定 M2 排期 |
| 五行/命理模块 | 永久不做 | 诊断维度 34 → 32 项 |
0.2 现在最该先做的三件事
按优先级，这三件都不产出代码，但决定后面全部节奏：
- ⚠️ 核实备案登记覆盖的模型清单（
T-P0-01）—— 是否含 DeepSeek 与智谱 GLM 两家？若只含一家，双路由属超范围提供服务，需办变更备案或 V1 先单路由。这是目前唯一可能影响 V1 上线合规性的未知项 - 🔴 全职形象顾问招聘与入场（
T-P0-20）—— 规则库产能直接决定 M2 能否按期，且顾问到岗第一件事是评审本体 Schema，必须在建表前完成 - 🔴 单品自采流水线搭通并测出每周产能（
T-P0-21）—— 300 件tryon_ready的达成时间要靠实测产能倒排，不能靠估算
为什么是这三件：备案完成后，项目的关键路径从"等外部审批"变成"内部内容产能"。第 2、3 项是唯一无法靠 AI 辅助开发压缩的工序 —— 招聘要时间、采购要物流、拍摄要棚时。它们晚一周启动，上线就晚一周，没有任何技术手段可以追回。
0.3 待业务输入的事项
仅剩 1 项：备案登记覆盖的模型清单（见上方第 1 条）。其余 20 项决策已全部收口，见产品方案 §11 与技术选型报告 §7。
1. 文档地图
文档分四层，每层解决不同的问题。遇到冲突时，以下层为准（下层更具体、更晚更新）。
第一层｜为什么做
└─ 产品方案（总纲）──────── 定位、市场、商业模式、范围、路线图
鸿蒙美搭-智能穿搭美学助手-产品方案.md
第二层｜做什么
├─ 需求规格说明 ★ ───────── 统一需求编号、优先级、验收标准（开发与测试的索引）
│ 需求规格说明.md
├─ 美学报告-需求文档 ─────── 报告分级、触发时机、诊断维度字典
├─ 穿搭Agent-需求文档 ────── 对话能力、意图、场景、输入输出规范
├─ 用户系统与记忆系统 ────── 账号体系、分层记忆模型、权益与配额
└─ 美学知识库-建设方案 ───── 知识分类、模态、构建流程、检索与推理
第三层｜怎么做
├─ 技术架构文档 ★ ───────── 分层架构、模块划分、数据模型、关键链路、部署
│ 技术架构文档.md
├─ 技术选型与调研报告 ★ ──── 所有技术决策的结论、理由、备选与切换条件
│ 技术选型与调研报告.md
└─ 合规与安全方案 ★ ─────── 人脸/AI 标识/备案登记/内容审核/数据安全
合规与安全方案.md
第四层｜谁来做、什么时候做
└─ 开发任务拆解 ★ ───────── WBS、依赖关系、里程碑、验收条件
开发任务拆解.md
★ = 本轮新增文档
文档清单（可点击）
| 层 | 文档 | 一句话 |
|---|---|---|
| 1 | 产品方案 | 总纲：定位、市场、商业模式、路线图 |
| 2 | 需求规格说明 ★ | 统一编号的需求与验收标准，开发测试的索引 |
| 2 | 美学报告-需求文档 | 报告分级、触发时机、32 项诊断维度 |
| 2 | 穿搭 Agent-需求文档 | 对话能力、意图识别、能力联动 |
| 2 | 用户系统与记忆系统-需求文档 | 账号与配额、L0~L5 分层记忆 |
| 2 | 美学知识库-建设方案 | 12 类知识、7 种模态、混合检索 |
| 3 | 技术架构文档 ★ | 分层架构、数据模型、关键链路、部署 |
| 3 | 技术选型与调研报告 ★ | 31 项技术决策的结论、理由与切换条件 |
| 3 | 合规与安全方案 ★ | 人脸、AI 标识、备案后的持续义务、审核、数据安全 |
| 4 | 开发任务拆解 ★ | WBS、依赖图、六个里程碑、验收条件 |
2. 按角色的阅读路径
| 角色 | 阅读顺序 |
|---|---|
| 新加入的工程师 | 产品方案 §1~§2（了解产品）→ 技术架构文档（全文）→ 技术选型报告（查为什么这么选）→ 开发任务拆解（找自己的任务）→ 对应模块的需求文档 |
| 前端/客户端 | 技术架构文档 §7 关键链路、§9 API 规范 → 需求规格说明（自己模块）→ 各需求文档的交互章节 |
| 后端 | 技术架构文档 §4 模块、§6 数据模型、§7 链路、§8 AI 层 → 需求规格说明 |
| 算法 | 技术选型报告 TD-04~TD-07、TD-22 → 技术架构文档 §8 → 美学报告需求文档 §4 诊断维度 → 知识库方案 §6 |
| 产品/设计 | 产品方案 → 需求规格说明 → 各需求文档 → 合规方案 §3 内容伦理红线 |
| 运营/内容（含形象顾问） | 美学知识库-建设方案（全文）→ 美学报告需求文档 §4 → 需求规格说明 FR-KB/FR-ADM |
| 法务/合规 | 合规与安全方案（全文）→ 需求规格说明 §3 合规需求 |
| 管理者/评审 | 产品方案 → 需求规格说明 §5 V1 范围矩阵 → 开发任务拆解 §1 里程碑 + §9 风险提醒 |
3. 快速查找
| 我想知道… | 去哪里 |
|---|---|
| 现在最该先做什么 | 本文 §0.2 |
| V1 到底做什么、不做什么 | 需求规格说明 §5 V1 范围矩阵 |
| V1 为什么不收费、怎么控成本 | 产品方案 §5.0 + §3.2 配额表；技术选型报告 TD-28 |
| 备案完成后还要做什么 | 合规与安全方案 §2.2.0 四项持续义务 |
| 市场数据的出处 | 产品方案 §4.1（国家统计局 / CNNIC / 华为 HDC 2026） |
| 某个功能的验收标准 | 需求规格说明，按 FR-xx 查 |
| 为什么选 A 不选 B | 技术选型与调研报告，按 TD-xx 查 |
| 报告是怎么生成的 | 技术架构文档 §7.1 |
| Agent 怎么用知识库和画像 | 技术架构文档 §7.2、§8.3、§8.4 |
| 数据库有哪些表 | 技术架构文档 §6.2 |
| 接口规范与错误码 | 技术架构文档 §9 |
| 人脸数据怎么处理才合法 | 合规与安全方案 §2.1 |
| 上线前必须做完什么 | 合规与安全方案 §5 检查清单 |
| 我的任务依赖谁 | 开发任务拆解 §1 依赖图 + 各任务表的「依赖」列 |
| 报告触发时机的完整规则 | 美学报告-需求文档 §3 |
| 记忆分层与冲突消解规则 | 用户系统与记忆系统-需求文档 §3 |
| 知识库有哪些类目和模态 | 美学知识库-建设方案 §3、§4 |
4. 编号体系
| 前缀 | 含义 | 定义位置 |
|---|---|---|
FR-<模块>-<序号> |
功能需求 | 需求规格说明 §2 |
NFR-<类别>-<序号> |
非功能需求 | 需求规格说明 §4 |
CR-<序号> |
合规需求（不可裁剪） | 需求规格说明 §3 |
TD-<序号> |
技术决策 | 技术选型与调研报告 §1 |
ADR-<序号> |
架构决策记录 | 技术架构文档 §18 |
T-P<阶段>-<序号> |
开发任务 | 开发任务拆解 |
R-<域>-<序号> |
知识库规则 ID | 美学知识库-建设方案 |
引用纪律：跨文档引用一律用编号，不要复制内容。同一事实只在一处定义，其他地方引用——这是这套文档能长期维护的前提。
5. 术语表
| 术语 | 含义 |
|---|---|
| 画像 | 由报告产出的结构化诊断结论（体型、色彩季型、脸型等 32 个维度） |
| 记忆系统 | 分层存储用户身份、画像、偏好、事件、衣橱的系统，L0~L5 |
| 初级报告 / 全面报告 | 免费版（V1）/ 付费版（V2）的美学报告 |
| 诊断维度 | 报告输出的单个结论项，含 value + confidence + evidence + rule_hits |
| 硬约束 / 禁忌 | 规则库中 is_hard=true 的规则，生成结果绝不允许违反 |
| tryon_ready | 单品素材已具备换装所需的白底图与规格，可用于试穿 |
| 混合检索 | 硬过滤 + 规则命中 + 向量召回 + 关键词召回 + 重排的检索链路 |
| 黄金集 | 固定输入与期望输出的测试样本集，用于质量回归 |
| 统一合规出口 | 所有 AI 生成物对外发布前必经的模块（审核 + 水印 + 元数据标识 + 编号登记） |
| 配额 | V1 的资源限制单位（次数），可通过任务奖励获得，不可购买。V1 唯一的成本控制手段 |
| 点数 | V2 的消耗单位，可通过任务获取或购买。与配额共用同一张账本表，仅 tx_type 不同 |
| 预扣三段式 | reserve（冻结）→ commit（确认）/ refund（退还），保证长耗时任务不会「扣了额度未交付」 |
| 任务中心 | 承载全部长耗时任务的统一视图与状态机 |
| 内容编号 | AI 生成内容的 27 位唯一标识，写入文件元数据用于隐式标识 |
| 大模型登记 | 调用已备案第三方模型对外提供服务时，向属地网信办办理的登记。本项目已完成，转为编号公示与变更备案等持续义务 |
| 量感 / 直曲 | 形象顾问领域术语，分别指身体线条的体量感与曲直特征。对用户展示时必须配白话释义 |
| 色彩季型 | 基于肤色、发色、瞳色的冷暖/明度/纯度特征划分的用色类型（自建体系，不使用外部商标名称） |
6. 文档维护规范
| 规则 | 说明 |
|---|---|
| 单一事实来源 | 同一信息只在一处定义，其余引用编号 |
| 变更留痕 | 修改需求或验收标准时，在文档末尾变更记录中登记日期与原因 |
| 版本号 | 结构性调整升主版本，内容补充升次版本 |
| 待确认事项 | 技术类结论统一收口在《技术选型与调研报告》§1 决策总表；仍需业务拍板的收口在该文 §7《待业务输入的事项》。各需求文档的「待确认事项」章节只保留结论摘要与编号引用，不再各自展开 |
| 冲突处理 | 发现文档间冲突时以「下层优先」原则处理，并同步修正上层文档 |
| 时效性标记 | 价格、厂商接口能力等易变信息标注 ⚠️ 时效性，使用前复核 |
7. 文档状态
| 类别 | 状态 |
|---|---|
| 产品需求 | 已定稿（V1 范围明确，见需求规格说明 §5） |
| 技术选型 | 已定稿（31 项决策全部收口，待业务输入仅剩 1 项） |
| 业务决策 | ✅ 已全部收口（素材自采、顾问全职、V1 不收费、命理不做、市场数据信源） |
| 备案 | ✅ 已完成，转为持续义务 |
| 技术架构 | 待技术评审 |
| 合规方案 | 待法务复核 |
| 任务拆解 | 待评审后进入执行 |
最紧急的三件事见 §0.2（备案完成后已重排：模型清单核实 → 顾问到岗 → 自采流水线）。
8. 本轮（2026-08-13）文档更新摘要
九份文档全部更新，核心是三件事：备案完成、V1 不收费、市场数据换成官方信源。
| 文档 | 版本 | 主要变更 |
|---|---|---|
| 产品方案 | v6.0 | §5.0 新增「V1 不收费只限量」；§3 权益拆为 V1 配额与 V2 规划；§4.1 市场数据全部换官方信源并纠正鸿蒙可触达口径；§8.1.1 用户目标下调且以季度回访率替代 DAU；§5.3 财务预期重写；备案风险关闭 |
| 需求规格说明 | v1.1 | BILL 域由「权益与计费」改为「配额与计量」，V1 移除全部支付；一键登录降级 V2；五行模块标记永久不做；§5.3 前置阻塞项状态重排 |
| 技术架构文档 | v1.1 | billing 域降级为配额与计量，bl_point_tx→bl_ledger 且新增 tx_type 使 V2 免迁移；§7.4 拆为 V1 配额与 V2 支付；成本模型补 V1 上限公式；风险登记重排 |
| 技术选型与调研报告 | v1.1 | §7 由「待业务输入」改为「决策收口」，TD-26~TD-31 六项全部给出结论与理由；TD-19 备案已办结 |
| 合规与安全方案 | v1.1 | 新增 §2.2.0 备案后四项持续义务；公示要求升为开发任务并加三条实现要求；检查清单标记已完成项 |
| 开发任务拆解 | v1.1 | 关键路径转移：备案申报任务关闭，内容与素材生产升为最优先；T-P0-20/21 要求输出每周产能用于倒排 |
| 美学知识库-建设方案 | v1.2 | 新增 §4.2.1 素材自采流水线（五工序 + 拍摄规范 + 降级路径）、§5.1.1 全职顾问工作流（四项职责按投入顺序） |
| 美学报告-需求文档 | v1.2 | 五行模块整体移除（维度 34→32）；预约卡片不得展示价格，价格敏感度改用访谈采集 |
| 用户系统与记忆系统-需求文档 | v1.2 | §2.4 重构为 V1 配额表 + V2 规划；一键登录降级；主表移除 points_balance；强化计量要求 |