meida/docs

「美搭」文档索引

智能穿搭美学助手 · 文档体系导航 最后更新：2026-08-13

---

0. 当前状态（先看这里）

0.1 已经定下来的关键前提

项	结论	影响
备案	✅ 已完成	原本 2~4 个月的上线瓶颈解除，开发进度即上线进度
V1 商业化	完全不收费，用配额限制控成本	无 IAP、无会员、无点数购买、无广告；billing 域降级为配额与计量
客户端	鸿蒙原生 ArkTS（V1 单端）	可触达基数是 HarmonyOS NEXT+ 设备，非全部鸿蒙生态设备
单品素材	全部自采实拍	版权干净，但成为项目新的关键路径
形象顾问	全职编制	规则库产能可控，但到岗时间决定 M2 排期
五行/命理模块	永久不做	诊断维度 32 项（原 34 项，移除五行分布与幸运色）
成本封顶	全局日成本熔断（四档自动降级）	⚠️ 配额封不住总成本 —— 总成本 = MAU × 人均，MAU 无上限
天气数据	V1 不接天气 API	Agent 反问用户或按城市月份推断，不编造温度
登录通道	华为账号 + 手机号验证码（两条互不依赖）	一键登录推 V2（需企业资质）

0.2 现在最该先做的三件事

按优先级，这三件都不产出代码，但决定后面全部节奏：

1. ⚠️ 核实备案登记覆盖的模型清单（T-P0-01）—— 是否含 DeepSeek 与智谱 GLM 两家？若只含一家，双路由属超范围提供服务，需办变更备案或 V1 先单路由。这是目前唯一可能影响 V1 上线合规性的未知项
2. 🔴 全职形象顾问招聘与入场（T-P0-20）—— 规则库产能直接决定 M2 能否按期，且顾问到岗第一件事是评审本体 Schema，必须在建表前完成
3. 🔴 单品自采流水线搭通并测出每周产能（T-P0-21）—— 300 件 tryon_ready 的达成时间要靠实测产能倒排，不能靠估算

为什么是这三件：备案完成后，项目的关键路径从"等外部审批"变成"内部内容产能"。第 2、3 项是唯一无法靠 AI 辅助开发压缩的工序 —— 招聘要时间、采购要物流、拍摄要棚时。它们晚一周启动，上线就晚一周，没有任何技术手段可以追回。

0.3 待业务输入的事项

仅剩 1 项：备案登记覆盖的模型清单（见上方第 1 条）。其余 24 项决策已全部收口，见产品方案 §11.1 与技术选型报告（TD-00~TD-33）。

---

1. 文档地图

文档分四层，每层解决不同的问题。遇到冲突时，以下层为准（下层更具体、更晚更新）。

第一层｜为什么做
└─ 产品方案（总纲）──────── 定位、市场、商业模式、范围、路线图
                            鸿蒙美搭-智能穿搭美学助手-产品方案.md

第二层｜做什么
├─ 需求规格说明 ★ ───────── 统一需求编号、优先级、验收标准（开发与测试的索引）
│                            需求规格说明.md
├─ 美学报告-需求文档 ─────── 报告分级、触发时机、诊断维度字典
├─ 穿搭Agent-需求文档 ────── 对话能力、意图、场景、输入输出规范
├─ 用户系统与记忆系统 ────── 账号体系、分层记忆模型、权益与配额
└─ 美学知识库-建设方案 ───── 知识分类、模态、构建流程、检索与推理

第三层｜怎么做
├─ 技术架构文档 ★ ───────── 分层架构、模块划分、数据模型、关键链路、部署
│                            技术架构文档.md
├─ 技术选型与调研报告 ★ ──── 所有技术决策的结论、理由、备选与切换条件
│                            技术选型与调研报告.md
└─ 合规与安全方案 ★ ─────── 人脸/AI 标识/备案登记/内容审核/数据安全
                            合规与安全方案.md

第四层｜谁来做、什么时候做
├─ 开发任务拆解 ★ ───────── WBS、依赖关系、里程碑、验收条件
│                           开发任务拆解.md
└─ Sprint 执行计划 ★ ────── 排期、轨道并行、已交付部分的验收状态
                            Sprint执行计划.md

★ = 本轮新增文档

文档清单（可点击）

层	文档	一句话
1	产品方案	总纲：定位、市场、商业模式、路线图
2	需求规格说明 ★	统一编号的需求与验收标准，开发测试的索引
2	美学报告-需求文档	报告分级、触发时机、32 项诊断维度
2	穿搭 Agent-需求文档	对话能力、意图识别、能力联动
2	用户系统与记忆系统-需求文档	账号与配额、L0~L5 分层记忆
2	美学知识库-建设方案	12 类知识、7 种模态、混合检索
3	技术架构文档 ★	分层架构、数据模型、关键链路、部署
3	技术选型与调研报告 ★	31 项技术决策的结论、理由与切换条件
3	合规与安全方案 ★	人脸、AI 标识、备案后的持续义务、审核、数据安全
4	开发任务拆解 ★	WBS、依赖图、六个里程碑、验收条件
4	Sprint 执行计划 ★	六个 Sprint 的排期与出口条件、四轨并行、后端脚手架已交付部分的实测验收状态

---

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 依赖图 + 各任务表的「依赖」列
现在该做哪个 Sprint、哪些已经做完了	Sprint 执行计划 §1.1（已交付）+ §1.2（待补）
后端代码在哪、怎么跑起来	Sprint 执行计划 §1；仓库 meida_backend 的 README.md
报告触发时机的完整规则	美学报告-需求文档 §3
记忆分层与冲突消解规则	用户系统与记忆系统-需求文档 §3
知识库有哪些类目和模态	美学知识库-建设方案 §3、§4

---

4. 编号体系

前缀	含义	定义位置
FR-<模块>-<序号>	功能需求	需求规格说明 §2
NFR-<类别>-<序号>	非功能需求	需求规格说明 §4
CR-<序号>	合规需求（不可裁剪）	需求规格说明 §3
TD-<序号>	技术决策	技术选型与调研报告 §1
ADR-<序号>	架构决策记录	技术架构文档 §18
T-P<阶段>-<序号>	开发任务	开发任务拆解
R-<域>-<序号>	知识库规则 ID	美学知识库-建设方案

引用纪律：跨文档引用一律用编号，不要复制内容。同一事实只在一处定义，其他地方引用——这是这套文档能长期维护的前提。

4.1 单一事实源索引（🔒 修改前必查）

2026-08-13 的一致性评审发现，几乎所有跨文档冲突都是"同一个数字被复制到多处"造成的，而不是判断分歧。下表锁定每类关键数字的唯一定义位置。

规则：要改这些数字，只改「唯一定义位置」那一列指向的地方；其余位置只允许写引用，不允许写数值。

事实	🔒 唯一定义位置	引用方
性能指标（延迟、可用性）	需求规格说明 §4.1	产品方案 §8.3.1、美学报告 §10.2、Agent §7.1/§8.3、架构 §12.1
换装/发型耗时	需求规格说明 §4.1.1（现状基线 → 目标值两段式）	同上。实测前不得引用 40s 作为验收线
配额数值（含游客）	产品方案 §3.2	用户系统 §2.4.1、FR-ACC-02、FR-BILL-*、bl_quota_rule 初始化数据
Token 预算	技术架构文档 §7.2（嵌套表，合计 4200）	FR-MEM-04、FR-AGT-03、用户系统 §3.8、Agent §3.5.2、T-P3-17、T-P4-03
成本口径（三档 + 熔断阈值）	产品方案 §5.2.1 / §5.3.1	架构 §13.1、§8.2.3、NFR-COST-*
诊断维度字典与覆盖数	美学报告 §4（32 项；初级覆盖 21）	架构 §6.2/§6.3、FR-RPT-06、README §5、产品方案 §2.2.1
诊断准确率门槛	美学报告 §9.4（验证档 / 上线档两档）	FR-RPT-05、FR-AGT-02、产品方案 §8.3.3、T-P0-10/11
知识库规模	美学知识库 §9.1（V1 硬指标 / 长期目标两列）	产品方案 §2.5.2/§2.8、FR-KB-*、T-P2-*
黄金集规模	美学知识库 §7（四个子集共 330 例）	FR-KB-11、FR-AGT-05、FR-RPT-07、美学报告 §9.4
人脸原图保留期	合规与安全方案 §2.1.2 / CR-02（2 小时）	产品方案 §7.1.4、美学报告 §9.1、架构 §7.1/§11.2、T-P1-27
记忆枚举与置信度初值	用户系统 §3.3 / §3.5	架构 §6.2、§8.4
配额账本四表职责	技术架构文档 §7.4 开头	FR-BILL-*、T-P1-26

流程建议：每次大改版后专门做一次「同一数字全局搜索」（搜 32、1400、4200、90s、300、99.5%）。本轮的问题高度集中在数字上，人工通读很难发现。

---

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；各需求文档页尾状态均为「待评审」，本表与之一致）
技术选型	已定稿（TD-00~TD-33 共 34 项决策全部收口，待业务输入仅剩 1 项）
业务决策	✅ 已全部收口（素材自采、顾问全职、V1 不收费、命理不做、市场数据信源）
备案	✅ 已完成，转为持续义务
技术架构	待技术评审
合规方案	待法务复核
任务拆解	待评审后进入执行
文档一致性评审	✅ 已完成一轮（见《文档评审报告-2026-08-13》），P0/P1/P2 全部修订完毕

最紧急的三件事见 §0.2（备案完成后已重排：模型清单核实 → 顾问到岗 → 自采流水线）。

---

8. 本轮（2026-08-13）文档更新摘要

十份内容文档全部更新 + 新增《Sprint 执行计划》（此前本表漏列《穿搭 Agent-需求文档》），分三批：

第一批 —— 业务决策落地：备案完成、V1 不收费、市场数据换官方信源、素材自采、顾问全职、命理不做。

第二批 —— 文档一致性评审修订（见《文档评审报告》）：11 项 P0 事实冲突、9 项 P1 覆盖缺口、9 项 P2 一致性问题全部修订。

第三批 —— 后端脚手架落地后的回写：meida_backend 仓库跑通真实纵向切片后，两项文档未覆盖的问题被实测暴露并回写为 T-P1-24a（思考模式）与 T-P1-25c（峰谷计价）；同时新增《Sprint 执行计划》承接排期与已交付部分的验收状态。

文档	版本	主要变更
产品方案	v6.1	§5.0「V1 不收费只限量」；§3.2 配额表补入游客列并成为唯一事实源；§4.1 市场数据换官方信源并纠正鸿蒙可触达口径；§8.1.1 用户目标下调且以季度回访率替代 DAU；§5.2.1/§5.3.1 成本口径重写为三档并推翻「配额封顶总成本」的错误论证；§8.3.1 性能指标改为引用 NFR-PERF-*；§8.3.3 准确率拆为验证/上线两档；删除全部日历周期承诺
需求规格说明	v1.2	BILL 域改为「配额与计量」，V1 移除全部支付；§4.1 成为性能指标唯一事实源（修正 Agent 整轮 8s→15s、可用性 99.9%→99.5%，换装改两段式）；NFR-COST-02 升级为自动熔断；新增 FR-ACC-14 短信防刷、FR-ACC-15 清空照片、FR-RPT-19 结论修正入口、FR-RPT-20 预约留资、FR-BILL-12 会员页留资
技术架构文档	v1.3	billing 域降级为配额与计量；§7.4 新增四张表职责边界与 task_bonus 物化方案（此前开发会卡在这里）；§7.2 token 预算改为嵌套表并修正合计 3700→4200；§13 成本模型重写为三口径 + §13.3 四档熔断降级；pf_memory/id_consent 枚举与用户系统对齐；手机号存储位置明确；points_reserved→quota_reserved；v1.3 按脚手架实现回写五处：§16.1 补全 11 个业务域包与三层判别标准、ob_ai_call 补 4 列（Prompt 版本/思考 token/峰谷档位）、§9.1 澄清 /api/v1 为规范写法、§13.2 新增峰谷计价约束、§13.3 补关键场景豁免
技术选型与调研报告	v1.2	TD-26~TD-31 六项业务决策收口；TD-19 备案已办结；补 TD-00 定义（此前被引用却未定义）；新增 TD-32 短信通道（此前 P0 需求无选型）、TD-33 天气数据源（V1 不接，给降级方案）
合规与安全方案	v1.2	§2.2.0 备案后四项持续义务；公示要求升为开发任务；人脸原图保留期统一为 2 小时（此前与产品方案的 24h 冲突）
开发任务拆解	v1.3	关键路径转移：内容与素材生产升为最优先；M4 拆为 a/b 两块消除依赖图歧义；新增 T-P1-12b/12c 短信、T-P1-16b 清空照片、T-P1-25b 熔断、T-P3-21/22 两个埋点、T-P5-17/18/19；v1.3 补 T-P1-24a 思考模式显式配置与 T-P1-25c 峰谷计价（均由后端实测暴露）
Sprint 执行计划	v1.0	新增。按依赖就绪切分六个 Sprint，标注 meida_backend 已交付任务的实测证据，并把「内容产能」明确为倒排上线时间的唯一依据
美学知识库-建设方案	v1.2	§4.2.1 素材自采流水线；§5.1.1 全职顾问工作流；§9.1 成为规模唯一事实源（V1 硬指标与长期目标分列）；§7 黄金集拆为四个子集共 330 例；修正脸型 8→7、局部特征 12→13
美学报告-需求文档	v1.2	五行模块移除（维度 34→32）；§9.4 成为准确率门槛唯一事实源（验证/上线两档）；清除全部价格残留（¥29.9、预计价格、点击价格档位）；维度覆盖改为准确口径（初级 21/32，原「40+ 项」不存在）
用户系统与记忆系统-需求文档	v1.2	§2.4 重构为 V1 配额 + V2 规划；一键登录降级；§3.8 记忆注入分项被采纳为全局事实源；配额数值改为引用产品方案 §3.2
穿搭 Agent-需求文档	v1.2	语音输入由 P0 改为 P1/V2（此前与 FR-AGT-17 冲突）；§2.1 能力表补版本与编号列；token 预算与性能指标改为引用；天气类问题明确不得编造数值；意图识别准确率拆两档；删除无依据的「1000+ 并发」