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

package/mcp/.doc_cache/d165d35fea568d64_/351/234/200/346/261/202/345/217/230/345/212/250/350/257/264/346/230/216/346/226/207/346/241/243/346/250/241/346/235/277.md

@@ -1,576 +0,0 @@
-# [版本号] 需求文档变动说明
-
-> **变动周期**: YYYY年MM月DD日 → YYYY年MM月DD日（X天）  
-> **对比版本**: `<旧commit>` → `<新commit>`
-
-## 1. 变动概述
-
-**对比版本**:
-
-- **基准版本**: `<commit-hash>` (YYYY年MM月DD日) - <提交信息>
-- **最新版本**: `<commit-hash>` (HEAD, YYYY年MM月DD日) - <提交信息>
-
-**变动周期**: YYYY年MM月DD日 → YYYY年MM月DD日（约X天）
-
-**总体变动**:
-
-- X个文件变更
-- 新增XXXX行
-- 删除XXX行
-- 净增加XXXX行
-- 新增X个需求文档（vX.X.X: X个，vX.X.X: X个）
-- 重大修改X个核心文档
-
----
-
-## 2. Commit 历史
-
-### 2.1 Commit #1: <commit-hash> (YYYY-MM-DD)
-
-**提交信息**: <提交信息>
-
-**变更内容**:
-
-- 新增/修改 `文件路径` (XXX行)
-- 新增/修改 `文件路径` (XXX行)
-
-### 2.2 Commit #2: <commit-hash> (YYYY-MM-DD)
-
-**提交信息**: <提交信息>
-
-**变更内容**:
-
-- 优化/新增/删除 描述 (±XXX行)
-- 优化/新增/删除 描述 (±XXX行)
-
----
-
-## 3. 文档级变动详情
-
-### 3.1 vX.X.X 版本
-
-#### 3.1.1 修改文档：`文件名.md` ⭐⭐⭐
-
-📄 查看文件 (./文件名.md)
-
-**变动量**: +XXX行 / -XX行（净增XXX行）
-
-**新增内容**:
-
-- 📍 新增"章节名称" → `章节名称:行号` (./文件名.md#L行号)
-  - 具体内容说明
-  - 具体内容说明
-- 📍 补充功能详细说明 → `章节名称:行号` (./文件名.md#L行号)
-  - 具体内容说明
-  - 具体内容说明
-- 新增其他内容（未链接）
-
-**修改内容**:
-
-- 📍 优化描述结构 → `章节名称:行号` (./文件名.md#L行号)
-- 📍 完善说明 → `章节名称:行号` (./文件名.md#L行号)
-- 调整其他内容
-- 更新内容
-- 优化表述
-
-**删除内容**:
-
-- 删除重复或过时的描述（XX行）
-- 精简冗余的说明文字
-
-#### 3.1.2 新增文档：`文件名.md` ⭐⭐⭐
-
-📄 查看文件 (./文件名.md)
-
-**文档规模**: XXX行
-
-**包含内容**:
-
-- 📍 需求背景和业务目标 → `1. 需求背景:X` (./文件名.md#LX)
-- 📍 功能设计 → `2. 功能设计:XX` (./文件名.md#LXX)
-  - 📍 子功能1 → `2.1 子功能1:XXX` (./文件名.md#LXXX)
-  - 📍 子功能2 → `2.2 子功能2:XXX` (./文件名.md#LXXX)
-- 📍 界面设计 → `3. 界面设计:XXX` (./文件名.md#LXXX)
-  - 📍 页面设计 → `3.1 页面设计:XXX` (./文件名.md#LXXX)
-- 📍 客户端需求 → `4. 客户端需求:XXX` (./文件名.md#LXXX)
-- 📍 服务端需求 → `5. 服务端需求:XXX` (./文件名.md#LXXX)
-
-#### 3.1.3 新增文件：draft文件和图片
-
-**draft/文件名.md** (XX行)
-
-- 内容说明
-
-**images/图片名.png**
-
-- 用途说明
-
-### 3.2 vX.X.X 版本（全新版本目录）
-
-**说明**: vX.X.X目录在<旧commit>版本中不存在，是本次变动新增的版本目录
-
-#### 3.2.1 新增文档：`文件名.md` ⭐⭐⭐
-
-📄 查看文件 (../vX.X.X/文件名.md)
-
-**文档规模**: XXX行（优化后）
-
-**包含内容**:
-
-- 📍 需求背景 → `1. 需求背景:X` (../vX.X.X/文件名.md#LX)
-  - 用户痛点
-  - 业务目标
-  - 竞品分析
-- 📍 功能设计 → `2. 功能设计:XX` (../vX.X.X/文件名.md#LXX)
-  - 📍 核心功能 → `2.1 核心功能:XXX` (../vX.X.X/文件名.md#LXXX)
-    - 子功能1
-    - 子功能2
-  - 功能2
-  - 功能3
-- 📍 界面设计 → `3. 界面设计:XXX` (../vX.X.X/文件名.md#LXXX)
-  - 📍 页面布局 → `3.1 页面布局:XXX` (../vX.X.X/文件名.md#LXXX)
-  - 📍 交互设计 → `3.2 交互设计:XXX` (../vX.X.X/文件名.md#LXXX)
-- 📍 交互流程 → `4. 交互流程:XXX` (../vX.X.X/文件名.md#LXXX)
-- 📍 技术实现 → `5. 技术实现:XXX` (../vX.X.X/文件名.md#LXXX)
-
-**优化历史**:
-
-- 初始版本(<commit>): XXX行
-- 优化后(<commit>): XXX行（-XX行）
-- 优化内容: 精简描述、优化结构、删除冗余
-
----
-
-## 4. 功能维度变动分析
-
-### 4.1 核心新功能
-
-#### 4.1.1 功能名称 ⭐⭐⭐
-
-📄 查看完整文档 (../vX.X.X/文件名.md)
-
-**功能定位**: 功能类型（创作能力增强/用户留存和激活/商业化增长）
-
-**新增内容**:
-
-- 📍 **功能模块1** → `章节:行号` (../vX.X.X/文件名.md#L行号)
-  - 具体功能点1（参数、配置）
-  - 具体功能点2
-  - 具体功能点3
-- 📍 **功能模块2** → `章节:行号` (../vX.X.X/文件名.md#L行号)
-  - 具体功能点
-  - 具体功能点
-- 📍 **功能模块3** → `章节:行号` (../vX.X.X/文件名.md#L行号)
-  - 具体功能点
-  - 具体功能点
-- 📍 **功能模块4** → `章节:行号` (../vX.X.X/文件名.md#L行号)
-  - 具体功能点
-
-**技术要求**:
-
-- 📍 技术点1 → `章节:行号` (../vX.X.X/文件名.md#L行号)
-- 📍 技术点2 → `章节:行号` (../vX.X.X/文件名.md#L行号)
-- 📍 技术点3 → `章节:行号` (../vX.X.X/文件名.md#L行号)
-- 技术点4
-
-**开发复杂度**: 高/中/低（预计XX-XX人日）
-
-### 4.2 核心功能优化
-
-#### 4.2.1 功能名称 ⭐⭐⭐
-
-📄 查看完整文档 (./文件名.md)
-
-**优化内容**:
-
-**新增部分**（+XXX行）:
-
-- 📍 **新增模块1** → `章节:行号` (./文件名.md#L行号)
-  - 具体内容
-  - 具体内容
-- **新增模块2**
-  - 📍 子模块1 → `章节:行号` (./文件名.md#L行号)
-  - 📍 子模块2 → `章节:行号` (./文件名.md#L行号)
-  - 📍 子模块3 → `章节:行号` (./文件名.md#L行号)
-- 📍 **新增模块3** → `章节:行号` (./文件名.md#L行号)
-  - 具体内容
-- 📍 **新增模块4** → `章节:行号` (./文件名.md#L行号)
-  - 具体内容
-- 📍 **新增模块5** → `章节:行号` (./文件名.md#L行号)
-  - 具体内容
-
-**删除部分**（-XX行）:
-
-- 删除内容说明
-- 删除内容说明
-
-**优化效果**:
-
-- 文档更加完整和详细（净增XXX行）
-- 功能描述更加清晰
-- 技术方案更加具体
-
-**开发影响**: 预计XX-XX人日
-
----
-
-## 5. 产品策略分析
-
-### 5.1 功能战略定位
-
-**创作能力增强**:
-
-- 功能1: 价值说明
-- 功能2: 价值说明
-
-**用户增长留存**:
-
-- 功能1: 价值说明
-- 功能2: 价值说明
-
-**商业化提升**:
-
-- 功能1: 价值说明
-- 功能2: 价值说明
-
-### 5.2 版本演进路径
-
-**vX.X.X 定位**: 定位说明
-
-- 重点1
-- 重点2
-- 重点3
-
-**vX.X.X 定位**: 定位说明
-
-- 重点1
-- 重点2
-- 重点3
-
----
-
-## 6. 附录
-
-### 6.1 完整变更文件清单
-
-**vX.X.X 修改文件** (X个):
-
-1. `文件名.md` (+XXX/-XX行)
-2. `文件名.md` (+XX行)
-
-**vX.X.X 新增文件** (X个):
-
-3. `文件名.md` (XXX行)
-4. `draft/文件名.md` (XX行)
-5. `images/图片名.png` (图片)
-
-**vX.X.X 新增文件（全新目录）** (X个):
-
-6. `文件名.md` (XXX行)
-7. `文件名.md` (XXX行)
-8. `draft/文件名.md` (XX行)
-9. `images/图片名.png` (图片)
-
-### 6.2 变动统计汇总
-
-| 类型 | 数量 | 行数 |
-|------|------|------|
-| 修改文档 | X个 | +XXX/-XX |
-| 新增文档 | X个 | XXX行 |
-| 新增draft | X个 | XX行 |
-| 新增图片 | X个 | - |
-| **合计** | **XX个** | **+XXXX/-XXX** |
-
-### 6.3 Commit 详情
-
-**Commit 1: <commit-hash>**
-
-- 日期: YYYY-MM-DD HH:MM:SS
-- 作者: 作者名
-- 提交信息: 提交信息
-- 文件变更: X个文件，XXX行新增
-
-**Commit 2: <commit-hash>**
-
-- 日期: YYYY-MM-DD HH:MM:SS
-- 作者: 作者名
-- 提交信息: 提交信息
-- 文件变更: X个文件，XXX行新增，XX行删除
-
-### 6.4 查看完整差异命令
-
-```bash
-# 查看所有文件变更统计
-git diff --stat <旧commit>..<新commit>
-
-# 查看所有文件详细变更
-git diff <旧commit>..<新commit>
-
-# 查看特定文件变更
-git diff <旧commit>..<新commit> -- "../../vX.X.X/文件名.md"
-
-# 查看两个版本的文件内容
-git show <旧commit>:../../vX.X.X/文件名.md
-git show <新commit>:../../vX.X.X/文件名.md
-
-# 查看提交历史
-git log --oneline <旧commit>..<新commit>
-```
-
-### 6.5 文档结构概览
-
-```
-../../requirements
-├── vX.X.X/
-│   ├── 文件名.md [修改: +XXX/-XX]
-│   ├── 文件名.md [修改: +XX]
-│   ├── 文件名.md [新增: XXX行]
-│   ├── draft/
-│   │   ├── 文件名.md [新增: XX行]
-│   │   └── 文件名.md [新增: XX行]
-│   └── images/
-│       └── 图片名.png [新增]
-└── vX.X.X/ [新增目录]
-    ├── 文件名.md [新增: XXX行]
-    ├── 文件名.md [新增: XXX行]
-    ├── draft/
-    │   ├── 文件名.md [新增: XX行]
-    │   └── 文件名.md [新增: XX行]
-    └── images/
-        └── 图片名.png [新增]
-```
-
----
-
-<!-- ============================================
-⚠️ 模板规范说明区域 - 请勿输出到最终文档 ⚠️
-============================================
-以下内容为模板使用规范和说明，仅用于指导如何填写模板，
-在使用模板生成最终文档时，应完全删除或忽略此部分内容。
-============================================ -->
-
-## 模板使用说明
-
-### 文档格式规范与检查清单
-
-#### 列表格式规范
-
-**功能需求描述：使用破折号 `-` + 加粗标题**
-
-```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. **示例对比**：
-   - ❌ 错误：`[功能名称]` → `[用户登录功能]`
-   - ✅ 正确：`功能名称` → `用户登录功能`
-   - ❌ 错误：`[功能描述]` → `[实现用户身份验证]`
-   - ✅ 正确：`功能描述` → `实现用户身份验证`
-
-### 链接格式规范
-
-**重要说明**：变动说明文档中的链接格式规范：
-
-**文件链接**：
-
-```markdown
-📄 查看文件 (./文件名.md)
-📄 查看完整文档 (../v2.1.0/文件名.md)
-```
-
-**章节行号链接**：
-
-```markdown
-📍 功能说明 → `章节名称:行号` (./文件名.md#L行号)
-📍 详细设计 → `3.1.1 页面设计:156` (./文件名.md#L156)
-```
-
-**图标使用**：
-
-- 📄 文件链接
-- 📍 位置链接（行号）
-- ⭐⭐⭐ 重要程度标识
-- ✅ 完成状态
-- 🔵 系统操作
-- 🟢 用户操作
-- 🟡 判断节点
-
-### 文档结构说明
-
-#### 必选章节（所有变动都需要）
-
-- **1. 变动概述**：必须明确版本对比、变动周期、总体统计
-- **2. Commit 历史**：必须包含所有相关commit信息
-- **3. 文档级变动详情**：必须详细说明每个文档的变动
-- **4. 功能维度变动分析**：必须从功能角度分析变动
-- **5. 产品策略分析**：必须包含战略定位和版本演进
-- **6. 附录**：必须包含统计表、命令等
-
-#### 可选章节（根据变动特点选择）
-
-- **3.1 文档级变动详情**：
-  - **修改文档**：当有文档被修改时使用
-    - 场景举例：功能优化、内容补充、结构调整
-    - **新增内容**：列出新增的章节、功能点（附带行号链接）
-    - **修改内容**：列出修改的内容（附带行号链接）
-    - **删除内容**：说明删除的内容
-  - **新增文档**：当有文档被新增时使用
-    - 场景举例：新功能需求、新版本需求、补充文档
-    - **文档规模**：标注文档总行数
-    - **包含内容**：列出主要章节并链接到具体行号
-    - **功能类型**：说明文档的功能类型
-  - **新增文件**：当有draft文件或图片被新增时使用
-    - 场景举例：草稿文档、设计图片、参考材料
-- **4. 功能维度变动分析**：
-  - **4.1 核心新功能**：当有重要新功能时使用
-    - 场景举例：全新功能模块、重大功能升级
-    - **功能定位**：说明功能在整体产品中的定位
-    - **新增内容**：详细列出功能模块，链接到文档具体位置
-    - **技术要求**：列出技术实现要点，链接到相关章节
-    - **开发复杂度**：预估工作量
-  - **4.2 核心功能优化**：当有功能被优化时使用
-    - 场景举例：功能改进、性能优化、用户体验提升
-    - **新增部分**：列出新增内容及行号链接
-    - **修改部分**：列出修改内容及行号链接
-    - **删除部分**：说明删除内容
-    - **开发影响**：预估工作量
-- **5. 产品策略分析**：
-  - **5.1 功能战略定位**：当需要分析功能战略价值时使用
-    - 场景举例：多功能协同、产品定位调整、商业化考虑
-  - **5.2 版本演进路径**：当涉及多版本管理时使用
-    - 场景举例：版本规划、功能迭代、产品路线图
-
-#### 省略规则举例
-
-- **纯文档优化场景**：
-  - 修改文档格式、调整章节结构、优化表述
-  - 可以省略：4.1核心新功能、5.1功能战略定位
-- **纯新增文档场景**：
-  - 新增需求文档、补充说明文档、添加参考材料
-  - 可以省略：4.2核心功能优化、5.2版本演进路径
-- **简单变动场景**：
-  - 小幅修改、格式调整、文案优化
-  - 可以省略：4.1核心新功能、4.2核心功能优化、5.1功能战略定位
-- **无功能变动场景**：
-  - 纯文档管理、格式统一、结构调整
-  - 可以省略：4.功能维度变动分析、5.产品策略分析
-
-### 忽略章节处理规范
-
-**重要说明**：当某个章节不适用于当前变动时，直接省略该章节，不要保留章节标题或添加任何标记。
-
-**处理原则**：
-
-- 不适用于当前变动的章节直接省略
-- 不需要保留章节标题结构
-- 保持文档简洁，只包含实际需要的内容
-
-### 关键要素
-
-- **变动导向**：围绕文档变动和功能影响
-- **链接清晰**：重要变动用链接展示具体位置
-- **统计准确**：提供准确的变动统计数据
-- **分析深入**：从功能维度和产品策略角度分析变动
-
-### 文档命名规范
-
-格式：`YYYYMMDD_需求文档变动说明_旧commit至新commit.md`
-
-示例：
-
-- `20251017_需求文档变动说明_90cad63至fa5a716.md`
-- `20251018_需求文档变动说明_v2.0.0至v2.1.0.md`
-- `20251019_需求文档变动说明_HEAD至main.md`