save

docs/穿搭Agent-需求文档.md

@@ -0,0 +1,430 @@
+# 穿搭 Agent 需求文档
+
+> 本文档为「美搭」App 中 AI 穿搭 Agent 的独立产品需求文档，与 [产品方案](./鸿蒙美搭-智能穿搭美学助手-产品方案.md) 配套使用。
+
+## 1. 概述
+
+### 1.1 产品定位
+穿搭 Agent 是「美搭」App 的智能交互核心，通过自然语言对话为用户提供个性化的穿搭建议、场景化造型方案，并能联动换装/换发型能力实现"建议 → 预览"的闭环体验。
+
+### 1.2 核心价值
+- **降低决策成本**：用户无需自己翻找搭配，一句话获得专业建议
+- **个性化陪伴**：基于用户画像持续学习，越用越懂你
+- **所见即所得**：建议可直接联动试穿预览，从"想"到"看"无缝衔接
+- **专业级指导**：内置美学知识库，提供造型师级别的建议
+
+### 1.3 目标用户
+- 不懂搭配、需要专业指导的用户
+- 有明确场景需求（面试/约会/聚会）的用户
+- 想尝试新风格但不知如何下手的用户
+- 希望快速获得多套方案的效率型用户
+
+---
+
+## 2. 核心能力
+
+### 2.1 能力总览
+
+| 能力模块 | 描述 | 优先级 |
+|---------|------|--------|
+| 自然语言对话 | 文字/语音多模态输入，流式回复 | P0 |
+| 意图识别 | 识别用户穿搭意图（咨询/搭配/风格/场景） | P0 |
+| 场景理解 | 理解场合/季节/天气/风格偏好 | P0 |
+| 知识检索 | 基于美学知识库给出专业建议 | P0 |
+| 个性化推荐 | 基于用户画像和历史偏好推荐 | P1 |
+| 能力联动 | 调用换装/换发型能力生成预览 | P1 |
+| 上下文记忆 | 多轮对话状态跟踪 | P1 |
+| 多模态输入 | 图片输入（穿搭照片/单品图） | P2 |
+
+### 2.2 第一版（P0）能力范围
+- 文字对话（语音输入转文字）
+- 穿搭咨询与建议
+- 场景化搭配方案
+- 基础知识问答（色彩/版型/风格）
+- 单轮 + 简单多轮对话
+
+### 2.3 后续版本（P1/P2）能力规划
+- 图片输入理解（评价用户穿搭照片）
+- 联动换装/换发型预览
+- 深度个性化（用户画像学习）
+- 长期上下文记忆
+- 主动推荐（基于天气/日程）
+
+---
+
+## 3. 功能需求
+
+### 3.1 对话交互
+
+#### 3.1.1 输入方式
+- **文字输入**：支持中文自然语言，单条消息 ≤ 500 字
+- **语音输入**：语音转文字（鸿蒙系统语音能力或第三方 ASR）
+- **快捷入口**：预设常见问题快捷按钮
+- **图片输入**（P2）：支持上传穿搭照片/单品图
+
+#### 3.1.2 输出方式
+- **流式文字回复**：逐字输出，提升体验
+- **结构化卡片**：搭配方案以卡片形式展示（含图片/标签）
+- **快捷操作**：回复中嵌入"试穿此搭配""换发型"等快捷按钮
+- **语音播报**（P2）：可选的语音朗读
+
+#### 3.1.3 对话界面
+- 聊天式交互界面（参考微信/豆包对话风格）
+- 支持上下滑动查看历史对话
+- 支持复制/分享对话内容
+- 支持新建对话/切换历史对话
+- 输入框上方展示快捷问题入口
+
+### 3.2 意图识别
+
+Agent 需识别以下用户意图类别：
+
+| 意图类别 | 示例 | 响应策略 |
+|---------|------|---------|
+| **场景咨询** | "面试怎么穿？""约会穿什么？" | 给出场景化搭配方案 |
+| **单品搭配** | "白衬衫配什么裤子？""这条裙子怎么搭？" | 给出单品搭配建议 |
+| **风格建议** | "我想走法式优雅风格""适合微胖女生的风格" | 风格定位 + 推荐 |
+| **色彩咨询** | "黄皮适合什么颜色？""红配绿好看吗？" | 色彩知识解答 |
+| **身材修饰** | "腿粗怎么穿？""小个子怎么显高？" | 身材优化建议 |
+| **天气适配** | "下雨天穿什么？""15度怎么穿？" | 天气场景建议 |
+| **发型建议** | "圆脸适合什么发型？""换个发型建议" | 发型推荐（可联动） |
+| **穿搭评价**（P2） | "帮我看看这身搭配怎么样？" | 图片理解 + 评价 |
+| **闲聊/其他** | "你好""你是谁" | 友好回复 + 引导 |
+
+### 3.3 场景理解能力
+
+#### 3.3.1 场景维度
+Agent 需从用户输入中提取以下场景维度：
+
+- **场合**：职场/面试/约会/聚会/婚礼/旅行/日常/运动
+- **季节**：春/夏/秋/冬
+- **天气**：晴/阴/雨/雪/温度区间
+- **风格偏好**：职业/休闲/优雅/甜美/酷帅/法式/韩系/日系
+- **身材特征**：身高/体重/体型（H/A/V/O/X 型）
+- **肤色**：冷色调/暖色调/中性
+- **预算**（后续）：低价/中端/高端
+
+#### 3.3.2 上下文继承
+- 同一会话内，已提供的场景信息自动继承
+- 用户未提供的信息，Agent 主动询问（如"请问是什么场合？"）
+- 避免重复询问已知信息
+
+### 3.4 知识库需求
+
+#### 3.4.1 知识领域
+- **色彩搭配**：色彩理论、肤色匹配、配色方案、禁忌色
+- **版型剪裁**：不同体型的版型选择、显瘦/显高技巧
+- **风格体系**：各类风格的定义、代表单品、搭配法则
+- **场景穿搭**：各场合的着装规范、搭配模板
+- **面料材质**：面料特性、季节适配、保养知识
+- **配饰搭配**：包/鞋/首饰/丝巾的搭配规则
+- **发型知识**：脸型与发型匹配、发色选择
+
+#### 3.4.2 知识来源
+- 专业时尚书籍/杂志
+- 造型师经验总结
+- 用户 UGC 内容（审核后）
+- 品牌官方资料
+- 季节性流行趋势更新
+
+#### 3.4.3 知识更新
+- 按月更新流行趋势
+- 按季节更新场景模板
+- 用户高频问题驱动知识补充
+
+### 3.5 个性化能力
+
+#### 3.5.1 用户画像
+- **基础信息**：性别/年龄/身高/体重/体型/肤色
+- **风格偏好**：偏好风格标签/历史选择
+- **身材数据**：肩宽/腰围/臀围/腿长（来自美学报告）
+- **历史行为**：试穿记录/收藏/对话历史
+- **禁忌项**：不喜欢的风格/颜色/单品
+
+#### 3.5.2 个性化策略
+- 建议优先匹配用户偏好风格
+- 主动规避用户禁忌项
+- 基于身材数据给出针对性建议
+- 基于历史反馈持续优化推荐
+
+#### 3.5.3 学习机制
+- 用户对建议的采纳/拒绝反馈
+- 收藏/试穿行为作为正样本
+- 忽略/删除作为负样本
+- 定期更新用户画像
+
+---
+
+## 4. 典型用户场景
+
+### 4.1 场景一：面试穿搭咨询
+
+```
+用户：我明天有个互联网公司面试，怎么穿比较好？
+Agent：互联网公司面试建议走"专业但不刻板"的路线。
+      推荐搭配：
+      1. 白色衬衫 + 黑色直筒西裤 + 黑色乐福鞋
+      2. 浅蓝色衬衫 + 深灰色西装裤 + 小白鞋
+      3. 针织衫 + 卡其色阔腿裤 + 平底鞋
+      避免过于正式的整套西装，也避免太休闲的T恤牛仔裤。
+      请问您的性别和体型是？我可以给出更精准的建议。
+用户：女生，梨形身材
+Agent：梨形身材建议：
+      - 上半身选有设计感的衬衫（如飘带/蝴蝶结），把视觉重心上移
+      - 下装选 A 字裤或直筒裤，避免紧身裤
+      - 推荐方案1：飘带白衬衫 + 黑色 A 字西裤 + 黑色乐福鞋
+      [试穿此搭配] [换发型]
+```
+
+### 4.2 场景二：单品搭配
+
+```
+用户：我买了一件白衬衫，不知道配什么
+Agent：白衬衫是百搭单品，可以搭配多种风格：
+      - 职场风：配黑色西裤 + 乐福鞋
+      - 休闲风：配牛仔裤 + 小白鞋
+      - 法式风：配卡其阔腿裤 + 芭蕾平底鞋
+      您想要哪种风格？或者可以上传衬衫照片我帮您看看。
+用户：法式风
+Agent：法式风格搭配建议：
+      - 白衬衫 + 卡其色高腰阔腿裤 + 棕色芭蕾鞋
+      - 配饰：丝巾/珍珠项链/藤编包
+      - 建议：衬衫随意扎一角，更显慵懒感
+      [试穿此搭配]
+```
+
+### 4.3 场景三：风格转型
+
+```
+用户：我一直是休闲风，想尝试优雅风格，怎么开始？
+Agent：从休闲风转优雅风，可以循序渐进：
+      第1步：替换基础单品
+      - T恤 → 针织衫/衬衫
+      - 运动鞋 → 乐福鞋/芭蕾鞋
+      第2步：加入优雅元素
+      - 珍珠配饰/丝巾/腰带
+      第3步：色彩升级
+      - 从亮色 → 莫兰迪色系/大地色系
+      建议先从一两件单品开始尝试，慢慢找到适合自己的优雅感。
+      要不要我帮您生成几套过渡期搭配？
+```
+
+### 4.4 场景四：天气适配
+
+```
+用户：明天15度，有雨，怎么穿？
+Agent：15度雨天穿搭建议：
+      - 外套：风衣/薄呢大衣（防水款更佳）
+      - 内搭：针织衫/长袖衬衫
+      - 下装：直筒裤/阔腿裤（避免拖地）
+      - 鞋子：切尔西靴/乐福鞋（避免帆布鞋）
+      - 配饰：折叠伞/防水包
+      推荐：卡其色风衣 + 白色针织衫 + 黑色直筒裤 + 黑色切尔西靴
+```
+
+---
+
+## 5. 交互流程
+
+### 5.1 标准对话流程
+
+```
+用户输入
+   ↓
+意图识别
+   ↓
+场景维度提取（场合/风格/身材等）
+   ↓
+缺失信息？——是——→ 主动询问
+   ↓ 否
+知识检索 + 用户画像匹配
+   ↓
+生成搭配方案（1-3套）
+   ↓
+结构化输出（文字 + 卡片 + 快捷操作）
+   ↓
+用户反馈（采纳/拒绝/调整）
+   ↓
+更新用户画像
+```
+
+### 5.2 联动试穿流程（P1）
+
+```
+用户：帮我搭一套职场 look
+   ↓
+Agent 生成搭配方案
+   ↓
+用户点击 [试穿此搭配]
+   ↓
+跳转换装页面，自动填入：
+  - 用户照片
+  - 上衣图（cloth_img）
+  - 裤子图（kuzi_img）
+  - 提示词（change_desc）
+   ↓
+调用换装 API
+   ↓
+返回试穿结果
+   ↓
+用户查看效果，可回到 Agent 继续调整
+```
+
+### 5.3 联动发型流程（P1）
+
+```
+用户：圆脸适合什么发型？
+   ↓
+Agent 推荐发型（基于脸型知识）
+   ↓
+用户点击 [试戴此发型]
+   ↓
+跳转发型设计页面，预选推荐发型
+   ↓
+用户上传照片 → 调用发型 API
+   ↓
+返回发型效果
+```
+
+---
+
+## 6. 输入输出规范
+
+### 6.1 输入规范
+
+#### 6.1.1 文字输入
+- 单条消息 ≤ 500 字
+- 支持中文
+- 支持表情符号
+
+#### 6.1.2 语音输入
+- 单次录音 ≤ 60 秒
+- 自动转文字后发送
+- 支持方言识别（普通话为主）
+
+#### 6.1.3 图片输入（P2）
+- 支持 JPG/PNG/WEBP
+- 单张 ≤ 10MB
+- 支持多图（≤ 4 张）
+
+### 6.2 输出规范
+
+#### 6.2.1 文字回复
+- 单次回复 ≤ 800 字
+- 使用分段 + 列表，避免大段文字
+- 语气友好专业，避免机械感
+
+#### 6.2.2 搭配方案卡片
+每套搭配方案包含：
+- 方案标题（如"职场优雅风"）
+- 单品列表（上衣/下装/鞋子/配饰）
+- 参考图片（风格参考图）
+- 适配标签（场合/风格/体型）
+- 快捷操作（试穿/换发型/收藏/调整）
+
+#### 6.2.3 快捷操作按钮
+- **试穿此搭配**：跳转换装页面
+- **换发型**：跳转发型设计页面
+- **换一套**：重新生成方案
+- **收藏**：保存到收藏夹
+- **为什么推荐**：解释推荐理由
+
+---
+
+## 7. 非功能需求
+
+### 7.1 性能需求
+- **首字响应时间**：< 2 秒（流式输出首字）
+- **完整回复时间**：< 15 秒
+- **并发支持**：支持 1000+ 并发对话
+- **可用性**：> 99.5%
+
+### 7.2 体验需求
+- 流式输出，避免长时间空白等待
+- 输入时显示"对方正在输入..."
+- 网络异常时友好提示并支持重试
+- 历史对话本地缓存，支持离线查看
+
+### 7.3 安全与合规
+- 对话内容过滤（涉黄/涉政/广告）
+- 用户数据加密存储
+- 不收集非必要个人信息
+- 用户可导出/删除对话数据
+- 遵守《生成式AI服务管理办法》
+
+### 7.4 成本控制
+- 单次对话成本控制在 ¥0.05 以内
+- 免费用户每日 10 次对话
+- 长对话自动总结，避免上下文过长
+- 缓存常见问题答案
+
+---
+
+## 8. 评估指标
+
+### 8.1 业务指标
+- **对话 DAU**：日均对话用户数
+- **人均对话轮次**：> 5 轮/日
+- **对话满意度**：> 4.0/5（用户评分）
+- **采纳率**：建议被采纳/试穿的比例 > 30%
+- **联动转化率**：对话 → 试穿的转化率 > 20%
+
+### 8.2 质量指标
+- **意图识别准确率**：> 90%
+- **场景理解准确率**：> 85%
+- **回复相关性**：> 4.0/5
+- **知识准确性**：> 95%
+- **违规率**：< 0.1%
+
+### 8.3 技术指标
+- **首字延迟**：< 2s（P95）
+- **完整回复延迟**：< 15s（P95）
+- **错误率**：< 1%
+- **崩溃率**：< 0.1%
+
+---
+
+## 9. 实施计划
+
+### 9.1 Phase 1：MVP（与产品 MVP 同步）
+- [ ] 大模型选型与对接
+- [ ] 基础对话能力（文字输入/流式输出）
+- [ ] 穿搭知识库搭建（色彩/版型/风格/场景）
+- [ ] 意图识别（场景咨询/单品搭配/风格建议）
+- [ ] 快捷问题入口
+- [ ] 对话历史保存
+
+### 9.2 Phase 2：能力增强
+- [ ] 语音输入
+- [ ] 多轮对话上下文记忆
+- [ ] 用户画像构建
+- [ ] 个性化推荐
+- [ ] 联动换装试穿
+- [ ] 联动发型设计
+- [ ] 搭配方案卡片优化
+
+### 9.3 Phase 3：深度能力
+- [ ] 图片输入理解
+- [ ] 穿搭评价
+- [ ] 主动推荐（天气/日程驱动）
+- [ ] 流行趋势更新
+- [ ] 多语言支持
+
+---
+
+## 10. 待确认事项
+
+- [ ] 大模型选型：GPT-4 / 文心一言 / 讯飞星火 / 通义千问 / 自研
+- [ ] 知识库技术方案：向量数据库 / 知识图谱 / RAG
+- [ ] 语音识别方案：鸿蒙系统 / 第三方 ASR
+- [ ] 对话数据存储策略与保留时长
+- [ ] 内容审核方案：自建 / 第三方
+- [ ] 成本预算与调用配额
+
+---
+
+**文档版本**：v1.0
+**创建日期**：2026-08-11
+**作者**：产品团队
+**状态**：待评审
+**关联文档**：[美搭-智能穿搭美学助手-产品方案](./鸿蒙美搭-智能穿搭美学助手-产品方案.md)