@guru-ai-product/ai-product-kit 0.2.251112184032 → 0.2.251113155253

package/mcp/.doc_cache/0c0570b87cf4a98a_/351/234/200/346/261/202/350/277/255/344/273/243/346/250/241/346/235/277.md

@@ -0,0 +1,821 @@
+# [功能名称] - [功能描述]
+
+## 1. 需求背景
+
+<!-- ⚠️ 以下为规范说明，请勿输出到最终文档 ⚠️ -->
+**重要说明**：在填写需求背景前，必须先完成历史需求文档检查：
+
+1. **查找历史文档**：在项目的 `requirements/` 或 `../../` 目录下查找相关的历史需求文档
+2. **分析现有设计**：仔细阅读历史文档中的相关功能描述、设计思路和实现方案
+3. **保持一致性**：尽量参考现有的设计（除了用户明确要调整的部分），保持统一和一致
+4. **明确变更**：清晰说明本次迭代与历史文档的关系，哪些是继承，哪些是修改
+<!-- ⚠️ 规范说明结束 ⚠️ -->
+
+**问题描述**：[描述当前存在的问题，用户痛点]
+
+**业务目标**：[描述通过此功能要达成的业务目标]
+
+**用户影响**：[描述影响的目标用户群体]
+
+**历史文档参考**（可选）：
+
+<!-- ⚠️ 以下为规范说明，请勿输出到最终文档 ⚠️ -->
+**重要说明**：如果本次迭代基于历史需求文档，应在此处引用相关文档，说明继承和修改的关系。如果没有相关历史文档，可省略此部分。
+<!-- ⚠️ 规范说明结束 ⚠️ -->
+
+* [相关历史需求文档](文档链接) - [说明与本次迭代的关系，如：继承设计思路、修改交互流程、扩展功能范围等]
+
+## 2. 整体修改逻辑
+
+### 2.1 整体设计
+
+[用简单清晰的语言，完整介绍整体设计思路和设计内容]
+
+**设计思路**：
+
+[描述在现有基础上如何设计新功能，解决什么问题]
+
+**核心功能**：
+
+* **[功能1]**：[功能描述]
+* **[功能2]**：[功能描述]
+* **[功能3]**：[功能描述]
+* **[功能4]**：[功能描述]
+* **[功能5]**：[功能描述]
+
+**需求要点**：
+
+* **[要点1]**：[需求要点描述]
+* **[要点2]**：[需求要点描述]
+* **[要点3]**：[需求要点描述]
+
+### 2.2 交互流程设计
+
+#### 2.2.1 完整交互流程
+
+<!-- ⚠️ 以下为规范说明，请勿输出到最终文档 ⚠️ -->
+**重要说明**：以下情况可以省略流程图，直接使用 `*略*` 标记：
+
+* **简单功能场景**：单一操作、无分支判断、无复杂交互
+  * 场景举例：修改按钮颜色、调整文案内容、添加简单设置选项
+* **无流程变更场景**：在现有流程基础上增加功能，不改变原有交互逻辑
+  * 场景举例：在现有页面添加新按钮、在现有表单增加字段
+* **纯展示功能场景**：只展示信息，无用户交互操作
+  * 场景举例：新增数据展示页面、添加统计图表
+* **后端功能场景**：纯服务端功能，无前端交互流程
+  * 场景举例：新增API接口、优化数据库查询、添加缓存机制
+
+**需要流程图的情况**：
+
+* 新增复杂交互流程
+* 修改现有流程逻辑
+* 多步骤操作流程
+* 有分支判断的交互
+* 涉及多页面跳转的功能
+<!-- ⚠️ 规范说明结束 ⚠️ -->
+
+[使用Mermaid流程图展示完整的用户交互流程]
+
+```mermaid
+graph TD
+    A[起始节点] --> B[用户操作]
+    B --> C{判断条件}
+    C -->|条件1| D[操作1]
+    C -->|条件2| E[操作2]
+    D --> F[结果1]
+    E --> G[结果2]
+    
+    %% 样式定义
+    style A fill:#e8f5e8
+    style B fill:#e3f2fd
+    style C fill:#e3f2fd
+    style D fill:#e8f5e8
+    style E fill:#e8f5e8
+    style F fill:#c8e6c9
+    style G fill:#c8e6c9
+```
+
+**图例说明**（可选）：
+
+* 🟢 **绿色节点**：起始/结束节点
+* 🔵 **蓝色节点**：用户操作/判断节点  
+* 🟢 **浅绿色节点**：操作结果节点
+
+#### 2.2.2 关键交互节点
+
+**用户主动触发点**：
+
+* **[触发点1]**：[触发点描述]
+* **[触发点2]**：[触发点描述]
+* **[触发点3]**：[触发点描述]
+
+**视觉反馈机制**：
+
+* **[反馈机制1]**：[具体表现]
+* **[反馈机制2]**：[具体表现]
+* **[反馈机制3]**：[具体表现]
+
+**个性化策略**：（可选）
+
+* **[用户特征1]**：[针对该特征的优化策略]
+* **[用户特征2]**：[针对该特征的优化策略]
+* **[用户特征3]**：[针对该特征的优化策略]
+
+## 3. 客户端需求
+
+### 3.1 页面设计
+
+#### 3.1.1 [页面1名称]
+
+**页面功能**：[页面功能描述]
+**页面布局**：[页面整体布局描述]
+
+**线框示意图**（可选）：
+
+<!-- ⚠️ 以下为规范说明，请勿输出到最终文档 ⚠️ -->
+*当页面布局复杂或包含多个组件时，提供线框示意图*
+<!-- ⚠️ 规范说明结束 ⚠️ -->
+
+```
+┌─────────────────────────────────────┐
+│ [页面标题]                    [返回] │
+├─────────────────────────────────────┤
+│ ┌─────────────────────────────────┐ │
+│ │ [组件1标题]                     │ │
+│ │ [文字内容] [图片]               │ │
+│ │ [按钮1] [按钮2]                 │ │
+│ └─────────────────────────────────┘ │
+├─────────────────────────────────────┤
+│ ┌─────────────────────────────────┐ │
+│ │ [组件2标题]                     │ │
+│ │ [文字内容]                      │ │
+│ │ [按钮3]                         │ │
+│ └─────────────────────────────────┘ │
+└─────────────────────────────────────┘
+```
+
+**页面组件**：
+
+##### 3.1.1.1 [组件1名称]
+
+**功能**：[组件功能描述]
+**UI布局**：[组件UI布局描述]
+
+**线框示意图**（可选）：
+
+<!-- ⚠️ 以下为规范说明，请勿输出到最终文档 ⚠️ -->
+*当组件结构复杂时，提供组件线框示意图*
+<!-- ⚠️ 规范说明结束 ⚠️ -->
+
+```
+┌─────────────────────────────────────┐
+│ [组件标题]                    ●状态 │
+├─────────────────────────────────────┤
+│ [文字内容] [图片]                   │
+│ [数据展示区域]                      │
+│ ┌─────┐ ┌─────┐ ┌─────┐           │
+│ │数据1│ │数据2│ │数据3│           │
+│ └─────┘ └─────┘ └─────┘           │
+├─────────────────────────────────────┤
+│ [按钮1] [按钮2] [按钮3]             │
+└─────────────────────────────────────┘
+```
+
+**显示内容**：
+
+* **[显示内容1]**：[显示内容描述]
+* **[显示内容2]**：[显示内容描述]
+* **[显示内容3]**：[显示内容描述]
+
+**交互逻辑**：
+
+* **[交互逻辑1]**：[交互逻辑描述]
+* **[交互逻辑2]**：[交互逻辑描述]
+* **[交互逻辑3]**：[交互逻辑描述]
+
+**文案**：
+
+* **[文案标签1]**：**[文案内容]**
+* **[文案标签2]**：**[文案内容]**
+* **[文案标签3]**：**[文案内容]**
+
+##### 3.1.1.2 [组件2名称]
+
+**功能**：[组件功能描述]
+**UI布局**：[组件UI布局描述]
+
+**线框示意图**（可选）：
+
+<!-- ⚠️ 以下为规范说明，请勿输出到最终文档 ⚠️ -->
+*当组件结构复杂时，提供组件线框示意图*
+<!-- ⚠️ 规范说明结束 ⚠️ -->
+
+```
+┌─────────────────────────────────────┐
+│ [组件标题]                          │
+├─────────────────────────────────────┤
+│ [文字内容]                          │
+│ [数据展示]                          │
+├─────────────────────────────────────┤
+│ [按钮1] [按钮2]                     │
+└─────────────────────────────────────┘
+```
+
+**显示内容**：
+
+* **[显示内容1]**：[显示内容描述]
+* **[显示内容2]**：[显示内容描述]
+* **[显示内容3]**：[显示内容描述]
+
+**交互逻辑**：
+
+* **[交互逻辑1]**：[交互逻辑描述]
+* **[交互逻辑2]**：[交互逻辑描述]
+* **[交互逻辑3]**：[交互逻辑描述]
+
+**文案**：
+
+* **[文案标签1]**：**[文案内容]**
+* **[文案标签2]**：**[文案内容]**
+* **[文案标签3]**：**[文案内容]**
+
+#### 3.1.2 [页面2名称]
+
+**页面功能**：[页面功能描述]
+**页面布局**：[页面整体布局描述]
+
+**线框示意图**（可选）：
+
+<!-- ⚠️ 以下为规范说明，请勿输出到最终文档 ⚠️ -->
+*当页面布局复杂或包含多个组件时，提供线框示意图*
+<!-- ⚠️ 规范说明结束 ⚠️ -->
+
+**页面组件**：
+
+##### 3.1.2.1 [组件3名称]
+
+**功能**：[组件功能描述]
+**UI布局**：[组件UI布局描述]
+
+**线框示意图**（可选）：
+
+<!-- ⚠️ 以下为规范说明，请勿输出到最终文档 ⚠️ -->
+*当组件结构复杂时，提供组件线框示意图*
+<!-- ⚠️ 规范说明结束 ⚠️ -->
+
+```
+┌─────────────────────────────────────┐
+│ [组件标题]                          │
+├─────────────────────────────────────┤
+│ [文字内容]                          │
+│ [数据展示]                          │
+├─────────────────────────────────────┤
+│ [按钮1] [按钮2]                     │
+└─────────────────────────────────────┘
+```
+
+**显示内容**：
+
+* **[显示内容1]**：[显示内容描述]
+* **[显示内容2]**：[显示内容描述]
+* **[显示内容3]**：[显示内容描述]
+
+**交互逻辑**：
+
+* **[交互逻辑1]**：[交互逻辑描述]
+* **[交互逻辑2]**：[交互逻辑描述]
+* **[交互逻辑3]**：[交互逻辑描述]
+
+**文案**：
+
+* **[文案标签1]**：**[文案内容]**
+* **[文案标签2]**：**[文案内容]**
+* **[文案标签3]**：**[文案内容]**
+
+##### 3.1.2.2 🆕 新增[组件4名称]
+
+**功能**：[组件功能描述]
+**UI布局**：[组件UI布局描述]
+
+**线框示意图**（可选）：
+
+<!-- ⚠️ 以下为规范说明，请勿输出到最终文档 ⚠️ -->
+*当组件结构复杂时，提供组件线框示意图*
+<!-- ⚠️ 规范说明结束 ⚠️ -->
+
+```
+┌─────────────────────────────────────┐
+│ [组件标题]                          │
+├─────────────────────────────────────┤
+│ [文字内容]                          │
+│ [数据展示]                          │
+├─────────────────────────────────────┤
+│ [按钮1] [按钮2]                     │
+└─────────────────────────────────────┘
+```
+
+**显示内容**：
+
+* **[显示内容1]**：[显示内容描述]
+* **[显示内容2]**：[显示内容描述]
+* **[显示内容3]**：[显示内容描述]
+
+**交互逻辑**：
+
+* **[交互逻辑1]**：[交互逻辑描述]
+* **[交互逻辑2]**：[交互逻辑描述]
+* **[交互逻辑3]**：[交互逻辑描述]
+
+**文案**：
+
+* **[文案标签1]**：**[文案内容]**
+* **[文案标签2]**：**[文案内容]**
+* **[文案标签3]**：**[文案内容]**
+
+### 3.4 技术需求要点（可选）
+
+**跨组件交互逻辑**（可选）
+
+* **[交互逻辑1]**：[跨组件交互逻辑描述]
+* **[交互逻辑2]**：[跨组件交互逻辑描述]
+* **[交互逻辑3]**：[跨组件交互逻辑描述]
+
+**性能优化**（可选）
+
+* **[优化点1]**：[性能优化描述]
+* **[优化点2]**：[性能优化描述]
+* **[优化点3]**：[性能优化描述]
+
+**技术要求**（可选）
+
+* **[性能要求]**：[性能相关的技术要求，如响应时间、内存使用等]
+* **[兼容性要求]**：[兼容性相关的技术要求，如系统版本、浏览器支持等]
+* **[安全要求]**：[安全性相关的技术要求，如数据加密、权限控制等]
+
+### 3.5 数据管理
+
+#### 3.5.1 本地存储
+
+* **[存储项1]**：[存储项描述]
+* **[存储项2]**：[存储项描述]
+* **[存储项3]**：[存储项描述]
+
+#### 3.5.2 状态管理
+
+<!-- ⚠️ 以下为规范说明，请勿输出到最终文档 ⚠️ -->
+**状态管理**：描述客户端需要管理的各种状态变量和状态变化逻辑
+<!-- ⚠️ 规范说明结束 ⚠️ -->
+
+* **[全局状态]**：[描述应用级别的状态，如用户登录状态、网络连接状态等]
+  * **状态变量**：[具体的状态变量名称和类型]
+  * **状态变化**：[什么情况下状态会发生变化]
+  * **状态影响**：[状态变化会影响哪些功能或界面]
+
+* **[页面状态]**：[描述特定页面的状态，如页面加载状态、表单填写状态等]
+  * **状态变量**：[具体的状态变量名称和类型]
+  * **状态变化**：[什么情况下状态会发生变化]
+  * **状态影响**：[状态变化会影响哪些UI元素或交互]
+
+* **[组件状态]**：[描述特定组件的状态，如按钮禁用状态、列表展开状态等]
+  * **状态变量**：[具体的状态变量名称和类型]
+  * **状态变化**：[什么情况下状态会发生变化]
+  * **状态影响**：[状态变化会影响组件的哪些行为]
+
+#### 3.5.3 数据流
+
+<!-- ⚠️ 以下为规范说明，请勿输出到最终文档 ⚠️ -->
+**数据流**：描述数据在客户端各组件、页面之间的传递路径和方式
+<!-- ⚠️ 规范说明结束 ⚠️ -->
+
+* **[数据流1]**：[描述具体的数据传递场景，如"用户输入数据到服务端"]
+  * **数据源**：[数据从哪里来，如用户输入、本地存储、网络请求等]
+  * **传递路径**：[数据经过哪些组件或页面]
+  * **传递方式**：[如何传递，如props、事件、状态管理等]
+  * **数据目标**：[数据最终到哪里，如服务端API、本地存储等]
+
+* **[数据流2]**：[描述具体的数据传递场景，如"服务端响应数据到UI展示"]
+  * **数据源**：[数据从哪里来，如服务端API、本地缓存等]
+  * **传递路径**：[数据经过哪些组件或页面]
+  * **传递方式**：[如何传递，如props、事件、状态管理等]
+  * **数据目标**：[数据最终到哪里，如UI组件、本地存储等]
+
+### 3.6 埋点设计（可选）
+
+<!-- ⚠️ 以下为规范说明，请勿输出到最终文档 ⚠️ -->
+**重要说明**：当客户端有较大调整或增加重要的新功能时，需要增加埋点设计说明。
+
+**适用场景**：
+
+* 新增重要功能模块
+* 修改核心业务流程
+* 增加用户行为追踪需求
+* 需要数据分析支持的功能
+
+**规范参考**：在编写埋点设计时，**必须优先参考埋点规范文档**，复用已有的事件和参数名：
+
+* [埋点规范文档](/Users/wuchong/Develop/AI Product Kit/mcp/.doc_cache/88e1d483f18abd02_埋点规范文档.md) - **必读**：包含已定义事件库和参数库
+<!-- ⚠️ 规范说明结束 ⚠️ -->
+
+**埋点设计表格**：
+
+| Event Name | Event Trigger | Params Key | Params Value |
+|------------|---------------|------------|--------------|
+| [事件名称1] | [触发时机描述] | [参数1名称] | [参数1值说明] |
+| | | [参数2名称] | [参数2值说明] |
+| | | [参数3名称] | [参数3值说明] |
+| [事件名称2] | [触发时机描述] | [参数1名称] | [参数1值说明] |
+| | | [参数2名称] | [参数2值说明] |
+| [事件名称3] | [触发时机描述] | [参数1名称] | [参数1值说明] |
+| | | [参数2名称] | [参数2值说明] |
+| | | [参数3名称] | [参数3值说明] |
+| | | [参数4名称] | [参数4值说明] |
+
+## 4. 服务端需求
+
+### 4.1 接口需求
+
+#### 4.1.1 [接口1名称]
+
+**接口功能**：[接口功能描述]
+
+**接口输入参数**：
+
+* **[参数1]**：[参数描述]
+* **[参数2]**：[参数描述]
+* **[参数3]**：[参数描述]
+
+**接口输出内容**：
+
+* **[输出1]**：[输出描述]
+* **[输出2]**：[输出描述]
+* **[输出3]**：[输出描述]
+
+**异常处理**：
+
+* **[异常类型1]**：
+  * **触发场景**：[异常触发场景]
+  * **具体表现**：[异常具体表现]
+  * **处理方式**：返回错误码 `[ERROR_CODE]`，[处理方式描述]
+
+* **[异常类型2]**：
+  * **触发场景**：[异常触发场景]
+  * **具体表现**：[异常具体表现]
+  * **处理方式**：返回错误码 `[ERROR_CODE]`，[处理方式描述]
+
+#### 4.1.2 [接口2名称]
+
+**接口功能**：[接口功能描述]
+
+**接口输入参数**：
+
+* **[参数1]**：[参数描述]
+* **[参数2]**：[参数描述]
+* **[参数3]**：[参数描述]
+
+**接口输出内容**：
+
+* **[输出1]**：[输出描述]
+* **[输出2]**：[输出描述]
+* **[输出3]**：[输出描述]
+
+**异常处理**：
+
+* **[异常类型1]**：
+  * **触发场景**：[异常触发场景]
+  * **具体表现**：[异常具体表现]
+  * **处理方式**：返回错误码 `[ERROR_CODE]`，[处理方式描述]
+
+* **[异常类型2]**：
+  * **触发场景**：[异常触发场景]
+  * **具体表现**：[异常具体表现]
+  * **处理方式**：返回错误码 `[ERROR_CODE]`，[处理方式描述]
+
+### 4.2 数据处理需求
+
+#### 4.2.1 [数据处理模块1]
+
+* [处理逻辑1]
+* [处理逻辑2]
+* [处理逻辑3]
+
+#### 4.2.2 [数据处理模块2]
+
+* [处理逻辑1]
+* [处理逻辑2]
+* [处理逻辑3]
+
+### 4.3 数据存储需求
+
+#### 4.3.1 数据库需求
+
+* **[数据表1]**：[数据表描述]
+* **[数据表2]**：[数据表描述]
+* **[数据表3]**：[数据表描述]
+
+#### 4.3.2 缓存需求
+
+* **[缓存1]**：[缓存策略描述]
+* **[缓存2]**：[缓存策略描述]
+* **[缓存3]**：[缓存策略描述]
+
+## 5. 附录
+
+### 5.1 相关文档
+
+* [相关文档1](文档链接)
+* [相关文档2](文档链接)
+
+<!-- ⚠️ 以下为规范说明，请勿输出到最终文档 ⚠️ -->
+**重要说明**：相关文档和参考资料必须按照 Markdown 链接格式填写：`[文档名称](文档链接)`。只列出实际存在的文档链接，如果没有具体的文档链接，请使用 `*略*` 标记，不要填写虚假或占位符链接。
+<!-- ⚠️ 规范说明结束 ⚠️ -->
+
+### 5.2 参考资料
+
+* [参考资料1](参考链接)
+* [参考资料2](参考链接)
+
+---
+
+<!-- ============================================
+⚠️ 模板规范说明区域 - 请勿输出到最终文档 ⚠️
+============================================
+以下内容为模板使用规范和说明，仅用于指导如何填写模板，
+在使用模板生成最终文档时，应完全删除或忽略此部分内容。
+============================================ -->
+
+## 模板使用说明
+
+### 文档格式规范与检查清单
+
+#### 列表格式规范
+
+**功能需求描述：使用破折号 `-` + 加粗标题**
+
+```markdown
+- **功能名称**：功能描述
+- **业务规则**：
+  * 具体规则1
+  * 具体规则2
+```
+
+**技术需求内容：使用星号 `*`**
+
+```markdown
+* 技术要点1
+* 技术要点2
+* 技术要点3
+```
+
+**操作步骤：使用数字列表 `1. 2. 3.`**
+
+```markdown
+1. 第一步操作
+2. 第二步操作
+3. 第三步操作
+```
+
+#### 加粗格式规范
+
+**标题性内容：冒号前加粗**
+
+```markdown
+- **功能名称**：功能描述
+- **业务规则**：具体规则
+```
+
+**普通描述：冒号前不加粗**
+
+```markdown
+- 分析按钮：用户输入食物描述后点击分析
+- 确认按钮：用户确认当前结果并返回
+```
+
+**重要强调：整段加粗**
+
+```markdown
+**重要说明**：这是需要特别注意的内容
+**CRITICAL**：这是关键信息
+```
+
+#### 代码格式规范
+
+**行内代码：使用单个反引号**
+
+```markdown
+使用 `API接口` 进行数据交互
+```
+
+**代码块：使用三个反引号**
+
+```markdown
+```json
+{
+  "key": "value"
+}
+```
+
+```
+
+**占位符：使用中括号**
+```markdown
+[功能名称]、[参数描述]、[返回值]
+```
+
+#### 格式检查清单
+
+**列表格式检查**
+
+* [ ] 功能需求描述使用破折号 `-` + 加粗标题
+* [ ] 技术需求内容使用星号 `*`
+* [ ] 操作步骤使用数字列表 `1. 2. 3.`
+
+**加粗格式检查**
+
+* [ ] 标题性内容冒号前加粗（如：**功能名称**：）
+* [ ] 普通描述冒号前不加粗（如：分析按钮：）
+* [ ] 重要强调整段加粗（如：**重要说明**：）
+
+**整体格式检查**
+
+* [ ] 标题层级正确（# ## ### ####）
+* [ ] 段落间有空行分隔
+* [ ] 中括号占位符已替换为实际内容
+* [ ] 文档结构完整，章节齐全
+
+### 中括号使用规则
+
+**重要说明**：模板中的 `[内容]` 格式表示需要替换的占位符内容。在实际使用时：
+
+1. **替换原则**：将 `[内容]` 替换为具体的实际内容
+2. **格式要求**：替换后的内容**不要保留中括号**
+3. **示例对比**：
+   * ❌ 错误：`[功能名称]` → `[用户登录功能]`
+   * ✅ 正确：`功能名称` → `用户登录功能`
+   * ❌ 错误：`[功能描述]` → `[实现用户身份验证]`
+   * ✅ 正确：`功能描述` → `实现用户身份验证`
+
+### 线框图符号约定
+
+**重要说明**：线框示意图使用ASCII艺术风格绘制，包含以下符号约定：
+
+* **┌─┐** 表示界面边界
+* **├─┤** 表示分隔线
+* **│ │** 表示内容区域
+* **[按钮]** 表示按钮元素
+* **[图片]** 表示图片元素
+* **[文字]** 表示文字内容
+* **●** 表示状态指示器
+* **→** 表示流程方向
+
+**使用场景**：
+
+* 当页面布局复杂或包含多个组件时，提供页面线框示意图
+* 当组件结构复杂时，提供组件线框示意图
+* 线框图应清晰展示UI元素的布局关系和层次结构
+
+### 状态管理与数据流概念说明
+
+**状态管理**：关注的是"什么状态"和"什么时候变化"
+
+* **状态**：描述应用、页面或组件当前的状态（如：加载中、已登录、表单有效等）
+* **变化**：描述什么情况下状态会发生变化（如：网络请求完成、用户点击按钮等）
+* **影响**：描述状态变化会影响什么（如：显示加载动画、启用提交按钮等）
+
+**数据流**：关注的是"数据怎么传递"和"经过哪些路径"
+
+* **数据源**：数据从哪里来（如：用户输入、API响应、本地存储等）
+* **传递路径**：数据经过哪些组件或页面
+* **传递方式**：如何传递数据（如：props、事件、状态管理等）
+* **数据目标**：数据最终到哪里（如：服务端API、UI组件等）
+
+**示例对比**：
+
+**状态管理示例**（拍照功能）：
+
+```markdown
+* **拍照状态**：描述拍照组件的当前状态
+  * **状态变量**：isCameraReady: boolean, photoCount: number
+  * **状态变化**：相机初始化完成时isCameraReady变为true，拍照后photoCount增加
+  * **状态影响**：isCameraReady为true时显示拍照按钮，photoCount达到3时隐藏添加按钮
+```
+
+**数据流示例**（拍照功能）：
+
+```markdown
+* **照片数据流**：描述照片数据从拍摄到上传的传递过程
+  * **数据源**：用户拍摄的照片文件
+  * **传递路径**：拍照组件 → 预览组件 → 编辑组件 → 上传服务
+  * **传递方式**：通过props传递照片对象，通过事件传递用户操作
+  * **数据目标**：最终上传到服务端API
+```
+
+### 文档结构说明
+
+#### 必选章节（所有功能都需要）
+
+* **1. 需求背景**：必须明确问题、目标和用户影响
+* **2. 整体修改逻辑**：必须包含整体设计和交互流程
+
+#### 可选章节（根据功能特点选择）
+
+* **2.1 整体设计**：
+  * **设计思路**：必须包含，描述整体设计思路
+  * **核心功能**：必须包含，列出主要功能
+  * **需求要点**：当有重要的需求考虑时使用
+    * 场景举例：多端同步、离线功能、性能优化、安全考虑
+* **2.2 交互流程设计**：
+  * **完整交互流程**：根据功能复杂度决定是否包含
+    * **需要流程图**：新增复杂交互流程、修改现有流程逻辑、多步骤操作、有分支判断、涉及多页面跳转
+    * **可省略流程图**：简单功能、无流程变更、纯展示功能、纯后端功能
+  * **关键交互节点**：必须包含，说明用户触发点和反馈机制
+  * **个性化策略**：当需要根据用户特征调整功能行为时使用
+    * 场景举例：新老用户引导差异、VIP用户特权、地域化适配
+* **3. 客户端需求**：
+  * **3.1 页面设计**：当需要新增或修改页面时使用
+    * 场景举例：新增拍照页面、修改设置页面布局、重构整个功能流程
+    * **页面线框示意图**：当页面布局复杂或包含多个组件时使用
+    * **组件线框示意图**：当组件结构复杂时使用
+    * **页面组件**：在页面下组织相关组件，体现页面-组件的层级关系
+  * **3.4 技术需求要点**：当有跨组件交互、性能要求或特殊技术要求时使用
+    * 场景举例：组件间数据传递、动画性能优化、第三方SDK集成
+  * **3.3 数据管理**：当需要本地存储、状态管理或数据流设计时使用
+    * 场景举例：离线数据缓存、用户偏好设置、数据同步策略
+    * **状态管理示例**：
+      * 用户登录状态（isLoggedIn: boolean）
+      * 页面加载状态（isLoading: boolean）
+      * 表单验证状态（formValid: boolean）
+    * **数据流示例**：
+      * 用户输入 → 表单组件 → 验证逻辑 → 提交按钮
+      * 服务端响应 → 状态管理 → UI组件 → 用户界面
+* **3.6 埋点设计**：当客户端有较大调整或增加重要的新功能时使用
+  * 场景举例：新增重要功能模块、修改核心业务流程、增加用户行为追踪需求
+  * **埋点设计表格**：包含Event Name、Event Trigger、Params Key、Params Value四个字段
+* **4. 服务端需求**：
+  * **4.1 接口需求**：当需要新增或修改API接口时使用
+    * 场景举例：新增食物识别API、修改用户信息接口、批量数据处理接口
+    * **异常处理**：每个接口都应包含异常处理部分，说明各种错误场景和处理方式
+  * **4.2 数据处理需求**：当有复杂的数据处理逻辑时使用
+    * 场景举例：营养数据计算、用户行为分析、推荐算法需求
+  * **4.3 数据存储需求**：当需要数据库设计或缓存策略时使用
+    * 场景举例：用户数据表设计、Redis缓存策略、数据备份方案
+* **5. 附录**：当有相关文档或参考资料时使用
+  * 场景举例：竞品分析报告、技术调研文档、设计规范参考
+
+#### 省略规则举例
+
+* **纯UI优化场景**：
+  * 修改按钮颜色、调整字体大小、优化页面布局
+  * 可以省略：2.2.1完整交互流程、4.2数据处理需求、4.3数据存储需求
+* **纯后端功能场景**：
+  * 新增数据分析接口、优化数据库查询、添加缓存机制
+  * 可以省略：2.2.1完整交互流程、3.1组件设计、3.2页面集成、3.5数据管理
+  * **注意**：4.1接口需求中的异常处理部分不能省略
+* **简单功能场景**：
+  * 添加一个简单的设置选项、修改文案内容、调整图标
+  * 可以省略：2.2.1完整交互流程、3.4技术需求要点、3.5数据管理、2.2.3个性化策略
+* **无数据存储场景**：
+  * 纯展示功能、临时计算、第三方数据展示
+  * 可以省略：2.2.1完整交互流程、4.3数据存储需求、3.5数据管理
+* **无个性化需求场景**：
+  * 通用功能、标准化流程、所有用户行为一致
+  * 可以省略：2.2.3个性化策略
+* **无跨组件交互场景**：
+  * 独立组件、单页面功能、无数据传递需求
+  * 可以省略：3.4.1跨组件交互逻辑
+* **无性能要求场景**：
+  * 简单展示、低频使用、无实时性要求
+  * 可以省略：3.4.2性能优化
+* **无特殊技术要求场景**：
+  * 标准功能、无第三方集成、无特殊限制
+  * 可以省略：3.4.3技术要求
+* **多页面调整场景**：
+  * 整个拍照流程重构、多页面UI统一调整、全流程优化
+  * 使用：3.3页面调整清单替代3.1和3.2，提供更详细的页面级别说明
+
+### 忽略章节处理规范
+
+**重要说明**：当某个章节不适用于当前功能时，直接省略该章节，不要保留章节标题或添加任何标记。
+
+**处理原则**：
+
+* 不适用于当前功能的章节直接省略
+* 不需要保留章节标题结构
+* 保持文档简洁，只包含实际需要的内容
+
+### 关键要素
+
+* **问题导向**：围绕用户问题和业务目标
+* **流程清晰**：复杂功能用流程图展示交互逻辑，简单功能用文字描述
+* **技术可行**：考虑需求难度和成本
+* **用户体验**：注重交互细节和视觉反馈
+
+### 文档命名规范
+
+格式：`YYYYMMDD_功能名称_功能描述.md`
+
+示例：
+
+* `20250818_PickForMe_菜单识别推荐功能.md`
+* `20250818_健康指标_新增健康评分系统.md`
+* `20250818_引导页_用户体验优化.md`
+* `20250818_拍照识别_多张照片支持与食材编辑流程重构.md`