@guru-ai-product/ai-product-kit 0.2.251117192248 → 0.2.251118120602

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

@@ -1,821 +0,0 @@
-# [功能名称] - [功能描述]
-
-## 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/563de023ffa4a630_埋点规范文档.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`