Merge branch 'feature/full_statck_skills' into main

Resolve modify/delete conflict: remove legacy dev-utils full-stack-doc/SKILL.md
after relocating skill to skills/document-skills/full-stack-doc.

Made-with: Cursor

.claude-plugin/marketplace.json

@@ -43,14 +43,18 @@
       "description": "Angular 框架（1个技能）。",
       "source": "./",
       "strict": false,
-      "skills": ["./skills/angular-skills/angular"]
+      "skills": [
+        "./skills/angular-skills/angular"
+      ]
     },
     {
       "name": "svelte-skills",
       "description": "Svelte 框架（1个技能）。",
       "source": "./",
       "strict": false,
-      "skills": ["./skills/svelte-skills/svelte"]
+      "skills": [
+        "./skills/svelte-skills/svelte"
+      ]
     },
     {
       "name": "build-skills",
@@ -226,7 +230,9 @@
       "description": "游戏引擎 Cocos2d-x（1个技能）。",
       "source": "./",
       "strict": false,
-      "skills": ["./skills/cocos-skills/cocos2d-x"]
+      "skills": [
+        "./skills/cocos-skills/cocos2d-x"
+      ]
     },
     {
       "name": "ascii-skills",
@@ -251,7 +257,7 @@
     },
     {
       "name": "dev-utils-skills",
-      "description": "开发工具链：代码生成、测试编写、文档构建、MCP 构建器、前端设计等（13个技能）。",
+      "description": "开发工具链：代码生成、测试编写、文档构建、MCP 构建器、前端设计等（12个技能）。",
       "source": "./",
       "strict": false,
       "skills": [
@@ -260,7 +266,6 @@
         "./skills/dev-utils-skills/java-code-comments",
         "./skills/dev-utils-skills/mybatis-plus-generator",
         "./skills/dev-utils-skills/documentation-builder",
-        "./skills/dev-utils-skills/full-stack-doc",
         "./skills/dev-utils-skills/mcp-builder",
         "./skills/dev-utils-skills/webapp-testing",
         "./skills/dev-utils-skills/frontend-design",
@@ -306,7 +311,7 @@
     },
     {
       "name": "document-skills",
-      "description": "文档与图表：docx、pptx、pdf、xlsx、文档协作、API 文档生成、ProcessOn 思维导图、Mermaid、PlantUML（9个技能，与 skill-group-mapping 一致）。",
+      "description": "文档与图表：docx、pptx、pdf、xlsx、文档协作、API 文档、全栈产品文档标准（full-stack-doc）、ProcessOn 思维导图、Mermaid、PlantUML（10个技能，与 skill-group-mapping 一致）。",
       "source": "./",
       "strict": false,
       "skills": [
@@ -316,6 +321,7 @@
         "./skills/document-skills/xlsx",
         "./skills/document-skills/doc-coauthoring",
         "./skills/document-skills/api-doc-generator",
+        "./skills/document-skills/full-stack-doc",
         "./skills/document-skills/processon-mindmap",
         "./skills/document-skills/mermaid",
         "./skills/document-skills/plantuml"

PLANNING_SKILL_CATEGORIES.md

@@ -346,7 +346,7 @@ Marketplace (full-stack-skills)
       "name": "documentation-skills",
       "description": "文档技能集合：文档生成、文档处理、图表绘制",
       "skills": [
-        "./skills/full-stack-doc",
+        "./skills/document-skills/full-stack-doc",
         "./skills/docx",
         "./skills/mermaid"
       ]

README.md

@@ -176,7 +176,7 @@ Skills 是由说明、脚本和资源组成的文件夹，Claude 会按需动态
 
 - `threejs-skills` 当前在仓库中包含 18 个技能，但未进入 Marketplace 发布面。
 - `vscode-skills` 当前在仓库中包含 4 个技能，但未进入 Marketplace 发布面。
-- `document-skills` 当前目录中有 5 个技能，而 Marketplace 仍引用 9 个条目，其中 `docx`、`pptx`、`pdf`、`xlsx` 为缺失目录引用。
+- `document-skills` 当前目录中有 6 个技能（含 `full-stack-doc`），而 Marketplace 仍引用 10 个条目，其中 `docx`、`pptx`、`pdf`、`xlsx` 为缺失目录引用。
 - `tauri-skills` 当前目录中有 52 个技能，而 Marketplace 当前发布 51 个条目；`tauri-app-updater` 目前仅存在于仓库目录中。
 
 ### 阅读路径建议
@@ -474,10 +474,10 @@ fskill install
 | `database-skills` | 5 | 是 | 5 | 已与当前发布面对应 |
 | `ddd-skills` | 6 | 是 | 6 | 已与当前发布面对应 |
 | `design-skills` | 12 | 是 | 12 | 已与当前发布面对应 |
-| `dev-utils-skills` | 13 | 是 | 13 | 已与当前发布面对应 |
+| `dev-utils-skills` | 12 | 是 | 12 | 已与当前发布面对应；`full-stack-doc` 已迁至 `document-skills` |
 | `devops-skills` | 6 | 是 | 6 | 已与当前发布面对应 |
 | `docker-skills` | 2 | 是 | 2 | 已与当前发布面对应 |
-| `document-skills` | 5 | 是 | 9 | 目录技能数与 Marketplace 引用数不一致，详见 repository-map |
+| `document-skills` | 6 | 是 | 10 | 目录技能数与 Marketplace 引用数不一致（含缺失的 docx/pptx/pdf/xlsx），详见 repository-map |
 | `drawio-skills` | 2 | 是 | 2 | 已与当前发布面对应 |
 | `electron-skills` | 3 | 是 | 3 | 已与当前发布面对应 |
 | `flutter-skills` | 2 | 是 | 2 | 已与当前发布面对应 |

README_EN.md

@@ -128,7 +128,7 @@ The main repo now covers frontend, backend, mobile, cross-platform development,
 
 - `threejs-skills` exists in the repository with 18 skills and is not currently published in Marketplace.
 - `vscode-skills` exists in the repository with 4 skills and is not currently published in Marketplace.
-- `document-skills` has 5 skill directories on disk, while Marketplace still references 9 entries, including missing paths for `docx`, `pptx`, `pdf`, and `xlsx`.
+- `document-skills` has 6 skill directories on disk (including `full-stack-doc`), while Marketplace still references 10 entries, including missing paths for `docx`, `pptx`, `pdf`, and `xlsx`.
 - `tauri-skills` has 52 skill directories on disk, while Marketplace currently publishes 51 entries; `tauri-app-updater` remains repo-only.
 
 ### Recommended Reading Path
@@ -308,10 +308,10 @@ The table below reflects the current `skills/` directory and `.claude-plugin/mar
 | `database-skills` | 5 | Yes | 5 | Aligned with current published surface |
 | `ddd-skills` | 6 | Yes | 6 | Aligned with current published surface |
 | `design-skills` | 12 | Yes | 12 | Aligned with current published surface |
-| `dev-utils-skills` | 13 | Yes | 13 | Aligned with current published surface |
+| `dev-utils-skills` | 12 | Yes | 12 | Aligned with current published surface; `full-stack-doc` moved under `document-skills` |
 | `devops-skills` | 6 | Yes | 6 | Aligned with current published surface |
 | `docker-skills` | 2 | Yes | 2 | Aligned with current published surface |
-| `document-skills` | 5 | Yes | 9 | On-disk count differs from Marketplace refs; see repository-map |
+| `document-skills` | 6 | Yes | 10 | On-disk count differs from Marketplace refs; see repository-map |
 | `drawio-skills` | 2 | Yes | 2 | Aligned with current published surface |
 | `electron-skills` | 3 | Yes | 3 | Aligned with current published surface |
 | `flutter-skills` | 2 | Yes | 2 | Aligned with current published surface |

docs/pipeline-stage-to-skills.md

@@ -24,7 +24,7 @@
 
 | 阶段 | 技能名 | 仓库 | 说明 |
 |------|--------|------|------|
-| 需求 / 一句话需求 / 需求分析 → 原始需求 | full-stack-doc | full-stack-skills | 需求分析模板、需求调研模板 |
+| 需求 / 一句话需求 / 需求分析 → 原始需求 | full-stack-doc（`document-skills` 插件） | full-stack-skills | `full-stack-doc/templates/version/` 需求分析/调研等；目录落位见 `full-stack-doc` SKILL |
 | 需求 / PRD（what/why） | speckit-specify | speckit-agent-skills（可选） | Spec Kit：从自然语言生成/更新规格 |
 | 需求澄清 / 歧义消除 | speckit-clarify | speckit-agent-skills（可选） | Spec Kit：澄清规格 |
 | 清楚的原始需求 → PRD 文档 | full-stack-doc | full-stack-skills | PRD 文档模板 |

docs/repository-map.md

@@ -44,10 +44,10 @@ full-stack-skills/
 | `database-skills` | 5 | 5 | 已发布 | — |
 | `ddd-skills` | 6 | 6 | 已发布 | — |
 | `design-skills` | 12 | 12 | 已发布 | — |
-| `dev-utils-skills` | 13 | 13 | 已发布 | — |
+| `dev-utils-skills` | 12 | 12 | 已发布 | `full-stack-doc` 已迁至 `document-skills` |
 | `devops-skills` | 6 | 6 | 已发布 | — |
 | `docker-skills` | 2 | 2 | 已发布 | — |
-| `document-skills` | 5 | 9 | 已发布 | 缺少目录：docx、pptx、pdf、xlsx |
+| `document-skills` | 6 | 10 | 已发布 | 含 `full-stack-doc`；仍缺目录：docx、pptx、pdf、xlsx |
 | `drawio-skills` | 2 | 2 | 已发布 | — |
 | `electron-skills` | 3 | 3 | 已发布 | — |
 | `flutter-skills` | 2 | 2 | 已发布 | — |

docs/skill-group-mapping.md

@@ -30,9 +30,9 @@
 | **svelte-skills** | svelte | 1 | Svelte 框架 |
 | **mobile-native-skills** | android-kotlin, ios-swift | 2 | 原生移动端 |
 | **chart-skills** | lime-echart, ucharts | 2 | 图表组件 |
-| **dev-utils-skills** | code-generator, test-writer, java-code-comments, mybatis-plus-generator, documentation-builder, full-stack-doc, mcp-builder, webapp-testing, frontend-design, web-artifacts-builder, theme-factory, agent-browser, maven-search | 13 | 开发工具链（与 development-skills-utils 对应） |
+| **dev-utils-skills** | code-generator, test-writer, java-code-comments, mybatis-plus-generator, documentation-builder, mcp-builder, webapp-testing, frontend-design, web-artifacts-builder, theme-factory, agent-browser, maven-search | 12 | 开发工具链（与 development-skills-utils 对应） |
 | **design-skills** | algorithmic-art, brand-guidelines, canvas-design, figma, figma-ai, sketch, adobe-xd, dalle, uizard, galileo-ai, runway-ml, framer | 12 | 设计与 AI 绘图（midjourney/stable-diffusion/axure/modao 待补目录则入本组） |
-| **document-skills** | docx, pptx, pdf, xlsx, doc-coauthoring, api-doc-generator, processon-mindmap, mermaid, plantuml | 9 | 文档与图表（与 document 插件对应） |
+| **document-skills** | docx, pptx, pdf, xlsx, doc-coauthoring, api-doc-generator, full-stack-doc, processon-mindmap, mermaid, plantuml | 10 | 文档与图表（与 document 插件对应） |
 | **testing-skills** | jest, vitest, pytest, junit, cypress, playwright, selenium, appium, detox | 9 | 测试框架与 E2E/移动端测试 |
 | **devops-skills** | gitlab-ci, github-actions, kubernetes, terraform, ansible, cloudformation | 6 | CI/CD 与 IaC（jenkins 待补目录则入本组） |
 | **database-skills** | postgresql, oracle, redis, elasticsearch, dbeaver | 5 | 数据库与工具（mysql/mongodb/navicat 待补目录则入本组） |

skills/dev-utils-skills/full-stack-doc/SKILL.md

@@ -1,183 +0,0 @@
----
-name: full-stack-doc
-description: "Generates full-lifecycle Chinese software project documentation using 14 templates covering product research, PRD, architecture design, domain modeling (DDD/COLA), testing, deployment, and operations. Use when the user needs to create product documentation in Chinese, generate PRD documents, write architecture designs, or produce deployment and maintenance docs."
----
-
-# 项目文档生成技能
-
-## 概述
-
-本技能提供了一套完整的项目文档模板集合，帮助快速生成软件开发项目所需的各种文档。模板基于 DDD（领域驱动设计）和 COLA 架构思想，适用于从产品调研到项目运维的全生命周期。
-
-**关键词**: 项目文档、PRD、需求文档、架构设计、技术文档、项目模板、文档生成、产品文档
-
-## 核心功能
-
-### 1. 产品阶段文档
-
-- **产品调研模板** - 市场调研、用户调研、竞品分析
-- **需求调研模板** - 需求收集、用户访谈、需求整理
-- **技术调研模板** - 技术选型、技术可行性分析、技术对比
-- **需求分析模板** - 需求拆解、优先级排序、需求评审
-
-### 2. 设计阶段文档
-
-- **PRD文档模板** - 产品需求文档，包含功能需求、用户故事、验收标准
-- **视觉与交互 DNA 规范模板** - 设计语言、交互规范、视觉规范
-- **UI 设计说明模板** - UI设计规范、组件库、设计系统
-
-### 3. 技术设计文档
-
-- **领域模型说明模板** - DDD领域模型、实体、值对象、聚合
-- **系统架构设计模板** - 技术架构、系统架构、部署架构
-- **技术细分模板** - 接口设计、数据库设计、技术实现细节
-
-### 4. 测试与交付文档
-
-- **功能提测模板** - 提测清单、测试环境、测试范围
-- **测试结果模板** - 测试报告、缺陷统计、测试结论
-- **上线通知模板** - 上线计划、上线检查清单、回滚方案
-- **项目运维模板** - 运维手册、监控告警、故障处理
-
-## 使用指南
-
-### 快速生成文档
-
-1. **指定文档类型**
-   ```
-   使用项目文档生成技能，帮我生成一个 PRD 文档
-   ```
-
-2. **指定项目信息**
-   ```
-   基于模板生成系统架构设计文档，项目名称是 partme-ai 教学平台
-   ```
-
-3. **批量生成文档**
-   ```
-   为我的项目生成全套文档，包括 PRD、架构设计、技术文档
-   ```
-
-### 模板使用说明
-
-所有模板文件位于 `templates/` 目录下，包含以下14个模板：
-
-1. `1、产品调研模板.md` - 产品调研阶段文档
-2. `2、需求调研模板.md` - 需求调研阶段文档
-3. `3、技术调研模板.md` - 技术调研阶段文档（技术选型、技术可行性分析）
-4. `4、需求分析模板.md` - 需求分析阶段文档
-5. `5、PRD文档模板.md` - 产品需求文档
-6. `6、视觉与交互 DNA 规范模板.md` - 设计规范文档
-7. `7、UI 设计说明模板.md` - UI设计文档
-8. `8、领域模型说明模板.md` - 领域模型文档
-9. `9、系统架构设计模板.md` - 系统架构文档
-10. `10、技术细分模板.md` - 技术实现文档
-11. `11、功能提测模板.md` - 提测文档
-12. `12、测试结果模板.md` - 测试报告
-13. `13、上线通知模板.md` - 上线文档
-14. `14、项目运维模板.md` - 运维文档
-
-### 模板占位符说明
-
-模板中使用 `{}` 包裹的内容为占位符，需要替换为实际内容：
-
-- `{产品名称}` - 产品名称
-- `{项目名称}` - 项目名称
-- `{YYYY-MM-DD}` - 日期格式
-- `{姓名}` - 人员姓名
-- 其他 `{}` 包裹的内容 - 根据上下文替换
-
-### 文档生成流程
-
-1. **选择模板**
-   - 根据项目阶段选择合适的模板
-   - 可以同时使用多个模板生成完整文档集
-
-2. **填写占位符**
-   - 替换模板中的 `{}` 占位符
-   - 根据项目实际情况填写内容
-
-3. **定制化调整**
-   - 根据项目特点调整模板结构
-   - 添加或删除不需要的章节
-
-4. **文档评审**
-   - 与团队评审文档内容
-   - 根据反馈调整和完善
-
-## 使用示例
-
-### 示例 1: 生成 PRD 文档
-
-```
-用户: 使用项目文档生成技能，帮我生成一个 PRD 文档，产品名称是"智能教学助手"
-
-AI: 我将基于 PRD 文档模板为您生成产品需求文档...
-```
-
-### 示例 2: 生成架构设计文档
-
-```
-用户: 基于模板生成系统架构设计文档，项目名称是 partme-ai 教学平台，使用 Spring Boot 和 Vue 3
-
-AI: 我将基于系统架构设计模板为您生成架构文档...
-```
-
-### 示例 3: 生成完整文档集
-
-```
-用户: 为我的新项目生成全套文档，包括产品调研、PRD、架构设计和技术文档
-
-AI: 我将为您生成以下文档：
-1. 产品调研文档
-2. PRD 文档
-3. 系统架构设计文档
-4. 技术细分文档
-...
-```
-
-## 模板特点
-
-### 1. 标准化结构
-
-- 统一的文档格式和结构
-- 清晰的章节划分
-- 完整的版本记录
-
-### 2. DDD 和 COLA 架构
-
-- 基于领域驱动设计思想
-- 遵循 COLA 架构原则
-- 支持微服务架构设计
-
-### 3. 全生命周期覆盖
-
-- 从产品调研到项目运维
-- 涵盖所有关键阶段
-- 文档之间相互关联
-
-### 4. 易于定制
-
-- 使用占位符便于替换
-- 结构清晰便于调整
-- 支持项目特定需求
-
-## 注意事项
-
-1. **占位符替换**: 确保所有 `{}` 占位符都被正确替换
-2. **文档关联**: 注意文档之间的关联关系，保持一致性
-3. **版本管理**: 使用版本记录表跟踪文档变更
-4. **团队协作**: 明确文档责任人，确保文档质量
-5. **持续更新**: 根据项目进展及时更新文档内容
-
-## 相关技能
-
-- `documentation-builder` - 通用文档构建技能
-- `code-generator` - 代码生成技能
-- `mcp-builder` - MCP 构建器技能
-
-## 参考资源
-
-- [DDD 领域驱动设计](https://domainlanguage.com/ddd/)
-- [COLA 架构](https://github.com/alibaba/COLA)
-- [产品文档最佳实践](https://www.atlassian.com/software/confluence)

skills/dev-utils-skills/full-stack-doc/templates/1、产品调研模板.md

@@ -1,313 +0,0 @@
-# {产品名称} - 产品调研文档 V1.0
-
-> **文档说明**：
-> - 本文档是产品调研阶段的产出物，用于记录市场调研、用户调研、竞品分析等信息
-> - 通过调研收集信息，为产品定位和需求分析提供依据
-> - `{}` 包裹的内容为占位符，请替换为实际内容
-> - 引用块 `>` 中的文字为填写指导，填写后可删除
-
----
-
-## 1. 文档信息 (Document Info)
-
-### 1.1 版本记录
-| 版本号 | 修改日期 | 修改人 | 修改内容 | 备注 |
-| :--- | :--- | :--- | :--- | :--- |
-| V1.0.0 | {YYYY-MM-DD} | {姓名} | 初始版本 | - |
-
-### 1.2 调研信息
-| 项目 | 内容 |
-| :--- | :--- |
-| 调研时间 | {YYYY-MM-DD} ~ {YYYY-MM-DD} |
-| 调研人员 | {姓名1}、{姓名2} |
-| 调研对象 | {目标用户群体} |
-| 调研方式 | {市场调研 / 用户访谈 / 问卷调查 / 竞品分析 / 数据分析} |
-
----
-
-## 2. 市场调研 (Market Research)
-
-### 2.1 市场规模 (Market Size)
-> 分析目标市场的规模、增长趋势等
-
-**市场规模 (TAM/SAM/SOM)**：
-- **TAM (潜在市场总额)**：{例如：中国家政服务行业总产值 1.2万亿元}
-- **SAM (可服务市场总额)**：{例如：数字化转型的中小型门店市场 3000亿元}
-- **SOM (可获得市场份额)**：{例如：预计3年内占据 5% 份额，约 150亿元}
-
-**市场趋势**：
-- {例如：XXX应用需求增长}
-- {例如：数据化运营成为趋势}
-- {例如：智能化服务管理需求增加}
-
-### 2.2 市场机会
-> 分析市场机会和切入点
-
-**市场机会**：
-1. **机会1**：{例如：现有产品功能不完善，存在改进空间}
-   - **机会描述**：{详细描述}
-   - **市场空间**：{估算市场空间}
-   - **竞争优势**：{我们的优势}
-
-2. **机会2**：{例如：市场空白或用户痛点带来的机会}
-   - **机会描述**：{详细描述}
-   - **市场空间**：{估算市场空间}
-   - **竞争优势**：{我们的优势}
-
-### 2.3 市场风险
-> 分析市场风险和挑战
-
-**市场风险**：
-1. **风险1**：{例如：市场竞争激烈}
-   - **风险描述**：{详细描述}
-   - **应对策略**：{应对策略}
-
-2. **风险2**：{例如：用户接受度不高}
-   - **风险描述**：{详细描述}
-   - **应对策略**：{应对策略}
-
----
-
-## 3. 用户调研 (User Research)
-
-### 3.1 目标用户群体
-> 定义目标用户群体
-
-| 用户群体 | 用户描述 | 规模 | 特征 | 核心诉求 |
-| :--- | :--- | :--- | :--- | :--- |
-| {用户群体1} | {例如：门店老板，拥有门店管理权限} | {例如：约XX万人} | {例如：年龄30-50岁，有一定管理经验} | {例如：提升门店运营效率} |
-| {用户群体2} | {例如：师傅，提供上门服务} | {例如：约XX万人} | {例如：年龄25-40岁，有一定服务经验} | {例如：提升工作效率，增加收入} |
-
-### 3.2 用户画像
-> 详细描述典型用户
-
-#### 用户画像1：{例如：门店老板 - 张总}
-
-**基本信息**：
-- **姓名**：{张总}（化名）
-- **年龄**：{35岁}
-- **职位**：{门店老板}
-- **门店规模**：{中型门店，10名师傅}
-- **使用经验**：{使用现有系统2年}
-
-**使用场景**：
-- **时间**：每天上午9:00-12:00，下午2:00-6:00
-- **地点**：门店办公室
-- **设备**：手机（iPhone 12）
-- **主要任务**：
-  1. 查看待接单订单，决定是否指派师傅
-  2. 查看门店运营数据，了解经营状况
-  3. 处理客户投诉，协调师傅工作
-
-**痛点**：
-- {例如：订单处理效率低，经常出现订单遗漏}
-- {例如：无法实时掌握订单状态，需要频繁刷新}
-- {例如：数据统计不准确，影响决策}
-
-**期望**：
-- {例如：能够快速查看和处理订单}
-- {例如：能够实时掌握订单状态}
-- {例如：能够准确统计门店运营数据}
-
----
-
-### 3.3 用户访谈
-> 记录用户访谈的详细内容
-
-#### 访谈1：{例如：门店老板 - 张总}
-
-**访谈时间**：{YYYY-MM-DD HH:mm}  
-**访谈地点**：{门店办公室}  
-**访谈人员**：{产品经理 - 张三}  
-**访谈对象**：{门店老板 - 张总}
-
-**访谈问题**：
-1. **Q：您平时是如何处理订单的？**
-   - A：{我每天上午9点打开系统，查看待接单订单，根据订单信息决定是指派师傅还是等待师傅抢单。}
-
-2. **Q：您在订单处理过程中遇到的最大问题是什么？**
-   - A：{订单处理效率低，经常出现订单遗漏。有时候订单太多，我看不过来，就会漏掉一些订单。}
-
-3. **Q：您希望系统能够提供什么功能来帮助您？**
-   - A：{希望能够快速查看订单，能够实时掌握订单状态，能够准确统计门店运营数据。}
-
-**关键发现**：
-- {订单处理效率低是主要痛点}
-- {实时掌握订单状态是核心需求}
-- {数据统计准确性很重要}
-
----
-
-### 3.4 问卷调查
-> 记录问卷调查的结果
-
-#### 问卷概况
-- **问卷名称**：{门店订单管理需求调研}
-- **发放时间**：{YYYY-MM-DD}
-- **回收时间**：{YYYY-MM-DD}
-- **有效问卷**：{30份}
-- **回收率**：{85%}
-
-#### 关键问题统计
-
-**问题1：您认为当前订单处理效率如何？**
-- 非常低：{5人，17%}
-- 较低：{15人，50%}
-- 一般：{8人，27%}
-- 较高：{2人，6%}
-- 非常高：{0人，0%}
-
-**问题2：您最希望系统增加什么功能？（多选）**
-- 订单实时提醒：{25人，83%}
-- 订单距离显示：{20人，67%}
-- 数据统计优化：{18人，60%}
-- 抢单流程优化：{15人，50%}
-
-#### 关键发现
-- {订单处理效率低是普遍问题}
-- {订单实时提醒是核心需求}
-- {系统满意度较低，需要改进}
-
----
-
-## 4. 竞品分析 (Competitive Analysis)
-
-### 4.1 竞品选择
-> 选择分析的竞品
-
-| 竞品名称 | 竞品类型 | 分析重点 | 官网/下载地址 |
-| :--- | :--- | :--- | :--- |
-| {竞品A} | {同类产品} | {订单管理、数据统计} | {https://example.com} |
-| {竞品B} | {同类产品} | {抢单流程、服务管理} | {https://example.com} |
-| {竞品C} | {参考产品} | {UI设计、交互体验} | {https://example.com} |
-
-### 4.2 竞品功能对比
-> 对比竞品的功能
-
-| 功能模块 | 我们的产品 | 竞品A | 竞品B | 竞品C |
-| :--- | :--- | :--- | :--- | :--- |
-| 订单列表 | ✅ | ✅ | ✅ | ✅ |
-| 订单详情 | ✅ | ✅ | ✅ | ✅ |
-| 订单指派 | ✅ | ✅ | ❌ | ✅ |
-| 抢单功能 | ✅ | ✅ | ✅ | ❌ |
-| 数据统计 | ✅ | ✅ | ✅ | ✅ |
-| 实时提醒 | ❌ | ✅ | ✅ | ✅ |
-| 订单距离 | ❌ | ✅ | ❌ | ❌ |
-
-### 4.3 竞品优势分析
-> 分析竞品的优势
-
-**竞品A的优势**：
-- {实时提醒功能完善，用户体验好}
-- {订单距离显示准确，帮助师傅选择订单}
-- {数据统计详细，支持多维度分析}
-
-**竞品B的优势**：
-- {抢单流程顺畅，响应速度快}
-- {服务管理完善，支持服务动态记录}
-- {UI设计简洁，交互体验好}
-
-### 4.4 竞品劣势分析
-> 分析竞品的劣势
-
-**竞品A的劣势**：
-- {订单指派功能不完善}
-- {数据统计不够详细}
-
-**竞品B的劣势**：
-- {缺少订单指派功能}
-- {订单距离显示不准确}
-
-### 4.5 差异化机会
-> 找出我们的差异化机会
-
-**差异化点**：
-- {结合订单指派和抢单功能，提供更灵活的订单分配方式}
-- {优化订单距离显示，帮助师傅选择合适订单}
-- {完善数据统计，提供更详细的分析维度}
-
----
-
-## 5. 商业模式调研 (Business Model Research)
-
-### 5.1 商业模式
-> 分析商业模式
-
-**商业模式**：
-- **收入来源**：{例如：SaaS订阅费、增值服务费}
-- **成本结构**：{例如：开发成本、运营成本、服务器成本}
-- **盈利模式**：{例如：按门店数量收费、按功能模块收费}
-
-### 5.2 定价策略
-> 分析定价策略
-
-**定价策略**：
-- **基础版**：{例如：免费，基础功能}
-- **专业版**：{例如：XX元/月，完整功能}
-- **企业版**：{例如：XX元/月，定制功能}
-
----
-
-## 6. 调研结论 (Research Conclusions)
-
-### 6.1 关键发现
-> 总结调研的关键发现
-
-1. **市场机会明确**
-   - {例如：市场规模大，增长趋势明显}
-   - {例如：现有产品存在改进空间}
-
-2. **用户需求强烈**
-   - {例如：用户痛点明确，需求强烈}
-   - {例如：用户愿意为优质产品付费}
-
-### 6.2 产品建议
-> 基于调研结果提出产品建议
-
-**产品定位建议**：
-- {例如：面向中小型门店的XXX应用}
-- {例如：帮助门店提升运营效率和服务质量}
-
-**功能优先级建议**：
-- **P0（必须做）**：{例如：订单管理、数据统计}
-- **P1（应该做）**：{例如：实时提醒、订单距离}
-- **P2（可以做）**：{例如：高级分析、定制功能}
-
-**差异化建议**：
-- {例如：结合订单指派和抢单功能}
-- {例如：优化订单距离显示}
-- {例如：完善数据统计}
-
----
-
-## 7. 附录 (Appendix)
-
-### 7.1 调研材料
-> 列出调研使用的材料
-
-- **市场调研报告**：{市场调研报告文件}
-- **用户访谈提纲**：{访谈提纲文件}
-- **问卷调查表**：{问卷文件}
-- **竞品分析报告**：{竞品分析文件}
-
-### 7.2 参考文档
-> 列出参考的相关文档
-
-- [需求调研模板](2、需求调研模板.md)
-- [技术调研模板](3、技术调研模板.md)
-- [需求分析模板](4、需求分析模板.md)
-- [PRD文档模板](5、PRD文档模板.md)
-
-### 7.3 变更记录
-> 记录调研变更的历史
-
-| 变更日期 | 变更内容 | 变更原因 | 变更人 |
-| :--- | :--- | :--- | :--- |
-| {YYYY-MM-DD} | {变更内容描述} | {变更原因} | {姓名} |
-
----
-
-**文档版本**：V1.0.0  
-**创建时间**：{YYYY-MM-DD}  
-**最后更新**：{YYYY-MM-DD}  
-**文档状态**：✅ 调研中 / ✅ 调研完成 / ✅ 待分析 / ✅ 已完成

skills/dev-utils-skills/full-stack-doc/templates/3、技术调研模板.md

@@ -1,659 +0,0 @@
-# {产品名称} - 技术调研文档 V1.0
-
-> **文档说明**：
-> - 本文档是技术调研阶段的产出物，用于记录技术选型、技术可行性分析、技术对比等信息
-> - 通过技术调研，为技术方案设计和架构设计提供依据
-> - `{}` 包裹的内容为占位符，请替换为实际内容
-> - 引用块 `>` 中的文字为填写指导，填写后可删除
-
----
-
-## 1. 文档信息 (Document Info)
-
-### 1.1 版本记录
-| 版本号 | 修改日期 | 修改人 | 修改内容 | 备注 |
-| :--- | :--- | :--- | :--- | :--- |
-| V1.0.0 | {YYYY-MM-DD} | {姓名} | 初始版本 | - |
-
-### 1.2 调研信息
-| 项目 | 内容 |
-| :--- | :--- |
-| 调研时间 | {YYYY-MM-DD} ~ {YYYY-MM-DD} |
-| 调研人员 | {姓名1}、{姓名2} |
-| 调研对象 | {技术栈、框架、工具等} |
-| 调研方式 | {技术调研 / 技术对比 / 技术验证 / POC验证 / 技术评估} |
-
-### 1.3 文档责任人
-| 角色 | 姓名 | 职责 |
-| :--- | :--- | :--- |
-| 技术负责人 | {姓名} | 技术方案评审、技术可行性评估 |
-| 架构师 | {姓名} | 架构设计、技术选型 |
-| 开发负责人 | {姓名} | 技术调研、技术验证 |
-
----
-
-## 2. 技术选型 (Technology Selection)
-
-### 2.1 前端技术栈
-
-#### 2.1.1 管理后台技术选型
-
-**前端框架候选方案**：
-
-1. **LayUI of Vue 3.0**
-   - 官方地址：https://www.layui-vue.com/zh-CN/index
-   - 使用指南：https://www.layui-vue.com/zh-CN/guide/introduce
-   - 组件文档：https://www.layui-vue.com/zh-CN/components
-   - 后台模板：https://gitee.com/lunarlanding/layui-vue-admin
-   - Github: https://github.com/layui-vue/layui-vue
-   - **特点**：{例如：基于Vue 3.0，组件丰富，提供后台模板}
-
-2. **Ant Design of React**
-   - 官方地址：https://4x-ant-design.antgroup.com/index-cn
-   - 使用指南：https://4x-ant-design.antgroup.com/docs/react/introduce-cn
-   - 组件文档：https://4x-ant-design.antgroup.com/components/overview-cn/
-   - 后台模板：https://pro.ant.design/zh-CN/docs/overview
-   - Github: https://github.com/ant-design/ant-design/
-   - **特点**：{例如：企业级UI设计语言，组件完善，生态庞大}
-
-3. **Bootstrap of Vue 3.0**
-   - 官方地址：https://bootstrap-vue.org
-   - 使用指南：https://bootstrap-vue.org/docs
-   - 组件文档：https://bootstrap-vue.org/docs/components
-   - Github: https://github.com/bootstrap-vue/bootstrap-vue
-   - **特点**：{例如：基于Bootstrap，响应式设计，组件丰富}
-
-4. **Element Plus of Vue 3.0** ✅ **推荐选择**
-   - 官方地址：https://element-plus.org/zh-CN/
-   - 使用指南：https://element-plus.org/en-US/guide/design
-   - 组件文档：https://element-plus.org/en-US/component/overview
-   - Github: https://github.com/element-plus/element-plus
-   - **选择理由**：{例如：组件丰富、文档完善、社区活跃、Vue 3.0性能优秀、团队熟悉}
-
-**状态管理候选方案**：
-
-1. **Vuex of Vue 2.0**
-   - 官方地址：https://vuex.vuejs.org/zh/
-   - 使用指南：https://vuex.vuejs.org/zh/guide/
-   - API文档：https://vuex.vuejs.org/zh/api/
-   - VUE3兼容：https://vuex.vuejs.org/zh/guide/migrating-to-4-0-from-3-x.html
-   - **特点**：{例如：Vue 2.0官方状态管理，成熟稳定，但Vue 3.0推荐使用Pinia}
-
-2. **Pinia of Vue 3.0** ✅ **推荐选择**
-   - 官方地址：https://pinia.vuejs.org/
-   - 使用指南：https://pinia.vuejs.org/core-concepts/
-   - API文档：https://pinia.vuejs.org/api/
-   - **选择理由**：{例如：Vue 3.0官方推荐、TypeScript支持好、API简洁、性能优秀}
-
-**样式预处理**：
-- **Dart Sass** ✅ **推荐选择**
-  - 官方地址：https://sass-lang.com/dart-sass/
-  - 使用指南：https://sass-lang.com/install/
-  - API文档：https://sass-lang.com/documentation/
-  - **选择理由**：{例如：功能强大、编译速度快、社区支持好、Sass官方推荐实现}
-
-**构建工具**：
-- **Vite** ✅ **推荐选择**
-  - 官方地址：https://vite.dev/guide/
-  - **选择理由**：{例如：快速构建、开发体验好、支持Vue 3.0、热更新快}
-
-**表单/表格组件**：
-- **Avue** ✅ **推荐选择**
-  - 官方地址：https://avuejs.com/
-  - Github: https://github.com/avue/avue
-  - 表单组件：https://avuejs.com/form/form-doc.html
-  - 表格组件：https://avuejs.com/crud/crud-doc.html
-  - **选择理由**：{例如：基于Element Plus、配置化开发、提升开发效率、减少重复代码}
-
-**图表库**：
-- **Echarts**
-  - 官方地址：https://echarts.apache.org/
-  - **选择理由**：{例如：功能强大、图表类型丰富、性能优秀}
-
-#### 2.1.2 移动端技术选型
-
-**前端框架候选方案**：
-
-1. **UniApp + uView 2.0 of Vue 2.0**
-   - 官方地址：https://www.uviewui.com/
-   - 使用指南：https://www.uviewui.com/guide/demo.html
-   - 组件文档：https://www.uviewui.com/components/intro.html
-   - UniApp: https://ext.dcloud.net.cn/plugin?id=1593
-   - Github: https://github.com/umicro/uView2.0
-   - **特点**：{例如：基于Vue 2.0，成熟稳定，但版本较旧}
-
-2. **UniApp-x + uView Pro of Vue 3.0** ✅ **推荐选择**
-   - 官方地址：https://uviewpro.cn/
-   - 使用指南：https://uviewpro.cn/zh/guide/intro.html
-   - 组件文档：https://uviewpro.cn/zh/components/intro.html
-   - 工具文档：https://uviewpro.cn/zh/tools/intro.html
-   - 模板文档：https://uviewpro.cn/zh/layout/intro.html
-   - UniApp: https://ext.dcloud.net.cn/plugin?id=24633
-   - **选择理由**：{例如：跨平台支持好、一套代码多端运行、组件丰富、基于Vue 3.0性能优秀}
-
-3. **UniApp-x + Vant of Vue 3.0**
-   - 官方地址：https://vant-ui.github.io/
-   - 使用指南：https://vant-ui.github.io/vant/#/zh-CN
-   - **特点**：{例如：轻量级组件库，适合移动端}
-
-**状态管理**：
-- **Pinia of Vue 3.0**
-  - 官方地址：https://pinia.vuejs.org/
-  - **选择理由**：{例如：与UniApp-x兼容性好、API简洁}
-
-**样式预处理**：
-- **Dart Sass**
-  - 官方地址：https://sass-lang.com/dart-sass/
-  - **选择理由**：{例如：功能强大、编译速度快}
-
-**图表库候选方案**：
-
-1. **lime-echart** ✅ **推荐选择**
-   - UniApp: https://ext.dcloud.net.cn/plugin?id=4899
-   - **选择理由**：{例如：为UniApp和UniAppX提供ECharts图表兼容支持，使ECharts图表能在H5、小程序、App中运行，功能强大}
-
-2. **uCharts**
-   - UniApp: https://ext.dcloud.net.cn/plugin?id=271
-   - **特点**：{例如：支持H5及APP用ucharts echarts渲染图表，uniapp可视化首选组件，支持正负柱状图}
-
----
-
-### 2.2 后端技术栈
-
-**后端框架**：
-- **Spring Boot**
-  - 官方地址：https://spring.io/projects/spring-boot
-  - **选择理由**：{例如：生态完善、开发效率高、社区活跃}
-
-**微服务框架**：
-- **Spring Cloud**
-  - 官方地址：https://spring.io/projects/spring-cloud
-  - **选择理由**：{例如：微服务架构支持、服务治理完善}
-
-**ORM框架**：
-- **MyBatis-Plus**
-  - 官方地址：https://baomidou.com/
-  - **选择理由**：{例如：基于MyBatis、功能增强、开发效率高}
-
-**数据库**：
-- **MySQL 8.0+**
-  - 官方地址：https://www.mysql.com/
-  - **选择理由**：{例如：成熟稳定、性能优秀、社区支持好}
-
-**缓存**：
-- **Redis**（包括Redis GEO，如适用）
-  - 官方地址：https://redis.io/
-  - **选择理由**：{例如：高性能、数据结构丰富、支持多种场景}
-
-**消息队列**：
-- **RocketMQ / Kafka**
-  - RocketMQ: https://rocketmq.apache.org/
-  - Kafka: https://kafka.apache.org/
-  - **选择理由**：{例如：高吞吐量、可靠性好、支持分布式}
-
-**服务注册**：
-- **Nacos / Eureka**
-  - Nacos: https://nacos.io/
-  - Eureka: https://github.com/Netflix/eureka
-  - **选择理由**：{例如：服务发现、配置管理、高可用}
-
-**AI服务**（如适用）：
-- **大模型API**：{例如：OpenAI API、Claude API等}
-- **向量数据库**：{例如：Milvus、Chroma等}
-- **选择理由**：{例如：支持AI功能、性能优秀}
-
----
-
-### 2.3 桌面应用技术栈（如适用）
-
-**桌面应用框架候选方案**：
-
-1. **Electron**
-   - 官方地址：https://www.electronjs.org/zh/
-   - 使用文档：https://www.electronjs.org/zh/docs/latest/
-   - API文档：https://www.electronjs.org/zh/docs/latest/api/app
-   - 其他工具：https://www.electronforge.io、https://www.electronjs.org/zh/fiddle
-   - Github: https://github.com/electron/electron
-   - 实践文档：https://wiki.hiwepy.com/docs/electron
-   - **特点**：{例如：跨平台桌面应用框架，基于Chromium和Node.js，生态完善}
-
-2. **Electron EGG**
-   - 官方地址：https://www.kaka996.com/
-   - 使用文档：https://www.kaka996.com/pages/987b1c/
-   - API文档：https://www.kaka996.com/pages/a99b72/
-   - Gitee: https://gitee.com/dromara/electron-egg
-   - **特点**：{例如：基于Electron的企业级框架，提供完整解决方案}
-
-3. **UpgradeLink**
-   - 官方地址：https://www.toolsetlink.com/
-   - 使用文档：https://www.toolsetlink.com/upgrade/what-is-upgrade.html
-   - **特点**：{例如：升级工具，用于应用更新管理}
-
-### 2.4 硬件技术栈（如适用）
-
-**主控芯片**：
-- {例如：ESP32-S3等}
-- **选择理由**：{例如：性能满足需求、成本可控}
-
-**操作系统**：
-- {例如：FreeRTOS等}
-- **选择理由**：{例如：实时性好、资源占用少}
-
-**图形库**：
-- {例如：LVGL等}
-- **选择理由**：{例如：功能丰富、性能优秀}
-
-**通信协议**：
-- **MQTT**：{例如：用于设备与云端通信}
-- **WebSocket**：{例如：用于实时通信}
-- **BLE**：{例如：用于近距离通信}
-
----
-
-### 2.5 基础设施
-
-**容器化**：
-- **Docker**
-  - 官方地址：https://www.docker.com/
-  - **选择理由**：{例如：标准化部署、环境一致性}
-
-- **Kubernetes**
-  - 官方地址：https://kubernetes.io/
-  - **选择理由**：{例如：容器编排、自动扩缩容、高可用}
-
-**CI/CD**：
-- **Jenkins / GitLab CI**
-  - Jenkins: https://www.jenkins.io/
-  - GitLab CI: https://docs.gitlab.com/ee/ci/
-  - **选择理由**：{例如：自动化构建、持续集成、持续部署}
-
-**监控**：
-- **Prometheus + Grafana**
-  - Prometheus: https://prometheus.io/
-  - Grafana: https://grafana.com/
-  - **选择理由**：{例如：指标收集、可视化展示、告警}
-
-**日志**：
-- **ELK Stack**
-  - Elasticsearch: https://www.elastic.co/elasticsearch/
-  - Logstash: https://www.elastic.co/logstash/
-  - Kibana: https://www.elastic.co/kibana/
-  - **选择理由**：{例如：日志收集、搜索、分析}
-
----
-
-## 3. 技术可行性分析 (Technology Feasibility)
-
-### 3.1 技术成熟度评估
-
-**成熟技术**：
-- {例如：Vue 3.0、Element Plus、Spring Boot等技术成熟，社区活跃}
-- {例如：MySQL、Redis等数据库技术成熟稳定}
-- {例如：Docker、Kubernetes等容器技术广泛应用}
-
-**新兴技术**：
-- {例如：UniApp-x相对较新，但基于Vue 3.0，技术栈成熟}
-- {例如：AI相关技术快速发展，需要持续关注}
-
-**技术风险**：
-- {例如：新技术可能存在兼容性问题}
-- {例如：第三方组件库可能存在维护风险}
-- {例如：微服务架构复杂度较高，需要团队具备相应能力}
-
----
-
-### 3.2 团队能力评估
-
-**团队技术栈熟悉度**：
-- **前端团队**：
-  - Vue 3.0：{例如：团队熟悉Vue技术栈，能够快速上手}
-  - Element Plus：{例如：团队有使用经验，学习成本低}
-  - UniApp-x：{例如：团队有UniApp经验，迁移成本低}
-
-- **后端团队**：
-  - Spring Boot：{例如：团队熟悉Spring Boot，开发效率高}
-  - Spring Cloud：{例如：团队有微服务经验，能够快速上手}
-  - MyBatis-Plus：{例如：团队熟悉MyBatis，学习成本低}
-
-**团队能力缺口**：
-- {例如：需要加强微服务架构设计能力}
-- {例如：需要提升AI技术应用能力}
-- {例如：需要加强DevOps能力}
-
-**培训计划**：
-- {例如：组织技术分享会，提升团队技术能力}
-- {例如：安排技术培训，补充能力缺口}
-
----
-
-### 3.3 开发成本评估
-
-**开发时间**：
-- **前端开发**：{例如：预计X个月}
-- **后端开发**：{例如：预计X个月}
-- **测试**：{例如：预计X个月}
-- **总计**：{例如：预计X个月}
-
-**人力成本**：
-- **前端开发**：{例如：X人}
-- **后端开发**：{例如：X人}
-- **测试**：{例如：X人}
-- **总计**：{例如：X人}
-
-**技术成本**：
-- **开发工具**：{例如：IDE、开发工具等，成本可控}
-- **第三方服务**：{例如：云服务、AI服务等，按需付费}
-- **基础设施**：{例如：服务器、数据库等，成本可控}
-
----
-
-### 3.4 维护成本评估
-
-**技术维护**：
-- {例如：使用主流技术，维护成本较低}
-- {例如：技术栈成熟，社区支持好，问题解决快}
-- {例如：文档完善，新人上手快}
-
-**运维成本**：
-- {例如：容器化部署，运维成本较低}
-- {例如：监控告警完善，问题发现快}
-- {例如：自动化程度高，人工干预少}
-
-**升级成本**：
-- {例如：技术栈版本升级成本可控}
-- {例如：向后兼容性好，升级风险低}
-
----
-
-## 4. 技术对比分析 (Technology Comparison)
-
-### 4.1 前端框架对比
-
-#### 4.1.1 管理后台框架对比
-
-| 技术方案 | 优势 | 劣势 | 适用场景 | 选择结果 |
-| :--- | :--- | :--- | :--- | :--- |
-| **LayUI of Vue 3.0** | 组件丰富、提供后台模板、基于Vue 3.0 | 生态相对较小、社区活跃度一般 | 中小型后台管理系统 | ❌ 未选择 |
-| **Ant Design of React** | 企业级设计、组件完善、生态庞大 | 基于React、学习成本高 | 大型企业级应用 | ❌ 未选择 |
-| **Bootstrap of Vue 3.0** | 响应式设计、组件丰富 | 样式相对传统、定制化程度低 | 快速开发、标准样式 | ❌ 未选择 |
-| **Element Plus of Vue 3.0** | 组件丰富、文档完善、社区活跃、Vue 3.0性能优秀 | 相对React生态稍小 | 中小型项目、快速开发 | ✅ 选择 |
-
-**选择理由**：
-- {例如：团队熟悉Vue技术栈，开发效率高}
-- {例如：Vue 3.0性能优秀，满足项目需求}
-- {例如：Element Plus生态完善，组件库丰富，文档完善}
-- {例如：与移动端技术栈统一，降低学习成本}
-
-#### 4.1.2 移动端框架对比
-
-| 技术方案 | 优势 | 劣势 | 适用场景 | 选择结果 |
-| :--- | :--- | :--- | :--- | :--- |
-| **UniApp + uView 2.0** | 成熟稳定、生态完善 | 基于Vue 2.0、版本较旧 | Vue 2.0项目 | ❌ 未选择 |
-| **UniApp-x + uView Pro** | 跨平台支持好、一套代码多端运行、基于Vue 3.0 | 相对较新、生态在发展中 | 跨平台移动应用 | ✅ 选择 |
-| **UniApp-x + Vant** | 轻量级、组件丰富 | 功能相对简单 | 轻量级移动应用 | ❌ 未选择 |
-
-**选择理由**：
-- {例如：UniApp-x跨平台支持好，一套代码多端运行}
-- {例如：uView Pro组件丰富，基于Vue 3.0性能优秀}
-- {例如：与后台技术栈统一，降低学习成本}
-
-#### 4.1.3 状态管理对比
-
-| 技术方案 | 优势 | 劣势 | 适用场景 | 选择结果 |
-| :--- | :--- | :--- | :--- | :--- |
-| **Vuex** | 成熟稳定、Vue 2.0官方推荐 | Vue 3.0不推荐、API相对复杂 | Vue 2.0项目 | ❌ 未选择 |
-| **Pinia** | Vue 3.0官方推荐、TypeScript支持好、API简洁 | 相对较新 | Vue 3.0项目 | ✅ 选择 |
-
-**选择理由**：
-- {例如：Vue 3.0官方推荐，性能优秀}
-- {例如：TypeScript支持好，API简洁易用}
-- {例如：与Vue 3.0技术栈完美配合}
-
----
-
-### 4.2 图表库对比
-
-| 技术方案 | 优势 | 劣势 | 适用场景 | 选择结果 |
-| :--- | :--- | :--- | :--- | :--- |
-| **lime-echart** | ECharts兼容、功能强大、支持多端 | 相对较重 | UniApp图表需求 | ✅ 选择 |
-| **uCharts** | 轻量级、支持正负柱状图 | 功能相对简单 | 简单图表需求 | ❌ 未选择 |
-
-**选择理由**：
-- {例如：lime-echart为UniApp提供ECharts兼容支持，功能强大}
-- {例如：使ECharts图表能在H5、小程序、App中运行，统一图表方案}
-
-### 4.3 后端框架对比
-
-| 技术方案 | 优势 | 劣势 | 适用场景 | 选择结果 |
-| :--- | :--- | :--- | :--- | :--- |
-| **Spring Boot** | 生态完善、开发效率高、社区活跃 | 配置相对复杂 | Java项目、企业级应用 | ✅ 选择 |
-| **Node.js** | 开发速度快、前后端统一 | 性能相对较低、不适合CPU密集型 | 中小型项目、实时应用 | ❌ 未选择 |
-| **Go** | 性能优秀、并发能力强 | 生态相对较小、学习成本高 | 高并发、微服务 | ❌ 未选择 |
-
-**选择理由**：
-- {例如：团队熟悉Java技术栈，开发效率高}
-- {例如：Spring Boot生态完善，功能丰富}
-- {例如：企业级应用，稳定性要求高}
-
----
-
-### 4.4 数据库对比
-
-| 技术方案 | 优势 | 劣势 | 适用场景 | 选择结果 |
-| :--- | :--- | :--- | :--- | :--- |
-| **MySQL** | 成熟稳定、性能优秀、社区支持好 | 高并发性能相对较低 | 关系型数据、事务处理 | ✅ 选择 |
-| **PostgreSQL** | 功能强大、扩展性好 | 学习成本高、生态相对较小 | 复杂查询、数据分析 | ❌ 未选择 |
-| **MongoDB** | 灵活、扩展性好 | 事务支持弱、一致性要求高时不适合 | 非关系型数据、文档存储 | ❌ 未选择 |
-
-**选择理由**：
-- {例如：MySQL成熟稳定，满足项目需求}
-- {例如：团队熟悉MySQL，运维成本低}
-- {例如：项目以关系型数据为主}
-
----
-
-### 4.5 缓存方案对比
-
-| 技术方案 | 优势 | 劣势 | 适用场景 | 选择结果 |
-| :--- | :--- | :--- | :--- | :--- |
-| **Redis** | 高性能、数据结构丰富、支持多种场景 | 内存成本较高 | 缓存、会话存储、消息队列 | ✅ 选择 |
-| **Memcached** | 简单、性能好 | 功能单一、不支持持久化 | 简单缓存场景 | ❌ 未选择 |
-| **本地缓存** | 无网络开销、性能极好 | 不支持分布式、数据一致性差 | 单机缓存 | ❌ 未选择 |
-
-**选择理由**：
-- {例如：Redis功能强大，满足多种场景需求}
-- {例如：支持持久化，数据安全}
-- {例如：支持分布式，扩展性好}
-
----
-
-## 5. 技术优势与风险 (Technology Advantages & Risks)
-
-### 5.1 技术优势
-
-**前端技术优势**：
-- {例如：Vue 3.0性能优秀，生态完善}
-- {例如：Element Plus组件丰富，开发效率高}
-- {例如：UniApp-x跨平台支持好，一套代码多端运行}
-
-**后端技术优势**：
-- {例如：Spring Cloud微服务架构，支持高并发和水平扩展}
-- {例如：MyBatis-Plus功能增强，开发效率高}
-- {例如：Redis高性能缓存，支持多种数据结构}
-
-**基础设施优势**：
-- {例如：Docker容器化，部署标准化}
-- {例如：Kubernetes容器编排，支持自动扩缩容}
-- {例如：Prometheus监控，问题发现快}
-
----
-
-### 5.2 技术风险
-
-**技术风险**：
-1. **新技术风险**
-   - {例如：新技术可能存在兼容性问题}
-   - **应对策略**：{例如：进行POC验证，充分测试}
-
-2. **第三方依赖风险**
-   - {例如：第三方组件库可能存在维护风险}
-   - **应对策略**：{例如：选择成熟稳定的组件库，关注社区动态}
-
-3. **架构复杂度风险**
-   - {例如：微服务架构复杂度较高，需要团队具备相应能力}
-   - **应对策略**：{例如：加强团队培训，引入架构师指导}
-
-4. **性能风险**
-   - {例如：高并发场景下可能存在性能瓶颈}
-   - **应对策略**：{例如：进行性能测试，优化关键路径}
-
-5. **安全风险**
-   - {例如：新技术可能存在安全漏洞}
-   - **应对策略**：{例如：关注安全公告，及时更新版本}
-
----
-
-## 6. 技术验证 (Technology Validation)
-
-### 6.1 POC验证
-
-**验证目标**：
-- {例如：验证技术选型的可行性}
-- {例如：验证关键功能的实现方案}
-- {例如：验证性能是否满足需求}
-
-**验证内容**：
-1. **前端POC**
-   - {例如：验证Vue 3.0 + Element Plus的集成}
-   - {例如：验证UniApp-x的跨平台能力}
-   - {例如：验证关键组件的性能}
-
-2. **后端POC**
-   - {例如：验证Spring Cloud微服务架构}
-   - {例如：验证Redis缓存性能}
-   - {例如：验证消息队列的可靠性}
-
-**验证结果**：
-- {例如：技术选型可行，满足项目需求}
-- {例如：性能满足要求，无明显瓶颈}
-- {例如：开发效率高，学习成本低}
-
----
-
-### 6.2 性能测试
-
-**测试场景**：
-- {例如：高并发场景测试}
-- {例如：大数据量场景测试}
-- {例如：长时间运行稳定性测试}
-
-**测试结果**：
-- {例如：QPS达到X，满足需求}
-- {例如：响应时间在Xms以内，满足要求}
-- {例如：系统稳定运行X小时，无异常}
-
----
-
-## 7. 技术方案建议 (Technology Recommendations)
-
-### 7.1 推荐技术栈
-
-**前端技术栈**：
-- **管理后台**：Vue 3.0 + Element Plus + Pinia + Dart Sass + Avue + Echarts + Vite
-- **移动端**：UniApp-x + uView Pro + Pinia + Dart Sass + lime-echart
-
-**技术选型说明**：
-- **前端框架**：Element Plus of Vue 3.0（管理后台）、UniApp-x + uView Pro of Vue 3.0（移动端）
-- **状态管理**：Pinia of Vue 3.0（统一使用）
-- **样式预处理**：Dart Sass（统一使用）
-- **构建工具**：Vite（管理后台）、UniApp-x构建工具（移动端）
-- **表单/表格组件**：Avue（管理后台，基于Element Plus）
-- **图表库**：Echarts（管理后台）、lime-echart（移动端，ECharts兼容）
-
-**后端技术栈**：
-- Spring Boot + Spring Cloud + MyBatis-Plus + MySQL + Redis + RocketMQ + Nacos
-
-**基础设施**：
-- Docker + Kubernetes + Jenkins + Prometheus + Grafana + ELK Stack
-
----
-
-### 7.2 技术实施建议
-
-**分阶段实施**：
-1. **第一阶段**：{例如：搭建基础框架，完成核心功能}
-2. **第二阶段**：{例如：完善功能，优化性能}
-3. **第三阶段**：{例如：扩展功能，提升体验}
-
-**技术债务管理**：
-- {例如：定期review技术债务}
-- {例如：制定技术债务偿还计划}
-- {例如：避免过度设计}
-
-**持续优化**：
-- {例如：关注技术发展趋势}
-- {例如：定期评估技术选型}
-- {例如：及时升级技术版本}
-
----
-
-## 8. 附录 (Appendix)
-
-### 8.1 技术文档链接
-
-**前端技术文档**：
-- [Vue 3.0 官方文档](https://vuejs.org/)
-- [Element Plus 官方文档](https://element-plus.org/)
-- [LayUI of Vue 3.0 官方文档](https://www.layui-vue.com/zh-CN/index)
-- [Ant Design of React 官方文档](https://4x-ant-design.antgroup.com/index-cn)
-- [Bootstrap of Vue 3.0 官方文档](https://bootstrap-vue.org)
-- [UniApp-x + uView Pro 官方文档](https://uviewpro.cn/)
-- [UniApp + uView 2.0 官方文档](https://www.uviewui.com/)
-- [UniApp-x + Vant 官方文档](https://vant-ui.github.io/)
-- [Pinia 官方文档](https://pinia.vuejs.org/)
-- [Vuex 官方文档](https://vuex.vuejs.org/zh/)
-- [Vite 官方文档](https://vite.dev/guide/)
-- [Avue 官方文档](https://avuejs.com/)
-- [lime-echart UniApp插件](https://ext.dcloud.net.cn/plugin?id=4899)
-- [uCharts UniApp插件](https://ext.dcloud.net.cn/plugin?id=271)
-- [Electron 官方文档](https://www.electronjs.org/zh/)
-- [Electron EGG 官方文档](https://www.kaka996.com/)
-
-**后端技术文档**：
-- [Spring Boot 官方文档](https://spring.io/projects/spring-boot)
-- [Spring Cloud 官方文档](https://spring.io/projects/spring-cloud)
-- [MyBatis-Plus 官方文档](https://baomidou.com/)
-- [Redis 官方文档](https://redis.io/)
-
-**基础设施文档**：
-- [Docker 官方文档](https://www.docker.com/)
-- [Kubernetes 官方文档](https://kubernetes.io/)
-- [Prometheus 官方文档](https://prometheus.io/)
-
----
-
-### 8.2 参考文档
-
-> 列出参考的相关文档
-
-- [产品调研模板](1、产品调研模板.md)
-- [需求分析模板](4、需求分析模板.md)
-- [系统架构设计模板](9、系统架构设计模板.md)
-- [技术细分模板](10、技术细分模板.md)
-
----
-
-### 8.3 变更记录
-
-> 记录技术调研变更的历史
-
-| 变更日期 | 变更内容 | 变更原因 | 变更人 |
-| :--- | :--- | :--- | :--- |
-| {YYYY-MM-DD} | {变更内容描述} | {变更原因} | {姓名} |
-
----
-
-**文档版本**：V1.0.0  
-**创建时间**：{YYYY-MM-DD}  
-**最后更新**：{YYYY-MM-DD}  
-**文档状态**：✅ 调研中 / ✅ 调研完成 / ✅ 待评审 / ✅ 已完成

skills/dev-utils-skills/full-stack-doc/templates/6、视觉与交互 DNA 规范模板.md

@@ -1,531 +0,0 @@
-# {产品名称} - 视觉与交互 DNA 规范 V1.0
-
-> **文档说明**：
-> - 本文档定义产品的视觉设计语言和交互设计规范，确保产品设计的一致性和品牌识别度
-> - DNA（Design & Navigation Architecture）规范是产品设计的核心指导原则
-> - `{}` 包裹的内容为占位符，请替换为实际内容
-> - 引用块 `>` 中的文字为填写指导，填写后可删除
-
----
-
-## 1. 文档信息 (Document Info)
-
-### 1.1 版本记录
-| 版本号 | 修改日期 | 修改人 | 修改内容 | 备注 |
-| :--- | :--- | :--- | :--- | :--- |
-| V1.0.0 | {YYYY-MM-DD} | {姓名} | 初始版本 | - |
-
-### 1.2 文档责任人
-| 角色 | 姓名 | 职责 |
-| :--- | :--- | :--- |
-| 设计负责人 | {姓名} | DNA规范制定、设计评审 |
-| UI设计师 | {姓名} | 设计规范执行、设计实现 |
-| 产品经理 | {姓名} | 需求确认、设计评审 |
-
----
-
-## 2. 设计理念 (Design Philosophy)
-
-### 2.1 设计原则
-> 定义产品设计的核心原则
-
-**简洁高效**：
-- 界面简洁，信息层次清晰
-- 操作流程高效，减少用户操作步骤
-- 功能直达，减少导航层级
-
-**专业可信**：
-- 视觉风格专业，体现产品专业性
-- 信息准确，数据可靠
-- 交互稳定，减少错误
-
-**友好易用**：
-- 交互友好，符合用户习惯
-- 反馈及时，操作有明确反馈
-- 容错性强，支持撤销和重试
-
-### 2.2 品牌调性
-> 定义产品的品牌调性和视觉风格
-
-**品牌调性**：
-- **专业**：体现产品的专业性和可靠性
-- **高效**：体现产品的高效性和便捷性
-- **友好**：体现产品的友好性和易用性
-- **陪伴与成长**：{例如：partme-ai的设计不仅仅是工具，更是孩子的伙伴。设计语言应体现：趣味性、安全感、仪式感、简洁性}
-
-**视觉风格**：
-- **现代简约**：采用现代简约的设计风格，突出内容
-- **清晰明确**：信息层次清晰，视觉引导明确
-- **统一协调**：色彩、字体、间距统一协调
-- **多主题支持**：{例如：支持探索版、梦幻版、少年版等多种主题，满足不同年龄段和性格偏好的用户需求}
-
----
-
-## 3. 视觉设计规范 (Visual Design System)
-
-### 3.1 色彩系统 (Color System)
-
-#### 3.1.1 主色调
-> 定义产品的主色调，支持多主题模式
-
-**主题模式**：
-> 根据产品定位，可支持多种主题模式，满足不同用户群体需求
-
-| 模式 | 主色 (Primary) | 辅助色 (Secondary) | 强调色 (Accent) | 背景色 (Background) | 适用场景 |
-| :--- | :--- | :--- | :--- | :--- | :--- |
-| **现代清新 (推荐)** | #2ECC71 (薄荷绿) | #D5F5E3 (浅绿) | #FEF5E7 (浅橘) | #F8FBF9 (呼吸白) | 全年龄通用，高品质视觉 |
-| **通用版 (General)** | #FFD54F (品牌黄) | #FFFFFF (纯白) | #4CAF50 (成功绿) | #FFFFFF (白色) | 3-12岁基础视觉 |
-| **梦幻版 (Dream)** | #F8BBD0 (樱花粉) | #FFF9C4 (奶油黄) | #BA68C8 (淡雅紫) | #FFF0F5 (薰衣草) | 3-10岁感性向 |
-| **探索版 (Explore)** | #2196F3 (科技蓝) | #00BCD4 (青色) | #FF9800 (活力橙) | #E1F5FE (天蓝) | 7-12岁理性向 |
-| **少年版 (Teen)** | #000000 (纯黑) | #1A1A1A (深灰) | #00FF9D (霓虹绿) | #000000 (纯黑) | 12-18岁赛博风 |
-
-**主色**（默认主题）：
-- **主色-主**：`#007AFF`（蓝色）
-  - **使用场景**：主要按钮、链接、选中状态、重要信息
-  - **RGB**：`rgb(0, 122, 255)`
-  - **HSL**：`hsl(210, 100%, 50%)`
-
-**主色-浅**：`#E6F2FF`（浅蓝色）
-  - **使用场景**：背景、标签背景、选中状态背景
-  - **RGB**：`rgb(230, 242, 255)`
-
-**主色-深**：`#0051D5`（深蓝色）
-  - **使用场景**：按钮按下状态、链接悬停状态
-  - **RGB**：`rgb(0, 81, 213)`
-
-**色彩原则**：
-> 定义色彩使用的基本原则
-
-1. **状态关联**：完成/成功态使用绿色，待办/进行态使用淡橙色
-2. **分色管理**：不同功能入口采用淡彩色背景区分（如淡蓝、淡绿、淡紫）
-3. **文字对比**：主文字使用深灰，次要说明使用中灰
-
-#### 3.1.2 功能色
-> 定义功能色（成功、警告、错误、信息）
-
-**成功色**：
-- **成功-主**：`#34C759`（绿色）
-  - **使用场景**：成功提示、完成状态、正向操作
-- **成功-浅**：`#E6F7ED`（浅绿色）
-  - **使用场景**：成功状态背景
-
-**警告色**：
-- **警告-主**：`#FF9500`（橙色）
-  - **使用场景**：警告提示、待处理状态、注意信息
-- **警告-浅**：`#FFF4E6`（浅橙色）
-  - **使用场景**：警告状态背景
-
-**错误色**：
-- **错误-主**：`#FF3B30`（红色）
-  - **使用场景**：错误提示、失败状态、危险操作
-- **错误-浅**：`#FFE6E6`（浅红色）
-  - **使用场景**：错误状态背景
-
-**信息色**：
-- **信息-主**：`#5AC8FA`（浅蓝色）
-  - **使用场景**：信息提示、说明文字
-- **信息-浅**：`#E6F7FD`（浅蓝色）
-  - **使用场景**：信息状态背景
-
-#### 3.1.3 中性色
-> 定义中性色（文字、背景、分割线等）
-
-**文字颜色**：
-- **文字-主**：`#000000`（黑色）
-  - **使用场景**：主要文字、标题
-- **文字-次**：`#666666`（深灰色）
-  - **使用场景**：次要文字、正文
-- **文字-辅助**：`#999999`（灰色）
-  - **使用场景**：辅助文字、说明文字
-- **文字-禁用**：`#CCCCCC`（浅灰色）
-  - **使用场景**：禁用状态文字
-
-**背景颜色**：
-- **背景-主**：`#FFFFFF`（白色）
-  - **使用场景**：页面背景、卡片背景
-- **背景-次**：`#F5F5F5`（浅灰色）
-  - **使用场景**：列表背景、分割区域背景
-- **背景-遮罩**：`rgba(0, 0, 0, 0.5)`（半透明黑色）
-  - **使用场景**：弹窗遮罩、浮层遮罩
-
-**分割线颜色**：
-- **分割线-主**：`#E5E5E5`（浅灰色）
-  - **使用场景**：列表分割线、卡片分割线
-- **分割线-次**：`#F0F0F0`（浅灰色）
-  - **使用场景**：区域分割线
-
-### 3.2 字体系统 (Typography System)
-
-#### 3.2.1 字体家族
-> 定义字体家族
-
-**中文字体**：
-- **iOS**：PingFang SC
-- **Android**：Microsoft YaHei（微软雅黑）
-- **Web**：-apple-system, BlinkMacSystemFont, "Segoe UI", "Microsoft YaHei", sans-serif
-
-**英文字体**：
-- **iOS**：SF Pro Text
-- **Android**：Roboto
-- **Web**：-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif
-
-#### 3.2.2 字号规范
-> 定义字号规范
-
-| 字号 | 使用场景 | 示例 | 字重 |
-| :--- | :--- | :--- | :--- |
-| 32px | 页面主标题 | 首页标题 | Semibold (600) |
-| 28px | 模块标题 | 工单、我的 | Semibold (600) |
-| 24px | 卡片标题 | 订单卡片标题 | Medium (500) |
-| 20px | 正文内容 | 订单详情、列表内容 | Regular (400) |
-| 18px | 辅助文字 | 说明文字、提示文字 | Regular (400) |
-| 16px | 次要文字 | 标签文字、时间文字 | Regular (400) |
-| 14px | 小号文字 | 底部提示、状态文字 | Regular (400) |
-
-#### 3.2.3 行高规范
-> 定义行高规范
-
-- **单行文字**：行高 = 字号 × 1.2
-- **多行文字**：行高 = 字号 × 1.5
-- **列表项**：行高 = 字号 × 1.8
-
-### 3.3 图形与材质 (Graphics & Texture)
-> 定义图形风格和材质效果
-
-**3D 粘土质感 (Claymorphism)**：
-- **说明**：按钮和卡片应具有微小的内阴影和柔和的外阴影，模拟真实物理世界的触感
-- **应用场景**：按钮、卡片、弹窗等交互元素
-
-**圆角规范**：
-- **硬件端**：12px - 24px（甚至全圆）
-- **移动端**：16px（卡片），8px（小按钮）
-- **Web端**：8px（卡片），4px（小按钮）
-
-**图标风格**：
-- **风格**：圆润的粗线条图标，避免尖锐边缘，增加安全感
-- **尺寸**：16px（小图标）、24px（中图标）、32px（大图标）
-
-### 3.4 间距系统 (Spacing System)
-
-#### 3.3.1 基础间距单位
-> 定义基础间距单位
-
-**基础间距单位**：8px（所有间距应为8px的倍数）
-
-#### 3.3.2 间距规范
-> 定义间距规范
-
-| 间距值 | 使用场景 | 示例 |
-| :--- | :--- | :--- |
-| 4px | 紧密元素间距 | 图标与文字间距 |
-| 8px | 小间距 | 列表项内元素间距 |
-| 12px | 中小间距 | 卡片内元素间距 |
-| 16px | 中等间距 | 卡片之间间距 |
-| 24px | 大间距 | 模块之间间距 |
-| 32px | 超大间距 | 页面上下边距 |
-
-#### 3.3.3 页面边距
-> 定义页面边距
-
-- **页面左右边距**：16px
-- **页面上下边距**：16px
-- **卡片内边距**：16px
-
-### 3.5 圆角系统 (Border Radius System)
-
-| 圆角值 | 使用场景 | 示例 |
-| :--- | :--- | :--- |
-| 4px | 小圆角 | 标签、小按钮 |
-| 8px | 中等圆角 | 卡片、输入框 |
-| 12px | 大圆角 | 大卡片、弹窗 |
-| 16px | 超大圆角 | 头像、特殊卡片 |
-| 50% | 圆形 | 头像、圆形按钮 |
-
-### 3.6 阴影系统 (Shadow System)
-
-| 阴影类型 | 使用场景 | 阴影参数 |
-| :--- | :--- | :--- |
-| 小阴影 | 卡片、列表项 | `0 2px 8px rgba(0,0,0,0.08)` |
-| 中阴影 | 弹窗、浮层 | `0 4px 16px rgba(0,0,0,0.12)` |
-| 大阴影 | 模态弹窗 | `0 8px 24px rgba(0,0,0,0.16)` |
-
-### 3.7 图标系统 (Icon System)
-
-#### 3.6.1 图标尺寸
-> 定义图标尺寸
-
-- **小图标**：16px × 16px（用于列表项、标签）
-- **中图标**：24px × 24px（用于按钮、卡片）
-- **大图标**：32px × 32px（用于页面标题、重要操作）
-
-#### 3.6.2 图标风格
-> 定义图标风格
-
-- **线性图标**：用于常规操作、导航
-- **填充图标**：用于选中状态、重要操作
-- **图标颜色**：跟随文字颜色或功能色
-
----
-
-## 4. 交互设计规范 (Interaction Design System)
-
-### 4.1 交互原则
-> 定义交互设计原则
-
-**即时反馈**：
-- 用户操作后立即给出反馈
-- 加载状态明确显示
-- 操作结果清晰提示
-
-**容错设计**：
-- 支持撤销和重试
-- 错误提示友好明确
-- 操作确认机制完善
-
-**一致性**：
-- 相同功能使用相同交互方式
-- 交互模式统一
-- 操作习惯一致
-
-### 4.2 交互动效
-> 定义交互动效规范
-
-#### 4.2.1 页面转场动画
-- **进入动画**：从右侧滑入，时长300ms，缓动函数 `ease-out`
-- **退出动画**：向左侧滑出，时长300ms，缓动函数 `ease-in`
-
-#### 4.2.2 弹窗动画
-- **进入动画**：从底部向上滑入，时长300ms，缓动函数 `ease-out`
-- **退出动画**：向底部滑出，时长300ms，缓动函数 `ease-in`
-- **背景遮罩**：淡入淡出，时长300ms
-
-#### 4.2.3 按钮动画
-- **按下动画**：背景色变深，缩放0.98，时长100ms
-- **释放动画**：恢复原状，时长100ms
-
-### 4.3 交互反馈
-> 定义交互反馈方式
-
-**视觉反馈**：
-- **成功操作**：所有的成功操作必须伴随"撒花"或"星星飞入"动画
-- **按钮点击**：显示点击态（颜色变化或阴影效果）
-- **列表项点击**：显示点击态，跳转页面
-- **卡片点击**：显示点击态，跳转详情页
-
-**听觉反馈**：
-- **TTS语音**：温暖的TTS回应（非机械音），用于重要操作确认
-- **音效**：轻快的音效（如Cha-ching!），用于成功操作
-
-**触觉反馈**：
-- **线性马达**：短震动（Haptic），模拟真实按键感
-- **应用场景**：按钮点击、重要操作确认
-
-**加载反馈**：
-- 页面加载：显示Loading动画
-- 列表加载：显示下拉刷新动画、上拉加载动画
-- 操作提交：显示Loading提示，防止重复提交
-
-**成功反馈**：
-- 操作成功：显示Toast提示（如"抢单成功"、"切换成功"）
-- 数据更新：自动刷新页面或列表
-
-**失败反馈**：
-- 网络异常：显示Toast提示"网络异常，请稍后重试"，支持重试
-- 操作失败：显示Toast提示具体错误信息
-- 数据加载失败：显示空状态，支持重试
-
-### 4.4 跨端同步逻辑 (Cross-Terminal Logic)
-> 定义跨端同步的交互逻辑
-
-**同步策略**：
-- **毫秒级反馈**：{例如：家长在App修改设置后，硬件端需在3s内展示同步动效（如partme-ai点头并说"收到啦"）}
-- **冲突解决策略**：{例如：家长指令优先级最高（Parent-First），冲突时提示"妈妈修改了计划哦"}
-
-**同步场景**：
-- 设置同步：App端修改设置，设备端实时同步
-- 状态同步：设备端状态变更，App端实时更新
-- 数据同步：离线数据同步，支持断点续传
-
----
-
-## 5. 组件设计规范 (Component Design System)
-
-### 5.1 按钮组件
-> 定义按钮组件规范
-
-**主要按钮（Primary Button）**：
-- 背景色：主色 `#007AFF`
-- 文字颜色：白色 `#FFFFFF`
-- 圆角：8px
-- 高度：44px（最小点击区域）
-- 字体：18px，Medium
-
-**次要按钮（Secondary Button）**：
-- 背景色：透明或浅灰色背景
-- 文字颜色：主色 `#007AFF`
-- 边框：1px，主色 `#007AFF`
-- 圆角：8px
-- 高度：44px
-
-### 5.2 输入框组件
-> 定义输入框组件规范
-
-**文本输入框**：
-- 背景色：白色 `#FFFFFF`
-- 边框：1px，颜色 `#E5E5E5`
-- 圆角：8px
-- 高度：44px
-- 字体：18px，Regular
-
-**搜索框**：
-- 背景色：`#F5F5F5`
-- 圆角：20px（高度的一半，形成胶囊形状）
-- 高度：40px
-
-### 5.3 卡片组件
-> 定义卡片组件规范
-
-**订单卡片**：
-- 背景色：白色 `#FFFFFF`
-- 圆角：12px
-- 内边距：16px
-- 阴影：小阴影 `0 2px 8px rgba(0,0,0,0.08)`
-- 间距：卡片之间间距16px
-
-### 5.4 列表组件
-> 定义列表组件规范
-
-**订单列表**：
-- 背景色：`#F5F5F5`（列表背景）、白色（卡片背景）
-- 间距：卡片之间间距16px
-- 下拉刷新：显示刷新动画，颜色主色 `#007AFF`
-- 上拉加载：显示加载动画，颜色主色 `#007AFF`
-
-### 5.5 弹窗组件
-> 定义弹窗组件规范
-
-**确认弹窗**：
-- 背景遮罩：`rgba(0,0,0,0.5)`，点击遮罩关闭弹窗
-- 弹窗背景：白色 `#FFFFFF`
-- 圆角：12px（顶部）
-- 宽度：屏幕宽度 - 64px（左右各32px边距）
-- 内边距：24px
-
----
-
-## 6. 适配规范 (Adaptation Guidelines)
-
-### 6.1 屏幕适配
-> 定义屏幕适配规范
-
-**屏幕尺寸适配**：
-- **小屏**（iPhone SE，375×667）：内容正常显示，字体和间距按比例缩放
-- **中屏**（iPhone 12，390×844）：内容正常显示
-- **大屏**（iPhone 14 Pro Max，430×932）：内容正常显示，左右边距适当增加
-
-**安全区域适配**：
-- **底部安全区域**：操作按钮栏需要适配底部安全区域（iPhone X及以上机型）
-- **顶部安全区域**：状态栏高度适配（刘海屏、灵动岛）
-
-### 6.2 深色模式适配
-> 定义深色模式适配规范（如需要）
-
-**深色模式**：
-- **背景色**：深色背景 `#000000`
-- **文字颜色**：浅色文字 `#FFFFFF`
-- **卡片背景**：深灰色 `#1C1C1E`
-- **分割线**：深灰色 `#38383A`
-
----
-
-## 6. 教育心理学应用 (Educational Strategy)
-> 定义基于教育心理学的设计策略
-
-**去排名化**：
-- 不设排行榜，只设"自我超越"成就
-- 强调个人成长，而非与他人比较
-
-**正面反馈**：
-- 失败时采用鼓励语（"下次再试试"），而非警示音
-- 强调过程而非结果，培养成长型思维
-
-**延迟满足**：
-- 愿望清单需累积星星兑换，培养长期主义意识
-- 通过目标设定和倒计时，培养时间管理能力
-
-**仪式感设计**：
-- 打卡操作需要长按或特定手势，增强仪式感
-- 重要成就解锁时，使用动画和音效增强成就感
-
-## 7. 品牌应用 (Brand Application)
-
-### 7.1 Logo使用规范
-> 定义Logo使用规范
-
-**Logo尺寸**：
-- **最小尺寸**：24px × 24px
-- **标准尺寸**：48px × 48px
-- **大尺寸**：96px × 96px
-
-**Logo使用场景**：
-- 应用图标
-- 启动页
-- 关于页面
-
-### 7.2 品牌色彩应用
-> 定义品牌色彩应用规范
-
-**主色应用**：
-- 主要按钮、链接、选中状态
-- 重要信息高亮
-- 品牌标识
-
-**功能色应用**：
-- 成功状态使用成功色
-- 警告状态使用警告色
-- 错误状态使用错误色
-- 信息提示使用信息色
-
----
-
-## 8. 设计工具与资源 (Design Tools & Resources)
-
-### 8.1 设计工具
-> 列出使用的设计工具
-
-- **UI设计**：Figma / Sketch
-- **原型设计**：Figma / Axure
-- **切图工具**：Figma / Sketch / Photoshop
-
-### 8.2 设计资源
-> 列出设计资源
-
-- **设计系统文件**：{Figma/Sketch链接}
-- **图标库**：{图标库链接}
-- **字体文件**：{字体文件下载链接}
-- **色彩工具**：{色彩工具链接}
-
----
-
-## 9. 附录 (Appendix)
-
-### 9.1 参考文档
-> 列出参考的相关文档
-
-- [需求分析模板](4、需求分析模板.md)
-- [PRD文档模板](5、PRD文档模板.md)
-- [UI 设计说明模板](7、UI%20设计说明模板.md)
-
-### 9.2 变更记录
-> 记录设计规范变更的历史
-
-| 变更日期 | 变更内容 | 变更原因 | 变更人 |
-| :--- | :--- | :--- | :--- |
-| {YYYY-MM-DD} | {变更内容描述} | {变更原因} | {姓名} |
-
----
-
-**文档版本**：V1.0.0  
-**创建时间**：{YYYY-MM-DD}  
-**最后更新**：{YYYY-MM-DD}  
-**文档状态**：✅ 设计中 / ✅ 待评审 / ✅ 评审通过 / ✅ 已完成

skills/dev-utils-skills/full-stack-doc/templates/8、领域模型说明模板.md

@@ -1,858 +0,0 @@
-# {产品名称} - 领域模型说明文档 V1.0
-
-> **文档说明**：
-> - 本文档用于描述产品的领域模型设计，包括领域划分、实体关系、领域服务等
-> - 基于领域驱动设计（DDD）思想，明确业务领域边界和核心概念
-> - `{}` 包裹的内容为占位符，请替换为实际内容
-> - 引用块 `>` 中的文字为填写指导，填写后可删除
-
----
-
-## 1. 文档信息 (Document Info)
-
-### 1.1 版本记录
-| 版本号 | 修改日期 | 修改人 | 修改内容 | 备注 |
-| :--- | :--- | :--- | :--- | :--- |
-| V1.0.0 | {YYYY-MM-DD} | {姓名} | 初始版本 | - |
-
-### 1.2 文档责任人
-| 角色 | 姓名 | 职责 |
-| :--- | :--- | :--- |
-| 架构师 | {姓名} | 领域模型设计、架构评审 |
-| 产品经理 | {姓名} | 业务需求确认、领域边界确认 |
-| 开发负责人 | {姓名} | 领域模型实现、技术评审 |
-
----
-
-## 2. 战略设计 (Strategic Design)
-
-### 2.1 限界上下文 (Bounded Contexts)
-> 基于业务复杂度与团队协作边界，将系统划分为核心上下文
-
-**上下文划分原则**：
-- **高内聚**：相关业务概念聚合在一起
-- **低耦合**：不同领域之间通过接口交互
-- **业务边界清晰**：每个领域有明确的业务边界
-- **团队边界**：考虑团队组织结构和协作边界
-
-**限界上下文列表**：
-
-```mermaid
-graph TB
-    subgraph Core["核心域 (Core Domain)"]
-        OrderContext[订单上下文]
-        ScheduleContext[日程上下文]
-        ExecutionContext[执行上下文]
-    end
-    
-    subgraph Support["支撑域 (Supporting Domain)"]
-        UserContext[用户上下文]
-        GamificationContext[激励上下文]
-        ContentContext[内容上下文]
-    end
-    
-    subgraph Generic["通用域 (Generic Domain)"]
-        AuthContext[认证上下文]
-        PaymentContext[支付上下文]
-        ReportContext[报表上下文]
-    end
-```
-
-| 上下文名称 | 上下文类型 | 领域描述 | 核心职责 |
-| :--- | :--- | :--- | :--- |
-| {订单上下文} | 核心域 | {订单相关的业务逻辑} | {订单创建、订单处理、订单状态管理} |
-| {门店上下文} | 核心域 | {门店相关的业务逻辑} | {门店信息管理、门店数据统计} |
-| {用户上下文} | 支撑域 | {用户相关的业务逻辑} | {用户认证、用户信息管理、用户关系管理} |
-| {激励上下文} | 支撑域 | {激励相关的业务逻辑} | {积分、勋章、愿望清单} |
-
-### 2.2 统一语言 (Ubiquitous Language)
-> 定义领域内的统一术语，确保团队沟通一致
-
-| 中文术语 | 英文术语 | 定义/说明 |
-| :--- | :--- | :--- |
-| **订单** | `Order` | 客户下单产生的服务订单 |
-| **工单** | `WorkOrder` | 需要师傅执行的服务工单 |
-| **任务** | `Task` | 具体的待办事项，如"早读"、"跳绳" |
-| **打卡** | `CheckIn` | 用户完成任务的动作记录 |
-| **专注会话** | `FocusSession` | 一次完整的专注过程（如番茄钟） |
-| **积分** | `Points` | 用于激励体系的虚拟货币（UI显示为"星星"） |
-| **勋章** | `Badge` | 达成特定成就后获得的虚拟荣誉 |
-| **愿望** | `Wish` | 使用积分兑换的奖励（如周末去公园） |
-
-## 3. 领域概述 (Domain Overview)
-
-### 3.1 业务领域
-> 描述产品的业务领域
-
-**核心业务领域**：
-{例如：门店管理、订单管理、师傅管理、客户管理等}
-
-**业务目标**：
-- {例如：提升门店运营效率}
-- {例如：优化订单处理流程}
-- {例如：提升服务质量}
-
-### 3.2 领域划分
-> 明确领域划分
-
-**领域列表**：
-
-| 领域名称 | 领域描述 | 核心职责 |
-| :--- | :--- | :--- |
-| {订单领域} | {订单相关的业务逻辑} | {订单创建、订单处理、订单状态管理} |
-| {门店领域} | {门店相关的业务逻辑} | {门店信息管理、门店数据统计} |
-| {师傅领域} | {师傅相关的业务逻辑} | {师傅管理、师傅工作流程} |
-| {客户领域} | {客户相关的业务逻辑} | {客户信息管理、客户关系管理} |
-
----
-
-## 4. 战术设计 (Tactical Design)
-
-## 5. 核心领域 (Core Domain)
-
-### 3.1 {领域名称 - 例如：订单领域}
-
-#### 5.1.1 领域描述
-> 描述领域的业务职责和边界
-
-**领域职责**：
-- {例如：订单的创建、处理、状态管理}
-- {例如：订单的分配、转派、完成}
-- {例如：订单的数据统计和分析}
-
-**领域边界**：
-- **包含**：订单实体、订单状态、订单操作
-- **不包含**：门店信息（属于门店领域）、客户信息（属于客户领域）
-
-#### 5.1.2 聚合根 (Aggregate Root)
-> 定义聚合根，作为聚合的入口
-
-**订单聚合根 (Order Aggregate)**：
-- **聚合根**：`Order`
-- **职责**：管理订单的完整生命周期，确保订单数据的一致性
-- **边界**：包含订单主信息、订单明细、订单状态等
-
-#### 5.1.3 领域实体 (Domain Entities)
-
-**订单实体 (Order)**：
-```mermaid
-classDiagram
-    class Order {
-        +String orderId
-        +String shopId
-        +String workerId
-        +String userId
-        +OrderStatus status
-        +OrderType type
-        +DateTime appointmentDate
-        +Time appointmentTime
-        +Address serviceAddress
-        +Money paymentPrice
-        +DateTime createTime
-        +DateTime updateTime
-        +create()
-        +assignWorker()
-        +transferOrder()
-        +completeOrder()
-        +cancelOrder()
-    }
-    
-    class OrderItem {
-        +String itemId
-        +String orderId
-        +String goodsName
-        +String picUrl
-        +Money paymentPrice
-    }
-    
-    class OrderStatus {
-        <<enumeration>>
-        PENDING
-        ASSIGNED
-        IN_SERVICE
-        COMPLETED
-        CANCELLED
-    }
-    
-    Order "1" *-- "N" OrderItem : contains
-    Order --> OrderStatus : has
-```
-
-**实体属性说明**：
-
-| 属性 | 类型 | 说明 | 约束 |
-| :--- | :--- | :--- | :--- |
-| orderId | String | 订单ID | 主键，唯一标识 |
-| shopId | String | 门店ID | 外键，关联门店 |
-| workerId | String | 师傅ID | 外键，关联师傅 |
-| userId | String | 客户ID | 外键，关联客户 |
-| status | OrderStatus | 订单状态 | 枚举值 |
-| type | OrderType | 订单类型 | 枚举值（上门订单/服务订单） |
-| appointmentDate | DateTime | 预约日期 | 必填 |
-| appointmentTime | Time | 预约时间 | 必填 |
-| serviceAddress | Address | 服务地址 | 值对象 |
-| paymentPrice | Money | 订单金额 | 值对象，保留2位小数 |
-
-**实体方法说明**：
-- **create()**：创建订单，初始化订单状态为PENDING
-- **assignWorker(workerId)**：指派师傅，更新订单状态为ASSIGNED
-- **transferOrder(newWorkerId)**：转派订单，更新师傅和状态
-- **completeOrder()**：完成订单，更新订单状态为COMPLETED
-- **cancelOrder()**：取消订单，更新订单状态为CANCELLED
-
-#### 5.1.4 值对象 (Value Objects)
-
-**地址值对象 (Address)**：
-```mermaid
-classDiagram
-    class Address {
-        +String province
-        +String city
-        +String district
-        +String detail
-        +Double longitude
-        +Double latitude
-        +getFullAddress()
-        +calculateDistance(target)
-    }
-```
-
-**值对象属性说明**：
-
-| 属性 | 类型 | 说明 |
-| :--- | :--- | :--- |
-| province | String | 省份 |
-| city | String | 城市 |
-| district | String | 区县 |
-| detail | String | 详细地址 |
-| longitude | Double | 经度 |
-| latitude | Double | 纬度 |
-
-**金额值对象 (Money)**：
-```mermaid
-classDiagram
-    class Money {
-        +BigDecimal amount
-        +String currency
-        +add(Money)
-        +subtract(Money)
-        +multiply(BigDecimal)
-        +compareTo(Money)
-    }
-```
-
-#### 5.1.5 领域服务 (Domain Services)
-
-**订单分配服务 (OrderAssignmentService)**：
-- **职责**：处理订单分配逻辑
-- **方法**：
-  - `assignOrder(orderId, workerId)`: 指派订单给师傅
-  - `transferOrder(orderId, newWorkerId)`: 转派订单
-  - `calculateDistance(orderId, workerLocation)`: 计算订单距离
-
-**订单状态服务 (OrderStatusService)**：
-- **职责**：管理订单状态流转
-- **方法**：
-  - `updateStatus(orderId, newStatus)`: 更新订单状态
-  - `validateStatusTransition(currentStatus, newStatus)`: 验证状态流转是否合法
-  - `getAvailableStatuses(currentStatus)`: 获取可用的状态列表
-
-#### 5.1.6 领域事件 (Domain Events)
-
-**订单已创建事件 (OrderCreatedEvent)**：
-- **触发时机**：订单创建成功
-- **事件数据**：订单ID、门店ID、客户ID、订单类型
-- **订阅者**：订单通知服务、数据统计服务
-
-**订单已分配事件 (OrderAssignedEvent)**：
-- **触发时机**：订单分配成功
-- **事件数据**：订单ID、师傅ID、分配时间
-- **订阅者**：通知服务（通知师傅）
-
-**订单已完成事件 (OrderCompletedEvent)**：
-- **触发时机**：订单完成
-- **事件数据**：订单ID、完成时间、服务时长
-- **订阅者**：数据统计服务、结算服务
-
----
-
-### 5.2 {领域名称 - 例如：门店领域}
-
-#### 5.2.1 领域描述
-> 描述领域的业务职责和边界
-
-**领域职责**：
-- {例如：门店信息管理}
-- {例如：门店数据统计}
-- {例如：门店配置管理}
-
-**领域边界**：
-- **包含**：门店实体、门店数据统计、门店配置
-- **不包含**：订单信息（属于订单领域）、师傅信息（属于师傅领域）
-
-#### 5.2.2 领域实体 (Domain Entities)
-
-**门店实体 (Shop)**：
-```mermaid
-classDiagram
-    class Shop {
-        +String shopId
-        +String shopName
-        +Address location
-        +ShopStatus status
-        +ShopConfig config
-        +DateTime createTime
-        +DateTime updateTime
-        +updateInfo()
-        +updateConfig()
-        +getStatistics()
-    }
-    
-    class ShopConfig {
-        +Integer maxWorkers
-        +Integer maxOrders
-        +Boolean autoAssign
-        +Distance maxCheckInDistance
-    }
-    
-    class ShopStatistics {
-        +Integer todayVisitors
-        +Integer todayOrders
-        +Money todayRevenue
-        +Integer yesterdayVisitors
-        +Integer yesterdayOrders
-        +Money yesterdayRevenue
-    }
-    
-    Shop "1" --> "1" ShopConfig : has
-    Shop --> ShopStatistics : generates
-```
-
-**实体属性说明**：
-
-| 属性 | 类型 | 说明 |
-| :--- | :--- | :--- |
-| shopId | String | 门店ID |
-| shopName | String | 门店名称 |
-| location | Address | 门店位置 |
-| status | ShopStatus | 门店状态 |
-| config | ShopConfig | 门店配置 |
-
-#### 5.2.3 领域服务 (Domain Services)
-
-**门店统计服务 (ShopStatisticsService)**：
-- **职责**：计算门店统计数据
-- **方法**：
-  - `calculateTodayStatistics(shopId)`: 计算今日统计数据
-  - `calculateYesterdayStatistics(shopId)`: 计算昨日统计数据
-  - `compareStatistics(today, yesterday)`: 对比统计数据
-
----
-
-## 6. 支撑领域 (Supporting Domain)
-
-### 6.1 {领域名称 - 例如：用户领域}
-
-#### 6.1.1 领域描述
-> 描述支撑领域的职责
-
-**领域职责**：
-- {例如：用户认证、用户授权}
-- {例如：用户信息管理}
-- {例如：角色权限管理}
-
-**领域边界**：
-- **包含**：用户实体、角色实体、权限实体
-- **不包含**：业务逻辑（属于核心领域）
-
-#### 6.1.2 领域实体 (Domain Entities)
-
-**用户实体 (User)**：
-```mermaid
-classDiagram
-    class User {
-        +String userId
-        +String username
-        +String phone
-        +UserRole role
-        +UserStatus status
-        +DateTime createTime
-        +authenticate()
-        +authorize()
-    }
-    
-    class UserRole {
-        <<enumeration>>
-        SHOP_OWNER
-        SHOP_STAFF
-        WORKER
-        CUSTOMER
-    }
-    
-    User --> UserRole : has
-```
-
----
-
-## 7. 通用领域 (Generic Domain)
-
-### 7.1 {领域名称 - 例如：通知领域}
-
-#### 5.1.1 领域描述
-> 描述通用领域的职责
-
-**领域职责**：
-- {例如：消息通知、推送通知}
-- {例如：短信通知、邮件通知}
-
-**领域边界**：
-- **包含**：通知实体、通知服务
-- **不包含**：业务逻辑（属于核心领域）
-
-#### 7.1.2 领域实体 (Domain Entities)
-
-**通知实体 (Notification)**：
-```mermaid
-classDiagram
-    class Notification {
-        +String notificationId
-        +String userId
-        +NotificationType type
-        +String title
-        +String content
-        +DateTime sendTime
-        +NotificationStatus status
-        +send()
-        +markAsRead()
-    }
-    
-    class NotificationType {
-        <<enumeration>>
-        SMS
-        EMAIL
-        PUSH
-        IN_APP
-    }
-    
-    Notification --> NotificationType : has
-```
-
----
-
-## 8. 领域关系图 (Domain Relationships)
-
-### 8.1 领域关系总览
-> 使用Mermaid图展示领域之间的关系
-
-```mermaid
-graph TB
-    subgraph Core["核心领域 (Core Domain)"]
-        OrderDomain[订单领域]
-        ShopDomain[门店领域]
-        WorkerDomain[师傅领域]
-    end
-    
-    subgraph Support["支撑领域 (Supporting Domain)"]
-        UserDomain[用户领域]
-        AuthDomain[认证领域]
-    end
-    
-    subgraph Generic["通用领域 (Generic Domain)"]
-        NotificationDomain[通知领域]
-        StatisticsDomain[统计领域]
-    end
-    
-    OrderDomain --> ShopDomain
-    OrderDomain --> WorkerDomain
-    OrderDomain --> UserDomain
-    ShopDomain --> UserDomain
-    WorkerDomain --> UserDomain
-    OrderDomain --> NotificationDomain
-    ShopDomain --> StatisticsDomain
-    OrderDomain --> StatisticsDomain
-```
-
-### 8.2 实体关系图 (Entity Relationship Diagram)
-> 使用ER图展示实体之间的关系
-
-```mermaid
-erDiagram
-    SHOP ||--o{ ORDER : has
-    SHOP ||--o{ WORKER : has
-    USER ||--o{ ORDER : places
-    WORKER ||--o{ ORDER : services
-    ORDER ||--|{ ORDER_ITEM : contains
-    ORDER }o--|| ADDRESS : has
-    
-    SHOP {
-        string shop_id PK
-        string shop_name
-        string status
-        datetime create_time
-    }
-    
-    ORDER {
-        string order_id PK
-        string shop_id FK
-        string worker_id FK
-        string user_id FK
-        string status
-        datetime appointment_date
-        time appointment_time
-        decimal payment_price
-        datetime create_time
-    }
-    
-    WORKER {
-        string worker_id PK
-        string shop_id FK
-        string name
-        string phone
-        string level_id
-        decimal score
-        int status
-    }
-    
-    USER {
-        string user_id PK
-        string username
-        string phone
-        string role
-        int status
-    }
-    
-    ORDER_ITEM {
-        string item_id PK
-        string order_id FK
-        string goods_name
-        string pic_url
-        decimal payment_price
-    }
-    
-    ADDRESS {
-        string address_id PK
-        string province
-        string city
-        string district
-        string detail
-        decimal longitude
-        decimal latitude
-    }
-```
-
----
-
-## 9. 领域服务接口 (Domain Service Interfaces)
-
-### 9.1 订单领域服务接口
-
-**订单分配服务接口 (IOrderAssignmentService)**：
-```typescript
-interface IOrderAssignmentService {
-  /**
-   * 指派订单给师傅
-   * @param orderId 订单ID
-   * @param workerId 师傅ID
-   * @returns 分配结果
-   */
-  assignOrder(orderId: string, workerId: string): Promise<AssignmentResult>;
-  
-  /**
-   * 转派订单
-   * @param orderId 订单ID
-   * @param newWorkerId 新师傅ID
-   * @returns 转派结果
-   */
-  transferOrder(orderId: string, newWorkerId: string): Promise<TransferResult>;
-  
-  /**
-   * 计算订单距离
-   * @param orderId 订单ID
-   * @param workerLocation 师傅位置
-   * @returns 距离（公里）
-   */
-  calculateDistance(orderId: string, workerLocation: Location): Promise<number>;
-}
-```
-
-### 9.2 门店领域服务接口
-
-**门店统计服务接口 (IShopStatisticsService)**：
-```typescript
-interface IShopStatisticsService {
-  /**
-   * 获取门店统计数据
-   * @param shopId 门店ID
-   * @param date 日期
-   * @returns 统计数据
-   */
-  getStatistics(shopId: string, date: Date): Promise<ShopStatistics>;
-  
-  /**
-   * 对比统计数据
-   * @param today 今日统计
-   * @param yesterday 昨日统计
-   * @returns 对比结果
-   */
-  compareStatistics(today: ShopStatistics, yesterday: ShopStatistics): ComparisonResult;
-}
-```
-
----
-
-## 10. 领域事件定义 (Domain Events Definition)
-
-### 10.1 事件列表
-> 列出所有领域事件
-
-| 事件名称 | 事件类型 | 触发时机 | 事件数据 | 订阅者 |
-| :--- | :--- | :--- | :--- | :--- |
-| OrderCreatedEvent | 订单已创建 | 订单创建成功 | orderId, shopId, userId, type | 通知服务、统计服务 |
-| OrderAssignedEvent | 订单已分配 | 订单分配成功 | orderId, workerId, assignTime | 通知服务 |
-| OrderCompletedEvent | 订单已完成 | 订单完成 | orderId, completeTime, duration | 统计服务、结算服务 |
-| OrderCancelledEvent | 订单已取消 | 订单取消 | orderId, cancelTime, reason | 通知服务、统计服务 |
-
-### 10.2 事件定义
-> 定义事件的数据结构
-
-**订单已创建事件 (OrderCreatedEvent)**：
-```typescript
-interface OrderCreatedEvent {
-  eventId: string;
-  eventType: 'OrderCreated';
-  timestamp: Date;
-  data: {
-    orderId: string;
-    shopId: string;
-    userId: string;
-    orderType: OrderType;
-    appointmentDate: Date;
-    appointmentTime: Time;
-    paymentPrice: Money;
-  };
-}
-```
-
----
-
-## 11. 领域模型规则 (Domain Model Rules)
-
-### 11.1 业务规则
-> 定义领域模型的业务规则
-
-**订单领域规则**：
-1. **订单创建规则**：
-   - 订单必须关联门店
-   - 订单必须关联客户
-   - 订单金额必须大于0
-   - 预约时间必须晚于当前时间
-
-2. **订单分配规则**：
-   - 只有待接单状态的订单才能分配
-   - 师傅必须属于订单所在门店
-   - 师傅状态必须为可用
-
-3. **订单状态流转规则**：
-   - 待接单 → 待服务 → 服务中 → 已完成
-   - 待接单 → 已取消
-   - 待服务 → 已取消
-   - 不允许跨状态流转
-
-**门店领域规则**：
-1. **门店创建规则**：
-   - 门店名称不能为空
-   - 门店位置必须有效
-   - 门店状态必须为有效状态
-
-2. **门店统计规则**：
-   - 统计数据按门店隔离
-   - 统计数据按日期统计
-   - 统计数据实时更新
-
-### 11.2 数据一致性规则
-> 定义数据一致性规则
-
-**订单数据一致性**：
-- 订单状态变更必须记录操作日志
-- 订单金额变更必须记录变更历史
-- 订单分配必须更新师傅工作状态
-
-**门店数据一致性**：
-- 门店信息变更必须记录变更历史
-- 门店统计数据必须与订单数据一致
-- 门店配置变更必须生效
-
----
-
-## 12. 领域模型实现 (Domain Model Implementation)
-
-### 12.1 实体实现
-> 说明实体的实现方式
-
-**订单实体实现**：
-```java
-@Entity
-@Table(name = "work_order_info")
-public class Order {
-    @Id
-    private String orderId;
-    
-    @Column(name = "shop_id")
-    private String shopId;
-    
-    @Column(name = "worker_id")
-    private String workerId;
-    
-    @Enumerated(EnumType.STRING)
-    @Column(name = "status")
-    private OrderStatus status;
-    
-    @Embedded
-    private Address serviceAddress;
-    
-    @Embedded
-    private Money paymentPrice;
-    
-    public void assignWorker(String workerId) {
-        if (this.status != OrderStatus.PENDING) {
-            throw new IllegalStateException("只能分配待接单状态的订单");
-        }
-        this.workerId = workerId;
-        this.status = OrderStatus.ASSIGNED;
-        // 发布领域事件
-        DomainEventPublisher.publish(new OrderAssignedEvent(this.orderId, workerId));
-    }
-    
-    public void completeOrder() {
-        if (this.status != OrderStatus.IN_SERVICE) {
-            throw new IllegalStateException("只能完成服务中状态的订单");
-        }
-        this.status = OrderStatus.COMPLETED;
-        // 发布领域事件
-        DomainEventPublisher.publish(new OrderCompletedEvent(this.orderId));
-    }
-}
-```
-
-### 12.2 领域服务实现
-> 说明领域服务的实现方式
-
-**订单分配服务实现**：
-```java
-@Service
-public class OrderAssignmentService implements IOrderAssignmentService {
-    
-    @Autowired
-    private OrderRepository orderRepository;
-    
-    @Autowired
-    private WorkerRepository workerRepository;
-    
-    @Override
-    public AssignmentResult assignOrder(String orderId, String workerId) {
-        Order order = orderRepository.findById(orderId)
-            .orElseThrow(() -> new OrderNotFoundException(orderId));
-        
-        Worker worker = workerRepository.findById(workerId)
-            .orElseThrow(() -> new WorkerNotFoundException(workerId));
-        
-        // 业务规则验证
-        if (!order.getShopId().equals(worker.getShopId())) {
-            throw new BusinessException("师傅必须属于订单所在门店");
-        }
-        
-        if (worker.getStatus() != WorkerStatus.AVAILABLE) {
-            throw new BusinessException("师傅状态必须为可用");
-        }
-        
-        // 执行分配
-        order.assignWorker(workerId);
-        orderRepository.save(order);
-        
-        return new AssignmentResult(true, "分配成功");
-    }
-}
-```
-
----
-
-## 13. 领域模型映射 (Domain Model Mapping)
-
-### 13.1 实体到数据库映射
-> 说明实体到数据库表的映射关系
-
-| 实体 | 数据库表 | 映射说明 |
-| :--- | :--- | :--- |
-| Order | work_order_info | 订单主表 |
-| OrderItem | work_order_item | 订单明细表 |
-| Shop | shop_info | 门店信息表 |
-| Worker | worker_user | 师傅表 |
-| User | user_info | 用户表 |
-
-### 13.2 值对象映射
-> 说明值对象到数据库字段的映射
-
-| 值对象 | 数据库字段 | 映射说明 |
-| :--- | :--- | :--- |
-| Address | service_address, service_address_lng, service_address_lat | 地址值对象映射到多个字段 |
-| Money | payment_price | 金额值对象映射到decimal字段 |
-
----
-
-## 14. 领域模型演进 (Domain Model Evolution)
-
-### 14.1 版本历史
-> 记录领域模型的版本历史
-
-| 版本 | 日期 | 变更内容 | 变更原因 |
-| :--- | :--- | :--- | :--- |
-| V1.0.0 | {YYYY-MM-DD} | 初始版本 | 初始设计 |
-| V1.1.0 | {YYYY-MM-DD} | 新增订单转派功能 | 业务需求 |
-| V1.2.0 | {YYYY-MM-DD} | 优化订单状态流转 | 业务优化 |
-
-### 14.2 未来规划
-> 说明领域模型的未来规划
-
-**规划内容**：
-- {例如：增加订单评价领域}
-- {例如：增加客户关系管理领域}
-- {例如：优化订单分配算法}
-
----
-
-## 15. 附录 (Appendix)
-
-### 15.1 术语表
-> 定义文档中使用的专业术语
-
-| 术语 | 定义 |
-| :--- | :--- |
-| 领域 (Domain) | 业务领域，一组相关的业务概念和规则 |
-| 实体 (Entity) | 有唯一标识的业务对象 |
-| 值对象 (Value Object) | 没有唯一标识，通过值相等判断的对象 |
-| 领域服务 (Domain Service) | 不属于特定实体的业务逻辑 |
-| 领域事件 (Domain Event) | 领域内发生的重要业务事件 |
-| 聚合 (Aggregate) | 一组相关对象的集合，有明确的边界 |
-| 仓储 (Repository) | 封装数据访问逻辑的接口 |
-
-### 15.2 参考文档
-> 列出参考的相关文档
-
-- [需求分析模板](4、需求分析模板.md)
-- [PRD文档模板](5、PRD文档模板.md)
-- [系统架构设计模板](9、系统架构设计模板.md)
-- [技术细分模板](10、技术细分模板.md)
-
-### 15.3 变更记录
-> 记录领域模型变更的历史
-
-| 变更日期 | 变更内容 | 变更原因 | 变更人 |
-| :--- | :--- | :--- | :--- |
-| {YYYY-MM-DD} | {变更内容描述} | {变更原因} | {姓名} |
-
----
-
-**文档版本**：V1.0.0  
-**创建时间**：{YYYY-MM-DD}  
-**最后更新**：{YYYY-MM-DD}  
-**文档状态**：✅ 设计中 / ✅ 待评审 / ✅ 评审通过 / ✅ 已完成

skills/dev-utils-skills/full-stack-doc/templates/9、系统架构设计模板.md

@@ -1,1131 +0,0 @@
-# {产品名称} - 系统架构设计文档 V1.0
-
-> **相关文档导航**：
-> *   [产品需求文档 (PRD)]({PRD文档路径})
-> *   [领域模型文档 (Domain Model)]({领域模型文档路径})
-> *   [UI/UX 设计规范 (Design Spec)]({UI设计规范路径})
-
-> **文档说明**：
-> - 本文档用于描述系统的整体架构设计，包括技术架构、系统架构、部署架构等
-> - 确保系统架构合理、可扩展、可维护
-> - 基于DDD思想和COLA架构进行设计
-> - `{}` 包裹的内容为占位符，请替换为实际内容
-> - 引用块 `>` 中的文字为填写指导，填写后可删除
-
----
-
-## 1. 文档信息 (Document Info)
-
-### 1.1 版本记录
-| 版本号 | 修改日期 | 修改人 | 修改内容 | 备注 |
-| :--- | :--- | :--- | :--- | :--- |
-| V1.0.0 | {YYYY-MM-DD} | {姓名} | 初始版本 | - |
-
-### 1.2 文档责任人
-| 角色 | 姓名 | 职责 |
-| :--- | :--- | :--- |
-| 架构师 | {姓名} | 架构设计、架构评审 |
-| 技术负责人 | {姓名} | 技术方案评审、技术可行性评估 |
-| 开发负责人 | {姓名} | 架构实现、技术选型 |
-
----
-
-## 2. 架构概述 (Architecture Overview)
-
-### 2.1 系统定位
-> 描述系统的定位和目标
-
-**系统定位**：
-{例如：面向门店老板和师傅的XXX应用，帮助门店高效管理订单、师傅、客户等业务}
-
-**系统目标**：
-- {例如：提升订单处理效率}
-- {例如：优化用户体验}
-- {例如：支持高并发访问}
-- {例如：保证系统稳定性和可扩展性}
-
-### 2.2 架构原则
-
-**总体架构原则**：
-- **云端智能，边缘执行**：复杂的AI推理、数据分析在云端完成；实时性要求高的交互、基础逻辑在设备端（如适用）完成
-- **领域驱动 (DDD)**：核心业务逻辑采用DDD战术设计，确保业务复杂度可控
-- **事件驱动 (EDA)**：各个上下文之间通过领域事件解耦，支持高并发与扩展性
-- **安全合规**：严格遵守相关法规（如COPPA儿童在线隐私保护法等），确保数据安全和隐私保护
-- **权限边界**：明确区分角色权限，确保数据隔离和操作安全（如适用：教师端仅拥有数据同步与查看权限，严格禁止直接下发设备控制指令）
-
-### 2.3 技术选型
-> 明确技术选型
-
-**前端技术栈**：
-- **管理后台**：
-  - Element Plus of Vue 3.0
-  - Pinia of Vue 3.0
-  - Dart Sass
-  - Avue
-  - Echarts
-- **移动端**：
-  - UniApp-x + uView Pro of Vue 3.0
-  - Pinia of Vue 3.0
-  - Dart Sass
-  - lime-echart
-
-**后端技术栈**：
-- **框架**：Spring Boot, Spring Cloud
-- **ORM**：MyBatis-Plus
-- **数据库**：MySQL 8.0+
-- **缓存**：Redis（包括Redis GEO，如适用）
-- **消息队列**：RocketMQ / Kafka
-- **服务注册**：Nacos / Eureka
-- **AI服务**：{如适用：大模型API、向量数据库（Milvus/Chroma）}
-
-**硬件技术栈**（如适用）：
-- **主控芯片**：{如ESP32-S3等}
-- **操作系统**：{如FreeRTOS等}
-- **图形库**：{如LVGL等}
-- **通信协议**：MQTT、WebSocket、BLE
-
-**基础设施**：
-- **容器化**：Docker, Kubernetes
-- **CI/CD**：Jenkins / GitLab CI
-- **监控**：Prometheus + Grafana
-- **日志**：ELK Stack
-
----
-
-## 3. 架构原则 (Architecture Principles)
-
-### 3.1 设计原则
-
-**核心设计原则**：
-- **高内聚低耦合**：模块内部高内聚，模块之间低耦合
-- **可扩展性**：支持水平扩展和垂直扩展
-- **可维护性**：代码结构清晰，易于维护
-- **高可用性**：系统具备容错和恢复能力
-- **安全性**：数据安全、接口安全、系统安全
-
-### 3.2 架构模式
-
-**分层架构**：
-- 采用COLA (Clean Object-Oriented & Layered Architecture) 分层架构
-- 清晰的分层边界和依赖方向
-
-**微服务架构**：
-- 按业务领域划分微服务
-- 服务间通过REST API和消息队列通信
-
-**事件驱动架构**：
-- 使用领域事件实现跨聚合、跨上下文的解耦通信
-- 支持异步处理和最终一致性
-
-## 4. 系统架构 (System Architecture)
-
-### 4.1 整体架构图
-> 使用Mermaid图展示整体架构
-
-```mermaid
-flowchart TB
-    subgraph Terminal["终端层 (Terminal Layer)"]
-        direction LR
-        IoTDevice["{IoT设备名称，如适用}"] 
-        MobileApp["{移动端名称}"] 
-        TeacherApp["{教师端名称，如适用}"] 
-        WebConsole["{管理后台名称}"] 
-    end
-    
-    subgraph Gateway["网关层 (Gateway Layer)"]
-        APIGateway["API网关<br/>Spring Cloud Gateway"]
-    end
-
-    subgraph Service["服务层 (Service Layer)"]
-        UserService["{用户服务名称}"]
-        ScheduleService["{计划服务名称}"]
-        GamificationService["{激励服务名称}"]
-        ContentService["{内容服务名称}"]
-        PlatformService["{平台服务名称}"]
-        AIGateway["{AI网关名称，如适用}"]
-    end
-
-    subgraph Infrastructure["基础设施层 (Infrastructure Layer)"]
-        MySQL[(MySQL<br/>数据库)]
-        Redis[(Redis<br/>缓存)]
-        MQ[消息队列<br/>RocketMQ/Kafka]
-        Milvus[(向量数据库<br/>Milvus/Chroma，如适用)]
-        OSS[对象存储<br/>OSS]
-    end
-
-    IoTDevice --> APIGateway
-    MobileApp --> APIGateway
-    TeacherApp --> APIGateway
-    WebConsole --> APIGateway
-    
-    APIGateway --> UserService
-    APIGateway --> ScheduleService
-    APIGateway --> GamificationService
-    APIGateway --> ContentService
-    APIGateway --> PlatformService
-    
-    UserService --> MySQL
-    ScheduleService --> MySQL
-    GamificationService --> MySQL
-    ContentService --> MySQL
-    PlatformService --> MySQL
-    
-    UserService --> Redis
-    ScheduleService --> Redis
-    GamificationService --> Redis
-    
-    ScheduleService --> MQ
-    GamificationService --> MQ
-    ContentService --> MQ
-    
-    AIGateway --> Milvus
-    AIGateway --> MySQL
-    UserService --> AIGateway
-    ScheduleService --> AIGateway
-    
-    ContentService --> OSS
-```
-
-### 4.2 逻辑架构 (Logical Architecture) - COLA 5.0
-
-采用 COLA (Clean Object-Oriented & Layered Architecture) 分层架构，并显式引入**终端层**以适应多端交互场景。
-
-```mermaid
-flowchart TD
-    subgraph "Terminal Layer (终端层)"
-        direction LR
-        IoTDevice["{IoT设备名称，如适用}"]
-        MobileApp["{移动端名称}"]
-        TeacherApp["{教师端名称，如适用}"]
-        WebConsole["{管理后台名称}"]
-    end
-
-    subgraph "Adapter Layer (适配层)"
-        WebController["Web API"]
-        MobileController["App API"]
-        IoTAdapter["IoT MQTT Adapter"]
-        DingTalkAdapter["{第三方平台Adapter，如适用}"]
-    end
-
-    subgraph "Application Layer (应用层)"
-        WorkflowService["业务流程编排"]
-        CommandExecutor["命令执行器"]
-        DTOAssembler["DTO 组装"]
-    end
-
-    subgraph "Domain Layer (领域层)"
-        DomainService["领域服务"]
-        Aggregate["聚合根"]
-        Entity["实体"]
-        DomainEvent["领域事件"]
-        GatewayIntf["网关接口定义"]
-    end
-
-    subgraph "Infrastructure Layer (基础设施层)"
-        DBImpl["数据库网关实现"]
-        RPCImpl["微服务调用"]
-        EventBusImpl["消息总线实现"]
-        LLMClient["{大模型客户端，如适用}"]
-    end
-
-    %% Terminal -> Adapter
-    IoTDevice --> IoTAdapter
-    MobileApp --> MobileController
-    TeacherApp --> DingTalkAdapter
-    WebConsole --> WebController
-
-    %% Adapter -> Application
-    WebController --> WorkflowService
-    MobileController --> WorkflowService
-    IoTAdapter --> WorkflowService
-    DingTalkAdapter --> WorkflowService
-
-    %% Application -> Domain
-    WorkflowService --> DomainService
-
-    %% Infrastructure Implementation
-    DBImpl -.-> GatewayIntf
-```
-
-**分层说明**：
-- **Terminal Layer (终端层)**：处理外部输入输出，如 HTTP 接口、消息队列、数据库等
-- **Adapter Layer (适配层)**：适配不同终端和协议
-- **Application Layer (应用层)**：协调领域层和基础设施层，实现业务逻辑
-- **Domain Layer (领域层)**：包含核心业务逻辑、领域模型、领域服务等
-- **Infrastructure Layer (基础设施层)**：实现技术细节，如数据库访问、消息队列、缓存等
-
-### 4.3 物理架构 (Physical Architecture)
-
-#### 4.3.1 云端架构 (Cloud)
-
-**API Gateway (Spring Cloud Gateway)**：
-- 统一入口，鉴权、限流、路由
-- 支持多端接入（App、小程序、Web、IoT）
-
-**Microservices (Spring Boot)**：
-- `{service-name}`: {服务描述}
-  - {详细功能说明，如适用}
-- **SyncService**（如适用）: 数据同步服务（支持离线队列、断点续传、最终一致性）
-  - **冲突策略**: 采用 **Parent-Override** (家长端优先) 策略，配合乐观锁 (Version Check) 解决多端并发修改冲突
-- **PaymentService**（如适用）: 支付中心（微信支付等）
-
-**AI Gateway**（如适用）：
-- 专用于处理 LLM 交互、RAG 检索、向量计算
-- 通过 gRPC 与 Java 核心服务通信
-
-**Data Storage**：
-- **MySQL**: 核心业务数据
-- **Redis**:
-  - `Token`: 鉴权令牌
-  - `Cache`: 热点数据缓存
-  - `Session`: 会话状态
-  - **NO Leaderboard**（如适用）: 系统已移除所有排名相关的数据结构
-- **Milvus/Chroma**（如适用）: 向量数据库，存储知识库与长期记忆
-- **EventStore/Kafka**: 存储领域事件流
-
-#### 4.3.2 边缘端架构 (IoT - ESP32)（如适用）
-
-**Hardware**: {硬件型号，如ESP32-S3}
-
-**OS**: {操作系统，如FreeRTOS}
-
-**Modules**：
-- `NetMgr`: Wi-Fi/BLE 连接管理
-- `AudioPipeline`: ASR (语音转文字) -> Upload -> TTS (文字转语音) Playback
-- `MediaPlayer`: 负责流媒体内容播放 (HLS/MP3)
-- `CameraDriver`: 驱动摄像头，负责{功能描述}
-- `SensorMgr`: 采集传感器数据，并执行本地阈值报警逻辑
-- `GUIMgr`: {图形库}驱动屏幕 UI
-  - **动态主题**（如适用）: 根据配置加载不同主题资源包
-  - **护眼逻辑**（如适用）: {时间}后触发全局色彩过滤器
-- `FocusMgr`（如适用）: 专注管理模块
-  - **RestGuard**: 监控连续屏幕使用时长。触发阈值时，强制接管显示"休息倒计时"
-  - **Interrupt Arbiter (中断仲裁器)**: 边缘端核心安全组件。负责监听云端下发的强制休息或本地紧急呼叫信号。当收到高优先级中断信号时，强制挂起所有后台任务，抢占音频通道和屏幕显示权，确保防沉迷机制绝对执行
-- `AgentClient`（如适用）: 与云端 AI Gateway 保持长连接 (MQTT/WebSocket)
-- `LocalStorage`: 基于 NVS (Non-Volatile Storage) 和 SPIFFS/LittleFS 文件系统
-  - **分区管理 (Partition Table)**:
-    - **nvs**: 存储 Wi-Fi 配置、设备证书
-    - **otadata**: OTA 引导标志位
-    - **app0**: 工厂固件
-    - **app1**: OTA 升级固件
-    - **spiffs**: 存储离线音频、用户数据、缓存
-  - **存储限制**: `OfflineQueue` 仅允许存储结构化 JSON 数据，严禁存储音频/图片等二进制文件，防止溢出
-- `ProvisioningMgr`: 负责设备配网 (Wi-Fi Provisioning via BLE)
-- `OTAMgr`: 负责固件升级
-  - **安全策略**: 仅当电量 > 50% 或 (> 20% + 充电中) 时启动
-  - **回滚机制**: 采用 A/B 分区，升级失败自动回滚至旧版本
-- `SystemWatchdog`: 设备稳定性保障
-  - **Task WDT**: 监控核心任务是否卡死，超时自动重启
-  - **High Priority WDT**: 独立监控关键组件的心跳，一旦发现无响应，立即触发系统重启
-  - **Panic Handler**: 捕获系统崩溃，将堆栈信息写入 Flash，下次联网时上传云端分析
-
----
-
-## 5. 微服务架构 (Microservices Architecture)
-
-### 5.1 服务划分
-> 描述微服务划分
-
-**服务列表**：
-
-| 服务名称 | 服务描述 | 技术栈 | 主要职责 |
-| :--- | :--- | :--- | :--- |
-| cloud-gateway | API网关 | Spring Cloud Gateway | 路由转发、限流、鉴权 |
-| cloud-auth | 认证服务 | Spring Boot + JWT | 用户认证、授权、Token管理 |
-| cloud-mall | 商城服务 | Spring Boot + MyBatis-Plus | 商品管理、订单管理、门店管理 |
-| cloud-workorder | 工单服务 | Spring Boot + MyBatis-Plus | 工单管理、订单分配、服务管理 |
-| cloud-message | 消息服务 | Spring Boot | 消息推送、通知管理 |
-| cloud-pay | 支付服务 | Spring Boot | 支付处理、支付回调 |
-| cloud-weixin | 微信服务 | Spring Boot | 微信API封装、小程序管理 |
-
-### 5.2 服务依赖关系
-> 使用Mermaid图展示服务依赖关系
-
-```mermaid
-graph LR
-    Gateway[cloud-gateway] --> Auth[cloud-auth]
-    Gateway --> Mall[cloud-mall]
-    Gateway --> WorkOrder[cloud-workorder]
-    Gateway --> Message[cloud-message]
-    Gateway --> Pay[cloud-pay]
-    
-    Mall --> Auth
-    WorkOrder --> Auth
-    WorkOrder --> Mall
-    Message --> Auth
-    Pay --> Mall
-    Pay --> Mall
-```
-
-### 5.3 服务通信
-> 描述服务之间的通信方式
-
-**同步通信**：
-- **REST API**：使用HTTP协议，适用于实时性要求高的场景
-- **服务发现**：使用Nacos进行服务注册和发现
-- **负载均衡**：使用Ribbon进行客户端负载均衡
-
-**异步通信**：
-- **消息队列**：使用RocketMQ进行异步消息传递
-- **事件驱动**：使用领域事件进行服务解耦
-- **消息类型**：订单创建事件、订单完成事件、支付成功事件等
-
----
-
-## 6. 数据架构 (Data Architecture)
-
-### 6.1 数据库设计
-> 描述数据库设计
-
-**数据库划分**：
-
-| 数据库名称 | 数据库描述 | 主要表 | 服务 |
-| :--- | :--- | :--- | :--- |
-| qumall_mall | 商城数据库 | shop_info, order_info, goods_spu | cloud-mall |
-| qumall_upms | 用户权限数据库 | user_info, role_info, permission_info | cloud-auth |
-| work_order | 工单数据库 | work_order_info, work_order_item, worker_user | cloud-workorder |
-
-**数据库设计原则**：
-- **分库分表**：按业务领域分库，按数据量分表
-- **读写分离**：主从复制，读写分离
-- **数据一致性**：使用事务保证数据一致性
-- **数据备份**：定期备份，支持数据恢复
-
-### 6.2 缓存设计
-> 描述缓存设计
-
-**缓存策略**：
-- **本地缓存**：使用Caffeine进行本地缓存
-- **分布式缓存**：使用Redis进行分布式缓存
-- **缓存层级**：L1（本地缓存）→ L2（Redis缓存）→ L3（数据库）
-
-**缓存使用场景**：
-- **热点数据**：门店信息、商品信息、用户信息
-- **统计数据**：订单统计、数据统计
-- **会话数据**：用户Token、会话信息
-- **地理位置**：使用Redis GEO存储地理位置数据
-
-### 6.3 数据一致性
-
-**一致性策略**：
-- **强一致性**：使用数据库事务保证
-- **最终一致性**：使用消息队列保证
-- **分布式事务**：使用Seata进行分布式事务管理
-
-### 6.4 数据同步
-
-**多端同步**（如适用）：
-- **冲突策略**: Parent-Override (家长端优先) + ServerTimestamp (最后修改优先)
-- **离线队列**: 断网时数据写入本地队列，网络恢复后批量同步
-- **最终一致性**: 采用最终一致性策略，保证数据最终一致
-
-**时间同步**（如适用）：
-- **NTP**: 首选。联网自动同步 NTP 服务器
-- **App Sync**: 备选。当 App 连接设备热点时，强制将手机系统时间下发给设备 RTC
-- **Manual**: 兜底。允许用户在系统设置中手动校准时间
-
----
-
-## 7. 安全架构 (Security Architecture)
-
-### 7.1 认证授权
-> 描述认证授权方案
-
-**认证方案**：
-- **JWT Token**：使用JWT进行无状态认证
-- **Token刷新**：支持Token刷新机制
-- **多端登录**：支持多设备同时登录
-
-**授权方案**：
-- **RBAC**：基于角色的访问控制
-- **权限管理**：细粒度权限控制
-- **接口鉴权**：接口级别权限验证
-
-### 7.2 数据安全
-
-**数据加密**：
-- **敏感数据加密**: 用户的手机号、家庭住址、作业照片（OCR 源文件）等在数据库中采用加密算法（如国密 SM4）加密存储
-- **数据签名**: 关键业务数据（如支付订单、积分流水）使用签名算法（如国密 SM3）进行完整性校验签名
-
-**数据隔离**：
-- **租户级隔离**: 租户级隔离，确保 A 用户无法查询 B 用户数据
-- **家庭隔离**（如适用）: 所有业务接口都需要校验家庭ID，确保只能操作当前家庭的数据
-
-**最小权限**：
-- AI智能体（如适用）仅能访问当前用户的上下文信息，严禁跨用户数据透传
-
-### 7.3 访问控制
-
-**App/Web**：
-- **OAuth2.0 + JWT**: 使用OAuth2.0和JWT进行认证授权
-- **Sa-Token**（如适用）: 使用Sa-Token实现多端统一登录、RBAC权限控制
-
-**IoT Device**（如适用）：
-- **mTLS (双向认证)**: 确保设备身份合法，防止伪造设备接入
-- **Device Secret**: 每个设备出厂烧录唯一密钥
-- **黑名单机制 (Blacklist)**: 云端维护已挂失或存在安全风险的设备证书序列号列表，拒绝其接入
-
-**重置同步 (Reset Sync)**（如适用）：
-- **在线重置**: 设备发送解绑事件 -> 云端解绑 -> 设备执行本地数据擦除
-- **离线重置**: 设备本地擦除。下次配网连接时，云端检测到新会话，自动校验旧绑定状态
-
-### 7.3 儿童保护（如适用）
-
-**内容过滤**：
-- **输入侧**: 拦截儿童的不当言论
-- **输出侧**: LLM输出经过敏感词库 + 语义分类模型双重过滤，杜绝暴力、色情内容
-
-**防沉迷**：
-- **云端记录**: 云端记录设备使用时长，达到阈值（如连续对话 30分钟）强制进入"休息模式"
-- **边缘执行**（如适用）: 设备端确保防沉迷机制绝对执行，不可被应用层逻辑绕过
-- **游戏限制**（如适用）: 严格控制各类游戏的单日时长与冷却时间
-
----
-
-## 8. 部署架构 (Deployment Architecture)
-
-### 8.1 部署方案
-> 描述部署方案
-
-**部署架构图**：
-```mermaid
-graph TB
-    subgraph LB["负载均衡层"]
-        Nginx[Nginx<br/>负载均衡]
-    end
-    
-    subgraph App["应用层"]
-        Gateway1[Gateway实例1]
-        Gateway2[Gateway实例2]
-        Service1[Service实例1]
-        Service2[Service实例2]
-    end
-    
-    subgraph DB["数据层"]
-        MySQL_Master[(MySQL主库)]
-        MySQL_Slave[(MySQL从库)]
-        Redis_Cluster[Redis集群]
-    end
-    
-    Nginx --> Gateway1
-    Nginx --> Gateway2
-    Gateway1 --> Service1
-    Gateway1 --> Service2
-    Gateway2 --> Service1
-    Gateway2 --> Service2
-    
-    Service1 --> MySQL_Master
-    Service2 --> MySQL_Master
-    MySQL_Master --> MySQL_Slave
-    
-    Service1 --> Redis_Cluster
-    Service2 --> Redis_Cluster
-```
-
-### 8.2 容器化部署
-> 描述容器化部署方案
-
-**容器化方案**：
-- **Docker**：使用Docker进行容器化
-- **Kubernetes**：使用K8s进行容器编排
-- **服务发现**：使用K8s Service进行服务发现
-- **配置管理**：使用ConfigMap和Secret管理配置
-
-**部署流程**：
-1. 代码构建：使用CI/CD工具构建镜像
-2. 镜像推送：推送到镜像仓库
-3. 部署更新：使用K8s进行滚动更新
-4. 健康检查：自动健康检查和故障恢复
-
-### 8.3 高可用方案
-> 描述高可用方案
-
-**高可用策略**：
-- **多实例部署**：每个服务至少2个实例
-- **负载均衡**：使用Nginx进行负载均衡
-- **故障转移**：自动故障检测和转移
-- **数据备份**：定期数据备份，支持快速恢复
-
----
-
-## 9. 监控架构 (Monitoring Architecture)
-
-### 9.1 监控体系
-> 描述监控体系
-
-**监控层次**：
-1. **基础设施监控**：服务器CPU、内存、磁盘、网络
-2. **应用监控**：接口响应时间、错误率、QPS
-3. **业务监控**：订单量、用户活跃度、业务指标
-4. **日志监控**：错误日志、异常日志、业务日志
-
-### 9.2 监控工具
-> 列出使用的监控工具
-
-| 监控类型 | 工具 | 说明 |
-| :--- | :--- | :--- |
-| 系统监控 | Prometheus + Grafana | 系统指标监控和可视化 |
-| 应用监控 | SkyWalking / Zipkin | 分布式链路追踪 |
-| 日志监控 | ELK Stack | 日志收集、分析和可视化 |
-| 告警通知 | 钉钉/企业微信/邮件 | 告警通知 |
-
-### 9.3 告警规则
-> 定义告警规则
-
-**告警级别**：
-- **P0（紧急）**：服务不可用、数据库连接失败
-- **P1（重要）**：接口响应时间过长、错误率过高
-- **P2（一般）**：资源使用率过高、业务指标异常
-
-**告警方式**：
-- **P0**：立即电话通知 + 钉钉/企业微信通知
-- **P1**：钉钉/企业微信通知 + 邮件通知
-- **P2**：邮件通知
-
----
-
-## 10. 性能架构 (Performance Architecture)
-
-### 10.1 性能目标
-> 定义性能目标
-
-**性能指标**：
-- **接口响应时间**：P95 < 500ms，P99 < 1s
-- **系统吞吐量**：支持1000+ QPS
-- **并发用户数**：支持10000+ 并发用户
-- **数据库查询**：单表查询 < 100ms
-
-### 10.2 性能优化
-> 描述性能优化方案
-
-**前端优化**：
-- **代码压缩**：压缩JS、CSS文件
-- **资源缓存**：使用浏览器缓存、CDN缓存
-- **懒加载**：图片懒加载、路由懒加载
-- **代码分割**：按需加载代码
-
-**后端优化**：
-- **数据库优化**：添加索引、优化SQL、读写分离
-- **缓存优化**：使用Redis缓存热点数据
-- **接口优化**：减少接口调用次数、批量查询
-- **异步处理**：使用消息队列进行异步处理
-
-### 10.3 容量规划
-> 描述容量规划
-
-**容量评估**：
-- **用户规模**：预计用户数、并发用户数
-- **数据量**：预计数据量、数据增长趋势
-- **访问量**：预计访问量、峰值访问量
-
-**扩容方案**：
-- **水平扩容**：增加服务实例
-- **垂直扩容**：提升服务器配置
-- **数据库扩容**：分库分表、读写分离
-
----
-
-## 11. 扩展架构 (Scalability Architecture)
-
-### 11.1 水平扩展
-> 描述水平扩展方案
-
-**扩展策略**：
-- **无状态服务**：服务无状态，支持水平扩展
-- **负载均衡**：使用负载均衡分发请求
-- **服务发现**：自动服务发现和注册
-- **弹性伸缩**：根据负载自动扩缩容
-
-### 11.2 垂直扩展
-> 描述垂直扩展方案
-
-**扩展策略**：
-- **服务器升级**：提升CPU、内存、磁盘性能
-- **数据库优化**：优化数据库配置和查询
-- **缓存优化**：增加缓存容量和性能
-
-### 11.3 扩展性设计
-> 描述扩展性设计
-
-**设计原则**：
-- **模块化设计**：模块独立，易于扩展
-- **接口标准化**：接口标准化，易于集成
-- **配置外部化**：配置外部化，易于调整
-- **插件化设计**：支持插件化扩展
-
----
-
-## 12. 容错架构 (Fault Tolerance Architecture)
-
-### 12.1 容错策略
-> 描述容错策略
-
-**容错机制**：
-- **服务降级**：服务异常时降级处理
-- **熔断机制**：服务异常时熔断保护
-- **重试机制**：失败自动重试
-- **超时控制**：设置合理的超时时间
-
-### 12.2 故障恢复
-> 描述故障恢复方案
-
-**恢复策略**：
-- **自动恢复**：自动检测和恢复故障
-- **手动恢复**：手动介入恢复故障
-- **数据恢复**：从备份恢复数据
-- **服务恢复**：重启服务或切换备用服务
-
-### 12.3 灾难恢复
-> 描述灾难恢复方案
-
-**恢复方案**：
-- **数据备份**：定期数据备份
-- **异地备份**：异地数据备份
-- **灾难演练**：定期灾难演练
-- **恢复流程**：明确的恢复流程和责任人
-
----
-
-## 13. 关键技术方案 (Key Technical Solutions)
-
-### 13.1 IoT 通信协议（如适用）
-
-**控制指令 (Control)**：
-- **协议**: 使用 **MQTT** (Message Queuing Telemetry Transport)
-- **Topic**: 
-  - `device/{deviceId}/cmd` (云 -> 端)
-  - `device/{deviceId}/event` (端 -> 云)
-- **QoS**: 1 (至少送达一次)
-- **支持指令**（如适用）: `ThemePreview` (临时预览) 和 `ThemeApply` (确认应用)
-
-**音频流 (Audio)**：
-- **协议**: 使用 **WebSocket** 或 **HTTP Chunked**
-- **实时语音流传输**: 降低延迟
-
-### 13.2 AI 智能体工作流 (Agent Workflow)（如适用）
-
-1. **ASR**: 设备端录音 -> 上传云端 -> 转录为文本
-2. **Intent Recognition (意图识别)**:
-   - 判断是"指令"（如"定闹钟"）还是"闲聊"
-   - 如果是指令，分发给对应服务
-3. **RAG (检索增强)**:
-   - 如果是闲聊/辅导，将 Query 向量化
-   - 在向量数据库中检索相关知识及历史记忆
-4. **LLM Generation**:
-   - Prompt = System Prompt (人设) + History + Context (RAG) + Query
-   - **主题人设策略**（如适用）:
-     - **Explore Theme (探索版)**: System Prompt 注入特定角色，语态干练、幽默、逻辑清晰
-     - **Dream Theme (梦幻版)**: System Prompt 注入特定角色，语态温暖、治愈、细腻
-     - **Age Adaptive (分龄适配)**: 在主题基础上，叠加不同年龄段的词汇复杂度控制
-   - **状态感知**（如适用）: Prompt 中动态注入状态信息（如心情/亲密度）
-   - 调用大模型 API 生成回复
-5. **TTS**: 生成文本 -> 合成音频 -> 下发设备播放
-
-### 13.3 自动调度（如适用）
-
-**针对特定模式**，系统需支持基于时间的自动播放逻辑，而非等待用户指令。
-
-**架构实现**：
-- `ScheduleService` 维护规则（如 "08:00 播放起床歌"）
-- 使用 **Quartz/XXL-JOB** 定时触发
-- 触发后，向设备发送指令，设备端自动唤醒并播放，无需用户交互
-
-### 13.4 App 虚拟设备模式（如适用）
-
-**设计思想**: 在后端将"纯净模式 App"视为一个特殊的 `VirtualDevice`。
-
-**实现**：
-- 所有 `Device` 聚合根有一个 `type` 字段 (PHYSICAL / VIRTUAL)
-- 虚拟设备没有 MQTT 长连接，所有交互通过 HTTPS 请求直接触发
-- 复用相同的业务逻辑，确保业务一致性
-
-### 13.5 边缘计算与离线同步 (Edge Computing & Offline Sync)（如适用）
-
-**Local-First 策略**：
-- **配置下发**: 云端仅作为配置中心。用户修改计划后，配置同步至设备本地存储
-- **本地引擎**: 设备端运行轻量级调度器，依据本地配置触发任务
-  - **离线播放**（如适用）: 自动解析规则，优先播放本地 Cache 音频，无需云端指令触发
-- **主题同步**（如适用）: 用户在 App 切换主题后，配置同步至本地，下次唤醒时加载对应资源包
-
-**离线数据同步**：
-- **Write**: 断网时，事件写入本地 `OfflineQueue` (Ring Buffer, **容量至少 1000 条或 30 天**)
-- **Sync**: 网络恢复后，后台线程批量上传队列数据至云端
-
-**时间同步兜底 (Time Sync Fallback)**：
-- **NTP**: 首选。联网自动同步 NTP 服务器
-- **App Sync**: 备选。当 App 连接设备时，强制将手机系统时间下发给设备
-- **Manual**: 兜底。允许用户在系统设置中手动校准时间
-
-**状态同步**（如适用）：
-- 采用 **Event Sourcing** 机制
-- App 端互动 -> 发送事件 -> MQTT 推送至设备 -> 设备更新本地状态
-- 若设备离线，事件暂存云端 MQTT Session Queue，设备重连后自动拉取
-
-**冲突解决策略 (Conflict Resolution Policy)**：
-- **原则**: Event Time Priority (时间优先) + Cloud Delete Wins (云端删除优先)
-- **场景**: 若云端已删除某任务，设备端上传该任务的完成事件将被标记为 `Discarded` (无效)，并下发删除事件修正设备状态
-
-### 13.6 智能配网方案 (Smart Provisioning)（如适用）
-
-**首选方案**: 采用官方 **Wi-Fi Provisioning** 协议 (基于 BLE + Protobuf)
-- 流程: Discovery -> Connect -> Security (PoP) -> Config -> Apply
-
-**兜底方案 (Fallback)**：
-- **SoftAP 配网**: 当 BLE 失败时，设备开启热点。App 连接热点后通过 HTTP POST `/config` 下发 Wi-Fi 账号密码
-- **SmartConfig / 声波配网**: 作为最终备选，通过 UDP 广播或音频频谱编码传输 SSID 信息
-
-### 13.7 离线语音指令 (Offline Commands)（如适用）
-
-**场景**: 断网或弱网环境下，保障基础语音交互可用。
-
-**实现**: 基于本地离线词识别库
-
-**指令集 (Command Set)**：
-- **唤醒词**: "{唤醒词}"
-- **控制类**: "{控制指令列表}"
-- **任务类**: "{任务指令列表}"
-
-**反馈**: 本地 TTS 播放预置音频
-
-**时区管理 (Time Zone Management)**：
-- **存储**: 数据库统一使用 **UTC**
-- **计算**: `ScheduleService` 根据用户 `ZoneId` 计算本地触发时间
-- **同步**: 设备端通过 NTP 同步 UTC 时间，本地 Display 层根据配置的时区偏移量渲染时间
-
-**多语言支持 (I18n Support)**：
-- 引入 `I18nService`，管理 App 文案、TTS 语音包、LLM System Prompt 的多语言版本
-
-## 14. 技术架构细节 (Technical Architecture Details)
-
-### 14.1 API设计
-
-**RESTful API**：
-- **统一格式**: 使用RESTful风格设计API
-- **版本控制**: API支持版本控制 (如 `/api/v1/...`)
-- **统一响应**: 使用统一的响应格式
-
-**核心接口**（示例）：
-
-| 接口名称 | 调用方 | 核心参数 (Input) | 核心响应 (Output) | QPS要求 | RT要求 |
-| :--- | :--- | :--- | :--- | :--- | :--- |
-| {接口名称} | {调用方} | `{参数列表}` | `{响应字段}` | {QPS} | < {时间}ms |
-
-### 14.2 消息队列设计
-
-**消息队列选型**：
-- **RocketMQ**: 主要消息队列，支持事务消息
-- **Kafka**: 用于事件流处理
-
-**消息主题**：
-- `{topic.name}`: {主题描述}
-
-### 14.3 缓存设计
-
-**缓存策略**：
-- **Cache-Aside**: 采用Cache-Aside模式
-- **缓存更新**: 数据更新时，先更新数据库，再删除缓存
-- **缓存失效**: 设置合理的缓存过期时间
-
-**缓存层级**：
-- **L1缓存**: 本地缓存（如Caffeine）
-- **L2缓存**: 分布式缓存（Redis）
-
-### 14.4 安全设计
-
-**认证授权**：
-- **OAuth2.0**: 使用OAuth2.0进行认证
-- **JWT**: 使用JWT进行授权
-- **Sa-Token**（如适用）: 使用Sa-Token实现多端统一登录
-
-**数据加密**：
-- **传输加密**: 使用HTTPS/TLS进行传输加密
-- **存储加密**: 敏感数据使用加密算法（如SM4）加密存储
-- **数据签名**: 关键数据使用签名算法（如SM3）进行签名
-
----
-
-## 15. 部署设计 (Deployment Design)
-
-### 15.1 容器化部署
-
-**Docker镜像**：
-- 每个微服务构建独立的Docker镜像
-- 使用多阶段构建，减小镜像体积
-
-**Kubernetes部署**：
-- 使用K8s进行容器编排
-- 支持自动扩缩容
-- 支持滚动更新
-
-### 15.2 CI/CD流程
-
-**持续集成**：
-- **代码提交**: 代码提交后自动触发CI
-- **单元测试**: 自动运行单元测试
-- **代码检查**: 自动进行代码质量检查
-
-**持续部署**：
-- **自动构建**: 自动构建Docker镜像
-- **自动部署**: 自动部署到测试/生产环境
-- **回滚机制**: 支持快速回滚
-
----
-
-## 16. 监控设计 (Monitoring Design)
-
-### 16.1 应用监控
-
-**指标监控**：
-- **QPS**: 每秒请求数
-- **RT**: 响应时间
-- **错误率**: 错误请求比例
-- **资源使用**: CPU、内存、磁盘使用率
-
-**告警规则**：
-- **QPS异常**: QPS超过阈值告警
-- **RT异常**: RT超过阈值告警
-- **错误率异常**: 错误率超过阈值告警
-- **资源异常**: 资源使用率超过阈值告警
-
-### 16.2 业务监控
-
-**业务指标**：
-- **DAU/MAU**: 日活/月活用户数
-- **{业务指标1}**: {指标描述}
-- **{业务指标2}**: {指标描述}
-
----
-
-## 17. 性能设计 (Performance Design)
-
-### 17.1 性能优化
-
-**数据库优化**：
-- **索引优化**: 为常用查询字段建立索引
-- **SQL优化**: 优化慢查询SQL
-- **分库分表**: 根据数据量进行分库分表
-
-**缓存优化**：
-- **热点数据缓存**: 缓存热点数据，减少数据库压力
-- **缓存预热**: 系统启动时预热缓存
-
-**接口优化**：
-- **接口合并**: 合并多个接口调用
-- **异步处理**: 非关键路径异步处理
-- **批量处理**: 支持批量操作
-
-### 17.2 性能测试
-
-**压力测试**：
-- **QPS测试**: 测试系统最大QPS
-- **并发测试**: 测试系统最大并发数
-- **稳定性测试**: 长时间运行稳定性测试
-
----
-
-## 18. 可扩展性设计 (Scalability Design)
-
-### 18.1 水平扩展
-
-**服务扩展**：
-- **无状态设计**: 所有服务设计为无状态
-- **负载均衡**: 使用负载均衡器分发请求
-- **自动扩缩容**: 根据负载自动扩缩容
-
-**数据库扩展**：
-- **读写分离**: 主从复制，读写分离
-- **分库分表**: 根据数据量进行分库分表
-
-### 18.2 垂直扩展
-
-**硬件升级**：
-- **CPU升级**: 支持CPU升级
-- **内存升级**: 支持内存升级
-- **存储扩容**: 支持存储扩容
-
----
-
-## 19. 容错设计 (Fault Tolerance Design)
-
-### 19.1 容错机制
-
-**服务容错**：
-- **熔断**: 服务异常时自动熔断
-- **降级**: 非核心功能支持降级
-- **重试**: 支持自动重试
-
-**数据容错**：
-- **数据备份**: 定期数据备份
-- **数据恢复**: 支持数据恢复
-- **事务保证**: 使用分布式事务保证数据一致性
-
-### 19.2 故障恢复
-
-**自动恢复**：
-- **健康检查**: 服务健康检查，自动重启异常服务
-- **故障转移**: 主从切换，自动故障转移
-
-**人工干预**：
-- **告警通知**: 异常告警通知运维人员
-- **人工处理**: 支持人工介入处理
-
----
-
-## 20. 架构演进 (Architecture Evolution)
-
-### 20.1 版本历史
-
-| 版本 | 修改日期 | 修改内容 | 修改人 |
-| :--- | :--- | :--- | :--- |
-| V1.0 | {YYYY-MM-DD} | 初始版本 | {姓名} |
-
-### 20.2 未来演进方向
-
-**短期演进**（V1.1）：
-- {例如：优化AI智能体的响应速度}
-- {例如：增强边缘计算能力}
-- {例如：完善离线同步机制}
-
-**中期演进**（V1.2）：
-- {例如：引入更多AI能力}
-- {例如：扩展内容生态}
-- {例如：支持多语言国际化}
-
-**长期演进**（V2.0）：
-- {例如：引入硬件周边联动}
-- {例如：智能家居联动}
-- {例如：支持更多终端形态}
-
----
-
-## 21. 附录 (Appendix)
-
-### 21.1 技术栈选型
-
-本项目基于成熟的架构体系构建，充分复用底层基础设施与通用业务能力。
-
-**总体架构依赖**（如适用）：
-
-```mermaid
-graph TD
-    subgraph "User Terminals (用户终端层)"
-        SmartClock["{智能设备名称，如适用}"]
-        ParentApp["{移动端名称}"]
-        TeacherApp["{教师端名称，如适用}"]
-        WebAdmin["{管理后台名称}"]
-    end
-
-    subgraph "{应用层名称}"
-        UserService[{user-service}]
-        ScheduleService[{schedule-service}]
-        ContentService[{content-service}]
-        GamificationService[{gamification-service}]
-        PlatformService[{platform-service}]
-    end
-
-    subgraph "{基础中台名称，如适用}"
-        AuthModule["{auth模块}"]
-        OssModule["{oss模块}"]
-        MsgModule["{message模块}"]
-        PayModule["{pay模块}"]
-        WeixinModule["{weixin模块，如适用}"]
-        DingModule["{dingtalk模块，如适用}"]
-    end
-
-    subgraph "{微服务治理，如适用}"
-        Nacos["Nacos (注册/配置)"]
-        Sentinel["Sentinel (熔断限流)"]
-        Gateway["Spring Cloud Gateway"]
-        Feign["OpenFeign"]
-    end
-
-    subgraph "{技术底座，如适用}"
-        BootCore["{boot-core}"]
-        BootCmpt["{boot-cmpt-*}"]
-    end
-
-    %% 终端 -> 应用
-    SmartClock --> Gateway
-    ParentApp --> Gateway
-    TeacherApp --> Gateway
-    WebAdmin --> Gateway
-
-    %% 网关 -> 应用
-    Gateway --> UserService
-    Gateway --> ScheduleService
-    Gateway --> ContentService
-    Gateway --> GamificationService
-    Gateway --> PlatformService
-
-    %% 应用 -> 中台
-    UserService --> AuthModule
-    UserService --> WeixinModule
-    PlatformService --> DingModule
-    ContentService --> OssModule
-    GamificationService --> PayModule
-    ScheduleService --> MsgModule
-
-    %% 应用 -> 治理
-    UserService --> Nacos
-    ScheduleService --> Nacos
-    ContentService --> Nacos
-    GamificationService --> Nacos
-    PlatformService --> Nacos
-
-    %% 中台 -> 底座
-    AuthModule --> BootCore
-    OssModule --> BootCore
-```
-
-**详细技术选型表**：
-
-| 领域 | 选型组件 | 对应模块 | 说明 |
-| :--- | :--- | :--- | :--- |
-| **基础框架** | {框架名称} | `{模块名称}` | 提供 DDD 核心注解、CQRS 支持、统一异常处理 |
-| **微服务治理** | {治理组件} | `{模块名称}` | 集成 Nacos, Sentinel, Seata 等 Spring Cloud Alibaba 组件 |
-| **Web 容器** | Spring WebMVC | `{模块名称}` | 提供统一的 RestResult 封装与 GlobalExceptionHandler |
-| **身份认证** | Sa-Token + JWT | `{模块名称}` | 实现多端统一登录、RBAC 权限控制 |
-| **对象存储** | MinIO / Aliyun OSS | `{模块名称}` | 存储图片、语音文件、固件包等 |
-| **消息通知** | RabbitMQ / Kafka | `{模块名称}` | 统一发送短信、App 推送、微信模板消息 |
-| **支付中心** | WxPay / AliPay | `{模块名称}` | 处理会员订阅、支付业务 |
-| **定时任务** | Quartz / XXL-JOB | `{模块名称}` | 处理定时任务和计划 |
-| **第三方生态** | Wechat / DingTalk | `{模块名称}` | 处理小程序登录、第三方平台数据同步 |
-| **AI 服务** | Python / LangChain | (独立部署) | 通过 gRPC 与 Java 核心服务通信 |
-| **IoT 固件** | ESP-IDF | (C/C++) | 运行于硬件设备，通过 MQTT 接入 |
-
-### 21.2 质量保障与测试策略
-
-**测试分层**：
-- **Unit Test**: 核心领域模型 (Domain) 覆盖率需 > 80%
-- **Integration Test**: 重点覆盖微服务间契约 (Pact) 及分布式事务一致性
-- **HIL (Hardware-in-the-Loop)**（如适用）:
-  - 搭建自动化测试台架，模拟断网、弱网、电源波动、按键老化等场景
-  - **MQTT 压力测试**: 模拟百万级设备长连接与消息吞吐
-- **AI Eval**（如适用）:
-  - 构建 "Golden Dataset" (500+ 安全对话用例)
-  - 每次 Prompt 更新后自动回归，确保不输出有害内容
-
-**性能指标 (SLA)**：
-- **API 响应**: 核心业务 TP99 < 200ms
-- **AI 交互**（如适用）: 端到端延迟 (ASR+LLM+TTS) < 1.5s (首包)
-- **流量削峰**: 引入 **Jitter (随机抖动)** 机制 (0-60s)，避免早高峰惊群效应
-
-### 21.3 参考文档
-
-- [领域模型说明.md]({领域模型文档路径})
-- [PRD文档.md]({PRD文档路径})
-- [系统架构设计.md]({系统架构设计文档路径})
-- [COLA 5.0文档]({COLA文档链接})
-
-### 21.4 变更记录
-
-| 变更日期 | 变更内容 | 变更原因 | 变更人 |
-| :--- | :--- | :--- | :--- |
-| {YYYY-MM-DD} | {变更内容描述} | {变更原因} | {姓名} |
-
----
-
-**文档版本**：V1.0.0  
-**创建时间**：{YYYY-MM-DD}  
-**最后更新**：{YYYY-MM-DD}  
-**文档状态**：✅ 设计中 / ✅ 待评审 / ✅ 评审通过 / ✅ 已完成

skills/document-skills/README.md

@@ -0,0 +1,16 @@
+# document-skills
+
+文档与图表相关技能组。Marketplace 插件 `document-skills` 还引用 `docx` / `pptx` / `pdf` / `xlsx`（部分目录待补）。
+
+## 本组目录内技能（已存在 `SKILL.md`）
+
+| 技能 | 说明 |
+|------|------|
+| [api-doc-generator](api-doc-generator/) | API 文档生成 |
+| [doc-coauthoring](doc-coauthoring/) | 文档协作 |
+| [full-stack-doc](full-stack-doc/) | **产品文档库标准布局**（根 11 + 版本 7 + 模块 PRD/Stitch/UI）；模板见 `full-stack-doc/templates/` 下 `root/`、`version/`、`module/`、`delivery/` |
+| [mermaid](mermaid/) | Mermaid 图表 |
+| [plantuml](plantuml/) | PlantUML |
+| [processon-mindmap](processon-mindmap/) | ProcessOn 思维导图 |
+
+安装：`/plugin install document-skills@full-stack-skills`

skills/document-skills/full-stack-doc/SKILL.md

@@ -0,0 +1,298 @@
+---
+name: full-stack-doc
+description: >
+  Scaffolds, validates, and maintains PartMe/Octo-style product documentation
+  trees — 10 root-level docs, 7 per-version docs, and optional per-module
+  triplets (PRD / Stitch / UI) plus 5 delivery-phase docs. Provides ready-to-copy
+  Markdown templates with {Name}/{V} placeholders and inline authoring guidance.
+  Use when creating new product doc repositories, organizing partme-docs or Octo*
+  projects, auditing repo doc structures, or generating documentation scaffolding
+  — even if the user just says "set up docs", "create doc structure", "初始化文档",
+  "产品文档", or "写规划文档".
+metadata:
+  author: partme
+  version: "3.0"
+compatibility: Requires filesystem access for scaffolding and template copying.
+---
+
+# Product Documentation Standard (full-stack-doc v3.0)
+
+Enforces a fixed directory-and-naming convention for product documentation, aligned with the PartMe / Octo series. Ready-to-copy Markdown templates live under [`templates/`](templates/). Detailed file mappings and conventions in [`references/structure.md`](references/structure.md).
+
+---
+
+## 1. When to Use
+
+- Creating or initializing a product documentation repository
+- Scaffolding doc trees for Octo* or PartMe projects
+- Auditing or aligning existing repos against the PartMe doc standard
+- Generating / renaming docs to match the naming convention
+- Aligning `partme-docs/` content with the template structure
+- Writing or expanding any of the 10 root-level planning documents
+
+---
+
+## 2. Placeholders
+
+| Placeholder | Meaning | Example |
+|:---|:---|:---|
+| `{Name}` | Product / brand name | `OctoEcom`, `OpenMem` |
+| `{Name-Open}` | Open-source variant name (if dual-track) | `OpenEcom`, `OpenMem` |
+| `{V}` | Version directory name | `V1`, `V2` |
+| `{模块简称}` | Module short name | `登录页`, `设备中心` |
+| `{YYYY-MM-DD}` | Date placeholder | `2026-03-27` |
+| `{姓名}` | Author / reviewer name | `张三` |
+| `{组织}` | Organization name | `PartMe` |
+
+Replace placeholders in **both filenames and content**. Root keeps one `6、` file. The old `6、详细功能清单` has been merged into `10、功能菜单与版本规划`.
+
+---
+
+## 3. Document Architecture
+
+### 3.1 Four-Layer Structure
+
+```
+{产品名}/
+├── 1、{Name}-命名与品牌说明.md          ─┐
+├── 2、{Name}-术语表与词汇表.md          │
+├── 3、{Name}-市场与商业分析.md          │
+├── 4、{Name}-技术与可行性分析.md        │ Root (10) — 产品级，与版本无关
+├── 5、{Name}-技术方案与路线.md          │
+├── 6、{Name}-产品与版本规划.md          │
+├── 7、{Name}-领域模型设计.md            │
+├── 8、{Name}-系统架构设计.md            │
+├── 9、{Name}-视觉与交互DNA规范.md       │
+├── 10、{Name}-功能菜单与版本规划.md      ─┘
+│
+├── V1/                                   ─┐
+│   ├── 1、{Name}-需求调研文档-V1.md      │
+│   ├── 2、{Name}-需求分析文档-V1.md      │
+│   ├── 3、{Name}-系统架构设计-V1.md      │ Version (7) — 版本级实施文档
+│   ├── 4、{Name}-功能与界面规划-V1.md    │
+│   ├── 5、{Name}-PRD文档-V1.md           │
+│   ├── 6、{Name}-功能菜单与版本规划-V1.md│
+│   ├── 7、{Name}-UI设计说明-V1.md        │
+│   │                                     ─┘
+│   ├── 1、{模块A}/                       ─┐
+│   │   ├── {Name}-{模块A}-PRD-V1.md      │ Module (3) — 可选，按模块
+│   │   ├── {Name}-{模块A}-Stitch设计提示词.md │
+│   │   └── {Name}-{模块A}-UI设计说明-V1.md    ─┘
+│   └── ...
+│
+├── 其他/                                 ─┐
+│   ├── 1、技术细分模板.md                │
+│   ├── 2、功能提测模板.md                │ Delivery (5) — 可选，研发交付
+│   ├── 3、测试结果模板.md                │
+│   ├── 4、上线通知模板.md                │
+│   └── 5、项目运维模板.md                ─┘
+│
+├── 技术调研/                             ── 技术调研、协议分析（版本无关）
+└── assets/                               ── 图片、附件等
+```
+
+### 3.2 Scope Summary
+
+| Scope | Count | Templates | Naming Pattern |
+|:---|:---:|:---|:---|
+| Root | 10 | [`templates/root/`](templates/root/) | `{序号}、{Name}-{文档名}.md` |
+| Version (`{V}/`) | 7 | [`templates/version/`](templates/version/) | `{序号}、{Name}-{文档名}-{V}.md` |
+| Module (optional) | 3 per module | [`templates/module/`](templates/module/) | `{Name}-{模块简称}-{类型}-{V}.md` |
+| Delivery (optional) | 5 | [`templates/delivery/`](templates/delivery/) | Context-dependent |
+
+### 3.3 Root 10 Documents — Authoring Chain
+
+文档间存在严格的上下游依赖关系，编写时应按顺序递进：
+
+```mermaid
+flowchart LR
+    D1["1、命名与品牌"] --> D2["2、术语表"]
+    D2 --> D3["3、市场分析"]
+    D3 --> D4["4、可行性分析"]
+    D4 --> D5["5、技术方案"]
+    D5 --> D6["6、版本规划"]
+    D6 --> D7["7、领域模型"]
+    D7 --> D8["8、系统架构"]
+    D8 --> D9["9、视觉DNA"]
+    D6 --> D10["10、功能菜单"]
+    D9 --> D10
+```
+
+| 序号 | 文档 | 关键输入 | 关键输出 | 对标 Mermaid 类型 |
+|:---:|:---|:---|:---|:---|
+| 1 | 命名与品牌说明 | 产品愿景 | 品牌口径、边界 | `graph LR` (品牌关系) |
+| 2 | 术语表与词汇表 | Doc 1 品牌定位 | 统一语言 | 无（纯表格） |
+| 3 | 市场与商业分析 | Doc 1 定位 + 外部数据 | TAM/SAM/SOM、竞品、定价 | `quadrantChart` / `funnel` |
+| 4 | 技术与可行性分析 | Doc 3 机会 + Doc 5 初步选型 | 可行性结论、风险 | `flowchart` / `sequenceDiagram` |
+| 5 | 技术方案与路线 | Doc 4 结论 | 技术栈、ADR、里程碑 | `flowchart` / `gantt` |
+| 6 | 产品与版本规划 | Doc 3 商业 + Doc 5 路线 | 版本矩阵、定价、发布策略 | `graph` / `timeline` |
+| 7 | 领域模型设计 | Doc 2 术语 + Doc 6 功能边界 | 限界上下文、聚合、事件 | `classDiagram` / `graph TB` |
+| 8 | 系统架构设计 | Doc 5 技术栈 + Doc 7 领域 | 分层、数据流、部署 | `flowchart` / `sequenceDiagram` |
+| 9 | 视觉与交互DNA规范 | Doc 1 品牌气质 | 色彩、字体、组件、动效 | `flowchart` (页面骨架) |
+| 10 | 功能菜单与版本规划 | Doc 6 + Doc 8 + Doc 9 | 导航、路由、功能清单、优先级 | `mindmap` / `pie` / `flowchart` |
+
+---
+
+## 4. Scaffolding Workflow
+
+### Step 1 — Root Docs
+
+Copy all 10 files from `templates/root/` into the project root. Rename each replacing `{Name}`:
+
+```bash
+# Example: OctoEcom
+for f in templates/root/*.md; do
+  name=$(basename "$f" | sed 's/{Name}/OctoEcom/g')
+  cp "$f" "partme-docs/18、OctoEcom/$name"
+done
+```
+
+### Step 2 — Version Docs
+
+Create `{V}/` (e.g., `V1/`). Copy 7 files from `templates/version/`. Replace both `{Name}` and `{V}` in filenames and content.
+
+### Step 3 — Module Docs (optional)
+
+For each functional module, create `{V}/{序号}、{模块名}/`. Copy 3 files from `templates/module/`. Replace `{Name}`, `{模块简称}`, and `{V}`.
+
+Example (OctoEcom V1 商品采集):
+```
+V1/1、商品采集/
+├── OctoEcom-商品采集-PRD-V1.md
+├── OctoEcom-商品采集-Stitch设计提示词.md
+└── OctoEcom-商品采集-UI设计说明-V1.md
+```
+
+### Step 4 — Delivery Docs (optional)
+
+Copy `templates/delivery/` into `其他/` or a dedicated delivery folder. Replace `{Name}` and dates.
+
+### Step 5 — Special Directories
+
+Create `技术调研/` for tech research and `其他/` for non-standard docs. Directories like `demo/`, `assets/`, `.stitch/` stay untouched.
+
+### Step 6 — Validate
+
+Run the validation checklist (Section 7).
+
+---
+
+## 5. Quality Standards
+
+### 5.1 Content Depth Benchmarks
+
+Based on OctoEcom and OpenEcom production documents:
+
+| 文档 | 目标行数 | 最少 Mermaid | 最少表格 | 关键质量标志 |
+|:---|:---:|:---:|:---:|:---|
+| 1、命名与品牌 | 100–120 | 1 | 2 | 品牌关系图、Open/商业对照表 |
+| 2、术语表 | 100–160 | 0 | 8+ | 按层/域分类、中英对照、缩略词 |
+| 3、市场分析 | 160–220 | 1–3 | 10+ | TAM 数据源注释、SWOT 表、竞品矩阵 |
+| 4、可行性分析 | 180–230 | 2–3 | 10+ | 可行性评级图例、分层评估、风险总表 |
+| 5、技术方案 | 260–400 | 3–4 | 9+ | 代码示例、Gantt 路线、部署拓扑 |
+| 6、版本规划 | 200–340 | 2–3 | 5+ | 版本功能矩阵、定价表、发布策略 |
+| 7、领域模型 | 300–410 | 7–9 | 7+ | classDiagram 每聚合、事件表、仓储接口 |
+| 8、系统架构 | 400–510 | 7–14 | 9+ | 分层 subgraph、序列图、状态机 |
+| 9、视觉DNA | 250–300 | 0–1 | 12+ | ASCII 线框、CSS 变量、色值表 |
+| 10、功能菜单 | 400–560 | 3–5 | 20+ | mindmap 全景、功能枚举、优先级统计 |
+
+### 5.2 Universal Document Structure
+
+每份 root 文档 **必须** 包含以下标准结构：
+
+**文档头部**:
+```markdown
+# {Name} 文档标题
+
+> **文档说明**：一句话说明文档用途与范围。
+>
+> **版本**：V1.0.0
+> **最后更新**：{YYYY-MM-DD}
+```
+
+**文档尾部**:
+```markdown
+---
+
+**文档版本**：V1.0.0
+**创建日期**：{YYYY-MM-DD}
+**最后更新**：{YYYY-MM-DD}
+**文档状态**：✅ 待评审
+```
+
+### 5.3 Formatting Conventions
+
+| 元素 | 规范 |
+|:---|:---|
+| 章节编号 | `## N.` 顶级，`### N.M` 子级，层级不超过 3 层 |
+| 表格对齐 | 使用 `:---` 左对齐 |
+| 可行性评级 | ✅ 高可行 / ⚠️ 中可行 / 🔴 低可行 |
+| 优先级 | P0（必须）/ P1（重要）/ P2（期望）/ P3（可选） |
+| 版本标签 | 🆓 免费 / 👤 个人 / 👥 专业 / 🏢 企业 |
+| 状态标记 | ✅ 已实现 / 🔧 开发中 / ⏳ 计划中 / ❌ 不实现 |
+| Mermaid | 每图前后空行；diagram 类型应匹配内容（见 3.3 对标列） |
+| 代码块 | 标注语言（`typescript`/`go`/`bash`/`yaml`/`sql`） |
+| 中英混排 | 中文与英文/数字间加空格：`OpenAI 模型` |
+
+### 5.4 Cross-Reference Rules
+
+- Doc 3 关联文档必须链接 Doc 1（品牌边界）和 Doc 5（技术可行性）
+- Doc 5 Gantt 日期必须与 Doc 6 版本里程碑、Doc 10 发布节奏一致
+- Doc 7 聚合名称必须在 Doc 2 术语表中有定义
+- Doc 8 分层名称必须与 Doc 5 技术选型对应
+- Doc 10 功能列表的版本标注必须与 Doc 6 版本矩阵一致
+
+---
+
+## 6. Gotchas
+
+- Sequence numbers `1–7` in version folders are **reserved** for the 7 standard docs. Non-standard docs must use `8+` or go into `其他/`.
+- Root has **one** file numbered `6、` (产品与版本规划). Detailed feature lists are embedded in `10、功能菜单与版本规划`.
+- Don't reorganize special directories (`demo/`, `assets/`, `.stitch/`, `stitch_*`, `实施指南/`) unless the user explicitly requests it.
+- Delivery templates are optional and do **not** occupy root-level standard sequence numbers.
+- When a product has open-source + commercial dual-track (e.g., OpenEcom/OctoEcom), each track gets its own full 10-doc set with cross-references.
+
+---
+
+## 7. Validation Checklist
+
+```
+Doc Validation:
+- [ ] Root contains exactly 10 standard files (1–10)
+- [ ] Each file starts with H1 + blockquote doc description
+- [ ] Each file ends with version/date/status footer
+- [ ] ## section numbering is sequential (no gaps, no duplicates)
+- [ ] ### sub-sections use parent number prefix (e.g., ## 3 → ### 3.1)
+- [ ] Mermaid diagrams render without syntax errors
+- [ ] Cross-document references resolve to existing files
+- [ ] Timeline dates are consistent across Doc 3, 5, 6, 10
+- [ ] Terminology matches Doc 2 definitions
+- [ ] Version folder contains exactly 7 standard files with {V} suffix
+- [ ] Module folders have PRD / Stitch / UI triplet (if applicable)
+- [ ] 技术调研/ and 其他/ do not contain root-level standard docs
+- [ ] No sequence numbers 1–7 used for non-standard docs in version folders
+```
+
+---
+
+## 8. Template Inventory
+
+| Template | Location | Lines | Mermaid | Key Sections |
+|:---|:---|:---:|:---:|:---|
+| 命名与品牌说明 | `templates/root/1、命名与品牌说明.md` | ~120 | 1 | 品牌定位、命名由来、产品边界、核心公式、品牌家族 |
+| 术语表与词汇表 | `templates/root/2、术语表与词汇表.md` | ~150 | 0 | 文档信息、产品/架构/业务/平台/治理术语、缩略词 |
+| 市场与商业分析 | `templates/root/3、市场与商业分析.md` | ~220 | 3 | 市场机会、TAM/SAM/SOM、竞品矩阵、SWOT、商业模式、定价 |
+| 技术与可行性分析 | `templates/root/4、技术与可行性分析.md` | ~230 | 3 | 分层评估、安全合规、性能扩展、风险总表、结论 |
+| 技术方案与路线 | `templates/root/5、技术方案与路线.md` | ~300 | 4 | 技术选型、分层方案、ADR、分阶段路线、部署、监控 |
+| 产品与版本规划 | `templates/root/6、产品与版本规划.md` | ~240 | 3 | 产品定位、版本矩阵、路线图、定价、发布策略、成功指标 |
+| 领域模型设计 | `templates/root/7、领域模型设计.md` | ~350 | 9 | 战略设计、统一语言、聚合设计、领域事件、仓储接口 |
+| 系统架构设计 | `templates/root/8、系统架构设计.md` | ~400 | 8 | 分层架构、DDD/COLA、数据流、安全、部署、扩展机制 |
+| 视觉与交互DNA | `templates/root/9、视觉与交互DNA规范.md` | ~280 | 1 | 设计原则、色彩、字体、布局、组件、动效、暗色、无障碍 |
+| 功能菜单与版本规划 | `templates/root/10、功能菜单与版本规划.md` | ~450 | 5 | 全景、菜单结构、功能明细、版本分布、用户旅程、功能清单 |
+
+---
+
+## 9. Related Skills
+
+- [`documentation-builder`](../dev-utils-skills/documentation-builder): General doc writing and formatting conventions
+- [`api-doc-generator`](api-doc-generator): OpenAPI and API documentation generation

skills/document-skills/full-stack-doc/references/structure.md

@@ -0,0 +1,183 @@
+# Document Structure Reference
+
+Detailed file listings, naming conventions, cross-reference rules, and quality metrics for the PartMe/Octo documentation standard. This file is loaded on-demand when agents need exact filenames, mapping details, or validation rules.
+
+## Contents
+
+- [Root directory: 10 standard docs](#root-directory-10-standard-docs)
+- [Version directory: 7 standard docs](#version-directory-7-standard-docs)
+- [Module directory: 3 docs per module](#module-directory-3-docs-per-module)
+- [Delivery templates: 5 optional docs](#delivery-templates-5-optional-docs)
+- [Special directories](#special-directories)
+- [Cross-document dependency map](#cross-document-dependency-map)
+- [Mermaid diagram type guide](#mermaid-diagram-type-guide)
+- [Quality metrics by document](#quality-metrics-by-document)
+- [Legacy template mapping](#legacy-template-mapping)
+
+---
+
+## Root directory: 10 standard docs
+
+Path: `{项目根}/`
+
+| # | Filename | Template | Primary Concern |
+|:---:|:---|:---|:---|
+| 1 | `1、{Name}-命名与品牌说明.md` | [`templates/root/1、命名与品牌说明.md`](../templates/root/1、命名与品牌说明.md) | 品牌口径、命名、边界 |
+| 2 | `2、{Name}-术语表与词汇表.md` | [`templates/root/2、术语表与词汇表.md`](../templates/root/2、术语表与词汇表.md) | 统一语言、中英对照 |
+| 3 | `3、{Name}-市场与商业分析.md` | [`templates/root/3、市场与商业分析.md`](../templates/root/3、市场与商业分析.md) | 市场规模、竞品、商业模式 |
+| 4 | `4、{Name}-技术与可行性分析.md` | [`templates/root/4、技术与可行性分析.md`](../templates/root/4、技术与可行性分析.md) | 技术评估、风险、POC |
+| 5 | `5、{Name}-技术方案与路线.md` | [`templates/root/5、技术方案与路线.md`](../templates/root/5、技术方案与路线.md) | 技术选型、ADR、里程碑 |
+| 6 | `6、{Name}-产品与版本规划.md` | [`templates/root/6、产品与版本规划.md`](../templates/root/6、产品与版本规划.md) | 版本矩阵、定价、发布 |
+| 7 | `7、{Name}-领域模型设计.md` | [`templates/root/7、领域模型设计.md`](../templates/root/7、领域模型设计.md) | DDD 限界上下文、聚合 |
+| 8 | `8、{Name}-系统架构设计.md` | [`templates/root/8、系统架构设计.md`](../templates/root/8、系统架构设计.md) | 分层架构、部署、安全 |
+| 9 | `9、{Name}-视觉与交互DNA规范.md` | [`templates/root/9、视觉与交互DNA规范.md`](../templates/root/9、视觉与交互DNA规范.md) | 色彩、字体、组件、动效 |
+| 10 | `10、{Name}-功能菜单与版本规划.md` | [`templates/root/10、功能菜单与版本规划.md`](../templates/root/10、功能菜单与版本规划.md) | 导航、功能清单、优先级 |
+
+`10、{Name}-功能菜单与版本规划.md` includes the full detailed feature list section. The old standalone `6、{Name}-详细功能清单.md` has been merged.
+
+---
+
+## Version directory: 7 standard docs
+
+Path: `{项目根}/{V}/` (e.g., `V1/`, `V2/`)
+
+| # | Filename | Template | Primary Concern |
+|:---:|:---|:---|:---|
+| 1 | `1、{Name}-需求调研文档-{V}.md` | [`templates/version/1、需求调研文档.md`](../templates/version/1、需求调研文档.md) | 用户调研、场景分析 |
+| 2 | `2、{Name}-需求分析文档-{V}.md` | [`templates/version/2、需求分析文档.md`](../templates/version/2、需求分析文档.md) | 用户故事、功能规则 |
+| 3 | `3、{Name}-系统架构设计-{V}.md` | [`templates/version/3、系统架构设计.md`](../templates/version/3、系统架构设计.md) | 版本级架构细化 |
+| 4 | `4、{Name}-功能与界面规划-{V}.md` | [`templates/version/4、功能与界面规划.md`](../templates/version/4、功能与界面规划.md) | 模块划分、界面规划 |
+| 5 | `5、{Name}-PRD文档-{V}.md` | [`templates/version/5、PRD文档.md`](../templates/version/5、PRD文档.md) | 需求规格说明 |
+| 6 | `6、{Name}-功能菜单与版本规划-{V}.md` | [`templates/version/6、功能菜单与版本规划.md`](../templates/version/6、功能菜单与版本规划.md) | 版本级菜单与功能 |
+| 7 | `7、{Name}-UI设计说明-{V}.md` | [`templates/version/7、UI设计说明.md`](../templates/version/7、UI设计说明.md) | 页面、组件、动效说明 |
+
+Sequence numbers 1–7 are **reserved**. Non-standard docs in version folders must use `8+` or be placed in `其他/`.
+
+---
+
+## Module directory: 3 docs per module
+
+Path: `{项目根}/{V}/{序号}、{模块中文名}/`
+
+| File | Template | Purpose |
+|:---|:---|:---|
+| `{Name}-{模块简称}-PRD-{V}.md` | [`templates/module/模块-PRD.md`](../templates/module/模块-PRD.md) | 模块级产品需求文档 |
+| `{Name}-{模块简称}-Stitch设计提示词.md` | [`templates/module/模块-Stitch设计提示词.md`](../templates/module/模块-Stitch设计提示词.md) | AI 设计生成提示词 |
+| `{Name}-{模块简称}-UI设计说明-{V}.md` | [`templates/module/模块-UI设计说明.md`](../templates/module/模块-UI设计说明.md) | UI 页面说明与切图规范 |
+
+The Stitch file may omit the `-{V}` suffix per project convention.
+
+---
+
+## Delivery templates: 5 optional docs
+
+Located in [`templates/delivery/`](../templates/delivery/). These do **not** occupy root-level sequence numbers. Place deliverables in `其他/` or a dedicated delivery folder.
+
+| # | File | Original Legacy # | Purpose |
+|:---:|:---|:---:|:---|
+| 1 | `1、技术细分模板.md` | Legacy #10 | 技术栈、架构、工时、风险 |
+| 2 | `2、功能提测模板.md` | Legacy #11 | 提测范围、环境、部署 |
+| 3 | `3、测试结果模板.md` | Legacy #12 | 测试统计、问题、发布建议 |
+| 4 | `4、上线通知模板.md` | Legacy #13 | 上线范围、时间、回滚计划 |
+| 5 | `5、项目运维模板.md` | Legacy #14 | 部署、监控、故障、备份 |
+
+---
+
+## Special directories
+
+These directories follow their own conventions — do **not** reorganize unless the user explicitly requests it:
+
+| Directory | Purpose | Notes |
+|:---|:---|:---|
+| `技术调研/` | Tech research, feasibility studies, protocol analysis | 版本无关，可包含独立调研报告 |
+| `其他/` | Non-standard docs: task lists, gate checklists, benchmarks | 交付模板通常放在这里 |
+| `demo/`, `assets/`, `article/`, `article-cn/` | Project-specific content | 项目特有的示例、图片、文章 |
+| `archive/`, `.stitch/`, `stitch_*`, `实施指南/` | Tool-specific or historical | 不主动修改 |
+
+---
+
+## Cross-document dependency map
+
+文档间的引用关系（→ 表示「应引用」）：
+
+| Source | Must Reference | Reason |
+|:---|:---|:---|
+| Doc 2 术语表 | Doc 1 品牌 | 术语源于品牌定位 |
+| Doc 3 市场分析 | Doc 1 品牌, Doc 5 技术 | 市场机会需产品边界和技术约束 |
+| Doc 4 可行性 | Doc 3 市场, Doc 5 技术 | 评估技术是否匹配市场机会 |
+| Doc 5 技术方案 | Doc 4 可行性 | 方案基于可行性结论 |
+| Doc 6 版本规划 | Doc 3 商业, Doc 5 路线 | 版本节奏对齐商业与技术 |
+| Doc 7 领域模型 | Doc 2 术语, Doc 6 功能边界 | 聚合名称须在术语表中定义 |
+| Doc 8 系统架构 | Doc 5 技术栈, Doc 7 领域 | 架构承接技术选型与领域划分 |
+| Doc 9 视觉DNA | Doc 1 品牌气质 | 视觉语言源于品牌 |
+| Doc 10 功能菜单 | Doc 6, Doc 8, Doc 9 | 功能列表对齐版本、架构、UI |
+
+**关键一致性约束**：
+
+1. **时间线一致**：Doc 5 Gantt、Doc 6 版本路线图、Doc 10 发布节奏的日期必须对齐
+2. **术语一致**：Doc 7 聚合/实体名 → Doc 2 必须有定义 → Doc 8 组件名应匹配
+3. **版本一致**：Doc 6 版本功能矩阵 → Doc 10 功能列表的版本标注必须相同
+4. **技术栈一致**：Doc 5 技术选型 → Doc 8 分层架构 → Doc 4 可行性评估三者对应
+
+---
+
+## Mermaid diagram type guide
+
+每类文档推荐使用的 Mermaid 图表类型：
+
+| Document | Recommended Types | Example Usage |
+|:---|:---|:---|
+| 1、命名与品牌 | `graph LR` | 品牌家族关系图 |
+| 2、术语表 | (无) | 纯表格驱动 |
+| 3、市场分析 | `quadrantChart`, `funnel`, `flowchart` | 竞品象限、转化漏斗、价值链 |
+| 4、可行性分析 | `flowchart TD`, `sequenceDiagram` | 技术验证流程、集成序列 |
+| 5、技术方案 | `flowchart`, `gantt`, `erDiagram` | 架构拓扑、技术路线、RBAC ER 图 |
+| 6、版本规划 | `graph`, `timeline`, `flowchart` | 产品边界、版本时间线、升级漏斗 |
+| 7、领域模型 | `graph TB`, `classDiagram`, `sequenceDiagram` | 限界上下文、聚合类图、事件流 |
+| 8、系统架构 | `flowchart`, `sequenceDiagram`, `stateDiagram-v2` | 分层架构、数据流、状态机 |
+| 9、视觉DNA | `flowchart TD` | 页面骨架流、组件层级 |
+| 10、功能菜单 | `mindmap`, `flowchart`, `pie` | 功能全景、导航结构、优先级分布 |
+
+---
+
+## Quality metrics by document
+
+Based on OctoEcom and OpenEcom production examples:
+
+| Doc | Target Lines | Min Mermaid | Min Tables | Must-Have Sections |
+|:---:|:---:|:---:|:---:|:---|
+| 1 | 100–120 | 1 | 2 | 品牌定位、命名由来、产品边界、核心公式、品牌关系 |
+| 2 | 100–160 | 0 | 8 | 文档信息、产品/架构/业务术语、缩略词、使用规则 |
+| 3 | 160–220 | 1 | 10 | 市场机会、TAM/SAM/SOM、竞品矩阵、SWOT、商业模式 |
+| 4 | 180–230 | 2 | 10 | 分层评估（每层一节）、安全合规、风险总表、结论 |
+| 5 | 260–400 | 3 | 9 | 技术选型、分层方案、ADR、Gantt 路线、部署方案 |
+| 6 | 200–340 | 2 | 5 | 产品定位、版本矩阵、路线图、定价、发布策略 |
+| 7 | 300–410 | 7 | 7 | 限界上下文、聚合 classDiagram、事件表、仓储接口 |
+| 8 | 400–510 | 7 | 9 | 分层架构、DDD 映射、数据流、安全、部署架构 |
+| 9 | 250–300 | 0–1 | 12 | 设计原则、色彩、字体、布局、组件、动效、暗色、无障碍 |
+| 10 | 400–560 | 3 | 20 | 全景 mindmap、菜单枚举、功能清单、优先级统计 |
+
+---
+
+## Legacy template mapping
+
+The original 14-phase lifecycle templates have been merged into the current structure:
+
+| Legacy # | Legacy Name | Current Location |
+|:---:|:---|:---|
+| 1 | 市场分析模板 | → `root/3、市场与商业分析.md` |
+| 2 | 需求调研模板 | → `version/1、需求调研文档.md` |
+| 3 | 技术调研模板 | → `root/4、技术与可行性分析.md` + `root/5、技术方案与路线.md` |
+| 4 | 交互原型模板 | → `version/4、功能与界面规划.md` |
+| 5 | PRD 文档模板 | → `version/5、PRD文档.md` + `module/模块-PRD.md` |
+| 6 | 视觉规范模板 | → `root/9、视觉与交互DNA规范.md` |
+| 7 | UI 设计说明模板 | → `version/7、UI设计说明.md` + `module/模块-UI设计说明.md` |
+| 8 | 领域模型说明模板 | → `root/7、领域模型设计.md` |
+| 9 | 系统架构模板 | → `root/8、系统架构设计.md` + `version/3、系统架构设计.md` |
+| 10 | 技术细分模板 | → `delivery/1、技术细分模板.md` |
+| 11 | 功能提测模板 | → `delivery/2、功能提测模板.md` |
+| 12 | 测试结果模板 | → `delivery/3、测试结果模板.md` |
+| 13 | 上线通知模板 | → `delivery/4、上线通知模板.md` |
+| 14 | 项目运维模板 | → `delivery/5、项目运维模板.md` |
+
+The `templates/legacy-lifecycle/` and `templates/project-standard/` directories have been removed; all content lives in `templates/root/`, `templates/version/`, `templates/module/`, and `templates/delivery/`.

skills/document-skills/full-stack-doc/templates/README.md

@@ -0,0 +1,86 @@
+# Templates
+
+Ready-to-copy Markdown templates for the PartMe/Octo documentation standard.
+
+## Quick Start
+
+1. Copy templates from the appropriate directory
+2. Replace `{Name}` with the product name in **both filenames and content**
+3. Replace `{V}` with the version identifier (e.g., `V1`) for version-level docs
+4. Replace `{模块简称}` with the module short name for module-level docs
+5. Fill in `{YYYY-MM-DD}` dates, `{姓名}` author names, and other placeholders
+6. Follow the inline `{例如：...}` guidance to populate each section
+
+## Template Directories
+
+| Directory | Contents | Count | Description |
+|:---|:---|:---:|:---|
+| [`root/`](root/) | Root-level standard docs | 10 | 产品级规划文档，与版本无关 |
+| [`version/`](version/) | Per-version standard docs | 7 | 版本级实施文档，每个版本目录一套 |
+| [`module/`](module/) | Per-module PRD / Stitch / UI triplet | 3 | 可选，按功能模块细化 |
+| [`delivery/`](delivery/) | Tech details + delivery phase docs | 5 | 可选，研发交付阶段 |
+
+## Root Templates (10)
+
+Root 文档为产品级基线，覆盖从品牌到功能的完整规划链：
+
+| # | Template | Lines | Mermaid | Key Content |
+|:---:|:---|:---:|:---:|:---|
+| 1 | `1、命名与品牌说明.md` | ~120 | 1 | 品牌定位、命名规则、产品边界、品牌家族关系 |
+| 2 | `2、术语表与词汇表.md` | ~150 | 0 | 产品/架构/业务/平台术语、缩略词、使用规则 |
+| 3 | `3、市场与商业分析.md` | ~220 | 3 | 市场机会、TAM/SAM/SOM、竞品矩阵、SWOT、定价 |
+| 4 | `4、技术与可行性分析.md` | ~230 | 3 | 分层可行性、安全合规、性能评估、风险总表、结论 |
+| 5 | `5、技术方案与路线.md` | ~300 | 4 | 技术选型、分层方案、ADR、Gantt 路线、部署 |
+| 6 | `6、产品与版本规划.md` | ~240 | 3 | 产品定位、版本矩阵、路线图、定价、发布策略 |
+| 7 | `7、领域模型设计.md` | ~350 | 9 | 限界上下文、聚合 classDiagram、事件、仓储 |
+| 8 | `8、系统架构设计.md` | ~400 | 8 | 分层架构、DDD/COLA、数据流、安全、部署 |
+| 9 | `9、视觉与交互DNA规范.md` | ~280 | 1 | 设计原则、色彩、字体、布局、组件、动效、无障碍 |
+| 10 | `10、功能菜单与版本规划.md` | ~450 | 5 | 功能全景 mindmap、菜单枚举、功能清单、优先级统计 |
+
+## Version Templates (7)
+
+版本文档为某一具体版本（如 V1）的实施级细化：
+
+| # | Template | Description |
+|:---:|:---|:---|
+| 1 | `1、需求调研文档.md` | 用户调研、访谈、场景分析 |
+| 2 | `2、需求分析文档.md` | 用户故事、功能规则、验收标准 |
+| 3 | `3、系统架构设计.md` | 版本级架构细化、技术决策 |
+| 4 | `4、功能与界面规划.md` | 模块划分、界面规划 |
+| 5 | `5、PRD文档.md` | 版本级需求规格说明 |
+| 6 | `6、功能菜单与版本规划.md` | 版本级菜单与功能规划 |
+| 7 | `7、UI设计说明.md` | 页面结构、组件、动效、切图 |
+
+## Module Templates (3)
+
+模块文档为版本内某一功能模块的三件套：
+
+| Template | Description |
+|:---|:---|
+| `模块-PRD.md` | 模块级产品需求文档，含功能规则、数据、交互 |
+| `模块-Stitch设计提示词.md` | AI 设计生成提示词（英文） |
+| `模块-UI设计说明.md` | 页面结构、组件使用、动效、适配、切图 |
+
+## Delivery Templates (5)
+
+交付文档为研发过程中的阶段性输出：
+
+| # | Template | Description |
+|:---:|:---|:---|
+| 1 | `1、技术细分模板.md` | 技术栈、架构拆分、接口、数据库、工时、风险 |
+| 2 | `2、功能提测模板.md` | 提测范围、环境、功能清单、部署步骤 |
+| 3 | `3、测试结果模板.md` | 测试统计、问题汇总、发布建议 |
+| 4 | `4、上线通知模板.md` | 上线范围、时间窗口、回滚计划 |
+| 5 | `5、项目运维模板.md` | 部署架构、监控、故障处理、备份 |
+
+## Authoring Guidelines
+
+- **每份文档头部必须包含** H1 标题 + `>` blockquote 文档说明 + 版本号 + 日期
+- **每份文档尾部必须包含** 文档版本 / 创建日期 / 最后更新 / 文档状态
+- **章节编号严格递增**：`## 1.` → `## 2.` → ...；子节使用 `### N.M`
+- **表格使用 `:---` 左对齐**
+- **Mermaid 图前后保留空行**
+- **中英混排加空格**：`OpenAI 模型` 而非 `OpenAI模型`
+- **跨文档引用使用相对路径**：`[术语表](2、{Name}-术语表与词汇表.md)`
+
+See [`SKILL.md`](../SKILL.md) for the complete scaffolding workflow and quality standards. See [`references/structure.md`](../references/structure.md) for detailed file mappings and cross-document dependencies.

skills/dev-utils-skills/full-stack-doc/templates/10、技术细分模板.md → skills/document-skills/full-stack-doc/templates/delivery/1、技术细分模板.md

@@ -1,4 +1,6 @@
-# {产品名称} - 技术细分文档模板 V2.0
+---
+
+# {Name} - 技术细分文档模板 V2.0
 
 > **模板使用说明**：
 > 本模板旨在指导开发人员进行深度的技术方案设计。请在开发前详细填写，确保架构合理、逻辑清晰。

skills/dev-utils-skills/full-stack-doc/templates/11、功能提测模板.md → skills/document-skills/full-stack-doc/templates/delivery/2、功能提测模板.md

@@ -1,4 +1,8 @@
-# {产品名称} - 需求提测文档 V1.0
+> **标准说明**：本文件对应原全生命周期模板 **「11、功能提测」**；占位符统一为 `{Name}`。落地时建议放入交付流程或项目约定目录。
+
+---
+
+# {Name} - 需求提测文档 V1.0
 
 > **文档说明**：
 > - 本文档用于开发完成后向测试团队提测，明确测试范围、测试环境、测试重点等

skills/dev-utils-skills/full-stack-doc/templates/12、测试结果模板.md → skills/document-skills/full-stack-doc/templates/delivery/3、测试结果模板.md

@@ -1,4 +1,8 @@
-# {产品名称} - 测试结果文档 V1.0
+> **标准说明**：本文件对应原全生命周期模板 **「12、测试结果」**；占位符统一为 `{Name}`。落地时建议放入交付流程或项目约定目录。
+
+---
+
+# {Name} - 测试结果文档 V1.0
 
 > **文档说明**：
 > - 本文档用于记录测试结果，包括测试概况、测试结果、问题汇总等

skills/dev-utils-skills/full-stack-doc/templates/13、上线通知模板.md → skills/document-skills/full-stack-doc/templates/delivery/4、上线通知模板.md

@@ -1,4 +1,8 @@
-# {产品名称} - 上线通知 V1.0
+> **标准说明**：本文件对应原全生命周期模板 **「13、上线通知」**；占位符统一为 `{Name}`。落地时建议放入交付流程或项目约定目录。
+
+---
+
+# {Name} - 上线通知 V1.0
 
 > **文档说明**：
 > - 本文档用于通知相关人员产品上线信息
@@ -13,7 +17,7 @@
 ### 1.1 基本信息
 | 项目 | 内容 |
 | :--- | :--- |
-| 产品名称 | {产品名称} |
+| 产品名称 | {Name} |
 | 版本号 | {v1.0.0} |
 | 上线时间 | {YYYY-MM-DD HH:mm} |
 | 上线环境 | {生产环境} |
@@ -265,7 +269,7 @@
 
 **各位同事：**
 
-{产品名称} v1.0.0 版本将于 **{YYYY-MM-DD HH:mm}** 正式上线。
+{Name} v1.0.0 版本将于 **{YYYY-MM-DD HH:mm}** 正式上线。
 
 **上线内容**：
 - ✅ 首页模块（搜索、Banner）

skills/dev-utils-skills/full-stack-doc/templates/14、项目运维模板.md → skills/document-skills/full-stack-doc/templates/delivery/5、项目运维模板.md

@@ -1,4 +1,8 @@
-# {产品名称} - 项目运维文档 V1.0
+> **标准说明**：本文件对应原全生命周期模板 **「14、项目运维」**；占位符统一为 `{Name}`。落地时建议放入交付流程或项目约定目录。
+
+---
+
+# {Name} - 项目运维文档 V1.0
 
 > **文档说明**：
 > - 本文档用于记录项目的运维信息，包括部署、监控、故障处理等
@@ -31,7 +35,7 @@
 
 | 项目 | 内容 |
 | :--- | :--- |
-| 项目名称 | {产品名称} |
+| 项目名称 | {Name} |
 | 项目类型 | {管理后台 / 移动端 / 全栈项目} |
 | 技术栈 | {前端技术栈 / 后端技术栈} |
 | 部署环境 | {开发环境 / 测试环境 / 预发环境 / 生产环境} |

skills/document-skills/full-stack-doc/templates/module/模块-PRD.md

@@ -0,0 +1,1112 @@
+> **标准说明**：以下为 原「PRD」阶段模板全文 **全文**嵌入；文件名建议 `{Name}-{模块简称}-PRD-{V}.md`。模块范围写在 §2.3「产品范围」并缩小到本菜单。
+
+---
+
+# {Name}-{模块简称}-PRD（{V}）
+
+> **文档说明**：
+> - 本文档用于描述产品功能需求，是产品设计、开发、测试的重要依据
+> - `{}` 包裹的内容为占位符，请替换为实际内容
+> - 引用块 `>` 中的文字为填写指导，填写后可删除
+> - 本文档应与技术细分文档、UI设计稿、原型图等配套使用
+
+---
+
+## 1. 文档信息 (Document Info)
+
+### 1.1 版本记录
+| 版本号 | 修改日期 | 修改人 | 修改内容 | 备注 |
+| :--- | :--- | :--- | :--- | :--- |
+| V1.0.0 | {YYYY-MM-DD} | {姓名} | 初始版本 | 对应技术文档 V1.0.0 |
+
+### 1.2 文档责任人
+| 角色 | 姓名 | 职责 |
+| :--- | :--- | :--- |
+| 产品经理 | {姓名} | 需求输出、需求评审、验收标准制定 |
+| UI设计师 | {姓名} | 界面设计、交互设计、原型输出 |
+| 技术负责人 | {姓名} | 技术方案评审、技术可行性评估 |
+| 测试负责人 | {姓名} | 测试用例编写、验收测试 |
+
+### 1.3 关联文档
+| 文档类型 | 文档名称 | 版本 | 说明 |
+| :--- | :--- | :--- | :--- |
+| 技术文档 | {Name}-技术细分文档.md | V1.0.0 | 技术实现方案 |
+| UI设计稿 | {Name}-UI设计稿 | V1.0 | Figma/Sketch设计文件 |
+| 原型图 | {Name}-原型图 | V1.0 | 交互原型文件 |
+| 数据库设计 | {Name}-数据库设计.md | V1.0 | 表结构设计文档 |
+
+---
+
+## 2. 产品概述 (Product Overview)
+
+### 2.1 产品定位
+> 简要描述产品的定位、目标用户、核心价值
+
+**产品定位**：{例如：面向门店老板和师傅的XXX应用，帮助门店高效管理订单、师傅、客户等业务}
+
+**目标用户**：
+- **主要用户**：{例如：门店老板、工作人员}
+- **次要用户**：{例如：师傅、运营人员}
+
+**核心价值**：
+1. {例如：提升订单处理效率，减少人工操作}
+2. {例如：实时掌握门店运营数据，辅助决策}
+3. {例如：优化师傅工作流程，提升服务质量}
+
+### 2.2 产品目标
+> 明确本次迭代要达成的业务目标
+
+**业务目标**：
+- {例如：提升订单处理效率30%}
+- {例如：减少订单遗漏率至5%以下}
+- {例如：提升师傅接单率至80%以上}
+
+**用户目标**：
+- {例如：门店老板能够快速查看和处理订单}
+- {例如：师傅能够便捷抢单和上报服务进度}
+
+### 2.3 产品范围
+> 明确本次迭代包含和不包含的功能范围
+
+**本次迭代包含**：
+- {例如：工单模块（订单列表、订单详情、订单操作）}
+- {例如：我的模块（门店信息、数据统计、待办事项）}
+- {例如：首页模块（搜索、Banner）}
+
+**本次迭代不包含**（后续迭代）：
+- {例如：数据报表详细分析}
+- {例如：客户管理模块}
+- {例如：商品管理模块}
+
+---
+
+## 3. 用户角色与场景 (User Roles & Scenarios)
+
+### 3.1 用户角色定义
+> 明确不同用户角色的权限、职责、使用场景
+
+| 角色名称 | 角色描述 | 权限范围 | 典型使用场景 |
+| :--- | :--- | :--- | :--- |
+| {门店老板} | {拥有门店管理权限，可查看门店所有数据} | {可查看门店所有订单、数据统计、可指派师傅、转派订单} | {每日查看工单，处理待接单订单，指派师傅} |
+| {工作人员} | {门店普通员工，权限受限} | {可查看门店订单，但不可进行指派、转派等操作} | {查看订单列表，联系客户} |
+| {师傅} | {提供上门服务的师傅} | {可查看新工单、抢单、上报到达、开始服务} | {抢单、上报到达、开始服务、完成服务} |
+
+### 3.2 用户使用场景
+> 描述典型用户的使用场景，帮助理解需求背景
+
+**场景1：门店老板处理待接单订单**
+- **用户**：门店老板
+- **时间**：每天上午9:00
+- **场景描述**：
+  1. 打开XXX应用，进入工单
+  2. 查看"待接单"Tab，发现有5个新订单
+  3. 点击订单卡片，查看订单详情（客户信息、服务地址、服务时间）
+  4. 点击"指派师傅"按钮，选择可用师傅
+  5. 指派成功后，订单状态更新为"待服务"
+
+**场景2：师傅抢单**
+- **用户**：师傅
+- **时间**：每天上午10:00
+- **场景描述**：
+  1. 打开XXX应用，进入工单
+  2. 查看"新工单"Tab，看到附近有3个可抢订单
+  3. 查看订单距离（距您2.5km），选择距离最近的订单
+  4. 点击"抢单"按钮，确认抢单
+  5. 抢单成功后，订单状态更新为"待服务"
+
+---
+
+## 4. 功能需求 (Functional Requirements)
+
+### 4.1 {模块名称 - 例如：首页模块}
+
+#### 4.1.1 {功能点名称 - 例如：搜索查询}
+
+**功能ID**：{例如：M-01}  
+**功能名称**：{例如：搜索查询}  
+**功能描述**：
+> 详细描述功能的作用、用户如何使用
+
+{例如：搜索框默认显示"全域用户运营课程"文案，用户点击搜索框后跳转到搜索结果页。搜索支持4种类型：1=课程；2=活动；3=文章；4=混合结果列表（默认）。}
+
+**用户故事**：
+> 使用"作为...我希望...以便..."的格式描述用户故事
+
+作为{门店老板}，我希望{能够快速搜索课程和活动}，以便{学习运营知识，提升门店经营能力}。
+
+**功能规则**：
+> 详细描述业务规则、数据规则、交互规则
+
+1. **搜索框显示规则**：
+   - 默认显示文案："全域用户运营课程"
+   - 搜索框为只读状态，不可直接输入
+   - 点击搜索框跳转到搜索结果页
+
+2. **搜索结果规则**：
+   - 支持4种搜索类型：课程、活动、文章、混合结果列表
+   - 默认显示混合结果列表
+   - 搜索结果按相关性排序
+   - 支持分页加载，每页20条
+
+3. **交互规则**：
+   - 点击搜索框：跳转到搜索结果页
+   - 搜索结果页支持Tab切换（课程/活动/文章/全部）
+   - 支持下拉刷新、上拉加载更多
+
+**数据来源**：
+> 明确数据来源、数据表、字段映射
+
+- **搜索服务**：调用搜索服务接口，传入关键词和类型参数
+- **数据表**：`tp_child_lesson`（课程表）、`tp_activity`（活动表）、`tp_article`（文章表）
+- **字段映射**：
+  - 课程标题：`tp_child_lesson.name`
+  - 课程图片：`tp_child_lesson.info`（多个OSS链接用逗号拼接，取第一个）
+
+**异常处理**：
+> 描述异常情况的处理方式
+
+- **网络异常**：显示"网络异常，请稍后重试"提示，支持重试
+- **无搜索结果**：显示"暂无搜索结果"空状态
+- **搜索关键词为空**：显示默认推荐内容
+
+> **【交互布局规范】**
+> *   **布局**: {例如：顶部搜索框 + 内容区域}
+> *   **尺寸**:
+>     *   **搜索框高度**: `40px`
+>     *   **搜索框圆角**: `20px`（高度的一半，形成胶囊形状）
+>     *   **搜索图标**: `16px`，颜色 `#999999`，左侧内边距 `16px`
+> *   **交互**:
+>     *   **点击搜索框**: 跳转到搜索结果页
+>     *   **搜索框为只读状态**: 不可直接输入
+
+**验收标准**：
+> 明确功能验收的标准，便于测试和验收
+
+1. ✅ 搜索框默认显示"全域用户运营课程"文案
+2. ✅ 点击搜索框能够跳转到搜索结果页
+3. ✅ 搜索结果页支持Tab切换，能够正确显示不同类型的结果
+4. ✅ 搜索结果支持分页加载，下拉刷新、上拉加载更多功能正常
+5. ✅ 网络异常时能够正确提示，支持重试
+6. ✅ 无搜索结果时显示空状态
+
+---
+
+#### 4.1.2 {功能点名称 - 例如：Banner配置}
+
+**功能描述**：
+{例如：首页主Banner支持后台配置，包含图片URL和跳转URL。支持多张Banner轮播，点击Banner跳转到配置的URL。}
+
+**用户故事**：
+作为{门店老板}，我希望{能够在首页看到运营活动Banner}，以便{了解最新活动和优惠信息}。
+
+**功能规则**：
+1. **Banner显示规则**：
+   - Banner图片由后台配置，支持上传多张
+   - Banner支持自动轮播，轮播间隔3秒
+   - Banner支持左右滑动切换
+   - Banner底部显示指示器（小圆点），当前Banner高亮
+
+2. **Banner跳转规则**：
+   - 点击Banner跳转到配置的URL
+   - 跳转类型包括：
+     - 内部页面：使用`uni.navigateTo`跳转
+     - 外部链接：跳转WebView页面
+     - 小程序ID：使用`uni.navigateToMiniProgram`跳转
+
+3. **Banner配置规则**：
+   - 后台可配置Banner图片URL、跳转URL、跳转类型
+   - 后台可配置Banner显示顺序
+   - 后台可配置Banner是否启用
+
+**数据来源**：
+- **接口**：`GET /mall/home/banner`
+- **数据表**：`mall_banner`（Banner配置表）
+- **字段映射**：
+  - Banner图片：`mall_banner.image_url`
+  - 跳转URL：`mall_banner.jump_url`
+  - 跳转类型：`mall_banner.jump_type`（1=内部页面，2=外部链接，3=小程序ID）
+  - 显示顺序：`mall_banner.sort_order`
+
+**异常处理**：
+- **Banner图片加载失败**：显示默认占位图
+- **无Banner配置**：不显示Banner区域
+- **跳转URL无效**：提示"链接无效"
+
+**验收标准**：
+1. ✅ Banner能够正确显示后台配置的图片
+2. ✅ Banner支持自动轮播，轮播间隔3秒
+3. ✅ Banner支持左右滑动切换
+4. ✅ Banner底部指示器正确显示，当前Banner高亮
+5. ✅ 点击Banner能够正确跳转到配置的URL
+6. ✅ Banner图片加载失败时显示占位图
+
+---
+
+### 4.2 {模块名称 - 例如：工单模块}
+
+#### 4.2.1 {功能点名称 - 例如：订单列表}
+
+**功能描述**：
+{例如：工单支持多状态Tab导航，展示订单列表。订单状态包括：待接单、待服务、待上门、服务中、待转派。每个Tab显示对应状态的订单数量，点击Tab切换订单列表。}
+
+**用户故事**：
+作为{门店老板}，我希望{能够快速查看不同状态的订单}，以便{及时处理待处理的订单}。
+
+**功能规则**：
+1. **Tab导航规则**：
+   - Tab显示：待接单、待服务、待上门、服务中、待转派
+   - 每个Tab显示订单数量，格式："待接单(10)"
+   - 当前选中Tab字体高亮+蓝色，未选中为默认灰色
+   - 点击Tab切换下方订单列表数据
+   - 订单数量实时更新
+
+2. **订单卡片显示规则**：
+   - **订单类型标签**：仅展示"上门订单"和"服务订单"
+   - **商品封面图**：取`work_order_item.pic_url`，图片固定展示尺寸根据UI定，若上传图片不符合尺寸要求，则根据比例做自适应适配
+   - **服务名称**：取`work_order_item.goods_name`，显示完整名称，超出部分换行显示
+   - **订单金额**：取`work_order_item.payment_price`，当前订单的实付金额
+   - **订单状态**：显示当前订单状态（待接单/待服务/待上门/服务中/待转派）
+   - **客户姓名**：取`work_order_info.user_name`，全量展示
+   - **联系方式**：取`work_order_info.phone`，全量展示
+   - **服务时长**：显示单位为分钟，后台有功能但数据库没找到对应的字段（需确认）
+   - **服务时间**：取`work_order_info.appointment_date + appointment_time`，格式化显示：
+     - 当服务日期是【今天】：文案展示为"今天 HH:mm–HH:mm"，如"今天 15:00–17:00"
+     - 当服务日期是【明天】：文案展示为"明天 HH:mm–HH:mm"，如"明天 09:00–11:00"
+     - 当服务日期不是今天/明天：展示"MM月dd日 HH:mm–HH:mm"，如"12月29日 15:00–17:00"
+     - 开始时间和结束时间均按24小时制展示，小时和分钟均补零（如 09:05）
+   - **服务地址**：多行展示，优先显示城市+区+详细地址。过长时自动换行，不做省略号
+   - **客户备注**：区块标题固定为"客户备注"，正文为完整备注内容；超过2行时默认折叠，尾部展示向下箭头（展开），点击展开查看全部，再次点击收起
+
+3. **列表交互规则**：
+   - 支持下拉刷新，刷新当前Tab的订单列表
+   - 支持上拉加载更多，每页10-20条
+   - 点击订单卡片跳转到订单详情页
+   - 订单状态数量实时更新（每30秒轮询一次或使用WebSocket推送）
+
+**数据来源**：
+- **接口**：`GET /workorder/workOrder/page?shopId=xxx&status=xxx&page=1&size=10`
+- **数据表**：
+  - `work_order_info`（工单主表）
+  - `work_order_item`（工单明细表）
+- **字段映射**：
+  - 订单ID：`work_order_info.id`
+  - 订单状态：`work_order_info.status`
+  - 客户姓名：`work_order_info.user_name`
+  - 联系方式：`work_order_info.phone`
+  - 服务时间：`work_order_info.appointment_date + appointment_time`
+  - 服务地址：`work_order_info.service_address`
+  - 客户备注：`work_order_info.customer_remark`
+  - 商品名称：`work_order_item.goods_name`
+  - 商品图片：`work_order_item.pic_url`
+  - 订单金额：`work_order_item.payment_price`
+
+**异常处理**：
+- **网络异常**：显示"网络异常，请稍后重试"提示，支持下拉刷新重试
+- **无订单数据**：显示"暂无订单"空状态
+- **订单数据加载失败**：显示"加载失败，请重试"提示，支持重试
+
+**验收标准**：
+1. ✅ Tab导航能够正确显示5个状态，每个Tab显示订单数量
+2. ✅ 当前选中Tab字体高亮+蓝色，未选中为默认灰色
+3. ✅ 点击Tab能够切换订单列表数据
+4. ✅ 订单卡片能够正确显示所有字段信息
+5. ✅ 服务时间能够正确格式化显示（今天/明天/其他日期）
+6. ✅ 客户备注超过2行时能够折叠/展开
+7. ✅ 支持下拉刷新、上拉加载更多
+8. ✅ 点击订单卡片能够跳转到订单详情页
+9. ✅ 订单状态数量能够实时更新
+
+---
+
+#### 4.2.2 {功能点名称 - 例如：订单详情}
+
+**功能描述**：
+{例如：订单详情页展示订单完整信息，包括服务信息、客户信息、师傅信息、订单信息、订单操作按钮等。}
+
+**用户故事**：
+作为{门店老板}，我希望{能够查看订单的详细信息}，以便{了解订单全貌，进行订单操作}。
+
+**功能规则**：
+1. **订单详情展示规则**：
+   - **服务信息**：服务名称、服务时长、服务时间、服务地址
+   - **客户信息**：客户姓名、联系方式、客户备注
+   - **师傅信息**（仅当已指派师傅时显示）：
+     - 接单师傅：取`worker_user.name`
+     - 联系师傅：取`worker_user.phone_mob`
+     - 当前等级：取`worker_user.level_id`，需要转换为等级名称显示（如"中级师傅"）
+     - 接单时间：前端统一展示为"MM月dd日 HH:mm"格式，例如：12月29日 15:02
+   - **订单信息**：
+     - 订单编号：取`work_order_info.order_no`，文本完整展示，不截断；点击【复制】按钮，复制成功toast"已复制"
+     - 订单收入：当前订单师傅预计总收入，含固定收入与上门费等合计，保留1位小数
+     - 收入说明文案：固定展示文案等运营那边确认后定（待定）
+     - 要求到达：默认比客户预计的上门时间早10分钟
+     - 客户期望到达：取`work_order_info.appointment_date + appointment_time`，展示用户下单时预定的服务开始–结束时间
+     - 阶段时间：抢单、到达、服务、完成，这几个时间以师傅实际点击提交为准，前端统一展示为"MM-dd HH:mm"格式，例如：12-29 15:02。未完成的阶段显示"--"
+
+2. **订单操作按钮规则**（根据订单状态显示不同按钮）：
+   - **待接单状态**：
+     - 【取消订单】按钮：点击需二次确认弹窗，确认后订单状态更新为已取消并从当前列表移除
+     - 【联系客户】按钮：点击直接调用系统拨号
+     - 【指派师傅】按钮：点击按钮进入指派弹窗，选择可用师傅后更新接单信息
+   - **待转派状态**：
+     - 【转派订单】按钮：点击按钮触发师傅弹窗，完成后当前师傅信息更新为新师傅，并记录转派时间
+   - **待上门状态**：
+     - 底部整条按钮展示为「X分钟后开始」（倒计时），或「已到预约时间，尽快上门」（已超时）
+     - 按钮为禁用态，仅做提示，无点击事件
+   - **服务中状态**：
+     - 展示距离服务结束的倒计时，实时按本地时间刷新
+     - 显示"剩余X分钟"或"已超时X分钟"
+
+3. **倒计时功能规则**：
+   - **待上门倒计时**：
+     - 当前时间 < expected_arrive_time：底部整条按钮展示为「X分钟后开始」，用分钟倒计时，实时刷新
+     - 当当前时间 ≥ expected_arrive_time 且 service_start_time 为空：底部按钮文案切换为「已到预约时间，尽快上门」，不再显示倒计时
+     - 进入详情页时按当前时间重新计算剩余时间；若停留在该页面，文案每分钟自动更新一次
+   - **服务中倒计时**：
+     - 根据服务时长字段（单位：分钟，如120分钟）计算本次服务计划结束时间：计划结束时间 = 服务开始时间 + 服务时长
+     - 当前时间 < 计划结束时间时，展示"剩余X分钟"
+     - 当前时间 ≥ 计划结束时间且师傅未点击"结束服务"时，展示"已超时X分钟"
+   - **倒计时计算规则**：
+     - 不依赖`setInterval`递减，而是依赖**系统时间差**
+     - 在`onShow`时强制重算，防止后台挂起导致计时偏差
+
+**数据来源**：
+- **接口**：`GET /workorder/workOrder/{orderId}`
+- **数据表**：
+  - `work_order_info`（工单主表）
+  - `work_order_item`（工单明细表）
+  - `worker_user`（师傅表）
+- **字段映射**：
+  - 订单编号：`work_order_info.order_no`
+  - 订单收入：`work_order_info.payment_price`（需计算固定收入+上门费）
+  - 要求到达：`work_order_info.expected_arrive_time`（如果不存在，需计算：appointment_time - 10分钟）
+  - 客户期望到达：`work_order_info.appointment_date + appointment_time`
+  - 阶段时间：`work_order_info.accept_time`（抢单）、`work_order_info.arrive_time`（到达）、`work_order_info.service_start_time`（服务）、`work_order_info.service_end_time`（完成）
+  - 师傅姓名：`worker_user.name`
+  - 师傅电话：`worker_user.phone_mob`（注意：不是`phone`字段）
+  - 师傅等级：`worker_user.level_id`（需要转换为等级名称）
+
+**异常处理**：
+- **订单不存在**：提示"订单不存在"，返回上一页
+- **订单数据加载失败**：显示"加载失败，请重试"提示，支持重试
+- **倒计时计算异常**：显示"--"，不影响其他功能
+
+**验收标准**：
+1. ✅ 订单详情页能够正确显示所有信息模块（服务信息、客户信息、师傅信息、订单信息）
+2. ✅ 订单编号能够正确显示，点击复制按钮能够复制成功并提示
+3. ✅ 阶段时间能够正确格式化显示，未完成的阶段显示"--"
+4. ✅ 根据订单状态能够正确显示不同的操作按钮
+5. ✅ 待上门倒计时能够正确计算和显示，每分钟自动更新
+6. ✅ 服务中倒计时能够正确计算和显示，实时刷新
+7. ✅ 倒计时在`onShow`时能够强制重算，防止后台挂起导致计时偏差
+8. ✅ 点击操作按钮能够正确执行相应操作（取消订单、联系客户、指派师傅等）
+
+---
+
+### 4.3 {模块名称 - 例如：我的模块}
+
+#### 4.3.1 {功能点名称 - 例如：门店信息展示}
+
+**功能描述**：
+{例如：我的页面顶部展示门店信息，包括门店名称、身份标签、评分等。}
+
+**用户故事**：
+作为{门店老板}，我希望{能够查看门店基本信息}，以便{了解门店状态}。
+
+**功能规则**：
+1. **门店名称显示规则**：
+   - 当前登录门店/商户名称，与账号绑定的主门店名
+   - 最多14个汉字（暂定），超出以「…」截断
+   - 点击右侧小三角展开门店选择弹层
+
+2. **身份标签显示规则**：
+   - 枚举：门店老板、工作人员
+   - 看设计那边是做成一张图还是背景图
+
+3. **门店评分显示规则**：
+   - 显示历史总得分，0-5分，保留一位小数
+   - 无点击交互仅展示
+   - 计算方式：门店内师傅评分总和/师傅人数
+
+**数据来源**：
+- **接口**：`GET /mall/shop/info?shopId=xxx`
+- **数据表**：
+  - `shop_info`（门店信息表）
+  - `worker_user`（师傅表）
+- **字段映射**：
+  - 门店名称：`shop_info.shop_name`
+  - 身份标签：根据用户角色判断（门店老板/工作人员）
+  - 门店评分：计算`SUM(worker_user.score) / COUNT(worker_user.id)`，限制`worker_user.shop_id = shopId`且`worker_user.status = 可用`
+
+**异常处理**：
+- **门店信息加载失败**：显示"加载失败，请重试"提示
+- **评分计算异常**：显示"--"
+
+**验收标准**：
+1. ✅ 门店名称能够正确显示，超出14个汉字时以「…」截断
+2. ✅ 点击右侧小三角能够展开门店选择弹层
+3. ✅ 身份标签能够正确显示（门店老板/工作人员）
+4. ✅ 门店评分能够正确计算和显示，保留一位小数
+
+---
+
+### 4.4 核心接口需求 (Core API Requirements)
+> 汇总核心业务接口及其性能要求
+
+| 接口名称 | 调用方 | 核心参数 (Input) | 核心响应 (Output) | QPS要求 | RT要求 |
+| :--- | :--- | :--- | :--- | :--- | :--- |
+| **抢单接口** | App-Worker | `orderId`, `geoPoint` | `success`, `reason` | 1000 | < 200ms |
+| **订单列表** | App-Worker | `page`, `lat`, `lng` | `List<OrderCard>` | 500 | < 500ms |
+| **位置上报** | IoT-Device | `deviceId`, `gps` | `ack` | 2000 | < 100ms |
+
+---
+
+## 5. 非功能需求 (Non-Functional Requirements)
+
+### 5.1 性能需求
+> 明确性能指标要求
+
+- **页面加载时间**：
+  - 首页加载时间 < 2秒
+  - 订单列表加载时间 < 1秒
+  - 订单详情加载时间 < 500ms
+
+- **接口响应时间**：
+  - 订单列表查询：< 1秒
+  - 订单详情查询：< 500ms
+  - 数据统计查询：< 2秒（可考虑缓存）
+
+- **列表滚动性能**：
+  - 列表滚动流畅，60fps
+  - 支持分页加载，每页10-20条
+
+### 5.2 兼容性需求
+> 明确兼容性要求
+
+- **平台兼容**：
+  - XXX应用（iOS、Android）
+  - 支持微信版本：7.0+
+
+- **设备兼容**：
+  - iOS 12.0+
+  - Android 8.0+
+
+- **屏幕适配**：
+  - 支持不同屏幕尺寸（iPhone SE、iPhone 12、iPhone 14 Pro Max等）
+  - 支持横竖屏切换（如需要）
+
+### 5.3 安全性需求
+> 明确安全性要求
+
+- **数据安全**：
+  - 所有接口需要Token认证
+  - 敏感数据（如手机号）需要脱敏显示
+  - 订单操作需要权限校验
+
+- **多租户隔离**：
+  - 所有接口都需要校验`tenant_id`，确保数据隔离
+  - 门店隔离：所有业务接口都需要校验`shop_id`，确保只能操作当前门店的数据
+
+### 5.4 可用性需求
+> 明确可用性要求
+
+- **错误处理**：
+  - 网络异常时显示友好提示，支持重试
+  - 数据加载失败时显示空状态，支持重试
+  - 操作失败时显示明确错误提示
+
+- **空状态处理**：
+  - 所有列表页需封装空状态组件，区分"无网络"、"无数据"、"加载失败"三种状态
+
+- **降级方案**：
+  - 若用户拒绝定位权限，"距离优先"排序置灰或降级为默认排序
+  - 若门店坐标缺失，距离计算返回默认值或提示"距离未知"
+
+---
+
+## 6. 数据统计需求 (Data Statistics Requirements)
+
+### 6.1 数据指标定义
+> 明确需要统计的数据指标
+
+| 指标名称 | 指标定义 | 计算方式 | 数据来源 |
+| :--- | :--- | :--- | :--- |
+| 访客数 | 今日访问XXX应用或门店的UV数 | 统计今日访问XXX应用或门店的独立用户数 | `mall_visit_log`表 |
+| 成交单量 | 今日已支付订单数 | 统计`order_info`表下限制同一个`sale_shop_id`，且`order_type`为1,2,3,4,5的所有`is_pay`状态=1的订单数量 | `order_info`表 |
+| 成交金额 | 今日已支付订单的实收金额（不含退款） | 统计今日已支付订单的`payment_price`总和，单位元，保留2位小数 | `order_info`表 |
+| 待接单数 | 进入工单池但尚未被师傅接单的服务单数 | 统计`work_order_info`表中`status='待接单'`的订单数量 | `work_order_info`表 |
+| 待服务数 | 已接单但服务未开始的服务单数 | 统计`work_order_info`表中`status='待服务'`的订单数量 | `work_order_info`表 |
+| 服务中数 | 服务已开始尚未结束的服务单数 | 统计`work_order_info`表中`status='服务中'`的订单数量 | `work_order_info`表 |
+
+### 6.2 数据展示规则
+> 明确数据展示的格式和规则
+
+- **访客数**：
+  - 显示今日UV数
+  - 下行文案显示【昨日 X】
+  - 点击跳转"数据"页面
+
+- **成交单量**：
+  - 显示今日已支付订单数
+  - 下行文案显示【昨日 X】
+  - 点击跳转"数据"页面
+
+- **成交金额**：
+  - 今日已支付订单的实收金额（不含退款），单位元，保留2位小数
+  - 超10万时用【1.2万】格式
+  - 点击跳转"数据"页面
+
+### 6.3 数据更新频率
+> 明确数据更新的频率
+
+- **实时数据**：订单状态数量、待办事项数量（每30秒轮询一次或使用WebSocket推送）
+- **准实时数据**：访客数、成交单量、成交金额（每小时更新一次）
+- **历史数据**：昨日数据（每天凌晨更新）
+
+---
+
+## 7. 交互设计说明 (Interaction Design)
+
+### 7.1 页面跳转规则
+> 明确页面之间的跳转关系
+
+| 来源页面 | 触发操作 | 目标页面 | 跳转方式 | 传递参数 |
+| :--- | :--- | :--- | :--- | :--- |
+| 首页 | 点击搜索框 | 搜索结果页 | `uni.navigateTo` | `keyword`, `type` |
+| 首页 | 点击Banner | 配置的URL | `uni.navigateTo` / `uni.navigateToMiniProgram` | - |
+| 工单 | 点击订单卡片 | 订单详情页 | `uni.navigateTo` | `orderId` |
+| 我的页面 | 点击数据统计项 | 数据页面 | `uni.navigateTo` | `type` |
+| 我的页面 | 点击待办项 | 对应列表页 | `uni.navigateTo` | `status` |
+
+### 7.2 交互反馈规则
+> 明确用户操作的反馈方式
+
+- **点击反馈**：
+  - 按钮点击：显示点击态（颜色变化或阴影效果）
+  - 列表项点击：显示点击态，跳转页面
+
+- **加载反馈**：
+  - 页面加载：显示Loading动画
+  - 列表加载：显示下拉刷新动画、上拉加载动画
+  - 操作提交：显示Loading提示，防止重复提交
+
+- **成功反馈**：
+  - 操作成功：显示Toast提示（如"抢单成功"、"切换成功"）
+  - 数据更新：自动刷新页面或列表
+
+- **失败反馈**：
+  - 网络异常：显示Toast提示"网络异常，请稍后重试"，支持重试
+  - 操作失败：显示Toast提示具体错误信息
+  - 数据加载失败：显示空状态，支持重试
+
+### 7.3 弹窗交互规则
+> 明确弹窗的显示和关闭规则
+
+- **确认弹窗**：
+  - 取消订单：点击"取消订单"按钮，弹出二次确认弹窗，确认后执行操作
+  - 抢单确认：点击"抢单"按钮，弹出确认弹窗，确认后执行抢单操作
+
+- **选择弹窗**：
+  - 门店切换：点击门店名称或小三角，弹出门店选择弹层，选择后关闭弹层并刷新页面
+  - 指派师傅：点击"指派师傅"按钮，弹出师傅选择弹层，选择后关闭弹层并更新订单
+
+- **信息弹窗**：
+  - 订单详情：点击订单卡片，跳转到订单详情页（非弹窗）
+
+---
+
+## 8. 验收标准 (Acceptance Criteria)
+
+### 8.1 功能验收标准
+> 明确每个功能的验收标准，便于测试和验收
+
+**通用验收标准**：
+1. ✅ 所有功能按照需求文档实现，无遗漏
+2. ✅ 所有交互按照交互设计实现，体验流畅
+3. ✅ 所有数据按照数据统计需求正确计算和显示
+4. ✅ 所有异常情况按照异常处理规则正确处理
+5. ✅ 所有性能指标达到性能需求要求
+
+**模块验收标准**：
+- **首页模块**：
+  - ✅ 搜索框默认显示"全域用户运营课程"文案
+  - ✅ 点击搜索框能够跳转到搜索结果页
+  - ✅ Banner能够正确显示和轮播
+  - ✅ 点击Banner能够正确跳转
+
+- **工单模块**：
+  - ✅ Tab导航能够正确显示5个状态，每个Tab显示订单数量
+  - ✅ 订单列表能够正确显示所有字段
+  - ✅ 订单详情页能够正确显示所有信息
+  - ✅ 订单操作按钮能够正确执行操作
+  - ✅ 倒计时功能能够正确计算和显示
+
+- **我的模块**：
+  - ✅ 门店信息能够正确显示
+  - ✅ 数据统计能够正确计算和显示
+  - ✅ 待办事项能够正确统计和显示
+  - ✅ 门店切换功能能够正常工作
+
+### 8.2 测试验收标准
+> 明确测试验收的标准
+
+- **功能测试**：
+  - 所有功能点测试通过率100%
+  - 所有异常情况测试通过率100%
+
+- **兼容性测试**：
+  - iOS 12.0+ 测试通过
+  - Android 8.0+ 测试通过
+  - XXX应用7.0+ 测试通过
+
+- **性能测试**：
+  - 页面加载时间达到性能需求要求
+  - 接口响应时间达到性能需求要求
+  - 列表滚动性能达到60fps
+
+---
+
+## 9. 版本规划 (Version Planning)
+
+### 9.1 本次迭代范围
+> 明确本次迭代包含的功能范围
+
+**V1.0.0 版本包含**：
+- 首页模块（搜索、Banner）
+- 工单模块（订单列表、订单详情、订单操作、筛选排序、倒计时）
+- 我的模块（门店信息、数据统计、待办事项、课程列表、退出登录）
+
+### 9.2 后续迭代规划
+> 明确后续迭代的功能规划
+
+**V1.1.0 版本规划**（预计{YYYY-MM-DD}上线）：
+- 数据报表详细分析
+- 客户管理模块
+- 商品管理模块
+
+**V1.2.0 版本规划**（预计{YYYY-MM-DD}上线）：
+- 消息通知功能
+- 评价管理功能
+- 更多数据统计功能
+
+---
+
+## 10. 附录 (Appendix)
+
+### 10.1 术语表
+> 定义文档中使用的专业术语
+
+| 术语 | 定义 |
+| :--- | :--- |
+| UV | Unique Visitor，独立访客数 |
+| PV | Page View，页面浏览量 |
+| OSS | Object Storage Service，对象存储服务 |
+| SSE | Server-Sent Events，服务器推送事件 |
+| MQTT | Message Queuing Telemetry Transport，消息队列遥测传输协议 |
+| Redis GEO | Redis地理位置数据结构，用于存储和查询地理位置信息 |
+| Haversine公式 | 计算地球表面两点间距离的公式 |
+
+### 10.2 参考文档
+> 列出参考的相关文档
+
+- [需求分析模板](4、需求分析模板.md)
+- [视觉与交互 DNA 规范模板](6、视觉与交互%20DNA%20规范模板.md)
+- [UI 设计说明模板](7、UI%20设计说明模板.md)
+- [技术细分模板](10、技术细分模板.md)
+- [UniApp官方文档](https://uniapp.dcloud.net.cn/)
+- [uView Pro官方文档](https://uviewpro.cn/)
+
+### 10.3 变更记录
+> 记录需求变更的历史
+
+| 变更日期 | 变更内容 | 变更原因 | 变更人 |
+| :--- | :--- | :--- | :--- |
+| {YYYY-MM-DD} | {变更内容描述} | {变更原因} | {姓名} |
+
+---
+
+**文档版本**：V1.0.0  
+**创建时间**：{YYYY-MM-DD}  
+**最后更新**：{YYYY-MM-DD}  
+**文档状态**：✅ 待评审 / ✅ 评审通过 / ✅ 开发中 / ✅ 已完成
+
+
+---
+
+## 附录：OctoPanel 设备中心子 PRD 节选（结构参考）
+
+# {Name} — 设备中心模块 PRD V1
+
+> **文档说明**：定义设备中心一级菜单的完整功能与布局，包括实例列表、实例分组、集群概览、批量操作、配置管理（基线/模板/一致性总览/下发任务/下发记录）及单实例管理（概览、对话测试、渠道、会话、Agent、技能、节点、用量、定时、配置、调试、上下文诊断、日志）。与 PRD-V1 总纲 §5.2 设备中心模块对应。
+
+---
+
+## 1. 文档信息 (Document Info)
+
+### 1.1 版本记录
+
+| 版本号 | 修改日期 | 修改人 | 修改内容 | 备注 |
+| :--- | :--- | :--- | :--- | :--- |
+| V1.0.0 | 2026-02-12 | PartMe | 初版：从总纲 PRD §5.2 拆出并扩展 | 按一级菜单拆分 |
+| V1.1.0 | 2026-02-12 | PartMe | §3.5 功能操作清单；§4 功能规则/数据来源/异常处理/验收标准清单化；§6 改为 Gateway WS | 按规划与 PRD 模板完善 |
+| V1.2.0 | 2026-02-24 | PartMe | §5.11 浏览器控制能力管理（@playwright/mcp、browser-use 两条路线） | 已被 V1.3.0 覆盖 |
+| V1.3.0 | 2026-02-24 | PartMe | §5.11 重写为四路线方案（A/B/C/D）；9 个功能模块 | 已被 V1.4.0 覆盖 |
+| V1.4.0 | 2026-02-24 | PartMe | §5.11 扩展为五路线方案：新增路线 E mcp-chrome（DC-04-10/11，Desktop P0）含安装连接管理和权限管理；11 个功能模块、13 项验收标准；异常处理增加 mcp-chrome 降级策略 | 已被 V1.5.0 覆盖 |
+| V1.5.0 | 2026-02-24 | PartMe | 新增 §5.12 Skills 管理能力（DC-05）：8 个功能模块（Skills 列表管理/ClawHub 商店/安装引导/配置基线/安全审核/审计日志/批量安装/Desktop 推荐向导）、13 项验收标准；含安全策略（ClawHavoc 事件应对）、异常处理 | - |
+| V1.6.0 | 2026-02-24 | PartMe | 新增 §5.13 环境检查与 CLI 管理能力（DC-06）：7 个功能模块（CLI 安装检测/环境变量冲突检测/环境变量管理/备份恢复/安装向导集成/远程诊断/Desktop 设置页）、9 项验收标准；借鉴 CC Switch EnvChecker/EnvManager 架构 | - |
+
+### 1.2 文档责任人
+
+| 角色 | 职责 |
+| :--- | :--- |
+| 产品经理 | 需求与验收确认 |
+| 技术负责人 | 与 OpenClaw 插件接口对齐 |
+| UI/前端 | 界面与交互实现 |
+
+### 1.3 关联文档
+
+| 文档类型 | 文档名称 | 说明 |
+| :--- | :--- | :--- |
+| 同模块 UI | [{Name}-设备中心-UI设计说明-V1]({Name}-设备中心-UI设计说明-V1.md) | §3 设备中心布局 |
+| 同模块 Stitch | [{Name}-设备中心-Stitch设计提示词]({Name}-设备中心-Stitch设计提示词.md) | Stitch 布局提示词 |
+| 模型服务 PRD | [{Name}-模型管理-PRD-V1](../6、模型服务/{Name}-模型管理-PRD-V1.md) | 模型配置模板下发、Key 池注入实例配置 |
+| 历史场景层说明 | 历史业务场景能力已移出主线 | 单实例仅保留会话查看与运行态排障，不承载业务场景配置 |
+| 功能与界面规划 | 《{Name}-V1-功能与界面规划》 | 功能操作与布局/交互要点 |
+| 技术方案 | 《{Name}-技术方案与路线》 | 平台能力与配置管理路线 |
+| DNA 规范 | [{Name}-视觉与交互DNA规范](../../9、{Name}-视觉与交互DNA规范.md) | 一致性状态色、表格、表单 |
+
+---
+
+## 2. 产品概述 (Product Overview)
+
+### 2.1 功能定位
+
+设备中心是 {Name} 的核心入口，提供多 OpenClaw 实例的注册、分组、监控、配置管理与单实例管理（点击某实例后进入的完整管理面板），通过游戏化向导与可视化表单提供与 OpenClaw 等同的配置能力，并支持基线/模板/一致性检测与批量下发。
+
+### 2.2 核心价值
+
+| 价值点 | 说明 |
+| :--- | :--- |
+| 多实例统一视图 | 实例列表、分组、集群概览、批量启停/重启/更新 |
+| 配置可落地可审计 | 基线配置、配置模板、一致性总览、下发任务、下发记录 |
+| 单实例全功能 | 点击实例进入 12 个子页面：概览、对话测试、渠道、会话、Agent、技能、节点、用量、定时、配置、调试、上下文诊断、日志 |
+
+---
+
+## 3. 二级菜单与能力
+
+| 二级菜单 | 能力简述 | 阶段 |
+| :--- | :--- | :--- |
+| **实例列表** | 卡片/列表视图，在线状态、版本、标签、分组、一致性状态、配置差异项数；添加实例、批量操作；管理 → 进入单实例 | P0 |
+| **实例分组** | 按业务线/地域/环境分组、打标签 | P0 |
+| **集群概览** | 多实例聚合指标：健康状态、会话量、用量、渠道状态 | P0 |
+| **批量操作** | 勾选实例 → 批量启停、批量重启、批量更新插件 | P0 |
+| **配置管理** | 基线配置、配置模板、一致性总览、下发任务、下发记录（见下表） | P0 |
+| **↳ 单实例管理** | 实例概览、对话测试、渠道管理、会话管理、Agent 管理、技能管理、节点管理、用量统计、定时任务、配置管理、调试工具、上下文诊断、实例日志 | P0/P1 |
+
+配置管理子项：
+
+| 子项 | 能力 |
+| :--- | :--- |
+| 基线配置 | 全局期望状态，可视化表单 7 大分类，版本管理、导出 JSON、从模板应用 |
+| 配置模板 | 可复用片段（Agent/渠道/插件等），分类与版本管理 |
+| 一致性总览 | 实例 × 一致性状态及差异项数；查看差异、下发基线、从基线恢复、关联基线 |
+| 下发任务 | 四步：选来源 → 选目标实例 → 预览 diff → 确认下发并展示结果 |
+| 下发记录 | 时间、操作人、配置来源、目标实例、变更摘要、每实例结果 |
+
+### 3.5 功能操作清单（与 《V1 功能与界面规划》 §3.1 对应）
+
+| 功能点 | 操作 | 预期结果 |
+| :--- | :--- | :--- |
+| DC-01 | 切换卡片/列表视图 | 保留筛选条件，内容区切换为卡片栅格或表格 |
+| DC-01 | 筛选（分组/标签/在线状态/搜索） | 请求实例列表带筛参，更新列表 |
+| DC-01 | 点击「+ 添加实例」 | 打开注册/添加表单或向导，提交后实例入库并出现在列表 |
+| DC-01 | 勾选多条 → 批量操作 | 显示批量操作栏，选择操作并确认后执行，结果 Toast 或结果列表 |
+| DC-01 | 点击「管理 →」 | 进入该实例单实例管理，默认 Tab「概览」 |
+| DC-01 | 查看差异/从基线恢复/下发基线/关联基线 | 按状态显示；从基线恢复/同步到基线二次确认后执行 |
+| DC-02a | 编辑基线 → 保存 | 乐观锁校验；冲突则提示「配置已被他人更新，请刷新后重新编辑」并拦截 |
+| DC-02c | 四步下发 → 确认 | 选来源→选目标→预览 diff→确认；离线实例按所选策略（立即失败/自动重试）；等待重试可查看与取消 |
+| DC-04 | 分组/标签 CRUD、管理实例 | 新建/编辑/删除分组或标签；多选实例关联分组；实例列表按分组/标签筛选 |
+| DC-05 | 时间筛选、刷新、下钻 | 聚合指标与图表展示；下钻跳转实例列表 |
+| DC-02e | 模板 CRUD、从模板应用 | 新建/编辑模板；在基线配置页从模板应用合并到基线 |
+| DC-02d | 查看下发记录 | 列表含操作人、时间、目标实例、结果；支持筛选与详情 |
+| DC-03 | 单实例配置保存/从基线恢复/同步到基线 | 保存写回实例并热重载；恢复/同步二次确认 |
+| DC-03-01～13 | 单实例各子页 | 概览/对话测试/渠道/会话/Agent/技能/节点/用量/定时/配置/调试/上下文诊断/日志 对应操作与展示 |
+
+---
+
+## 4. 功能需求 (Functional Requirements)
+
+### 5.1 实例列表（DC-01）
+
+**功能ID**：DC-01  
+**功能名称**：实例列表  
+
+**功能描述**：设备中心默认页。展示已注册 OpenClaw 实例的卡片或列表视图，含在线状态、实例名、一致性状态、版本、标签、Agent 数、会话数、配置差异项数；支持添加实例、筛选、视图切换、批量操作；操作包括管理 →、查看差异、从基线恢复、下发基线、关联基线（按状态显示）。与《{Name} 需求分析文档 V1》§5.1.1 一致。
+
+**用户故事**：作为运维人员，我希望在设备中心看到所有实例的状态与一致性，以便快速进入管理或执行下发/恢复。
+
+**功能规则**：
+
+1. **显示规则**：卡片视图栅格 3～4 列，卡片内在线状态点（8px）+ 实例名 + 一致性状态 ●（已同步/已修改/待下发/下发失败/未纳管，色与 DNA 一致）、版本、标签、Agent 数/会话数/配置差异项数、勾选框与操作按钮。列表视图为表格，列与卡片信息对应，操作列右对齐。筛选区：分组 ▾、标签 ▾、在线状态 ▾、搜索框（占位「搜索实例名...」）；视图切换「卡片 | 列表」。
+2. **业务规则**：一致性状态与差异项数由「当前实例配置 vs 基线」计算（通过 WS config.get 拉取实例配置）；未纳管实例可关联基线后纳入管理。批量操作：批量启停、批量重启、批量更新插件等。
+3. **交互规则**：切换视图保留筛选条件。勾选多条后显示批量操作栏；选择操作并确认后请求执行。点击「管理 →」路由到该实例单实例管理，默认 Tab「概览」。从基线恢复、同步到基线需二次确认（与总纲 §2.4 危险操作一致）。
+
+**数据来源**：
+
+- 实例列表：管理后台 {Name} 数据库（instance、instance_group、instance_tag）；在线状态、会话数、Agent 数等通过各实例 **Gateway WebSocket** `health`、`status` 及统计能力获取；一致性状态与差异项数由聚合层对每个实例 **WS config.get** 与基线 diff 计算。
+
+**异常处理**：
+
+- **网络异常**：列表加载失败展示 Toast 或横幅，支持重试。单实例离线时该实例显示离线态，不影响其他实例展示。
+- **无实例**：空状态展示插画+「立即添加实例」引导（与总纲 §2.3 一致）。
+- **从基线恢复/同步失败**：模态展示错误原因，支持重试。
+
+**验收标准**：
+
+1. ✅ 筛选（分组/标签/在线状态/搜索）正确过滤实例列表。
+2. ✅ 卡片/列表视图切换正确，切换后保留筛选条件。
+3. ✅ 点击「管理 →」进入该实例单实例管理，默认 Tab「概览」。
+4. ✅ 按一致性状态正确显示「查看差异」「从基线恢复」「下发基线」「关联基线」等操作。
+5. ✅ 从基线恢复、同步到基线有二次确认，执行后状态与基线一致。
+6. ✅ 批量勾选后批量操作栏出现，执行后结果正确反馈。
+
+### 5.2 实例分组（DC-04）
+
+**功能ID**：DC-04  
+**功能名称**：实例分组  
+
+**功能描述**：按业务线/地域/环境等维度对实例进行分组与打标签；分组/标签 CRUD、与实例多对多关联；实例列表筛选依赖分组与标签。界面与交互遵循 [{Name} 视觉与交互 DNA 规范](../../9、{Name}-视觉与交互DNA规范.md) §5.3 列表与表格、§5.2 表格与卡片。
+
+**用户故事**：作为运维人员，我希望将实例按业务线或地域分组并打标签，以便在实例列表与下发给定时快速筛选。
+
+**功能规则**：
+
+1. **显示规则**：独立页「设备中心 > 实例分组」；分组与标签可分 Tab 或左右区；表格或卡片：分组名/标签名、关联实例数、操作（编辑、删除、管理实例）；主按钮「+ 新建分组」「+ 新建标签」；空状态插画+引导（DNA §5.6）。
+2. **业务规则**：分组与标签存 {Name} 数据库；实例与分组多对多；删除分组前若有实例关联需提示或先解绑。
+3. **交互规则**：新建/编辑 → 表单（名称、描述等）→ 保存后列表刷新；管理实例 → 多选实例关联到该分组。
+
+**数据来源**：{Name} 数据库 instance_group、instance_tag、instance_group_relation；实例列表筛选时带 group_id/tag_id 参数。
+
+**异常处理**：保存失败 Toast；删除有关联实例的分组时提示「请先解除实例关联」或二次确认。
+
+**验收标准**：
+
+1. ✅ 分组/标签 CRUD 正常，列表正确展示关联实例数。
+2. ✅ 管理实例可多选实例关联到分组；实例列表筛选按分组/标签正确过滤。
+3. ✅ 删除有关联的分组有提示或二次确认。
+
+### 5.3 集群概览（DC-05）
+
+**功能ID**：DC-05  
+**功能名称**：集群概览  
+
+**功能描述**：多实例聚合指标页：健康状态（正常/异常/离线占比）、总会话量、总用量、渠道状态；支持时间筛选与刷新；可选下钻到实例列表。状态色与 [DNA 规范](../../9、{Name}-视觉与交互DNA规范.md) §3.1 功能色、§3.1.2 一致性状态色 一致。
+
+**用户故事**：作为运维人员，我希望在一页看到所有实例的聚合健康与用量，以便快速发现异常。
+
+**功能规则**：
+
+1. **显示规则**：独立页「设备中心 > 集群概览」；顶栏时间范围下拉、刷新按钮；指标卡片行（健康、会话量、用量、渠道状态）；可选饼图/柱状图，图例 12px。
+2. **业务规则**：数据由聚合层汇总各实例 **Gateway WebSocket** health、status 及统计接口。
+3. **交互规则**：时间筛选/刷新 → 重新请求聚合数据；下钻（若有）→ 跳转实例列表并带筛选。
+
+**数据来源**：各实例 WS health、status；聚合层或 {Name} 统计表。
+
+**异常处理**：加载失败 Toast/横幅、重试；部分实例离线时聚合仍展示，离线数计入「异常/离线」占比。
+
+**验收标准**：
+
+1. ✅ 指标卡片与可选图表正确展示；时间筛选与刷新生效。
+2. ✅ 下钻（若有）跳转实例列表并带正确筛选参数。
+
+### 5.4 配置管理 — 配置模板（DC-02e）
+
+**功能ID**：DC-02e  
+**功能名称**：配置模板  
+
+**功能描述**：可复用的配置片段（Agent/渠道/插件等），分类管理、版本管理；从模板应用至基线；列表与新建/编辑表单。遵循 [DNA 规范](../../9、{Name}-视觉与交互DNA规范.md) §5.4 表单与配置、§5.2 表格。
+
+**用户故事**：作为运维人员，我希望维护一批配置模板并可从模板应用到基线，以便快速生成标准配置。
+
+**功能规则**：
+
+1. **显示规则**：独立子页「配置管理 > 配置模板」；表格 模板名、分类、版本、操作；主按钮「+ 新建模板」；新增/编辑弹窗或抽屉（模板名、分类、内容 JSON 或表单）。
+2. **业务规则**：模板存 {Name} 数据库；分类可选 Agent/渠道/插件等；从模板应用在基线配置页操作，选择模板后合并到当前基线（同 DC-02a 乐观锁）。
+3. **交互规则**：新建/编辑 → 保存后列表刷新；从模板应用入口可在基线配置页。
+
+**数据来源**：{Name} 数据库 config_template；从模板应用写基线表。
+
+**异常处理**：保存失败 Toast；从模板应用时若基线版本冲突同 DC-02a。
+
+**验收标准**：
+
+1. ✅ 模板 CRUD 正常；从模板应用至基线后基线内容正确合并。
+2. ✅ 分类与版本展示正确。
+
+### 5.5 配置管理 — 基线配置（DC-02a）
+
+**功能ID**：DC-02a  
+**功能名称**：基线配置  
+
+**功能描述**：可视化表单编辑「基线配置」，对应 OpenClaw 配置结构，分 7 大分类（基础/认证/Agent/渠道/插件/监控/会话等）；支持版本管理（版本号、备注）、导出 JSON、从模板应用。
+
+**用户故事**：作为运维人员，我希望在管理后台编辑基线配置并保存版本，以便统一下发给多实例且可追溯。
+
+**功能规则**：
+
+1. **显示规则**：7 大分类以 Tab 或左侧导航组织；表单字段与 openclaw.json 结构对齐；版本号与备注在页顶或版本历史区展示。
+2. **业务规则**：必填与格式校验（失焦校验，与总纲 §2.4 一致）；保存后生成新版本、版本递增。**基线版本冲突处理**：保存时传当前 version，后端乐观锁校验；若后端 version > 前端，返回冲突错误，前端提示「配置已被他人更新，请刷新后重新编辑」并拦截保存。
+3. **交互规则**：从模板应用 → 选择模板后合并到当前基线。导出 JSON → 下载文件可被 OpenClaw 加载。
+
+**数据来源**：
+
+- 基线存 {Name} 数据库（baseline_version 等）；读写为管理后台自有 API；与实例交互通过 **Gateway WebSocket** config.set/config.apply 在下发时使用。
+
+**异常处理**：
+
+- **冲突**：保存时若版本冲突，展示上述提示，不提交；用户刷新后重新编辑再保存。
+- **校验失败**：字段下方红色错误文案，不提交。
+- **网络异常**：保存失败 Toast 或模态，支持重试。
+
+**验收标准**：
+
+1. ✅ 编辑保存成功，版本历史可查。
+2. ✅ 导出 JSON 可被 OpenClaw 加载。
+3. ✅ 多人同时编辑时，后保存者遇到版本冲突则提示「配置已被他人更新，请刷新后重新编辑」并拦截保存。
+4. ✅ 从模板应用后基线内容正确合并。
+
+### 5.6 配置管理 — 一致性总览（DC-02b）
+
+**功能ID**：DC-02b  
+**功能名称**：一致性总览  
+
+**功能描述**：表格展示「实例 × 一致性状态」及差异项数；操作：查看差异、下发基线、从基线恢复、关联基线（未纳管）；支持按状态/分组筛选；底部「全部下发」「仅下发待下发」「按分组下发」「按标签下发」。
+
+**用户故事**：作为运维人员，我希望在一页看到所有实例与基线的一致性及差异项数，以便批量下发或恢复。
+
+**功能规则**：
+
+1. **显示规则**：表格列 实例、状态、差异项数、操作；状态列 ● + 已同步/已修改/待下发/下发失败/未纳管（色与 DNA 一致）；操作列按状态显示查看差异、下发基线、从基线恢复、关联基线等。
+2. **业务规则**：状态与差异项数由「当前实例配置 vs 基线」计算（对各实例 **WS config.get** 与基线 diff）；未纳管实例可关联基线后纳入管理。
+3. **交互规则**：查看差异 → 打开 diff 弹窗或跳转单实例配置页；下发基线/从基线恢复 → 可多选实例后执行；从基线恢复需二次确认。
+
+**数据来源**：
+
+- 实例列表与基线来自 {Name} 数据库；每个实例当前配置通过 **Gateway WebSocket** `config.get` 拉取；一致性由聚合层计算后返回。
+
+**异常处理**：
+
+- **部分实例离线**：该实例状态可为「未纳管」或标记离线，不影响其他行操作。
+- **下发/恢复失败**：单实例失败时记录原因，可重试；整批失败时模态展示。
+
+**验收标准**：
+
+1. ✅ 状态与差异项数与实际「实例 config vs 基线」一致。
+2. ✅ 查看差异内容与单实例配置页 diff 一致。
+3. ✅ 下发与从基线恢复流程可用，结果与下发记录一致。
+4. ✅ 未纳管实例关联基线后纳入管理并出现在列表中。
+
+### 5.7 配置管理 — 下发任务（DC-02c）
+
+**功能ID**：DC-02c  
+**功能名称**：下发任务  
+
+**功能描述**：新建下发 → 步骤 1 选来源（基线/模板）→ 步骤 2 选目标实例（可全选、按分组）→ 步骤 3 预览每实例 diff → 步骤 4 确认下发并展示每实例结果（成功/失败+原因）。**操作人必填**并写入下发记录（总纲 §5.4）。**离线实例策略**：模式 A 立即失败；模式 B 自动重试最多 3 次；等待重试可查看与取消。
+
+**用户故事**：作为运维人员，我希望通过四步向导将基线或模板下发给多台实例，并看到每台成功/失败结果，以便审计与重试。
+
+**功能规则**：
+
+1. **显示规则**：四步步骤条；每步内容区最大宽度约 720px；步骤 3 预览 diff 等宽字体，删除线+红表示旧值、下划线+绿表示新值；步骤 4 每实例一行 ✅/❌ 与重试按钮。
+2. **业务规则**：下发时对每个目标实例通过 **Gateway WebSocket** `config.set`/`config.apply` 写入配置并触发热重载。失败记录原因并支持单实例重试。**离线实例**：模式 A 则该实例立即失败并记录；模式 B 则进入重试队列，最多 3 次，等待重试状态可查看与取消。**操作人**：当前登录用户写入 deployment_task，与总纲 §5.4 审计一致。
+3. **交互规则**：每步可上一步/下一步；步骤 4 确认后异步或同步执行，展示每实例结果；重试仅针对失败实例。
+
+**数据来源**：
+
+- 来源：基线/模板来自 {Name} 数据库。目标实例列表来自 {Name} 数据库。执行：Infrastructure 层按实例建立 **Gateway WebSocket** 连接，调用 config.set/config.apply；结果写回 deployment_task、deployment_task_result。
+
+**异常处理**：
+
+- **部分实例失败**：该实例行显示 ❌ 与原因，可点击重试；整任务不回滚已成功实例。
+- **全部失败**：步骤 4 展示全部 ❌，可全部重试或返回修改来源/目标。
+- **网络异常**：请求超时或断开按失败处理，记录原因。
+
+**验收标准**：
+
+1. ✅ 四步流程完整，步骤 3 预览 diff 与步骤 4 结果一致。
+2. ✅ 下发记录可查，且含操作人、时间、目标实例、每实例结果。
+3. ✅ 离线实例：模式 A 立即失败并记录；模式 B 进入重试队列，可查看与取消，最多重试 3 次。
+4. ✅ 单实例失败可重试，重试后结果更新。
+
+### 5.8 配置管理 — 下发记录（DC-02d）
+
+**功能ID**：DC-02d  
+**功能名称**：下发记录  
+
+**功能描述**：历史下发任务列表：时间、**操作人**、配置来源、目标实例、变更摘要、每实例结果；支持筛选与查看详情。与总纲 §5.4 审计日志一致。
+
+**用户故事**：作为运维人员，我希望查看历史下发记录及操作人，以便审计与排查问题。
+
+**功能规则**：
+
+1. **显示规则**：表格列 时间、操作人、配置来源、目标实例、变更摘要、每实例结果（可展开或详情页）；支持按时间、操作人、来源筛选。
+2. **业务规则**：所有下发与基线恢复/同步操作写入 operation_log 或 deployment_task，**操作人必填**；保存期限与总纲 §5.4 一致（≥90 天）。
+3. **交互规则**：点击某条可查看详情（每实例成功/失败及原因）。
+
+**数据来源**：
+
+- deployment_task、deployment_task_result 及操作人来自 {Name} 数据库；只读展示。
+
+**异常处理**：
+
+- **无记录**：空状态展示「暂无下发记录」类文案。
+
+**验收标准**：
+
+1. ✅ 记录完整可查，每条含操作人、时间、配置来源、目标实例、结果。
+2. ✅ 与下发任务执行结果一致；筛选与详情正确。
+
+### 5.9 单实例管理 — 配置管理（DC-03）
+
+**功能ID**：DC-03  
+**功能名称**：单实例配置管理  
+
+**功能描述**：单实例内「配置管理」页：顶部展示与基线差异 N 项及状态；按钮「查看差异」「从基线恢复」「同步到基线」；下方为 7 大分类表单；与基线不同的字段有「⚠ 差异」标记；支持保存、重置、与基线对比、导出 JSON。
+
+> **模型服务关联**：单实例配置中的「模型配置」节点支持从**模型服务模板库**（[4.6](../6、模型服务/{Name}-模型管理-PRD-V1.md) MM-07）应用模板；Key 池中的 API Key 可在下发时注入实例配置（加密或引用方式）。详见 《4.6 §2.6.3》
+
+**用户故事**：作为运维人员，我希望在单实例配置页直接编辑并保存，或从基线恢复/同步到基线，以便单实例与基线一致或保留差异。
+
+**功能规则**：
+
+1. **显示规则**：顶部横幅「与基线差异 N 项」+ 三按钮；左侧配置分类（或 Tab）；右侧 7 大分类表单；差异字段 ⚠ 标记；底部保存、重置、与基线对比、导出 JSON。
+2. **业务规则**：保存后通过该实例 **Gateway WebSocket** `config.set` 写回并触发热重载。从基线恢复（用基线覆盖当前实例）、同步到基线（用当前实例覆盖基线）需**二次确认**（与总纲 §2.4 危险操作一致）。
+3. **交互规则**：查看差异 → 打开 diff 视图；保存 → 提交当前表单，成功 Toast；恢复/同步 → 确认框 → 执行后刷新状态。
+
+**数据来源**：
+
+- 当前实例配置：**Gateway WebSocket** `config.get`。基线：{Name} 数据库。保存：**WS config.set** 写回该实例。
+
+**异常处理**：
+
+- **保存失败**：模态展示错误原因（如实例离线、网络超时），支持重试。
+- **从基线恢复/同步失败**：同上。
+
+**验收标准**：
+
+1. ✅ 差异 N 项与 diff 内容正确。
+2. ✅ 保存后实例配置更新且热重载生效。
+3. ✅ 从基线恢复后实例与基线一致；同步到基线后基线更新。
+4. ✅ 危险操作均有二次确认。
+
+### 5.10 单实例管理 — 其余子页（DC-03-01 ～ DC-03-13）
+
+单实例从「管理 →」进入后，除配置管理（§5.9）外另有 13 个子页；Tab 或左侧菜单：概览、对话测试、渠道、会话、Agent、技能、节点、用量、定时、配置、调试、上下文诊断、日志。以下各子页功能描述、主要操作、数据来源与验收要点；界面与交互遵循 [DNA 规范](../../9、{Name}-视觉与交互DNA规范.md) §4、§5。
+
+| 子页 | 功能ID | 功能描述 | 主要操作 | 数据来源 | 阶段 |
+| :--- | :--- | :--- | :--- | :--- | :--- |
+| 实例概览 | DC-03-01 | 单实例 Overview：健康状态、会话数、消息量、资源使用 | 查看指标、刷新 | WS health、status | P0 |
+| 对话测试 | DC-03-0
+
+> （节选结束）

skills/document-skills/full-stack-doc/templates/module/模块-Stitch设计提示词.md

@@ -0,0 +1,93 @@
+# {Name}-{模块简称}-Stitch设计提示词（{V}）
+
+> **标准说明**：以下为 Octo **实例中心** Stitch 提示词全文（`partme-docs/…/OctoPanel-实例中心-Stitch设计提示词.md`），将「实例中心」替换为目标模块即可。
+
+---
+
+## 原文标题：{Name} — 实例中心 Stitch 设计提示词
+
+> **文档说明**：为 [{Name}-V1界面重构与研发任务清单](../../31、{Name}-V1%E7%95%8C%E9%9D%A2%E9%87%8D%E6%9E%84%E4%B8%8E%E7%A0%94%E5%8F%91%E4%BB%BB%E5%8A%A1%E6%B8%85%E5%8D%95.md) 中的“实例中心”模块提供 Stitch 设计提示词。该模块负责管理所有已纳管的智能体引擎实例（OpenClaw / ZeroClaw / OctoClaw）。
+
+---
+
+## 1. 文档信息
+
+| 属性 | 内容 |
+| :--- | :--- |
+| 文档版本 | V1.0.0 |
+| 创建日期 | 2026-03-24 |
+| 设计规范 | [{Name}-视觉与交互DNA规范](../../9、{Name}-视觉与交互DNA规范.md) |
+
+---
+
+## 2. 设计系统摘要
+
+- **实例状态颜色**：
+  - 在线 (Online)：绿色 `#07C160`
+  - 异常 (Degraded)：橙色 `#FFAA00`
+  - 离线 (Offline)：红色 `#DC2626`
+  - 维护中 (Upgrading)：蓝色 `#2563EB`
+- **布局**：概览卡片（Summary Cards）+ 实例列表（Table）+ 实例详情（Details）
+- **字体**：微软雅黑 (Microsoft YaHei)
+
+---
+
+## 3. 实例中心 — Stitch 提示词
+
+### 3.1 提示词：实例列表页面
+
+```
+REQUIRED: Font Microsoft YaHei. All UI copy in Chinese.
+
+Design an "实例中心" (Instance Center) page for {Name}.
+
+Header:
+- Title: "实例管理" (20px bold)
+- Stats Row: [总实例: 12] [● 在线: 10] [● 异常: 1] [● 离线: 1]
+- Buttons: [+ 部署新实例] red button #E63946, [刷新] icon.
+
+Filter Bar:
+- Engine Filter: "全部引擎", "OpenClaw", "ZeroClaw", "OctoClaw".
+- Group Filter: "全部生产", "测试环境", "边缘节点".
+- Search: "搜索实例名称/ID..."
+
+Data Table:
+1. 实例名称 (Icon per engine + Name + ID)
+2. 引擎类型 (Badge: OpenClaw / ZeroClaw / OctoClaw)
+3. 所在节点 (Host name link)
+4. 健康状态 (Pill: ● 在线 Green / ● 离线 Red)
+5. 运行时间 (e.g. 12d 4h)
+6. 操作: [控制台] [日志] [设置] [重启/停止] (Dropdown).
+
+Style: High density data view, clear engine distinction, hover effects on rows.
+```
+
+### 3.2 提示词：实例详情页面
+
+```
+REQUIRED: Font Microsoft YaHei. All UI copy in Chinese.
+
+Design the "实例详情" (Instance Detail) page for {Name}.
+
+Header:
+- Breadcrumb: "实例管理 > claw-instance-01"
+- Header Actions: [重启] [停止] [删除] red text.
+
+Layout:
+- Left Column (70%):
+  - Card 1: 运行时概览 (CPU/RAM usage charts, Process ID, Port).
+  - Card 2: 最新配置 (Read-only YAML/JSON view).
+  - Card 3: 关联扩展 (List of skills/tools active for this instance).
+- Right Column (30%):
+  - Health History: Small timeline of status changes.
+  - Recent Events: Audit logs specific to this instance.
+  - Quick Info: Node location, IP address, version.
+
+Style: Dashboard-in-dashboard, use small charts for real-time metrics, clear section titles.
+```
+
+---
+
+**文档版本**：V1.0.0  
+**最后更新**：2026-03-24  
+**文档状态**：✅ 已完成

skills/dev-utils-skills/full-stack-doc/templates/7、UI 设计说明模板.md → skills/document-skills/full-stack-doc/templates/module/模块-UI设计说明.md

@@ -1,4 +1,8 @@
-# {产品名称} - 设计说明书 V1.0
+> **标准说明**：以下为 原「UI 设计说明」阶段模板全文 **全文**。
+
+---
+
+# {Name}-{模块简称}-UI设计说明（{V}）
 
 > **文档说明**：
 > - 本文档是UI设计阶段的产出物，用于明确界面设计规范和交互细节
@@ -25,10 +29,10 @@
 ### 1.3 关联文档
 | 文档类型 | 文档名称 | 版本 | 说明 |
 | :--- | :--- | :--- | :--- |
-| 需求分析文档 | {产品名称}-需求分析文档.md | V1.0.0 | 功能需求和用户故事 |
-| UI设计稿 | {产品名称}-UI设计稿 | V1.0 | Figma/Sketch设计文件 |
-| 原型图 | {产品名称}-原型图 | V1.0 | 交互原型文件 |
-| DNA规范 | {产品名称}-视觉与交互DNA规范.md | V1.0.0 | 设计DNA规范 |
+| 需求分析文档 | {Name}-需求分析文档.md | V1.0.0 | 功能需求和用户故事 |
+| UI设计稿 | {Name}-UI设计稿 | V1.0 | Figma/Sketch设计文件 |
+| 原型图 | {Name}-原型图 | V1.0 | 交互原型文件 |
+| DNA规范 | {Name}-视觉与交互DNA规范.md | V1.0.0 | 设计DNA规范 |
 
 ---
 
@@ -37,7 +41,7 @@
 ### 2.1 设计系统
 > 参考视觉与交互DNA规范
 
-本文档遵循《{产品名称}-视觉与交互DNA规范》，包括：
+本文档遵循《{Name}-视觉与交互DNA规范》，包括：
 - 色彩系统
 - 字体系统
 - 间距系统

skills/document-skills/full-stack-doc/templates/root/10、功能菜单与版本规划.md

@@ -0,0 +1,367 @@
+# {Name} 功能菜单与版本规划
+
+> **文档说明**：冻结产品导航结构、页面清单、路由规划、版本分布、核心用户旅程与详细功能清单（含优先级和版本归属）。本文包含原「详细功能清单」内容。
+>
+> **版本**：V1.0.0
+> **最后更新**：{YYYY-MM-DD}
+
+---
+
+## 1. 功能全景
+
+```mermaid
+mindmap
+  root(("{Name}"))
+    仪表盘
+      数据概览
+      趋势图表
+      快捷操作
+    商品管理
+      商品采集
+      商品编辑
+      批量上架
+      定价策略
+    订单管理
+      订单列表
+      订单详情
+      批量处理
+      退款管理
+    店铺管理
+      平台连接
+      店铺配置
+      授权管理
+    Agent 管理
+      Agent 列表
+      任务监控
+      执行日志
+      调度配置
+    数据报表
+      销售报表
+      流量分析
+      Agent 效率
+    系统设置
+      用户管理
+      角色权限
+      通知配置
+      系统日志
+```
+
+### 1.1 优先级与版本标注说明
+
+| 标注 | 含义 |
+| :--- | :--- |
+| P0 | 必须实现，阻塞发布 |
+| P1 | 重要，影响核心体验 |
+| P2 | 期望，提升用户体验 |
+| P3 | 可选，低优先级增强 |
+| 🆓 | 免费版可用 |
+| 👤 | 个人版 (Pro) 可用 |
+| 👥 | 专业版 (Team) 可用 |
+| 🏢 | 企业版 (Enterprise) 可用 |
+
+---
+
+## 2. 一级导航结构
+
+```mermaid
+flowchart LR
+    NAV["侧栏导航"]
+    NAV --> DASH["📊 仪表盘"]
+    NAV --> PROD["📦 商品管理"]
+    NAV --> ORD["📋 订单管理"]
+    NAV --> STORE["🏪 店铺管理"]
+    NAV --> AGENT["🤖 Agent 管理"]
+    NAV --> REPORT["📈 数据报表"]
+    NAV --> SET["⚙️ 系统设置"]
+```
+
+### 2.1 菜单归位规则
+
+| 规则 | 说明 |
+| :--- | :--- |
+| 频率优先 | 高频功能排在前面（仪表盘 → 商品 → 订单） |
+| 逻辑分组 | 同一业务域功能归入同一菜单 |
+| 版本控制 | 高版本功能在低版本中隐藏（非灰色禁用） |
+| 角色控制 | 无权限菜单不显示 |
+
+---
+
+## 3. 二级菜单、页面清单与功能明细
+
+### 3.1 {例如：仪表盘 (Dashboard)}
+
+| 二级菜单 | 路由 | 版本 | 优先级 | 说明 |
+| :--- | :--- | :---: | :---: | :--- |
+| {例如：数据概览} | {例如：`/dashboard`} | 🆓 | P0 | {例如：核心指标卡片 + 趋势图} |
+| {例如：快捷操作} | {例如：`/dashboard`} | 🆓 | P1 | {例如：常用操作入口} |
+
+---
+
+### 3.2 {例如：商品管理 (Products)}
+
+| 二级菜单 | 路由 | 版本 | 优先级 | 说明 |
+| :--- | :--- | :---: | :---: | :--- |
+| {例如：商品列表} | {例如：`/products`} | 🆓 | P0 | {例如：全部商品 + 筛选 + 搜索} |
+| {例如：商品详情} | {例如：`/products/:id`} | 🆓 | P0 | {例如：基本信息 + SKU + 上架状态} |
+| {例如：商品采集} | {例如：`/products/scrape`} | 👤 | P0 | {例如：从源平台采集商品} |
+| {例如：批量上架} | {例如：`/products/batch-list`} | 👤 | P1 | {例如：批量发布到目标平台} |
+| {例如：定价策略} | {例如：`/products/pricing`} | 👥 | P1 | {例如：自动定价规则配置} |
+
+---
+
+### 3.3 {例如：订单管理 (Orders)}
+
+| 二级菜单 | 路由 | 版本 | 优先级 | 说明 |
+| :--- | :--- | :---: | :---: | :--- |
+| {例如：订单列表} | {例如：`/orders`} | 🆓 | P0 | {例如：全部订单 + 状态筛选} |
+| {例如：订单详情} | {例如：`/orders/:id`} | 🆓 | P0 | {例如：订单信息 + 物流 + 操作} |
+| {例如：批量处理} | {例如：`/orders/batch`} | 👤 | P1 | {例如：批量发货、批量备注} |
+| {例如：退款管理} | {例如：`/orders/refunds`} | 👤 | P1 | {例如：退款申请处理} |
+
+---
+
+### 3.4 {例如：店铺管理 (Stores)}
+
+| 二级菜单 | 路由 | 版本 | 优先级 | 说明 |
+| :--- | :--- | :---: | :---: | :--- |
+| {例如：店铺列表} | {例如：`/stores`} | 🆓 | P0 | {例如：已连接店铺 + 状态} |
+| {例如：添加店铺} | {例如：`/stores/add`} | 🆓 | P0 | {例如：选择平台 + 授权连接} |
+| {例如：店铺配置} | {例如：`/stores/:id/settings`} | 👤 | P1 | {例如：同步设置、通知规则} |
+
+---
+
+### 3.5 {例如：Agent 管理 (Agents)}
+
+| 二级菜单 | 路由 | 版本 | 优先级 | 说明 |
+| :--- | :--- | :---: | :---: | :--- |
+| {例如：Agent 列表} | {例如：`/agents`} | 🆓 | P0 | {例如：可用 Agent + 状态} |
+| {例如：任务监控} | {例如：`/agents/tasks`} | 🆓 | P0 | {例如：执行中/已完成任务} |
+| {例如：执行日志} | {例如：`/agents/logs`} | 👤 | P1 | {例如：Agent 执行详细日志} |
+| {例如：调度配置} | {例如：`/agents/schedules`} | 👤 | P1 | {例如：定时任务配置} |
+| {例如：Agent 市场} | {例如：`/agents/marketplace`} | 👥 | P2 | {例如：社区 / Premium Agent} |
+
+---
+
+### 3.6 {例如：数据报表 (Reports)}
+
+| 二级菜单 | 路由 | 版本 | 优先级 | 说明 |
+| :--- | :--- | :---: | :---: | :--- |
+| {例如：销售报表} | {例如：`/reports/sales`} | 👤 | P1 | {例如：GMV、订单量、转化率} |
+| {例如：Agent 效率} | {例如：`/reports/agents`} | 👤 | P2 | {例如：Agent 执行成功率、耗时} |
+| {例如：导出报表} | {例如：`/reports/export`} | 👥 | P2 | {例如：Excel/PDF 导出} |
+
+---
+
+### 3.7 {例如：系统设置 (Settings)}
+
+| 二级菜单 | 路由 | 版本 | 优先级 | 说明 |
+| :--- | :--- | :---: | :---: | :--- |
+| {例如：个人设置} | {例如：`/settings/profile`} | 🆓 | P0 | {例如：头像、密码、通知偏好} |
+| {例如：团队管理} | {例如：`/settings/team`} | 👥 | P1 | {例如：成员邀请、角色分配} |
+| {例如：角色权限} | {例如：`/settings/roles`} | 🏢 | P1 | {例如：自定义角色、权限配置} |
+| {例如：审计日志} | {例如：`/settings/audit`} | 🏢 | P1 | {例如：操作日志查询} |
+| {例如：API 密钥} | {例如：`/settings/api-keys`} | 👥 | P2 | {例如：API 密钥管理} |
+
+---
+
+## 4. CLI / IM 交互菜单（按需）
+
+```mermaid
+flowchart TD
+    CLI["{例如：opencli}"]
+    CLI --> PROD_CMD["product<br/>scrape / list / publish"]
+    CLI --> ORD_CMD["order<br/>sync / ship / list"]
+    CLI --> STORE_CMD["store<br/>connect / status"]
+    CLI --> AGENT_CMD["agent<br/>run / status / logs"]
+    CLI --> SYS_CMD["system<br/>config / health"]
+```
+
+```bash
+# CLI 命令示例
+{例如：opencli} product scrape --platform taobao --keyword "手机壳"
+{例如：opencli} product publish --store my-store --ids 1,2,3
+{例如：opencli} order sync --store my-store --since 2026-01-01
+{例如：opencli} agent run product-selector --config ./config.yaml
+{例如：opencli} system health
+```
+
+---
+
+## 5. 页面版本分布
+
+### 5.1 版本 → 页面映射
+
+| 页面 | V1.0 | V2.0 | V3.0 | V4.0 |
+| :--- | :---: | :---: | :---: | :---: |
+| {例如：仪表盘} | ✅ | ✅ | ✅ | ✅ |
+| {例如：商品列表} | ✅ | ✅ | ✅ | ✅ |
+| {例如：商品采集} | ✅ | ✅ | ✅ | ✅ |
+| {例如：订单列表} | ✅ | ✅ | ✅ | ✅ |
+| {例如：店铺管理} | ✅ | ✅ | ✅ | ✅ |
+| {例如：Agent 列表} | ✅ | ✅ | ✅ | ✅ |
+| {例如：团队管理} | — | ✅ | ✅ | ✅ |
+| {例如：角色权限} | — | — | ✅ | ✅ |
+| {例如：审计日志} | — | — | ✅ | ✅ |
+| {例如：Agent 市场} | — | — | — | ✅ |
+| {页面} | — | — | — | — |
+
+---
+
+## 6. 导航状态规则
+
+### 6.1 角标规则
+
+| 角标类型 | 触发条件 | 样式 |
+| :--- | :--- | :--- |
+| 红点 | {例如：有未读通知} | {例如：8px 红色圆点} |
+| 数字角标 | {例如：待处理订单数} | {例如：红色圆角矩形 + 白色数字} |
+| NEW 标签 | {例如：新功能上线} | {例如：蓝色圆角标签，7 天后消失} |
+
+### 6.2 面包屑规则
+
+```
+首页 > 商品管理 > 商品详情 > SKU-12345
+```
+
+| 规则 | 说明 |
+| :--- | :--- |
+| 层级 | {例如：最多 4 级，超过省略中间层} |
+| 可点击 | {例如：除最后一级外均可点击跳转} |
+| 动态段 | {例如：ID 显示为名称（如商品名）} |
+
+### 6.3 搜索规则
+
+| 规则 | 说明 |
+| :--- | :--- |
+| 全局搜索 | {例如：顶栏搜索框，搜索商品/订单/Agent} |
+| 快捷键 | {例如：`Cmd+K` / `Ctrl+K` 唤起} |
+| 搜索范围 | {例如：商品名、订单号、Agent 名称} |
+
+---
+
+## 7. 核心用户旅程
+
+### 7.1 旅程一：{例如：新用户首次采集商品}
+
+```mermaid
+flowchart TD
+    START["注册登录"] --> CONNECT["连接店铺"]
+    CONNECT --> SCRAPE["采集商品"]
+    SCRAPE --> REVIEW["审核编辑"]
+    REVIEW --> PUBLISH["发布上架"]
+    PUBLISH --> MONITOR["查看状态"]
+    MONITOR --> DONE["✅ 完成"]
+```
+
+| 步骤 | 页面 | 关键操作 | 预期时间 |
+| :--- | :--- | :--- | :--- |
+| {例如：连接店铺} | {例如：店铺管理 → 添加} | {例如：选择平台 → 扫码授权} | {例如：2 分钟} |
+| {例如：采集商品} | {例如：商品采集} | {例如：输入关键词 → 选择来源 → 开始采集} | {例如：5 分钟} |
+| {例如：审核发布} | {例如：商品列表 → 批量上架} | {例如：勾选 → 编辑 → 确认发布} | {例如：3 分钟} |
+
+### 7.2 旅程二：{例如：日常 Agent 自动运营}
+
+```mermaid
+flowchart TD
+    CONFIG["配置 Agent 调度"] --> AUTO["Agent 自动执行"]
+    AUTO --> NOTIFY["执行结果通知"]
+    NOTIFY --> CHECK["查看报表"]
+    CHECK --> ADJUST["调整策略"]
+    ADJUST --> AUTO
+```
+
+---
+
+## 8. 版本发布节奏
+
+| 版本 | 发布日期 | 核心功能 | 页面数 |
+| :--- | :--- | :--- | :---: |
+| V1.0 MVP | {例如：2026 Q2} | {例如：基础采集 + 上架 + 订单} | {例如：15} |
+| V2.0 商业版 | {例如：2026 Q3} | {例如：多租户 + 团队 + Premium Agent} | {例如：22} |
+| V3.0 企业版 | {例如：2026 Q4} | {例如：RBAC + 审计 + 私有部署} | {例如：28} |
+| V4.0 生态版 | {例如：2027 Q1} | {例如：Agent 市场 + 插件 + 开放 API} | {例如：35} |
+
+---
+
+## 9. 详细功能清单（按业务域）
+
+### 9.1 {例如：商品采集}
+
+| # | 功能 | 描述 | 优先级 | 版本 | 状态 |
+| :---: | :--- | :--- | :---: | :---: | :---: |
+| F-PROD-01 | {例如：关键词采集} | {例如：输入关键词从源平台搜索采集} | P0 | 🆓 V1.0 | ⏳ |
+| F-PROD-02 | {例如：链接采集} | {例如：输入商品链接直接采集} | P0 | 🆓 V1.0 | ⏳ |
+| F-PROD-03 | {例如：批量采集} | {例如：Excel 导入链接批量采集} | P1 | 👤 V1.0 | ⏳ |
+| F-PROD-04 | {例如：智能推荐采集} | {例如：AI 推荐热销商品} | P2 | 👥 V2.0 | ⏳ |
+| F-PROD-NN | {功能} | {描述} | — | — | — |
+
+### 9.2 {例如：订单履约}
+
+| # | 功能 | 描述 | 优先级 | 版本 | 状态 |
+| :---: | :--- | :--- | :---: | :---: | :---: |
+| F-ORD-01 | {例如：订单同步} | {例如：定时从平台同步订单} | P0 | 🆓 V1.0 | ⏳ |
+| F-ORD-02 | {例如：自动发货} | {例如：匹配物流单号自动发货} | P1 | 👤 V1.0 | ⏳ |
+| F-ORD-03 | {例如：退款处理} | {例如：自动/手动处理退款} | P1 | 👤 V1.0 | ⏳ |
+| F-ORD-NN | {功能} | {描述} | — | — | — |
+
+### 9.3 {例如：Agent 调度}
+
+| # | 功能 | 描述 | 优先级 | 版本 | 状态 |
+| :---: | :--- | :--- | :---: | :---: | :---: |
+| F-AGT-01 | {例如：手动触发} | {例如：一键运行指定 Agent} | P0 | 🆓 V1.0 | ⏳ |
+| F-AGT-02 | {例如：定时调度} | {例如：Cron 定时执行} | P1 | 👤 V1.0 | ⏳ |
+| F-AGT-03 | {例如：执行日志} | {例如：查看 Agent 执行过程} | P0 | 🆓 V1.0 | ⏳ |
+| F-AGT-04 | {例如：Agent 市场} | {例如：浏览安装社区 Agent} | P2 | 👥 V4.0 | ⏳ |
+| F-AGT-NN | {功能} | {描述} | — | — | — |
+
+### 9.4 {例如：系统管理}
+
+| # | 功能 | 描述 | 优先级 | 版本 | 状态 |
+| :---: | :--- | :--- | :---: | :---: | :---: |
+| F-SYS-01 | {例如：用户注册/登录} | {例如：邮箱注册、社交登录} | P0 | 🆓 V1.0 | ⏳ |
+| F-SYS-02 | {例如：团队管理} | {例如：邀请成员、分配角色} | P1 | 👥 V2.0 | ⏳ |
+| F-SYS-03 | {例如：RBAC 权限} | {例如：自定义角色与权限} | P1 | 🏢 V3.0 | ⏳ |
+| F-SYS-04 | {例如：审计日志} | {例如：操作日志查询与导出} | P1 | 🏢 V3.0 | ⏳ |
+| F-SYS-NN | {功能} | {描述} | — | — | — |
+
+---
+
+## 10. 功能优先级统计
+
+```mermaid
+pie title 功能优先级分布
+    "P0 (必须)" : 12
+    "P1 (重要)" : 15
+    "P2 (期望)" : 8
+    "P3 (可选)" : 3
+```
+
+| 优先级 | 数量 | 占比 | V1.0 交付 | V2.0 交付 |
+| :--- | :---: | :---: | :---: | :---: |
+| P0 | {例如：12} | {例如：32%} | {例如：12} | {例如：0} |
+| P1 | {例如：15} | {例如：39%} | {例如：8} | {例如：7} |
+| P2 | {例如：8} | {例如：21%} | {例如：2} | {例如：4} |
+| P3 | {例如：3} | {例如：8%} | {例如：0} | {例如：1} |
+| **合计** | **38** | **100%** | **22** | **12** |
+
+---
+
+## 11. REST API 菜单（按需）
+
+| 方法 | 路径 | 版本 | 说明 | 状态 |
+| :--- | :--- | :---: | :--- | :---: |
+| GET | {例如：`/api/v1/products`} | 🆓 | {例如：商品列表} | ⏳ |
+| POST | {例如：`/api/v1/products/scrape`} | 👤 | {例如：商品采集} | ⏳ |
+| POST | {例如：`/api/v1/products/publish`} | 👤 | {例如：商品发布} | ⏳ |
+| GET | {例如：`/api/v1/orders`} | 🆓 | {例如：订单列表} | ⏳ |
+| POST | {例如：`/api/v1/agents/:id/run`} | 🆓 | {例如：运行 Agent} | ⏳ |
+| GET | {例如：`/api/v1/agents/tasks`} | 🆓 | {例如：任务列表} | ⏳ |
+| GET | {例如：`/healthz`} | 🆓 | {例如：健康检查} | ⏳ |
+| {方法} | {路径} | — | {说明} | — |
+
+---
+
+**文档版本**：V1.0.0
+**创建日期**：{YYYY-MM-DD}
+**最后更新**：{YYYY-MM-DD}
+**文档状态**：✅ 待评审

skills/document-skills/full-stack-doc/templates/root/1、命名与品牌说明.md

@@ -0,0 +1,159 @@
+# {Name} 命名与品牌说明
+
+> **文档说明**：用于冻结产品品牌口径、命名规则、对外表达与产品边界。所有对外材料、文档、代码仓库命名均以本文为准。
+>
+> **版本**：V1.0.0
+> **最后更新**：{YYYY-MM-DD}
+
+---
+
+## 1. 品牌定位
+
+- **一句话定位**：{例如：面向中小电商的 AI 自动化运营平台}
+- **目标用户**：{例如：独立站卖家、跨境电商团队、MCN 机构}
+- **核心价值**：{例如：用 AI Agent 替代重复性电商操作，降低 80% 人工成本}
+
+| 维度 | 内容 |
+| :--- | :--- |
+| 产品类别 | {例如：AI Agent 平台 / SaaS 工具 / 开源基础设施} |
+| 核心受众 | {例如：电商运营人员、独立开发者} |
+| 竞争定位 | {例如：比 X 更智能，比 Y 更开放} |
+| 开源策略 | {例如：核心引擎开源，商业版增值} |
+
+---
+
+## 2. 命名由来
+
+### 2.1 前缀含义
+
+- **{例如：Octo}**：{例如：源自 Octopus（章鱼），象征多触手并行能力与智能协调}
+- 命名意图：{例如：暗示平台能同时操控多个平台、多条流程}
+
+### 2.2 后缀含义
+
+- **{例如：Ecom}**：{例如：Electronic Commerce 缩写，明确电商领域定位}
+- 组合效果：{例如：OctoEcom = 章鱼级电商自动化}
+
+### 2.3 开源版 vs 商业版（如适用）
+
+| 维度 | {Name-Open} (开源版) | {Name} (商业版) |
+| :--- | :--- | :--- |
+| 定位 | {例如：个人/小团队自部署} | {例如：企业级 SaaS} |
+| 许可证 | {例如：MIT / Apache 2.0} | {例如：商业许可} |
+| 核心差异 | {例如：单租户、本地存储} | {例如：多租户、云端治理} |
+| 技术栈 | {例如：Node.js / TypeScript} | {例如：Go + Python + PostgreSQL} |
+| 品牌关系 | 社区版、推广引擎 | 商业变现主体 |
+
+---
+
+## 3. 产品边界
+
+### 3.1 {Name} 是什么
+
+- {例如：基于 OpenClaw 编排引擎的电商自动化 Agent 平台}
+- {例如：提供选品、上架、定价、订单、客服等全链路 AI 操作}
+- {例如：支持淘宝、拼多多、Shopee、Amazon 等多平台}
+
+### 3.2 {Name} 不是什么
+
+- {例如：不是 ERP 系统（不做进销存管理）}
+- {例如：不是广告投放平台（不做 ROI 优化）}
+- {例如：不是通用 AI 对话工具（专注电商领域）}
+
+---
+
+## 4. 核心公式
+
+{Name} 的能力由以下分层组合而成：
+
+```
+{Name} = {例如：OpenClaw (编排层) + agency-agents (专家层) + OpenCLI (执行层) + Enterprise (企业层)}
+```
+
+### 4.1 分层职责
+
+| 层级 | 组件 | 职责 | 来源 |
+| :--- | :--- | :--- | :--- |
+| 编排层 | {例如：OpenClaw} | {例如：任务拆解、Agent 调度} | {例如：开源共享} |
+| 专家层 | {例如：agency-agents} | {例如：领域知识、策略执行} | {例如：开源 + 商业 Premium} |
+| 执行层 | {例如：OpenCLI} | {例如：平台 API 调用、浏览器控制} | {例如：开源共享} |
+| 企业层 | {例如：Enterprise Module} | {例如：多租户、审计、RBAC} | {例如：商业版独有} |
+
+---
+
+## 5. 品牌家族关系
+
+```mermaid
+graph LR
+    subgraph "Claw 生态"
+        OC["OpenClaw<br/>编排引擎"]
+        AA["agency-agents<br/>Agent 专家库"]
+        CLI["OpenCLI<br/>执行层"]
+    end
+
+    subgraph "{Name} 产品线"
+        OPEN["{Name-Open}<br/>开源版"]
+        BIZ["{Name}<br/>商业版"]
+    end
+
+    OC --> OPEN
+    OC --> BIZ
+    AA --> OPEN
+    AA --> BIZ
+    CLI --> OPEN
+    CLI --> BIZ
+    BIZ -->|"企业层<br/>多租户/审计/RBAC"| ENT["Enterprise<br/>Module"]
+```
+
+> **说明**：虚线/实线表示依赖强度。开源版与商业版共享编排/专家/执行三层，商业版额外包含企业层。
+
+---
+
+## 6. 对外表达规范
+
+| 场景 | 正确用法 | 错误用法 |
+| :--- | :--- | :--- |
+| 官方全称 | {Name} | {例如：octo-ecom, OCTOECOM} |
+| 代码仓库 | {例如：`octoecom`（全小写）} | {例如：`Octo_Ecom`, `octo-Ecom`} |
+| CLI 命令 | {例如：`octoecom`} | {例如：`OctoEcom`, `octo_ecom`} |
+| npm/pip 包 | {例如：`@octoecom/core`} | {例如：`@OctoEcom/Core`} |
+| 文档标题 | {Name} + 空格 + 文档名 | 无空格连写 |
+| 中文语境 | {例如：OctoEcom 电商平台} | {例如：OctoEcom电商平台（缺空格）} |
+
+---
+
+## 7. 品牌标识规范（可选）
+
+| 元素 | 规范 |
+| :--- | :--- |
+| Logo 主色 | {例如：#1A73E8（科技蓝）} |
+| 辅助色 | {例如：#34A853（成功绿）, #EA4335（警告红）} |
+| 字体 | {例如：Inter（英文）+ 思源黑体（中文）} |
+| 图标风格 | {例如：Outlined, 2px stroke, 24×24 基准} |
+| Favicon | {例如：章鱼触手简化图形，32×32} |
+
+---
+
+## 8. 文档体系
+
+本产品文档遵循 `full-stack-doc` 标准，完整文档索引如下：
+
+| 序号 | 文档 | 说明 |
+| :---: | :--- | :--- |
+| 1 | [命名与品牌说明](1、{Name}-命名与品牌说明.md) | 本文 |
+| 2 | [术语表与词汇表](2、{Name}-术语表与词汇表.md) | 统一语言 |
+| 3 | [市场与商业分析](3、{Name}-市场与商业分析.md) | 市场规模、竞品、定价 |
+| 4 | [技术与可行性分析](4、{Name}-技术与可行性分析.md) | 技术评估、风险 |
+| 5 | [技术方案与路线](5、{Name}-技术方案与路线.md) | 技术栈、里程碑 |
+| 6 | [产品与版本规划](6、{Name}-产品与版本规划.md) | 版本矩阵、定价 |
+| 7 | [领域模型设计](7、{Name}-领域模型设计.md) | DDD 限界上下文、聚合 |
+| 8 | [系统架构设计](8、{Name}-系统架构设计.md) | 分层架构、部署 |
+| 9 | [视觉与交互DNA规范](9、{Name}-视觉与交互DNA规范.md) | 色彩、字体、组件 |
+| 10 | [功能菜单与版本规划](10、{Name}-功能菜单与版本规划.md) | 导航、功能清单 |
+
+---
+
+**文档版本**：V1.0.0
+**创建日期**：{YYYY-MM-DD}
+**最后更新**：{YYYY-MM-DD}
+**文档状态**：✅ 待评审

skills/document-skills/full-stack-doc/templates/root/2、术语表与词汇表.md

@@ -0,0 +1,149 @@
+# {Name} 术语表与词汇表
+
+> **文档说明**：沉淀产品统一语言（Ubiquitous Language），用于产品、研发、设计、测试、运营跨角色对齐。所有文档、代码、UI 中的概念名称以本表为准。
+>
+> **版本**：V1.0.0
+> **最后更新**：{YYYY-MM-DD}
+
+---
+
+## 1. 文档信息 (Document Info)
+
+### 1.1 版本记录
+
+| 版本 | 日期 | 作者 | 变更说明 |
+| :--- | :--- | :--- | :--- |
+| V1.0.0 | {YYYY-MM-DD} | {姓名} | 初始版本 |
+
+### 1.2 文档责任人
+
+| 角色 | 姓名 | 职责 |
+| :--- | :--- | :--- |
+| 主编 | {姓名} | 术语定义与维护 |
+| 审核 | {姓名} | 术语一致性审查 |
+
+---
+
+## 2. 产品层术语
+
+| 术语 | 英文 | 定义 | 示例 |
+| :--- | :--- | :--- | :--- |
+| {例如：选品} | {例如：Product Selection} | {例如：从外部平台筛选合适商品的过程} | {例如：从 1688 采集商品到候选池} |
+| {例如：上架} | {例如：Product Listing} | {例如：将商品信息发布到目标平台} | {例如：将商品推送到淘宝店铺} |
+| {例如：定价策略} | {例如：Pricing Strategy} | {例如：根据规则自动计算销售价格} | {例如：成本 × 1.5 + 运费} |
+| {术语} | {English} | {定义} | {示例} |
+
+---
+
+## 3. 架构层术语
+
+### 3.1 编排层（{例如：OpenClaw}）
+
+| 术语 | 英文 | 定义 |
+| :--- | :--- | :--- |
+| {例如：Commander} | {例如：Commander} | {例如：任务编排入口，负责接收指令并拆解为子任务} |
+| {例如：TaskGraph} | {例如：Task Graph} | {例如：DAG 形式的任务依赖关系图} |
+| {例如：Cron Schedule} | {例如：Cron Schedule} | {例如：定时触发的编排任务配置} |
+| {术语} | {English} | {定义} |
+
+### 3.2 专家层（{例如：agency-agents}）
+
+| 术语 | 英文 | 定义 |
+| :--- | :--- | :--- |
+| {例如：Agent} | {例如：Agent} | {例如：具备特定领域能力的 AI 智能体} |
+| {例如：Premium Agent} | {例如：Premium Agent} | {例如：商业版独占的高级 Agent} |
+| {例如：Community Agent} | {例如：Community Agent} | {例如：社区贡献的开源 Agent} |
+| {术语} | {English} | {定义} |
+
+### 3.3 执行层（{例如：OpenCLI}）
+
+| 术语 | 英文 | 定义 |
+| :--- | :--- | :--- |
+| {例如：Platform Adapter} | {例如：Platform Adapter} | {例如：对接具体电商平台 API 的适配器} |
+| {例如：Browser Pool} | {例如：Browser Pool} | {例如：管理 Chrome 实例的连接池} |
+| {术语} | {English} | {定义} |
+
+### 3.4 企业层（{Name} 独有，按需）
+
+| 术语 | 英文 | 定义 |
+| :--- | :--- | :--- |
+| {例如：Tenant} | {例如：Tenant} | {例如：多租户模式下的独立租户} |
+| {例如：RBAC} | {例如：Role-Based Access Control} | {例如：基于角色的权限控制体系} |
+| {例如：Audit Log} | {例如：Audit Log} | {例如：关键操作的审计日志} |
+| {术语} | {English} | {定义} |
+
+---
+
+## 4. 业务流程术语
+
+| 术语 | 英文 | 定义 | 所属阶段 |
+| :--- | :--- | :--- | :--- |
+| {例如：采集} | {例如：Scraping} | {例如：从源平台抓取商品信息} | {例如：选品} |
+| {例如：铺货} | {例如：Bulk Listing} | {例如：批量将商品发布到多个店铺} | {例如：上架} |
+| {例如：跟卖} | {例如：Follow Sell} | {例如：跟随热销商品上架同款} | {例如：选品} |
+| {术语} | {English} | {定义} | {阶段} |
+
+---
+
+## 5. 平台与集成术语
+
+| 术语 | 英文 | 适用平台 | 定义 |
+| :--- | :--- | :--- | :--- |
+| {例如：店铺令牌} | {例如：Store Token} | {例如：淘宝/拼多多} | {例如：平台授权的 API 访问令牌} |
+| {例如：商品 SKU} | {例如：SKU} | {例如：通用} | {例如：库存管理的最小商品单位} |
+| {术语} | {English} | {平台} | {定义} |
+
+---
+
+## 6. 企业治理术语（按需）
+
+| 术语 | 英文 | 定义 | 适用版本 |
+| :--- | :--- | :--- | :--- |
+| {例如：配额} | {例如：Quota} | {例如：租户可使用的资源上限} | {例如：👥 专业版+} |
+| {例如：白标} | {例如：White Label} | {例如：企业自定义品牌展示} | {例如：🏢 企业版} |
+| {术语} | {English} | {定义} | {版本} |
+
+---
+
+## 7. 版本与状态术语
+
+| 术语 | 定义 | 标记 |
+| :--- | :--- | :--- |
+| P0 | 必须实现，阻塞发布 | 🔴 |
+| P1 | 重要，影响核心体验 | 🟠 |
+| P2 | 期望，提升用户体验 | 🟡 |
+| P3 | 可选，低优先级增强 | 🟢 |
+| MVP | Minimum Viable Product，最小可行产品 | — |
+| GA | General Availability，正式发布 | — |
+| RC | Release Candidate，发布候选 | — |
+| LTS | Long-Term Support，长期支持 | — |
+
+---
+
+## 8. 首字母缩略词
+
+| 缩写 | 全称 | 说明 |
+| :--- | :--- | :--- |
+| {例如：DDD} | {例如：Domain-Driven Design} | {例如：领域驱动设计} |
+| {例如：COLA} | {例如：Clean Object-oriented and Layered Architecture} | {例如：菱形分层架构} |
+| {例如：CQRS} | {例如：Command Query Responsibility Segregation} | {例如：命令查询职责分离} |
+| {例如：RBAC} | {例如：Role-Based Access Control} | {例如：基于角色的访问控制} |
+| {例如：SLA} | {例如：Service Level Agreement} | {例如：服务等级协议} |
+| {缩写} | {全称} | {说明} |
+
+---
+
+## 9. 使用规则
+
+1. **新术语必须先在本文定义**，再在其他文档中引用
+2. **代码中的命名应与本表英文一致**：类名、变量名、API 路径均使用英文术语
+3. **UI 中的标签使用中文术语**：按钮、标题、提示文字使用本表中文定义
+4. **术语变更需同步更新**：修改本文后，须检查 Doc 7（领域模型）和 Doc 8（系统架构）的一致性
+5. **中英混排**：中文与英文/数字间加空格（如 `Agent 调度` 而非 `Agent调度`）
+
+---
+
+**文档版本**：V1.0.0
+**创建日期**：{YYYY-MM-DD}
+**最后更新**：{YYYY-MM-DD}
+**文档状态**：✅ 待评审

skills/document-skills/full-stack-doc/templates/root/3、市场与商业分析.md

@@ -0,0 +1,205 @@
+# {Name} 市场与商业分析
+
+> **文档说明**：定义目标市场、客户分层、竞品格局、商业模式与定价策略，给产品路线和销售策略提供依据。
+>
+> **版本**：V1.0.0
+> **最后更新**：{YYYY-MM-DD}
+
+---
+
+## 1. 文档信息 (Document Info)
+
+### 1.1 版本记录
+
+| 版本 | 日期 | 作者 | 变更说明 |
+| :--- | :--- | :--- | :--- |
+| V1.0.0 | {YYYY-MM-DD} | {姓名} | 初始版本 |
+
+### 1.2 关联文档
+
+| 文档 | 关联说明 |
+| :--- | :--- |
+| [1、命名与品牌说明](1、{Name}-命名与品牌说明.md) | 产品边界与品牌定位 |
+| [5、技术方案与路线](5、{Name}-技术方案与路线.md) | 技术可行性约束 |
+| [6、产品与版本规划](6、{Name}-产品与版本规划.md) | 版本矩阵与定价策略 |
+
+---
+
+## 2. 市场机会判断
+
+### 2.1 问题定义
+
+{例如：中小电商卖家面临多平台运营效率低、人工成本高、合规风险大三大痛点。}
+
+### 2.2 机会假设
+
+- **机会 1**：{例如：AI Agent 替代重复性运营操作，效率提升 5–10 倍}
+- **机会 2**：{例如：跨平台统一管理减少工具碎片化}
+- **机会 3**：{例如：开源生态吸引开发者，形成社区壁垒}
+- **机会 4**：{例如：企业级治理需求催生 SaaS 付费意愿}
+
+> 数据来源：{例如：Statista 2025, 艾瑞咨询, 行业访谈}
+
+---
+
+## 3. 市场规模 (TAM / SAM / SOM)
+
+| 市场层级 | 定义 | 估算 | 数据来源 |
+| :--- | :--- | :--- | :--- |
+| TAM (Total Addressable Market) | {例如：全球电商 SaaS 工具市场} | {例如：$150B} | {例如：Gartner 2025} |
+| SAM (Serviceable Available Market) | {例如：AI 电商运营工具市场} | {例如：$8B} | {例如：CB Insights} |
+| SOM (Serviceable Obtainable Market) | {例如：中国 + 东南亚中小卖家} | {例如：$200M, 3 年目标} | {例如：行业估算} |
+
+> **估算方法**：{例如：自下而上 = 目标用户数 × ARPU × 付费率}
+
+---
+
+## 4. 目标客户
+
+### 4.1 按规模细分
+
+| 客户类型 | 特征 | 痛点 | 付费意愿 |
+| :--- | :--- | :--- | :--- |
+| {例如：个人卖家} | {例如：1-2 人，月 GMV <10 万} | {例如：时间不够，多平台切换} | {例如：低，偏免费/低价} |
+| {例如：小微团队} | {例如：3-10 人，月 GMV 10-100 万} | {例如：人效低，缺自动化} | {例如：中，¥99-299/月} |
+| {例如：中型企业} | {例如：10-50 人，月 GMV >100 万} | {例如：合规、审计、多账号管理} | {例如：高，¥999+/月} |
+
+### 4.2 按场景细分
+
+| 场景 | 用户画像 | 核心需求 |
+| :--- | :--- | :--- |
+| {例如：跨境电商} | {例如：Amazon/Shopee 卖家} | {例如：多语言上架、汇率定价} |
+| {例如：国内电商} | {例如：淘宝/拼多多卖家} | {例如：批量铺货、自动改价} |
+| {场景} | {画像} | {需求} |
+
+---
+
+## 5. 竞品分析
+
+### 5.1 竞品类型
+
+| 类型 | 代表产品 | 与 {Name} 关系 |
+| :--- | :--- | :--- |
+| {例如：传统 ERP} | {例如：聚水潭、旺店通} | {例如：互补（ERP 管库存，{Name} 管运营）} |
+| {例如：AI 运营工具} | {例如：DataHunter, 店小蜜} | {例如：直接竞争} |
+| {例如：开源自动化} | {例如：n8n, Dify} | {例如：通用竞争（非电商专用）} |
+
+### 5.2 对比矩阵
+
+```mermaid
+quadrantChart
+    title 竞品定位矩阵
+    x-axis "通用" --> "电商专用"
+    y-axis "手动配置" --> "AI 自动化"
+    "聚水潭": [0.8, 0.2]
+    "n8n": [0.2, 0.5]
+    "店小蜜": [0.7, 0.6]
+    "{Name}": [0.9, 0.9]
+```
+
+### 5.3 竞品功能矩阵
+
+| 能力 | {Name} | {例如：竞品 A} | {例如：竞品 B} | {例如：竞品 C} |
+| :--- | :---: | :---: | :---: | :---: |
+| {例如：多平台支持} | ✅ | ⚠️ | ✅ | ❌ |
+| {例如：AI Agent 编排} | ✅ | ❌ | ⚠️ | ❌ |
+| {例如：开源可自部署} | ✅ | ❌ | ❌ | ✅ |
+| {例如：企业级 RBAC} | ✅ | ✅ | ❌ | ❌ |
+| {能力} | — | — | — | — |
+
+---
+
+## 6. SWOT 分析
+
+| | 有利 | 不利 |
+| :--- | :--- | :--- |
+| **内部** | **Strengths**<br/>- {例如：开源生态获客成本低}<br/>- {例如：AI Agent 技术壁垒}<br/>- {例如：多平台执行层成熟} | **Weaknesses**<br/>- {例如：团队规模小}<br/>- {例如：品牌知名度不足}<br/>- {例如：企业级功能尚不完整} |
+| **外部** | **Opportunities**<br/>- {例如：AI 电商赛道快速增长}<br/>- {例如：中小卖家降本需求强烈}<br/>- {例如：竞品缺乏开源方案} | **Threats**<br/>- {例如：大厂入场（如阿里/字节）}<br/>- {例如：平台 API 政策变化}<br/>- {例如：开源竞品模仿} |
+
+---
+
+## 7. 商业模式与定价
+
+### 7.1 商业模式画布
+
+| 要素 | 内容 |
+| :--- | :--- |
+| 价值主张 | {例如：AI 驱动的电商全自动运营} |
+| 客户关系 | {例如：开源社区 → 免费用户 → 付费转化} |
+| 渠道 | {例如：GitHub、技术社区、KOL 推广} |
+| 关键资源 | {例如：AI 模型、平台 Adapter、社区} |
+| 收入来源 | {例如：订阅 + 增值 + 企业定制} |
+
+### 7.2 定价方案
+
+| 档位 | 标签 | 月价 | 核心权益 |
+| :--- | :--- | :--- | :--- |
+| 免费版 | 🆓 Free | ¥0 | {例如：3 个 Agent、1 个店铺、社区支持} |
+| 个人版 | 👤 Pro | {例如：¥99} | {例如：10 个 Agent、5 个店铺、邮件支持} |
+| 专业版 | 👥 Team | {例如：¥299} | {例如：无限 Agent、20 个店铺、优先支持} |
+| 企业版 | 🏢 Enterprise | {例如：议价} | {例如：私有部署、RBAC、SLA、专属顾问} |
+
+### 7.3 增值收入
+
+- {例如：Premium Agent 市场（按 Agent 付费）}
+- {例如：数据分析增值包}
+- {例如：API 调用量计费}
+
+### 7.4 开源转商业漏斗
+
+```mermaid
+---
+config:
+  sankey:
+    showValues: false
+---
+sankey-beta
+    GitHub Star,开源用户,1000
+    开源用户,免费注册,400
+    免费注册,活跃使用,200
+    活跃使用,付费转化,40
+    付费转化,企业版,8
+```
+
+---
+
+## 8. 风险与应对
+
+### 8.1 市场风险
+
+| 风险 | 影响 | 概率 | 应对措施 |
+| :--- | :--- | :--- | :--- |
+| {例如：大厂推出类似产品} | 高 | 中 | {例如：深耕垂直场景，保持开源优势} |
+| {例如：目标市场增速放缓} | 中 | 低 | {例如：拓展东南亚/拉美市场} |
+
+### 8.2 技术风险
+
+| 风险 | 影响 | 概率 | 应对措施 |
+| :--- | :--- | :--- | :--- |
+| {例如：平台 API 限制/封号} | 高 | 中 | {例如：多通道降级、浏览器 fallback} |
+| {例如：AI 模型成本过高} | 中 | 中 | {例如：本地模型 + 缓存策略} |
+
+### 8.3 商业风险
+
+| 风险 | 影响 | 概率 | 应对措施 |
+| :--- | :--- | :--- | :--- |
+| {例如：付费转化率低于预期} | 高 | 中 | {例如：优化 onboarding、增加试用期} |
+| {例如：客户流失率过高} | 中 | 低 | {例如：增值功能锁定、社区粘性} |
+
+---
+
+## 9. 里程碑与关键指标
+
+| 里程碑 | 时间 | 关键指标 |
+| :--- | :--- | :--- |
+| {例如：开源版发布} | {例如：2026 Q2} | {例如：GitHub Stars >500, 周活 >100} |
+| {例如：商业版 Beta} | {例如：2026 Q3} | {例如：付费用户 >50, MRR >¥10K} |
+| {例如：商业版 GA} | {例如：2026 Q4} | {例如：付费用户 >200, MRR >¥50K} |
+| {里程碑} | {时间} | {指标} |
+
+---
+
+**文档版本**：V1.0.0
+**创建日期**：{YYYY-MM-DD}
+**最后更新**：{YYYY-MM-DD}
+**文档状态**：✅ 待评审

skills/document-skills/full-stack-doc/templates/root/4、技术与可行性分析.md

@@ -0,0 +1,231 @@
+# {Name} 技术与可行性分析
+
+> **文档说明**：分析技术成熟度、实现成本、安全合规与性能扩展性，为技术方案与架构设计提供决策依据。按产品分层逐一评估可行性。
+>
+> **版本**：V1.0.0
+> **最后更新**：{YYYY-MM-DD}
+
+---
+
+## 1. 文档信息
+
+### 1.1 版本记录
+
+| 版本 | 日期 | 作者 | 变更说明 |
+| :--- | :--- | :--- | :--- |
+| V1.0.0 | {YYYY-MM-DD} | {姓名} | 初始版本 |
+
+### 1.2 关联文档
+
+| 文档 | 关联说明 |
+| :--- | :--- |
+| [3、市场与商业分析](3、{Name}-市场与商业分析.md) | 市场机会与商业约束 |
+| [5、技术方案与路线](5、{Name}-技术方案与路线.md) | 技术选型与实施方案 |
+| [8、系统架构设计](8、{Name}-系统架构设计.md) | 架构设计承接 |
+
+### 1.3 评估标准
+
+| 等级 | 图标 | 定义 |
+| :--- | :---: | :--- |
+| 高可行 | ✅ | 技术成熟、团队有经验、风险可控 |
+| 中可行 | ⚠️ | 技术可用但需额外投入或验证 |
+| 低可行 | 🔴 | 技术不成熟或风险过高，需替代方案 |
+
+---
+
+## 2. 编排层可行性（{例如：OpenClaw}）
+
+### 2.1 评估结论：✅ 高可行
+
+| 维度 | 评估 | 说明 |
+| :--- | :---: | :--- |
+| 技术成熟度 | ✅ | {例如：已有生产环境验证，稳定运行 6+ 月} |
+| 团队适配度 | ✅ | {例如：核心团队为框架原作者} |
+| 业务适配度 | ✅ | {例如：任务编排、DAG 调度完全匹配需求} |
+
+### 2.2 关键技术点
+
+- {例如：任务拆解（Divide & Conquer）}
+- {例如：状态机管理（Plan → Execute → Review → Finalize）}
+- {例如：多 Agent 并行调度}
+
+```mermaid
+flowchart TD
+    CMD["Commander<br/>接收指令"] --> PLAN["Plan<br/>任务拆解"]
+    PLAN --> EXEC["Execute<br/>Agent 执行"]
+    EXEC --> REV["Review<br/>结果审查"]
+    REV -->|通过| FIN["Finalize<br/>完成"]
+    REV -->|失败| RETRY["Retry<br/>重试/降级"]
+    RETRY --> EXEC
+```
+
+---
+
+## 3. 专家层可行性（{例如：agency-agents}）
+
+### 3.1 评估结论：✅ 高可行
+
+| 维度 | 评估 | 说明 |
+| :--- | :---: | :--- |
+| 技术成熟度 | ✅ | {例如：LLM 调用链成熟，Prompt 模板体系完善} |
+| 团队适配度 | ✅ | {例如：团队有 AI 工程经验} |
+| 业务适配度 | ⚠️ | {例如：部分垂直场景 Agent 需要行业数据训练} |
+
+### 3.2 Agent 技术栈
+
+| 组件 | 技术 | 说明 |
+| :--- | :--- | :--- |
+| {例如：LLM 调用} | {例如：OpenAI API / 本地 Ollama} | {例如：可切换模型} |
+| {例如：Prompt 管理} | {例如：Template + Few-shot} | {例如：版本化管理} |
+| {例如：工具调用} | {例如：Function Calling} | {例如：平台 API 映射} |
+
+### 3.3 Agent 分级体系
+
+| 级别 | 来源 | 质量保证 | 可用范围 |
+| :--- | :--- | :--- | :--- |
+| {例如：Core Agent} | {例如：官方开发} | {例如：全量测试 + SLA} | {例如：全版本} |
+| {例如：Premium Agent} | {例如：官方 + 合作伙伴} | {例如：审核 + 测试} | {例如：商业版} |
+| {例如：Community Agent} | {例如：社区贡献} | {例如：社区评分} | {例如：开源版} |
+
+---
+
+## 4. 执行层可行性（{例如：OpenCLI}）
+
+### 4.1 评估结论：✅ 高可行
+
+| 维度 | 评估 | 说明 |
+| :--- | :---: | :--- |
+| 技术成熟度 | ✅ | {例如：CLI + Adapter 模式已验证} |
+| 团队适配度 | ✅ | {例如：团队有 Puppeteer/Playwright 经验} |
+| 业务适配度 | ⚠️ | {例如：平台 API 变更频繁，需持续维护} |
+
+### 4.2 平台接入验证
+
+| 平台 | 接入方式 | 验证状态 | 备注 |
+| :--- | :--- | :---: | :--- |
+| {例如：淘宝} | {例如：开放 API + 浏览器} | ✅ | {例如：需商家授权} |
+| {例如：拼多多} | {例如：开放 API} | ✅ | {例如：API 限流较严} |
+| {例如：Amazon} | {例如：SP-API + MWS} | ⚠️ | {例如：需 Developer 注册} |
+| {平台} | {方式} | — | {备注} |
+
+### 4.3 浏览器控制方案
+
+```mermaid
+sequenceDiagram
+    participant Agent
+    participant CLI as OpenCLI
+    participant Browser as Chrome Pool
+    participant Platform as 电商平台
+
+    Agent->>CLI: 执行操作指令
+    CLI->>Browser: 获取 Chrome 实例
+    Browser->>Platform: 模拟用户操作
+    Platform-->>Browser: 返回页面结果
+    Browser-->>CLI: 解析结果
+    CLI-->>Agent: 返回结构化数据
+```
+
+---
+
+## 5. 企业层可行性（{Name} 独有，按需）
+
+### 5.1 评估结论：✅ 高可行
+
+| 维度 | 评估 | 说明 |
+| :--- | :---: | :--- |
+| 技术成熟度 | ✅ | {例如：多租户、RBAC 为成熟模式} |
+| 团队适配度 | ⚠️ | {例如：需补充 SaaS 运营经验} |
+| 业务适配度 | ✅ | {例如：企业客户明确需要审计与权限} |
+
+### 5.2 多租户隔离方案
+
+```mermaid
+flowchart TD
+    subgraph "租户 A"
+        A_DB[(DB Schema A)]
+        A_Agent["Agent Pool A"]
+    end
+    subgraph "租户 B"
+        B_DB[(DB Schema B)]
+        B_Agent["Agent Pool B"]
+    end
+    GW["API Gateway"] --> A_Agent
+    GW --> B_Agent
+    A_Agent --> A_DB
+    B_Agent --> B_DB
+```
+
+| 隔离策略 | 优点 | 缺点 | 推荐场景 |
+| :--- | :--- | :--- | :--- |
+| {例如：Schema 级隔离} | {例如：成本低，迁移简单} | {例如：大租户可能有噪声邻居} | {例如：专业版} |
+| {例如：Database 级隔离} | {例如：完全隔离} | {例如：运维成本高} | {例如：企业版} |
+
+### 5.3 RBAC 角色矩阵
+
+| 角色 | 查看 | 编辑 | 管理 Agent | 管理团队 | 审计日志 |
+| :--- | :---: | :---: | :---: | :---: | :---: |
+| {例如：Owner} | ✅ | ✅ | ✅ | ✅ | ✅ |
+| {例如：Admin} | ✅ | ✅ | ✅ | ✅ | ❌ |
+| {例如：Operator} | ✅ | ✅ | ✅ | ❌ | ❌ |
+| {例如：Viewer} | ✅ | ❌ | ❌ | ❌ | ❌ |
+
+---
+
+## 6. 安全与合规可行性
+
+### 6.1 评估结论：⚠️ 中可行（需持续建设）
+
+| 安全维度 | 现状 | 目标 | 差距 |
+| :--- | :--- | :--- | :--- |
+| {例如：数据加密} | {例如：传输 TLS 已实现} | {例如：静态 AES-256} | {例如：存储加密待实现} |
+| {例如：凭证管理} | {例如：环境变量} | {例如：Vault/KMS} | {例如：需引入密钥管理} |
+| {例如：审计} | {例如：无} | {例如：全操作审计} | {例如：需新建审计模块} |
+| {例如：合规认证} | {例如：无} | {例如：SOC2 / 等保} | {例如：V3.0 启动} |
+
+---
+
+## 7. 性能与扩展性评估
+
+| 维度 | 目标 | 当前能力 | 差距 | 优化方向 |
+| :--- | :--- | :--- | :--- | :--- |
+| {例如：并发 Agent} | {例如：100 并发/租户} | {例如：10 并发} | {例如：10×} | {例如：Worker Pool + 队列} |
+| {例如：API 响应} | {例如：P99 < 500ms} | {例如：P99 ~800ms} | {例如：优化 DB 查询} | {例如：索引 + 缓存} |
+| {例如：存储扩展} | {例如：TB 级} | {例如：GB 级} | {例如：需分片} | {例如：对象存储 + 归档} |
+
+---
+
+## 8. 技术风险总表
+
+| # | 风险描述 | 影响 | 概率 | 缓解措施 | 负责人 |
+| :---: | :--- | :---: | :---: | :--- | :--- |
+| R1 | {例如：平台 API 限流导致任务堆积} | 高 | 中 | {例如：限流降级 + 队列缓冲} | {姓名} |
+| R2 | {例如：LLM 调用成本超预算} | 中 | 高 | {例如：本地模型 fallback + Token 缓存} | {姓名} |
+| R3 | {例如：浏览器指纹被平台识别} | 高 | 中 | {例如：指纹随机化 + IP 轮换} | {姓名} |
+| R4 | {例如：多租户数据泄露} | 高 | 低 | {例如：Schema 隔离 + 行级安全} | {姓名} |
+| RN | {风险} | — | — | {措施} | {姓名} |
+
+---
+
+## 9. 结论
+
+### 9.1 总体评估
+
+| 层级 | 可行性 | 核心优势 | 主要风险 |
+| :--- | :---: | :--- | :--- |
+| 编排层 | ✅ | {例如：成熟引擎，团队自研} | {例如：状态机复杂度} |
+| 专家层 | ✅ | {例如：LLM 能力成熟} | {例如：领域 Agent 需持续训练} |
+| 执行层 | ✅ | {例如：多平台 Adapter 验证} | {例如：平台 API 变更频繁} |
+| 企业层 | ✅ | {例如：多租户模式成熟} | {例如：安全合规需持续投入} |
+
+### 9.2 建议
+
+1. {例如：V1.0 优先交付编排层 + 执行层，专家层使用 Core Agent}
+2. {例如：V2.0 补齐企业层 RBAC + 审计}
+3. {例如：安全合规作为持续性投入，V3.0 前完成等保/SOC2 基线}
+
+---
+
+**文档版本**：V1.0.0
+**创建日期**：{YYYY-MM-DD}
+**最后更新**：{YYYY-MM-DD}
+**文档状态**：✅ 待评审

skills/document-skills/full-stack-doc/templates/root/5、技术方案与路线.md

@@ -0,0 +1,361 @@
+# {Name} 技术方案与路线
+
+> **文档说明**：沉淀技术选型结论、分层方案设计、关键组件细节、ADR 决策记录与里程碑路线。为系统架构设计和版本研发提供技术基线。
+>
+> **版本**：V1.0.0
+> **最后更新**：{YYYY-MM-DD}
+
+---
+
+## 1. 文档信息
+
+### 1.1 版本记录
+
+| 版本 | 日期 | 作者 | 变更说明 |
+| :--- | :--- | :--- | :--- |
+| V1.0.0 | {YYYY-MM-DD} | {姓名} | 初始版本 |
+
+### 1.2 关联文档
+
+| 文档 | 关联说明 |
+| :--- | :--- |
+| [4、技术与可行性分析](4、{Name}-技术与可行性分析.md) | 可行性评估结论 |
+| [6、产品与版本规划](6、{Name}-产品与版本规划.md) | 版本节奏对齐 |
+| [8、系统架构设计](8、{Name}-系统架构设计.md) | 架构设计承接 |
+
+---
+
+## 2. 技术选型总览
+
+### 2.1 核心技术栈
+
+| 层级 | 技术 | 版本 | 说明 |
+| :--- | :--- | :--- | :--- |
+| {例如：编排引擎} | {例如：OpenClaw (Rust)} | {例如：≥0.5} | {例如：任务编排与 Agent 调度} |
+| {例如：后端 API} | {例如：Go / Node.js} | {例如：≥1.22 / ≥20} | {例如：REST API 服务} |
+| {例如：AI 推理} | {例如：Python} | {例如：≥3.11} | {例如：LLM 调用、数据提取} |
+| {例如：前端 Web} | {例如：Vue 3 + Element Plus} | {例如：≥3.4} | {例如：管理控制台} |
+| {例如：移动端} | {例如：UniApp-x + uView Pro} | {例如：latest} | {例如：移动端适配} |
+| {例如：数据库} | {例如：PostgreSQL} | {例如：≥15} | {例如：元数据存储} |
+| {例如：缓存} | {例如：Redis} | {例如：≥7} | {例如：热数据缓存、任务队列} |
+| {例如：消息队列} | {例如：NATS / RabbitMQ} | {例如：latest} | {例如：异步任务分发} |
+| {例如：对象存储} | {例如：MinIO / S3} | {例如：latest} | {例如：文件与快照存储} |
+
+### 2.2 技术选型决策矩阵
+
+| 决策点 | 候选 A | 候选 B | 选择 | 理由 |
+| :--- | :--- | :--- | :--- | :--- |
+| {例如：后端语言} | {例如：Go} | {例如：Node.js} | {例如：Go} | {例如：并发性能、类型安全} |
+| {例如：数据库} | {例如：PostgreSQL} | {例如：MySQL} | {例如：PostgreSQL} | {例如：JSON 支持、扩展生态} |
+| {例如：前端框架} | {例如：Vue 3} | {例如：React} | {例如：Vue 3} | {例如：团队经验、生态成熟} |
+| {决策点} | {A} | {B} | {选择} | {理由} |
+
+---
+
+## 3. 编排层技术方案
+
+### 3.1 编排引擎集成
+
+- {例如：基于 OpenClaw Commander 的任务编排}
+- {例如：DAG 式任务拆解，支持并行/串行/条件分支}
+
+```mermaid
+flowchart LR
+    INPUT["用户指令"] --> CMD["Commander"]
+    CMD --> PLAN["Task Planner"]
+    PLAN --> |"子任务 1"| A1["Agent A"]
+    PLAN --> |"子任务 2"| A2["Agent B"]
+    PLAN --> |"子任务 3"| A3["Agent C"]
+    A1 --> MERGE["Result Merger"]
+    A2 --> MERGE
+    A3 --> MERGE
+    MERGE --> OUTPUT["执行结果"]
+```
+
+### 3.2 调度方案
+
+| 调度类型 | 实现 | 示例 |
+| :--- | :--- | :--- |
+| {例如：即时任务} | {例如：REST API 触发} | {例如：用户点击「立即采集」} |
+| {例如：定时任务} | {例如：Cron 表达式} | {例如：每日 8:00 自动改价} |
+| {例如：事件触发} | {例如：Webhook / MQ} | {例如：新订单触发发货流程} |
+
+### 3.3 多渠道输入
+
+```mermaid
+flowchart LR
+    WEB["Web Console"] --> GW["API Gateway"]
+    CLI_CMD["CLI 命令"] --> GW
+    IM["IM Bot<br/>（微信/飞书）"] --> GW
+    CRON["Cron 调度器"] --> GW
+    GW --> CMD["Commander"]
+```
+
+---
+
+## 4. 专家层技术方案
+
+### 4.1 Agent 模板规范
+
+```yaml
+# Agent 模板示例
+name: "{例如：product-selector}"
+version: "1.0.0"
+category: "{例如：选品}"
+tier: "{例如：core | premium | community}"
+description: "{例如：从源平台筛选合适商品}"
+inputs:
+  - name: "source_platform"
+    type: "string"
+    required: true
+  - name: "criteria"
+    type: "object"
+outputs:
+  - name: "product_list"
+    type: "array"
+tools:
+  - "{例如：platform.search}"
+  - "{例如：platform.getDetail}"
+llm:
+  model: "{例如：gpt-4o-mini}"
+  temperature: 0.3
+```
+
+### 4.2 Agent 分类体系
+
+| 类别 | 说明 | 示例 |
+| :--- | :--- | :--- |
+| {例如：Core Agent} | {例如：官方内置，覆盖核心流程} | {例如：选品、上架、定价} |
+| {例如：Premium Agent} | {例如：商业版专属，高级能力} | {例如：竞品监控、智能定价} |
+| {例如：Community Agent} | {例如：社区贡献，开放注册} | {例如：自定义选品规则} |
+
+---
+
+## 5. 执行层技术方案
+
+### 5.1 命令规范
+
+```bash
+# CLI 命令示例
+{例如：opencli} platform list                    # 列出已连接平台
+{例如：opencli} product scrape --platform taobao  # 采集商品
+{例如：opencli} order sync --store my-store       # 同步订单
+{例如：opencli} agent run product-selector        # 运行 Agent
+```
+
+### 5.2 平台适配器接口
+
+```typescript
+// 平台适配器抽象接口示例
+interface PlatformAdapter {
+  /** 适配器唯一标识 */
+  readonly id: string;
+  /** 平台名称 */
+  readonly name: string;
+  /** 初始化连接 */
+  connect(credentials: Credentials): Promise<void>;
+  /** 搜索商品 */
+  searchProducts(query: SearchQuery): Promise<Product[]>;
+  /** 上架商品 */
+  listProduct(product: ProductDraft): Promise<ListingResult>;
+  /** 同步订单 */
+  syncOrders(since: Date): Promise<Order[]>;
+  /** 健康检查 */
+  healthCheck(): Promise<HealthStatus>;
+}
+```
+
+### 5.3 浏览器控制方案
+
+| 方案 | 适用场景 | 优点 | 缺点 |
+| :--- | :--- | :--- | :--- |
+| {例如：Playwright} | {例如：复杂页面操作} | {例如：API 稳定、多浏览器} | {例如：资源占用较高} |
+| {例如：CDP 直连} | {例如：轻量操作} | {例如：低开销} | {例如：需自行管理生命周期} |
+
+---
+
+## 6. 企业层技术方案
+
+### 6.1 多租户实现
+
+| 隔离级别 | 实现方式 | 适用版本 |
+| :--- | :--- | :--- |
+| {例如：Row-Level} | {例如：`tenant_id` 列 + RLS Policy} | {例如：👥 专业版} |
+| {例如：Schema-Level} | {例如：PostgreSQL Schema 隔离} | {例如：🏢 企业版} |
+
+### 6.2 RBAC 实现
+
+```mermaid
+erDiagram
+    TENANT ||--o{ USER : has
+    USER ||--o{ USER_ROLE : assigned
+    ROLE ||--o{ USER_ROLE : contains
+    ROLE ||--o{ ROLE_PERMISSION : grants
+    PERMISSION ||--o{ ROLE_PERMISSION : included_in
+
+    TENANT {
+        uuid id PK
+        string name
+        string plan
+    }
+    USER {
+        uuid id PK
+        uuid tenant_id FK
+        string email
+    }
+    ROLE {
+        uuid id PK
+        string name
+        string scope
+    }
+    PERMISSION {
+        uuid id PK
+        string resource
+        string action
+    }
+```
+
+### 6.3 审计日志方案
+
+| 字段 | 类型 | 说明 |
+| :--- | :--- | :--- |
+| `id` | UUID | 日志 ID |
+| `tenant_id` | UUID | 租户 |
+| `actor_id` | UUID | 操作者 |
+| `action` | string | 操作类型 |
+| `resource` | string | 操作对象 |
+| `payload` | JSON | 变更详情 |
+| `timestamp` | datetime | 操作时间 |
+| `ip` | string | 客户端 IP |
+
+### 6.4 Web Console 技术方案
+
+| 技术 | 版本 | 用途 |
+| :--- | :--- | :--- |
+| {例如：Vue 3} | {例如：3.4+} | {例如：UI 框架} |
+| {例如：Element Plus} | {例如：2.8+} | {例如：组件库} |
+| {例如：Pinia} | {例如：2.x} | {例如：状态管理} |
+| {例如：Vue Router} | {例如：4.x} | {例如：路由} |
+| {例如：Axios} | {例如：1.x} | {例如：HTTP 客户端} |
+| {例如：lime-echart} | {例如：latest} | {例如：图表组件} |
+
+---
+
+## 7. 技术决策记录 (ADR)
+
+| ADR# | 决策 | 状态 | 背景 | 后果 |
+| :--- | :--- | :--- | :--- | :--- |
+| ADR-001 | {例如：选择 Go 作为 API 层语言} | ✅ Accepted | {例如：需要高并发处理能力} | {例如：编译部署简单，但 AI 生态需通过 Python sidecar} |
+| ADR-002 | {例如：PostgreSQL 替代 MySQL} | ✅ Accepted | {例如：需 JSON 查询 + pgvector} | {例如：运维复杂度略增} |
+| ADR-003 | {例如：采用 Schema 级租户隔离} | ✅ Accepted | {例如：企业客户数据隔离要求} | {例如：迁移脚本需按租户执行} |
+| ADR-NNN | {决策} | — | {背景} | {后果} |
+
+---
+
+## 8. 分阶段技术路线
+
+### 8.1 技术路线 Gantt
+
+```mermaid
+gantt
+    title {Name} 技术路线
+    dateFormat YYYY-MM-DD
+    axisFormat %Y-%m
+
+    section V1.0 MVP
+    编排层核心          :v1_1, 2026-04-01, 60d
+    执行层 Adapter ×3   :v1_2, 2026-04-15, 45d
+    Core Agent ×5       :v1_3, 2026-05-01, 30d
+    Web Console 基础    :v1_4, 2026-05-15, 30d
+    集成测试 & Beta     :v1_5, after v1_4, 15d
+
+    section V2.0 商业版
+    多租户 + RBAC       :v2_1, 2026-07-01, 45d
+    审计日志            :v2_2, 2026-07-15, 30d
+    Premium Agent ×3    :v2_3, 2026-07-01, 45d
+    计费与定价          :v2_4, 2026-08-01, 30d
+
+    section V3.0 企业版
+    Schema 级隔离       :v3_1, 2026-10-01, 30d
+    私有部署支持        :v3_2, 2026-10-15, 45d
+    SOC2 / 等保基线     :v3_3, 2026-11-01, 60d
+```
+
+### 8.2 版本交付清单
+
+| 版本 | 时间 | 关键交付 |
+| :--- | :--- | :--- |
+| V1.0 MVP | {例如：2026 Q2} | {例如：编排 + 执行 + 5 Core Agent + Web Console} |
+| V2.0 商业版 | {例如：2026 Q3} | {例如：多租户 + RBAC + 审计 + Premium Agent + 计费} |
+| V3.0 企业版 | {例如：2026 Q4} | {例如：Schema 隔离 + 私有部署 + 合规} |
+| V4.0 生态版 | {例如：2027 Q1} | {例如：Agent 市场 + 插件系统 + 开放 API} |
+
+---
+
+## 9. 部署方案
+
+### 9.1 部署架构
+
+```mermaid
+flowchart TD
+    subgraph "用户端"
+        WEB["Web Console"]
+        CLI["CLI"]
+        MOB["Mobile App"]
+    end
+
+    subgraph "接入层"
+        LB["Load Balancer<br/>Nginx / Caddy"]
+    end
+
+    subgraph "应用层"
+        API["API Server<br/>(Go/Node)"]
+        WORKER["Worker<br/>(Python)"]
+        CRON["Cron Scheduler"]
+    end
+
+    subgraph "数据层"
+        PG[(PostgreSQL)]
+        REDIS[(Redis)]
+        MQ["Message Queue"]
+        OSS["Object Storage"]
+    end
+
+    WEB --> LB
+    CLI --> LB
+    MOB --> LB
+    LB --> API
+    API --> PG
+    API --> REDIS
+    API --> MQ
+    MQ --> WORKER
+    WORKER --> PG
+    WORKER --> OSS
+    CRON --> MQ
+```
+
+### 9.2 部署选项
+
+| 部署模式 | 适用 | 技术 | 说明 |
+| :--- | :--- | :--- | :--- |
+| {例如：Docker Compose} | {例如：开发 / 小规模} | {例如：docker compose up} | {例如：单机部署，最快上手} |
+| {例如：Kubernetes} | {例如：生产 / SaaS} | {例如：Helm Chart} | {例如：自动扩缩容} |
+| {例如：私有化} | {例如：企业版} | {例如：离线安装包} | {例如：客户自有机房} |
+
+---
+
+## 10. 监控与可观测性
+
+| 维度 | 工具 | 指标 |
+| :--- | :--- | :--- |
+| {例如：Metrics} | {例如：Prometheus + Grafana} | {例如：QPS、延迟、错误率} |
+| {例如：Logging} | {例如：ELK / Loki} | {例如：结构化日志、错误追踪} |
+| {例如：Tracing} | {例如：OpenTelemetry + Jaeger} | {例如：请求链路、Agent 执行跟踪} |
+| {例如：Alerting} | {例如：AlertManager / PagerDuty} | {例如：SLA 违约、任务堆积} |
+
+---
+
+**文档版本**：V1.0.0
+**创建日期**：{YYYY-MM-DD}
+**最后更新**：{YYYY-MM-DD}
+**文档状态**：✅ 待评审

skills/document-skills/full-stack-doc/templates/root/6、产品与版本规划.md

@@ -0,0 +1,238 @@
+# {Name} 产品与版本规划
+
+> **文档说明**：定义产品定位、版本体系、功能演进路线与商业化节奏，作为研发与商业协同基线。
+>
+> **版本**：V1.0.0
+> **最后更新**：{YYYY-MM-DD}
+
+---
+
+## 1. 文档信息
+
+### 1.1 版本记录
+
+| 版本 | 日期 | 作者 | 变更说明 |
+| :--- | :--- | :--- | :--- |
+| V1.0.0 | {YYYY-MM-DD} | {姓名} | 初始版本 |
+
+### 1.2 关联文档
+
+| 文档 | 关联说明 |
+| :--- | :--- |
+| [3、市场与商业分析](3、{Name}-市场与商业分析.md) | 商业模式与定价 |
+| [5、技术方案与路线](5、{Name}-技术方案与路线.md) | 技术路线与里程碑 |
+| [10、功能菜单与版本规划](10、{Name}-功能菜单与版本规划.md) | 功能清单与版本分布 |
+
+---
+
+## 2. 产品定位
+
+### 2.1 一句话定位
+
+{例如：面向中小电商卖家的 AI 自动化运营平台，让 Agent 替你开店。}
+
+### 2.2 核心价值主张
+
+| 价值 | 说明 |
+| :--- | :--- |
+| {例如：效率} | {例如：AI Agent 替代重复操作，降低 80% 人工成本} |
+| {例如：覆盖} | {例如：多平台统一管理，告别工具碎片化} |
+| {例如：智能} | {例如：AI 驱动选品、定价、客服，数据驱动决策} |
+| {例如：开放} | {例如：开源核心引擎，社区驱动创新} |
+
+### 2.3 产品边界
+
+```mermaid
+graph LR
+    subgraph "{Name} 做"
+        A["选品采集"]
+        B["商品上架"]
+        C["智能定价"]
+        D["订单履约"]
+        E["客服回复"]
+        F["数据报表"]
+    end
+
+    subgraph "{Name} 不做"
+        X["进销存管理"]
+        Y["广告投放"]
+        Z["物流仓储"]
+    end
+
+    style X fill:#fee,stroke:#f99
+    style Y fill:#fee,stroke:#f99
+    style Z fill:#fee,stroke:#f99
+```
+
+---
+
+## 3. 版本体系
+
+### 3.1 开源与商业关系（如适用）
+
+```mermaid
+graph TD
+    OPEN["{Name-Open}<br/>开源版"] -->|"共享核心"| CORE["编排 + 执行 + Core Agent"]
+    BIZ["{Name}<br/>商业版"] -->|"共享核心"| CORE
+    BIZ -->|"独占"| ENT["企业层<br/>多租户 / RBAC / 审计"]
+    BIZ -->|"独占"| PREM["Premium Agent"]
+    BIZ -->|"独占"| SUP["商业支持 / SLA"]
+```
+
+| 维度 | {Name-Open} 开源版 | {Name} 商业版 |
+| :--- | :--- | :--- |
+| 编排引擎 | ✅ 完整 | ✅ 完整 |
+| 执行层 | ✅ 完整 | ✅ 完整 |
+| Core Agent | ✅ 全部 | ✅ 全部 |
+| Premium Agent | ❌ | ✅ |
+| 多租户 | ❌ | ✅ |
+| RBAC | ❌ | ✅ |
+| 审计日志 | ❌ | ✅ |
+| 技术支持 | 社区 | 专属/SLA |
+
+### 3.2 版本功能矩阵
+
+| 功能 | 🆓 Free | 👤 Pro | 👥 Team | 🏢 Enterprise |
+| :--- | :---: | :---: | :---: | :---: |
+| {例如：Agent 数量} | {例如：3} | {例如：10} | {例如：无限} | {例如：无限} |
+| {例如：店铺数量} | {例如：1} | {例如：5} | {例如：20} | {例如：无限} |
+| {例如：平台数量} | {例如：2} | {例如：5} | {例如：全部} | {例如：全部} |
+| {例如：定时任务} | ❌ | ✅ | ✅ | ✅ |
+| {例如：Premium Agent} | ❌ | ❌ | ✅ | ✅ |
+| {例如：多租户} | ❌ | ❌ | ❌ | ✅ |
+| {例如：RBAC} | ❌ | ❌ | ❌ | ✅ |
+| {例如：私有部署} | ❌ | ❌ | ❌ | ✅ |
+| {例如：SLA} | ❌ | ❌ | ❌ | ✅ |
+| {功能} | — | — | — | — |
+
+---
+
+## 4. 版本路线图
+
+### 4.1 V1.0 — MVP（{例如：2026 Q2}）
+
+**目标**：{例如：核心流程跑通，验证 PMF}
+
+| 功能 | 优先级 | 状态 |
+| :--- | :---: | :---: |
+| {例如：编排引擎集成} | P0 | ⏳ |
+| {例如：淘宝/拼多多 Adapter} | P0 | ⏳ |
+| {例如：选品 Agent} | P0 | ⏳ |
+| {例如：上架 Agent} | P0 | ⏳ |
+| {例如：Web Console 基础} | P1 | ⏳ |
+| {功能} | — | — |
+
+### 4.2 V2.0 — 商业版基础（{例如：2026 Q3}）
+
+**目标**：{例如：商业化启动，付费用户增长}
+
+| 功能 | 优先级 | 状态 |
+| :--- | :---: | :---: |
+| {例如：多租户 + 用户管理} | P0 | ⏳ |
+| {例如：RBAC 权限体系} | P0 | ⏳ |
+| {例如：Premium Agent ×3} | P1 | ⏳ |
+| {例如：计费与套餐管理} | P1 | ⏳ |
+| {功能} | — | — |
+
+### 4.3 V3.0 — 企业版完整（{例如：2026 Q4}）
+
+**目标**：{例如：满足企业客户安全与合规需求}
+
+| 功能 | 优先级 | 状态 |
+| :--- | :---: | :---: |
+| {例如：Schema 级租户隔离} | P0 | ⏳ |
+| {例如：审计日志} | P0 | ⏳ |
+| {例如：私有部署支持} | P1 | ⏳ |
+| {例如：白标定制} | P2 | ⏳ |
+| {功能} | — | — |
+
+### 4.4 V4.0 — 生态版（{例如：2027 Q1}，可选）
+
+**目标**：{例如：构建开放生态}
+
+| 功能 | 优先级 | 状态 |
+| :--- | :---: | :---: |
+| {例如：Agent 市场} | P1 | ⏳ |
+| {例如：插件系统} | P1 | ⏳ |
+| {例如：开放 API} | P1 | ⏳ |
+| {功能} | — | — |
+
+---
+
+## 5. 版本定价对照
+
+| 档位 | 月价 | 年价（折扣） | 适用版本 |
+| :--- | :--- | :--- | :--- |
+| 🆓 Free | ¥0 | ¥0 | V1.0+ |
+| 👤 Pro | {例如：¥99} | {例如：¥999 (¥83/月)} | V1.0+ |
+| 👥 Team | {例如：¥299} | {例如：¥2,999 (¥250/月)} | V2.0+ |
+| 🏢 Enterprise | {例如：议价} | {例如：议价} | V3.0+ |
+
+---
+
+## 6. 开源与商业协同策略（如适用）
+
+### 6.1 开源版角色
+
+- {例如：社区推广引擎，降低获客成本}
+- {例如：开发者生态入口，培养 Agent 贡献者}
+- {例如：核心引擎稳定性验证}
+
+### 6.2 商业版护城河
+
+- {例如：企业级治理（多租户、RBAC、审计）}
+- {例如：Premium Agent（更高质量、SLA 保证）}
+- {例如：商业支持与 SLA}
+
+### 6.3 功能墙策略
+
+```mermaid
+graph TD
+    FREE["🆓 Free<br/>Core Agent + 基础编排"] -->|"升级"| PRO["👤 Pro<br/>更多 Agent + 定时任务"]
+    PRO -->|"升级"| TEAM["👥 Team<br/>Premium Agent + 团队协作"]
+    TEAM -->|"升级"| ENT["🏢 Enterprise<br/>私有部署 + 合规 + SLA"]
+```
+
+---
+
+## 7. 发布策略
+
+| 策略 | 说明 |
+| :--- | :--- |
+| 版本号规范 | SemVer：`MAJOR.MINOR.PATCH`（如 `1.2.3`） |
+| 发布节奏 | {例如：Major 每季度、Minor 每月、Patch 按需} |
+| 灰度策略 | {例如：内部 → 5% 灰度 → 50% → 全量} |
+| 回滚策略 | {例如：蓝绿部署，30 分钟内可回滚} |
+| 变更日志 | {例如：每版本 CHANGELOG.md + 用户通知} |
+
+---
+
+## 8. 生态协作路径（如适用）
+
+```mermaid
+flowchart LR
+    CONTRIB["社区贡献者"] -->|"提交 Agent"| REVIEW["官方审核"]
+    REVIEW -->|"通过"| MARKET["Agent 市场"]
+    REVIEW -->|"优质"| PREMIUM["Premium 邀请"]
+    MARKET -->|"安装"| USER["用户"]
+    USER -->|"评分/反馈"| REVIEW
+```
+
+---
+
+## 9. 成功指标
+
+| 指标 | V1.0 目标 | V2.0 目标 | V3.0 目标 |
+| :--- | :--- | :--- | :--- |
+| {例如：GitHub Stars} | {例如：>500} | {例如：>2,000} | {例如：>5,000} |
+| {例如：注册用户} | {例如：>200} | {例如：>1,000} | {例如：>3,000} |
+| {例如：付费用户} | {例如：>20} | {例如：>100} | {例如：>300} |
+| {例如：MRR} | {例如：>¥5K} | {例如：>¥50K} | {例如：>¥200K} |
+| {例如：NPS} | {例如：>30} | {例如：>40} | {例如：>50} |
+
+---
+
+**文档版本**：V1.0.0
+**创建日期**：{YYYY-MM-DD}
+**最后更新**：{YYYY-MM-DD}
+**文档状态**：✅ 待评审

skills/document-skills/full-stack-doc/templates/root/7、领域模型设计.md

@@ -0,0 +1,425 @@
+# {Name} 领域模型设计
+
+> **文档说明**：基于 DDD（战略 + 战术）定义限界上下文、聚合、实体和值对象，并说明上下文协作方式、领域事件与仓储接口。
+>
+> **版本**：V1.0.0
+> **最后更新**：{YYYY-MM-DD}
+
+---
+
+## 1. 文档信息
+
+### 1.1 版本记录
+
+| 版本 | 日期 | 作者 | 变更说明 |
+| :--- | :--- | :--- | :--- |
+| V1.0.0 | {YYYY-MM-DD} | {姓名} | 初始版本 |
+
+### 1.2 关联文档
+
+| 文档 | 关联说明 |
+| :--- | :--- |
+| [2、术语表与词汇表](2、{Name}-术语表与词汇表.md) | 统一语言定义 |
+| [6、产品与版本规划](6、{Name}-产品与版本规划.md) | 功能边界与版本范围 |
+| [8、系统架构设计](8、{Name}-系统架构设计.md) | 架构分层承接 |
+
+### 1.3 文档责任人
+
+| 角色 | 姓名 | 职责 |
+| :--- | :--- | :--- |
+| 领域专家 | {姓名} | 业务规则与模型验证 |
+| 架构师 | {姓名} | 聚合划分与上下文映射 |
+
+---
+
+## 2. 战略设计 (Strategic Design)
+
+### 2.1 核心公式映射
+
+```
+{Name} = {例如：商品域 + 订单域 + 店铺域 + 智能体域 + 运营域}
+```
+
+### 2.2 限界上下文
+
+```mermaid
+graph TB
+    subgraph "核心域 (Core)"
+        PROD["商品上下文<br/>Product Context"]
+        ORDER["订单上下文<br/>Order Context"]
+    end
+
+    subgraph "支撑域 (Supporting)"
+        STORE["店铺上下文<br/>Store Context"]
+        AGENT_CTX["智能体上下文<br/>Agent Context"]
+    end
+
+    subgraph "通用域 (Generic)"
+        USER_CTX["用户上下文<br/>User Context"]
+        NOTIFY["通知上下文<br/>Notification Context"]
+    end
+
+    PROD -->|"商品事件"| ORDER
+    ORDER -->|"订单状态"| STORE
+    AGENT_CTX -->|"执行结果"| PROD
+    AGENT_CTX -->|"执行结果"| ORDER
+    USER_CTX -->|"权限"| STORE
+```
+
+| 上下文 | 类型 | 核心职责 | 关键聚合 |
+| :--- | :--- | :--- | :--- |
+| {例如：商品上下文} | 核心域 | {例如：商品全生命周期管理} | {例如：Product, Category} |
+| {例如：订单上下文} | 核心域 | {例如：订单创建、履约、退款} | {例如：Order, Payment} |
+| {例如：店铺上下文} | 支撑域 | {例如：店铺连接与平台对接} | {例如：Store, PlatformConnection} |
+| {例如：智能体上下文} | 支撑域 | {例如：Agent 配置、执行、调度} | {例如：AgentConfig, Execution} |
+| {例如：用户上下文} | 通用域 | {例如：用户认证、角色、权限} | {例如：User, Role, Tenant} |
+| {上下文} | {类型} | {职责} | {聚合} |
+
+### 2.3 上下文映射 (Context Map)
+
+```mermaid
+graph LR
+    PROD["商品上下文"] -->|"OHS/PL"| ORDER["订单上下文"]
+    ORDER -->|"ACL"| STORE["店铺上下文"]
+    AGENT_CTX["智能体上下文"] -->|"Conformist"| PROD
+    USER_CTX["用户上下文"] -->|"Shared Kernel"| STORE
+```
+
+| 上游 | 下游 | 关系类型 | 说明 |
+| :--- | :--- | :--- | :--- |
+| {例如：商品} | {例如：订单} | OHS/PL | {例如：商品发布事件触发订单域商品快照} |
+| {例如：订单} | {例如：店铺} | ACL | {例如：订单通过防腐层调用店铺 API} |
+| {例如：智能体} | {例如：商品} | Conformist | {例如：Agent 遵循商品域协议} |
+| {上游} | {下游} | {类型} | {说明} |
+
+> **关系类型说明**：OHS = Open Host Service, PL = Published Language, ACL = Anti-Corruption Layer, SK = Shared Kernel
+
+---
+
+## 3. 统一语言 (Ubiquitous Language)
+
+| 领域概念 | 英文 | 定义 | 所属上下文 |
+| :--- | :--- | :--- | :--- |
+| {例如：商品} | Product | {例如：可上架到平台的商品实体} | 商品上下文 |
+| {例如：SKU} | SKU | {例如：库存管理最小单位} | 商品上下文 |
+| {例如：订单} | Order | {例如：用户购买行为的交易记录} | 订单上下文 |
+| {例如：履约} | Fulfillment | {例如：订单从创建到完成的全流程} | 订单上下文 |
+| {例如：平台连接} | Platform Connection | {例如：与外部电商平台的授权连接} | 店铺上下文 |
+| {概念} | {English} | {定义} | {上下文} |
+
+> **注意**：本表中的术语定义须与 [术语表](2、{Name}-术语表与词汇表.md) 保持完全一致。
+
+---
+
+## 4. 核心聚合设计
+
+### 4.1 {例如：商品聚合 (Product Aggregate)}
+
+```mermaid
+classDiagram
+    class Product {
+        <<AggregateRoot>>
+        +ProductId id
+        +String title
+        +Money price
+        +ProductStatus status
+        +List~SKU~ skus
+        +publish()
+        +updatePrice(Money)
+        +delist()
+    }
+
+    class SKU {
+        <<Entity>>
+        +SkuId id
+        +String spec
+        +Money cost
+        +Integer stock
+    }
+
+    class Money {
+        <<ValueObject>>
+        +BigDecimal amount
+        +Currency currency
+    }
+
+    class ProductStatus {
+        <<ValueObject>>
+        DRAFT
+        PUBLISHED
+        DELISTED
+    }
+
+    Product "1" --> "*" SKU : contains
+    Product --> Money : price
+    Product --> ProductStatus : status
+    SKU --> Money : cost
+```
+
+**不变量 (Invariants)**:
+- {例如：商品至少包含一个 SKU}
+- {例如：已发布商品不可删除，只能下架}
+- {例如：售价不得低于成本价}
+
+### 4.2 {例如：订单聚合 (Order Aggregate)}
+
+```mermaid
+classDiagram
+    class Order {
+        <<AggregateRoot>>
+        +OrderId id
+        +TenantId tenantId
+        +StoreId storeId
+        +OrderStatus status
+        +List~OrderItem~ items
+        +Money totalAmount
+        +create()
+        +pay()
+        +ship()
+        +complete()
+        +cancel()
+    }
+
+    class OrderItem {
+        <<Entity>>
+        +OrderItemId id
+        +ProductSnapshot product
+        +Integer quantity
+        +Money subtotal
+    }
+
+    class ProductSnapshot {
+        <<ValueObject>>
+        +ProductId productId
+        +String title
+        +Money price
+    }
+
+    class OrderStatus {
+        <<ValueObject>>
+        PENDING
+        PAID
+        SHIPPED
+        COMPLETED
+        CANCELLED
+    }
+
+    Order "1" --> "*" OrderItem : contains
+    OrderItem --> ProductSnapshot : snapshot
+    Order --> OrderStatus : status
+    Order --> Money : totalAmount
+```
+
+**不变量 (Invariants)**:
+- {例如：已支付订单不可修改商品}
+- {例如：取消订单需退款}
+- {例如：订单总额 = Σ(订单项小计)}
+
+### 4.3 {例如：租户聚合 (Tenant Aggregate)（商业版）}
+
+```mermaid
+classDiagram
+    class Tenant {
+        <<AggregateRoot>>
+        +TenantId id
+        +String name
+        +PlanType plan
+        +TenantStatus status
+        +Quota quota
+        +activate()
+        +upgradePlan(PlanType)
+        +suspend()
+    }
+
+    class Quota {
+        <<ValueObject>>
+        +Integer maxAgents
+        +Integer maxStores
+        +Integer maxPlatforms
+    }
+
+    class PlanType {
+        <<ValueObject>>
+        FREE
+        PRO
+        TEAM
+        ENTERPRISE
+    }
+
+    Tenant --> Quota : quota
+    Tenant --> PlanType : plan
+```
+
+**不变量 (Invariants)**:
+- {例如：免费版配额不可超出}
+- {例如：降级版本需检查当前资源使用}
+
+### 4.4 {例如：平台连接聚合 (PlatformConnection Aggregate)}
+
+```mermaid
+classDiagram
+    class PlatformConnection {
+        <<AggregateRoot>>
+        +ConnectionId id
+        +StoreId storeId
+        +PlatformType platform
+        +ConnectionStatus status
+        +Credentials credentials
+        +connect()
+        +refresh()
+        +disconnect()
+        +healthCheck()
+    }
+
+    class Credentials {
+        <<ValueObject>>
+        +String accessToken
+        +String refreshToken
+        +DateTime expiresAt
+    }
+
+    class ConnectionStatus {
+        <<ValueObject>>
+        ACTIVE
+        EXPIRED
+        DISCONNECTED
+        ERROR
+    }
+
+    PlatformConnection --> Credentials : credentials
+    PlatformConnection --> ConnectionStatus : status
+```
+
+---
+
+## 5. 领域事件
+
+### 5.1 事件清单
+
+| 事件名 | 触发条件 | 发布上下文 | 消费上下文 | 说明 |
+| :--- | :--- | :--- | :--- | :--- |
+| {例如：ProductPublished} | {例如：商品发布成功} | 商品 | 订单、店铺 | {例如：触发商品同步} |
+| {例如：OrderCreated} | {例如：新订单创建} | 订单 | 店铺、通知 | {例如：触发发货流程} |
+| {例如：OrderShipped} | {例如：订单发货} | 订单 | 通知 | {例如：通知买家} |
+| {例如：AgentExecutionCompleted} | {例如：Agent 执行完成} | 智能体 | 商品、订单 | {例如：更新执行结果} |
+| {例如：TenantPlanUpgraded} | {例如：租户升级套餐} | 用户 | 全局 | {例如：更新配额} |
+| {例如：ConnectionExpired} | {例如：平台授权过期} | 店铺 | 通知 | {例如：提醒重新授权} |
+| {事件} | {条件} | {发布} | {消费} | {说明} |
+
+### 5.2 事件流示意
+
+```mermaid
+sequenceDiagram
+    participant User as 用户
+    participant Agent as Agent 上下文
+    participant Product as 商品上下文
+    participant Store as 店铺上下文
+    participant Notify as 通知上下文
+
+    User->>Agent: 下达采集指令
+    Agent->>Product: ProductScraped 事件
+    Product->>Product: 创建商品草稿
+    Product->>Agent: ProductDraftCreated 事件
+    Agent->>Product: 发布商品
+    Product->>Store: ProductPublished 事件
+    Store->>Store: 同步到平台
+    Store-->>Notify: SyncCompleted 事件
+    Notify-->>User: 推送通知
+```
+
+---
+
+## 6. 领域服务
+
+| 服务名 | 所属上下文 | 职责 | 跨聚合 |
+| :--- | :--- | :--- | :---: |
+| {例如：PricingService} | 商品 | {例如：根据策略计算售价} | 否 |
+| {例如：OrderFulfillmentService} | 订单 | {例如：协调发货流程} | 是 |
+| {例如：AgentSchedulingService} | 智能体 | {例如：调度 Agent 执行任务} | 是 |
+| {例如：QuotaEnforcementService} | 用户 | {例如：检查租户配额} | 是 |
+| {服务} | {上下文} | {职责} | — |
+
+---
+
+## 7. 仓储接口 (Repository)
+
+```typescript
+// 商品仓储
+interface ProductRepository {
+  findById(id: ProductId): Promise<Product | null>;
+  findByStore(storeId: StoreId, page: PageRequest): Promise<Page<Product>>;
+  save(product: Product): Promise<void>;
+  delete(id: ProductId): Promise<void>;
+}
+
+// 订单仓储
+interface OrderRepository {
+  findById(id: OrderId): Promise<Order | null>;
+  findByTenant(tenantId: TenantId, filter: OrderFilter): Promise<Page<Order>>;
+  save(order: Order): Promise<void>;
+}
+
+// 租户仓储（商业版）
+interface TenantRepository {
+  findById(id: TenantId): Promise<Tenant | null>;
+  findByApiKey(key: string): Promise<Tenant | null>;
+  save(tenant: Tenant): Promise<void>;
+}
+
+// 平台连接仓储
+interface PlatformConnectionRepository {
+  findByStore(storeId: StoreId): Promise<PlatformConnection[]>;
+  findActive(platform: PlatformType): Promise<PlatformConnection[]>;
+  save(connection: PlatformConnection): Promise<void>;
+}
+```
+
+---
+
+## 8. 上下文关系类型速查
+
+| 关系类型 | 缩写 | 含义 | 适用场景 |
+| :--- | :--- | :--- | :--- |
+| Shared Kernel | SK | 共享代码/模型 | 紧密协作的上下文 |
+| Customer-Supplier | C/S | 上游供应，下游消费 | 有明确上下游关系 |
+| Conformist | CF | 下游完全遵循上游 | 下游无需变换 |
+| Anti-Corruption Layer | ACL | 下游添加防腐层 | 隔离外部系统变化 |
+| Open Host Service | OHS | 上游提供标准 API | 上游为多消费者服务 |
+| Published Language | PL | 标准化数据格式 | 跨上下文数据交换 |
+
+---
+
+## 9. 领域对象关系图
+
+```mermaid
+classDiagram
+    Product "1" --> "*" SKU
+    Product "1" --> "1" ProductStatus
+    Order "1" --> "*" OrderItem
+    OrderItem --> ProductSnapshot
+    Tenant "1" --> "*" Store
+    Store "1" --> "*" PlatformConnection
+    Store "1" --> "*" Product
+    AgentConfig "1" --> "*" Execution
+    Execution --> Product
+    Execution --> Order
+```
+
+---
+
+## 10. 演进与治理
+
+| 维度 | 规则 |
+| :--- | :--- |
+| 新增上下文 | {例如：需领域专家 + 架构师共同评审} |
+| 聚合拆分 | {例如：当聚合事务边界过大时考虑拆分} |
+| 事件版本 | {例如：使用 CloudEvents 规范，语义化版本} |
+| 模型同步 | {例如：每次 Sprint 结束同步更新领域模型文档} |
+| 代码一致 | {例如：代码中的 Entity/VO/Service 命名须与本文一致} |
+
+---
+
+**文档版本**：V1.0.0
+**创建日期**：{YYYY-MM-DD}
+**最后更新**：{YYYY-MM-DD}
+**文档状态**：✅ 待评审

skills/document-skills/full-stack-doc/templates/root/8、系统架构设计.md

@@ -0,0 +1,392 @@
+# {Name} 系统架构设计
+
+> **文档说明**：描述系统总体架构、分层职责、核心数据流、安全设计、部署方案与扩展机制。基于 DDD + COLA 架构分层。
+>
+> **版本**：V1.0.0
+> **最后更新**：{YYYY-MM-DD}
+
+---
+
+## 1. 文档信息
+
+| 项目 | 内容 |
+| :--- | :--- |
+| 文档类型 | 系统架构设计 |
+| 产品 | {Name} |
+| 版本 | V1.0.0 |
+| 状态 | ✅ 待评审 |
+
+### 1.1 关联文档
+
+| 文档 | 关联说明 |
+| :--- | :--- |
+| [5、技术方案与路线](5、{Name}-技术方案与路线.md) | 技术选型与路线 |
+| [7、领域模型设计](7、{Name}-领域模型设计.md) | 领域模型与上下文 |
+| [9、视觉与交互DNA规范](9、{Name}-视觉与交互DNA规范.md) | 前端架构约束 |
+
+---
+
+## 2. 架构定位
+
+### 2.1 核心公式
+
+```
+{Name} = {例如：OpenClaw (编排) + agency-agents (专家) + OpenCLI (执行) + Enterprise (企业)}
+```
+
+### 2.2 架构目标
+
+| 目标 | 说明 | 度量 |
+| :--- | :--- | :--- |
+| {例如：高可用} | {例如：核心服务 99.9% 可用} | {例如：SLA ≥ 99.9%} |
+| {例如：可扩展} | {例如：支持水平扩展} | {例如：100→10K 用户无架构变更} |
+| {例如：安全} | {例如：数据隔离、传输加密} | {例如：通过安全审计} |
+| {例如：可观测} | {例如：全链路追踪} | {例如：Metrics + Logging + Tracing} |
+
+---
+
+## 3. 总体分层架构
+
+```mermaid
+flowchart TD
+    subgraph "Adapter 层（适配器）"
+        direction LR
+        HTTP["HTTP API"]
+        CLI_AD["CLI Adapter"]
+        MQ_AD["MQ Consumer"]
+        CRON_AD["Cron Trigger"]
+    end
+
+    subgraph "Application 层（应用服务）"
+        direction LR
+        CMD["Command Handler"]
+        QUERY["Query Handler"]
+        SAGA["Saga / 编排"]
+    end
+
+    subgraph "Domain 层（领域）"
+        direction LR
+        AGG["聚合 & 实体"]
+        DS["领域服务"]
+        EVT["领域事件"]
+    end
+
+    subgraph "Infrastructure 层（基础设施）"
+        direction LR
+        REPO["Repository 实现"]
+        CACHE["缓存"]
+        EXT["外部服务网关"]
+        MSG["消息发布"]
+    end
+
+    HTTP --> CMD
+    HTTP --> QUERY
+    CLI_AD --> CMD
+    MQ_AD --> CMD
+    CRON_AD --> SAGA
+    CMD --> AGG
+    CMD --> DS
+    QUERY --> REPO
+    SAGA --> DS
+    AGG --> EVT
+    EVT --> MSG
+    DS --> REPO
+    DS --> CACHE
+    DS --> EXT
+```
+
+| 层级 | 职责 | 典型组件 |
+| :--- | :--- | :--- |
+| Adapter | 处理外部 I/O | HTTP Controller, CLI, MQ Consumer, Cron |
+| Application | 编排用例，协调领域 | Command/Query Handler, Saga |
+| Domain | 核心业务逻辑 | Aggregate, Entity, VO, Domain Service, Event |
+| Infrastructure | 技术实现 | Repository Impl, Cache, Gateway, Publisher |
+
+---
+
+## 4. DDD + COLA 分层映射
+
+| COLA 层 | DDD 概念 | {Name} 实现 |
+| :--- | :--- | :--- |
+| Adapter | Interface / Gateway | {例如：REST Controller, gRPC Endpoint} |
+| Application | Application Service | {例如：CommandHandler, QueryHandler} |
+| Domain | Aggregate / Service / Event | {例如：Product, Order, PricingService} |
+| Infrastructure | Repository / Gateway Impl | {例如：PostgresProductRepo, RedisCache} |
+
+### 4.1 CQRS 与事件驱动（按需）
+
+```mermaid
+flowchart LR
+    subgraph "Command Side (写)"
+        C_API["Command API"] --> C_HANDLER["Command Handler"]
+        C_HANDLER --> AGG["Aggregate"]
+        AGG --> EVT_STORE["Event Store"]
+    end
+
+    subgraph "Event Bus"
+        EVT_STORE --> BUS["Message Queue"]
+    end
+
+    subgraph "Query Side (读)"
+        BUS --> PROJECTOR["Projector"]
+        PROJECTOR --> READ_DB["Read Model"]
+        Q_API["Query API"] --> READ_DB
+    end
+```
+
+---
+
+## 5. 核心数据流
+
+### 5.1 主流程示例：{例如：Agent 执行商品采集}
+
+```mermaid
+sequenceDiagram
+    participant User as 用户
+    participant API as API Server
+    participant CMD as Commander
+    participant Agent as Agent Worker
+    participant CLI as OpenCLI
+    participant Platform as 电商平台
+    participant DB as Database
+
+    User->>API: POST /tasks/create
+    API->>CMD: 创建编排任务
+    CMD->>Agent: 分发子任务
+    Agent->>CLI: 调用平台 Adapter
+    CLI->>Platform: 搜索商品 API
+    Platform-->>CLI: 返回商品列表
+    CLI-->>Agent: 结构化商品数据
+    Agent->>DB: 保存商品草稿
+    Agent-->>CMD: 报告子任务完成
+    CMD-->>API: 任务完成
+    API-->>User: 返回结果
+```
+
+### 5.2 数据流摘要
+
+| 流程 | 入口 | 经过组件 | 存储 |
+| :--- | :--- | :--- | :--- |
+| {例如：商品采集} | {例如：REST API} | {例如：Commander → Agent → CLI → Adapter} | {例如：PostgreSQL} |
+| {例如：订单同步} | {例如：Cron 调度} | {例如：Cron → Commander → Agent → CLI} | {例如：PostgreSQL + Redis} |
+| {例如：用户操作审计} | {例如：All API} | {例如：Middleware → Audit Writer} | {例如：审计日志表} |
+| {流程} | {入口} | {组件} | {存储} |
+
+---
+
+## 6. 编排层架构
+
+### 6.1 Commander 状态机
+
+```mermaid
+stateDiagram-v2
+    [*] --> Created : 创建任务
+    Created --> Planning : 开始规划
+    Planning --> Executing : 子任务分发
+    Executing --> Reviewing : 执行完成
+    Reviewing --> Completed : 审查通过
+    Reviewing --> Executing : 需重试
+    Executing --> Failed : 不可恢复错误
+    Failed --> [*]
+    Completed --> [*]
+```
+
+---
+
+## 7. 企业层架构（{Name} 独有，按需）
+
+### 7.1 总体架构
+
+```mermaid
+flowchart TD
+    subgraph "企业层"
+        GW["API Gateway<br/>认证 + 限流"]
+        TENANT["Tenant Service<br/>租户管理"]
+        RBAC_SVC["RBAC Service<br/>权限控制"]
+        AUDIT["Audit Service<br/>审计日志"]
+        BILLING["Billing Service<br/>计费管理"]
+    end
+
+    GW --> TENANT
+    GW --> RBAC_SVC
+    GW --> AUDIT
+    TENANT --> BILLING
+```
+
+### 7.2 多租户架构
+
+| 隔离策略 | 数据库层面 | 应用层面 | 适用版本 |
+| :--- | :--- | :--- | :--- |
+| {例如：Row-Level} | {例如：RLS Policy} | {例如：tenant_id 上下文} | {例如：👥 Team} |
+| {例如：Schema-Level} | {例如：独立 Schema} | {例如：连接池路由} | {例如：🏢 Enterprise} |
+
+### 7.3 RBAC 设计
+
+| 角色 | 权限范围 | 典型用户 |
+| :--- | :--- | :--- |
+| {例如：Owner} | {例如：全部权限} | {例如：账户创建者} |
+| {例如：Admin} | {例如：除转让外全部} | {例如：管理员} |
+| {例如：Operator} | {例如：操作类权限} | {例如：运营人员} |
+| {例如：Viewer} | {例如：只读} | {例如：查看者} |
+
+### 7.4 审计日志架构
+
+```mermaid
+flowchart LR
+    API["API Request"] --> MW["Audit Middleware"]
+    MW --> QUEUE["Audit Queue"]
+    QUEUE --> WRITER["Audit Writer"]
+    WRITER --> AUDIT_DB["Audit Store"]
+    AUDIT_DB --> QUERY["Audit Query API"]
+```
+
+---
+
+## 8. 数据架构
+
+### 8.1 数据库设计概要
+
+| 数据库 | 用途 | 存储内容 |
+| :--- | :--- | :--- |
+| {例如：PostgreSQL} | 主库 | {例如：商品、订单、用户、租户元数据} |
+| {例如：Redis} | 缓存 + 队列 | {例如：会话、热数据、任务队列} |
+| {例如：MinIO/S3} | 对象存储 | {例如：图片、导出文件、快照} |
+
+### 8.2 缓存策略
+
+| 场景 | 策略 | TTL | 更新方式 |
+| :--- | :--- | :--- | :--- |
+| {例如：商品列表} | {例如：Cache-Aside} | {例如：5min} | {例如：写入时失效} |
+| {例如：用户会话} | {例如：Write-Through} | {例如：24h} | {例如：登录时写入} |
+| {场景} | {策略} | {TTL} | {更新} |
+
+### 8.3 消息队列设计
+
+| Topic | 生产者 | 消费者 | 说明 |
+| :--- | :--- | :--- | :--- |
+| {例如：task.created} | {例如：API Server} | {例如：Commander} | {例如：新任务创建} |
+| {例如：agent.result} | {例如：Agent Worker} | {例如：Commander} | {例如：Agent 执行结果} |
+| {例如：audit.event} | {例如：All Services} | {例如：Audit Writer} | {例如：审计事件} |
+| {topic} | {生产者} | {消费者} | {说明} |
+
+---
+
+## 9. 安全架构
+
+### 9.1 安全分层
+
+| 层级 | 措施 | 说明 |
+| :--- | :--- | :--- |
+| 传输层 | {例如：TLS 1.3} | {例如：全链路 HTTPS} |
+| 认证层 | {例如：JWT + API Key} | {例如：双模认证} |
+| 授权层 | {例如：RBAC} | {例如：基于角色的细粒度权限} |
+| 数据层 | {例如：AES-256 加密} | {例如：敏感字段加密存储} |
+| 审计层 | {例如：全操作日志} | {例如：不可篡改审计记录} |
+
+### 9.2 凭证安全
+
+| 凭证类型 | 存储方式 | 访问方式 |
+| :--- | :--- | :--- |
+| {例如：平台 Token} | {例如：加密数据库} | {例如：解密后注入 Adapter} |
+| {例如：API Key} | {例如：哈希存储} | {例如：请求头验证} |
+| {例如：LLM Key} | {例如：Vault/KMS} | {例如：运行时获取} |
+
+---
+
+## 10. 部署架构
+
+### 10.1 SaaS 部署（推荐）
+
+```mermaid
+flowchart TD
+    subgraph "CDN"
+        CF["Cloudflare / CDN"]
+    end
+
+    subgraph "K8s Cluster"
+        INGRESS["Ingress Controller"]
+        API_POD["API Server<br/>×3 replicas"]
+        WORKER_POD["Agent Worker<br/>×N replicas"]
+        CRON_POD["Cron Scheduler<br/>×1"]
+    end
+
+    subgraph "Data Layer"
+        PG[(PostgreSQL<br/>Primary + Replica)]
+        REDIS_C[(Redis Cluster)]
+        MQ_C["NATS / RabbitMQ"]
+        S3["Object Storage"]
+    end
+
+    CF --> INGRESS
+    INGRESS --> API_POD
+    API_POD --> PG
+    API_POD --> REDIS_C
+    API_POD --> MQ_C
+    MQ_C --> WORKER_POD
+    WORKER_POD --> PG
+    WORKER_POD --> S3
+    CRON_POD --> MQ_C
+```
+
+### 10.2 私有化部署（企业版）
+
+| 组件 | 最小配置 | 推荐配置 |
+| :--- | :--- | :--- |
+| {例如：API Server} | {例如：2C4G ×1} | {例如：4C8G ×2} |
+| {例如：Agent Worker} | {例如：2C4G ×1} | {例如：4C8G ×N} |
+| {例如：PostgreSQL} | {例如：2C4G ×1} | {例如：4C16G ×2 (主从)} |
+| {例如：Redis} | {例如：1C2G ×1} | {例如：2C4G ×3 (Cluster)} |
+
+---
+
+## 11. 扩展机制
+
+### 11.1 Agent 插件
+
+```typescript
+// Agent 插件接口示例
+interface AgentPlugin {
+  readonly id: string;
+  readonly name: string;
+  readonly version: string;
+  install(context: PluginContext): Promise<void>;
+  uninstall(): Promise<void>;
+}
+```
+
+### 11.2 Platform Adapter 扩展
+
+```typescript
+// 自定义 Adapter 注册示例
+interface AdapterRegistry {
+  register(adapter: PlatformAdapter): void;
+  get(platformId: string): PlatformAdapter | null;
+  list(): PlatformAdapter[];
+}
+```
+
+### 11.3 Webhook 事件订阅
+
+| 事件 | Payload 示例 | 说明 |
+| :--- | :--- | :--- |
+| {例如：`task.completed`} | `{"taskId": "...", "status": "done"}` | {例如：任务完成回调} |
+| {例如：`order.created`} | `{"orderId": "...", "total": 99.00}` | {例如：新订单通知} |
+| {事件} | {Payload} | {说明} |
+
+---
+
+## 12. 技术债与演进计划
+
+| # | 技术债 | 影响 | 计划修复版本 |
+| :---: | :--- | :--- | :--- |
+| 1 | {例如：缺少请求幂等性保证} | {例如：重复请求可能导致数据不一致} | {例如：V1.1} |
+| 2 | {例如：日志格式不统一} | {例如：排查问题效率低} | {例如：V1.0 Patch} |
+| 3 | {例如：缺少限流中间件} | {例如：突发流量可能打垮服务} | {例如：V2.0} |
+| N | {技术债} | {影响} | {版本} |
+
+---
+
+**文档版本**：V1.0.0
+**创建日期**：{YYYY-MM-DD}
+**最后更新**：{YYYY-MM-DD}
+**文档状态**：✅ 待评审

skills/document-skills/full-stack-doc/templates/root/9、视觉与交互DNA规范.md

@@ -0,0 +1,323 @@
+# {Name} 视觉与交互 DNA 规范
+
+> **文档说明**：定义视觉语言、交互原则、组件规范、页面布局与体验基线，确保产品在多版本、多端下保持一致性。
+>
+> **版本**：V1.0.0
+> **最后更新**：{YYYY-MM-DD}
+
+---
+
+## 1. 文档信息
+
+### 1.1 版本记录
+
+| 版本 | 日期 | 作者 | 变更说明 |
+| :--- | :--- | :--- | :--- |
+| V1.0.0 | {YYYY-MM-DD} | {姓名} | 初始版本 |
+
+---
+
+## 2. 设计原则
+
+| 原则 | 说明 | 体现 |
+| :--- | :--- | :--- |
+| {例如：清晰 (Clarity)} | {例如：信息层次分明，一眼可见核心内容} | {例如：大标题 + 关键指标卡片} |
+| {例如：效率 (Efficiency)} | {例如：减少操作步骤，常用功能一键触达} | {例如：批量操作、快捷键} |
+| {例如：一致 (Consistency)} | {例如：跨页面、跨版本视觉语言统一} | {例如：统一组件库 + Design Token} |
+| {例如：友好 (Friendly)} | {例如：温和色彩、流畅动效、清晰反馈} | {例如：操作确认、状态提示} |
+
+### 2.1 品牌气质
+
+- {例如：专业而不冰冷 —— 科技蓝搭配暖色点缀}
+- {例如：高效而不压迫 —— 合理留白、渐进式信息展示}
+- {例如：智能而不神秘 —— Agent 执行过程可视化}
+
+---
+
+## 3. 色彩体系
+
+### 3.1 品牌主色
+
+| 色名 | 色值 | 用途 | 示例 |
+| :--- | :--- | :--- | :--- |
+| 主色 (Primary) | {例如：#1A73E8} | {例如：按钮、链接、选中态} | {例如：主操作按钮} |
+| 主色悬浮 | {例如：#1557B0} | {例如：Hover 状态} | — |
+| 主色按下 | {例如：#0D47A1} | {例如：Active 状态} | — |
+
+```css
+/* CSS 变量示例 */
+:root {
+  --color-primary: #1A73E8;
+  --color-primary-hover: #1557B0;
+  --color-primary-active: #0D47A1;
+  --color-primary-light: #E8F0FE;
+}
+```
+
+### 3.2 状态色
+
+| 状态 | 色值 | 用途 |
+| :--- | :--- | :--- |
+| 成功 (Success) | {例如：#34A853} | {例如：操作成功、在线状态} |
+| 警告 (Warning) | {例如：#FBBC04} | {例如：注意提示、过期预警} |
+| 错误 (Error) | {例如：#EA4335} | {例如：操作失败、必填校验} |
+| 信息 (Info) | {例如：#4285F4} | {例如：提示信息、帮助} |
+
+### 3.3 平台品牌色（图标标识）
+
+| 平台 | 色值 | 用途 |
+| :--- | :--- | :--- |
+| {例如：淘宝} | {例如：#FF5000} | {例如：平台标识、连接卡片} |
+| {例如：拼多多} | {例如：#E02E24} | 同上 |
+| {例如：Amazon} | {例如：#FF9900} | 同上 |
+| {平台} | {色值} | — |
+
+### 3.4 版本标识色
+
+| 版本 | 色值 | 标签 |
+| :--- | :--- | :--- |
+| 🆓 Free | {例如：#9E9E9E} | 灰色 |
+| 👤 Pro | {例如：#1A73E8} | 蓝色 |
+| 👥 Team | {例如：#7B1FA2} | 紫色 |
+| 🏢 Enterprise | {例如：#FF6F00} | 橙色 |
+
+---
+
+## 4. 字体与排版
+
+### 4.1 字体堆栈
+
+| 用途 | 字体 | 备选 |
+| :--- | :--- | :--- |
+| 英文正文 | {例如：Inter} | {例如：-apple-system, Segoe UI} |
+| 中文正文 | {例如：思源黑体} | {例如：PingFang SC, Microsoft YaHei} |
+| 代码 | {例如：JetBrains Mono} | {例如：Menlo, Consolas} |
+
+```css
+:root {
+  --font-sans: 'Inter', 'PingFang SC', 'Microsoft YaHei', sans-serif;
+  --font-mono: 'JetBrains Mono', 'Menlo', monospace;
+}
+```
+
+### 4.2 字号层级
+
+| 层级 | 字号 | 行高 | 用途 |
+| :--- | :--- | :--- | :--- |
+| H1 | {例如：24px} | {例如：32px} | 页面标题 |
+| H2 | {例如：20px} | {例如：28px} | 区块标题 |
+| H3 | {例如：16px} | {例如：24px} | 卡片标题 |
+| Body | {例如：14px} | {例如：22px} | 正文 |
+| Caption | {例如：12px} | {例如：18px} | 辅助说明 |
+
+### 4.3 间距系统
+
+| Token | 值 | 用途 |
+| :--- | :--- | :--- |
+| `--space-xs` | {例如：4px} | 紧凑间距 |
+| `--space-sm` | {例如：8px} | 元素间距 |
+| `--space-md` | {例如：16px} | 区块内间距 |
+| `--space-lg` | {例如：24px} | 区块间间距 |
+| `--space-xl` | {例如：32px} | 页面级间距 |
+
+---
+
+## 5. 布局规范
+
+### 5.1 Web Console 主布局
+
+```
+┌──────────────────────────────────────────────┐
+│  Logo    搜索框           通知 🔔  头像 ▾   │  顶栏 (56px)
+├────────┬─────────────────────────────────────┤
+│        │                                     │
+│  菜单   │  面包屑 > 当前页                    │
+│        │                                     │
+│  ─ 仪表盘│  ┌─────────┐ ┌─────────┐          │
+│  ─ 商品 │  │ 统计卡片  │ │ 统计卡片  │         │
+│  ─ 订单 │  └─────────┘ └─────────┘          │
+│  ─ 店铺 │                                     │
+│  ─ Agent│  ┌────────────────────────┐        │
+│  ─ 设置 │  │     数据表格 / 内容区     │       │
+│        │  │                          │       │
+│        │  └────────────────────────┘        │
+├────────┴─────────────────────────────────────┤
+│  © {组织}  版本 v1.0.0                        │  底栏 (可选)
+└──────────────────────────────────────────────┘
+```
+
+| 区域 | 宽度 | 高度 | 说明 |
+| :--- | :--- | :--- | :--- |
+| 顶栏 | 100% | {例如：56px} | Logo + 搜索 + 通知 + 用户 |
+| 侧栏 | {例如：220px (展开) / 64px (折叠)} | 满高 | 一级菜单 |
+| 内容区 | 自适应 | 自适应 | 面包屑 + 功能区 |
+
+### 5.2 页面模式
+
+| 模式 | 说明 | 适用 |
+| :--- | :--- | :--- |
+| {例如：列表页} | {例如：筛选条 + 操作栏 + 数据表格 + 分页} | {例如：商品列表、订单列表} |
+| {例如：详情页} | {例如：信息卡片 + Tab 切换 + 操作按钮} | {例如：商品详情、订单详情} |
+| {例如：表单页} | {例如：步骤条 + 表单区 + 提交/取消} | {例如：新建商品、编辑设置} |
+| {例如：Dashboard} | {例如：统计卡片 + 图表 + 快捷操作} | {例如：首页仪表盘} |
+
+### 5.3 响应式断点
+
+| 断点 | 宽度 | 布局 |
+| :--- | :--- | :--- |
+| Desktop L | ≥ 1440px | {例如：侧栏展开 + 内容区最大宽度 1200px} |
+| Desktop | ≥ 1024px | {例如：侧栏展开} |
+| Tablet | ≥ 768px | {例如：侧栏折叠} |
+| Mobile | < 768px | {例如：底部导航替代侧栏} |
+
+---
+
+## 6. 组件规范
+
+### 6.1 概览卡片
+
+```
+┌──────────────────┐
+│  📦 商品总数       │
+│  1,234            │  ← 大字号数值
+│  ↑ 12% vs 上月    │  ← 趋势指示
+└──────────────────┘
+```
+
+| 属性 | 规范 |
+| :--- | :--- |
+| 圆角 | {例如：8px} |
+| 阴影 | {例如：0 1px 3px rgba(0,0,0,0.1)} |
+| 内边距 | {例如：16px 20px} |
+| 数值字号 | {例如：28px, font-weight: 600} |
+
+### 6.2 状态标签
+
+| 状态 | 背景色 | 文字色 | 示例 |
+| :--- | :--- | :--- | :--- |
+| {例如：已发布} | {例如：#E6F4EA} | {例如：#137333} | `✅ 已发布` |
+| {例如：草稿} | {例如：#F1F3F4} | {例如：#5F6368} | `📝 草稿` |
+| {例如：已下架} | {例如：#FCE8E6} | {例如：#C5221F} | `⛔ 已下架` |
+| {例如：执行中} | {例如：#E8F0FE} | {例如：#1A73E8} | `🔄 执行中` |
+
+### 6.3 操作确认
+
+| 场景 | 确认方式 | 说明 |
+| :--- | :--- | :--- |
+| {例如：删除} | {例如：二次确认弹窗} | {例如：「确定删除？此操作不可撤销」} |
+| {例如：批量操作} | {例如：确认弹窗 + 数量提示} | {例如：「确定上架 23 件商品？」} |
+| {例如：提交表单} | {例如：按钮 Loading + 成功提示} | {例如：「保存成功」Toast} |
+
+### 6.4 空状态
+
+| 场景 | 插图 | 文案 | 操作 |
+| :--- | :--- | :--- | :--- |
+| {例如：无商品} | {例如：空箱子插图} | {例如：还没有商品} | {例如：「去采集」按钮} |
+| {例如：无订单} | {例如：空购物车} | {例如：暂无订单数据} | — |
+| {场景} | {插图} | {文案} | {操作} |
+
+---
+
+## 7. 图表规范
+
+### 7.1 Dashboard 图表
+
+| 图表类型 | 适用场景 | 组件 |
+| :--- | :--- | :--- |
+| {例如：折线图} | {例如：趋势数据（订单量、GMV）} | {例如：ECharts / lime-echart} |
+| {例如：柱状图} | {例如：对比数据（平台销量）} | 同上 |
+| {例如：饼图} | {例如：占比数据（平台分布）} | 同上 |
+| {例如：漏斗图} | {例如：转化数据（采集→上架→成交）} | 同上 |
+
+### 7.2 图表配色
+
+| 序号 | 色值 | 用途 |
+| :--- | :--- | :--- |
+| 1 | {例如：#1A73E8} | 第一数据系列 |
+| 2 | {例如：#34A853} | 第二数据系列 |
+| 3 | {例如：#FBBC04} | 第三数据系列 |
+| 4 | {例如：#EA4335} | 第四数据系列 |
+| 5 | {例如：#9C27B0} | 第五数据系列 |
+
+---
+
+## 8. 动效规范
+
+| 场景 | 动效 | 时长 | 缓动函数 |
+| :--- | :--- | :--- | :--- |
+| {例如：页面切换} | {例如：Fade + Slide} | {例如：300ms} | {例如：ease-in-out} |
+| {例如：弹窗出现} | {例如：Scale + Fade} | {例如：200ms} | {例如：ease-out} |
+| {例如：列表加载} | {例如：Skeleton → Fade in} | {例如：200ms} | {例如：ease-in} |
+| {例如：按钮悬浮} | {例如：Background transition} | {例如：150ms} | {例如：ease} |
+| {例如：通知滑入} | {例如：Slide from right} | {例如：300ms} | {例如：ease-out} |
+
+```css
+/* 动效变量 */
+:root {
+  --transition-fast: 150ms ease;
+  --transition-normal: 300ms ease-in-out;
+  --transition-slow: 500ms ease;
+}
+```
+
+---
+
+## 9. 暗色模式
+
+### 9.1 暗色配色
+
+| Token | 亮色值 | 暗色值 |
+| :--- | :--- | :--- |
+| `--bg-primary` | {例如：#FFFFFF} | {例如：#1E1E1E} |
+| `--bg-secondary` | {例如：#F5F5F5} | {例如：#2D2D2D} |
+| `--text-primary` | {例如：#1F1F1F} | {例如：#E0E0E0} |
+| `--text-secondary` | {例如：#5F6368} | {例如：#9E9E9E} |
+| `--border` | {例如：#E0E0E0} | {例如：#424242} |
+
+### 9.2 切换策略
+
+| 策略 | 说明 |
+| :--- | :--- |
+| 自动跟随 | {例如：默认跟随系统偏好 prefers-color-scheme} |
+| 手动切换 | {例如：设置页 + 顶栏快捷切换} |
+| 持久化 | {例如：localStorage 存储用户偏好} |
+
+---
+
+## 10. 品牌差异化（如适用）
+
+### 10.1 与同系产品的视觉区分
+
+| 维度 | {Name} | {例如：OctoPanel} |
+| :--- | :--- | :--- |
+| 主色 | {例如：#1A73E8（蓝）} | {例如：#6D28D9（紫）} |
+| 图标风格 | {例如：电商相关（购物车、商品）} | {例如：管理相关（仪表盘、齿轮）} |
+| 品牌标识 | {例如：购物袋 + 触手} | {例如：章鱼 + 面板} |
+
+### 10.2 白标定制（企业版）
+
+| 可定制项 | 范围 | 实现方式 |
+| :--- | :--- | :--- |
+| Logo | {例如：顶栏 + 登录页} | {例如：管理后台上传} |
+| 主色 | {例如：全局品牌色} | {例如：CSS 变量覆盖} |
+| 域名 | {例如：自定义域名} | {例如：CNAME 配置} |
+| Favicon | {例如：浏览器标签图标} | {例如：管理后台上传} |
+
+---
+
+## 11. 无障碍规范
+
+| 维度 | 标准 | 说明 |
+| :--- | :--- | :--- |
+| 对比度 | WCAG 2.1 AA (≥ 4.5:1) | {例如：正文文字与背景色对比度} |
+| 键盘导航 | 全键盘可操作 | {例如：Tab 聚焦、Enter 确认、Esc 取消} |
+| 屏幕阅读器 | aria-label 标注 | {例如：图标按钮、状态标签} |
+| 焦点指示 | 可见焦点环 | {例如：2px solid 主色} |
+| 色觉友好 | 不仅靠颜色传达信息 | {例如：图标 + 颜色双重标识状态} |
+
+---
+
+**文档版本**：V1.0.0
+**创建日期**：{YYYY-MM-DD}
+**最后更新**：{YYYY-MM-DD}
+**文档状态**：✅ 待评审

skills/dev-utils-skills/full-stack-doc/templates/2、需求调研模板.md → skills/document-skills/full-stack-doc/templates/version/1、需求调研文档.md

@@ -1,4 +1,18 @@
-# {产品名称} - 需求调研文档 V1.0
+# {Name} 需求调研文档（{V}）
+
+> **标准说明**：本文由 原「需求调研」阶段模板全文 全文合并；占位符 `{Name}` 为产品名，`{V}` 为版本目录名（如 V1）。
+
+### 关联文档（Octo / PartMe）
+
+| 文档 | 说明 |
+| :--- | :--- |
+| `{V}/2、{Name}-需求分析文档-{V}.md` | 需求分析 |
+| `{V}/5、{Name}-PRD文档-{V}.md` | PRD |
+| `6、{Name}-产品与版本规划.md` | 产品边界 |
+| `10、{Name}-功能菜单与版本规划.md` | 功能菜单总表 |
+
+---
+
 
 > **文档说明**：
 > - 本文档是需求调研阶段的产出物，用于记录用户需求、业务痛点、竞品分析等
@@ -487,11 +501,11 @@
 ### 9.2 参考文档
 > 列出参考的相关文档
 
-- [产品调研模板](1、产品调研模板.md)
-- [技术调研模板](3、技术调研模板.md)
-- [需求分析模板](4、需求分析模板.md)
-- [PRD文档模板](5、PRD文档模板.md)
-- [UI 设计说明模板](7、UI%20设计说明模板.md)
+- 根目录 `3、{Name}-市场与商业分析.md`（产品调研章节并入）
+- `技术调研/` 目录或 `other/10、技术细分模板.md`
+- `{V}/2、{Name}-需求分析文档-{V}.md`
+- `{V}/5、{Name}-PRD文档-{V}.md`
+- `{V}/7、{Name}-UI设计说明-{V}.md`
 
 ### 9.3 变更记录
 > 记录调研变更的历史

skills/dev-utils-skills/full-stack-doc/templates/4、需求分析模板.md → skills/document-skills/full-stack-doc/templates/version/2、需求分析文档.md

@@ -1,4 +1,18 @@
-# {产品名称} - 需求分析文档 V1.0
+# {Name} 需求分析文档（{V}）
+
+> **标准说明**：本文由 原「需求分析」阶段模板全文 全文合并。
+
+### 关联文档（Octo / PartMe）
+
+| 文档 | 说明 |
+| :--- | :--- |
+| `{V}/1、{Name}-需求调研文档-{V}.md` | 需求调研 |
+| `{V}/5、{Name}-PRD文档-{V}.md` | PRD |
+| `{V}/4、{Name}-功能与界面规划-{V}.md` | 功能与界面规划 |
+| `7、{Name}-领域模型设计.md` | 领域模型（根目录） |
+
+---
+
 
 > **文档说明**：
 > - 本文档是需求分析阶段的产出物，用于明确产品功能需求和用户故事
@@ -367,11 +381,11 @@
 ### 9.2 参考文档
 > 列出参考的相关文档
 
-- [产品调研模板](1、产品调研模板.md)
-- [需求调研模板](2、需求调研模板.md)
-- [技术调研模板](3、技术调研模板.md)
-- [PRD文档模板](5、PRD文档模板.md)
-- [UI 设计说明模板](7、UI%20设计说明模板.md)
+- 根目录 `3、{Name}-市场与商业分析.md`
+- `{V}/1、{Name}-需求调研文档-{V}.md`
+- `技术调研/`
+- `{V}/5、{Name}-PRD文档-{V}.md`
+- `{V}/7、{Name}-UI设计说明-{V}.md`
 
 ### 9.3 变更记录
 > 记录需求变更的历史

skills/document-skills/full-stack-doc/templates/version/3、系统架构设计.md

@@ -0,0 +1,362 @@
+# {Name} 系统架构设计（{V}）
+
+> **标准说明**：以下为 **OctoPanel V1** 实例（`partme-docs/1、OctoPanel/V1/3、…`）全文，产品名已替换为 `{Name}`，`{V}` 请替换为实际版本目录名。分版本架构应与根目录 `8、{Name}-系统架构设计.md`（legacy 9 全文合并）对照：**总纲在根目录，本文档写本版增量与范围**。
+>
+> 若需按 legacy 章节从零起草，可对照根目录 `8、{Name}-系统架构设计.md` 的同一套二级标题。
+
+---
+
+
+> 范围更新：V1 当前 canonical 架构只服务于 {Name} Web / Desktop / Node 三形态的三引擎安装闭环。若本文仍出现渠道、模型或平台扩张表述，以 [../25、{Name}-三形态部署与运行架构说明](../25%E3%80%81{Name}-%E4%B8%89%E5%BD%A2%E6%80%81%E9%83%A8%E7%BD%B2%E4%B8%8E%E8%BF%90%E8%A1%8C%E6%9E%B6%E6%9E%84%E8%AF%B4%E6%98%8E.md) 与 [../27、{Name}-安装兼容与联调执行基线](../27%E3%80%81{Name}-%E5%AE%89%E8%A3%85%E5%85%BC%E5%AE%B9%E4%B8%8E%E8%81%94%E8%B0%83%E6%89%A7%E8%A1%8C%E5%9F%BA%E7%BA%BF.md) 为准。
+
+> **文档说明**：描述 **V1** 技术架构（多场景连接与编排：多实例管理 + 配置 + 渠道 + 模型）。V2/V3 架构见 [系统架构设计-V2](../V2/3、{Name}-系统架构设计-V2.md)、[系统架构设计-V3](../V3/3、{Name}-系统架构设计-V3.md)。
+
+---
+
+## 1. 文档信息 (Document Info)
+
+### 1.1 版本记录
+| 版本号 | 修改日期 | 修改人 | 修改内容 | 备注 |
+| :--- | :--- | :--- | :--- | :--- |
+| V1.0.0 | 2026-02-11 | PartMe | 从总架构文档拆分为 V1 独立文档 | 仅含 V1 范围 |
+| V1.1.0 | 2026-02-12 | PartMe | 依据 PRD 完善：以 Gateway WebSocket 为主、基线冲突与离线策略、审计与企微凭证加密、性能与时区、术语与参考 | 与 PRD §5.7、§5、§6、§7 对齐 |
+
+### 1.2 文档责任人
+| 角色 | 职责 |
+| :--- | :--- |
+| 架构师 | 架构设计、技术评审 |
+| 技术负责人 | 技术选型、与 OpenClaw/插件接口对齐 |
+| 开发负责人 | 架构实现、接口契约落地 |
+
+### 1.3 关联文档
+| 文档类型 | 文档名称 | 说明 |
+| :--- | :--- | :--- |
+| PRD V1 | [{Name}-PRD文档-V1](5、{Name}-PRD文档-V1.md) | V1 功能需求、非功能与验收（权威依据） |
+| 需求分析 V1 | [{Name}-需求分析文档-V1](2、{Name}-需求分析文档-V1.md) | 用户故事与功能规则细粒度依据 |
+| 需求调研 V1 | [{Name}-需求调研文档-V1](1、{Name}-需求调研文档-V1.md) | 调研结论支撑 PRD |
+| 架构 V2/V3 | {Name}-系统架构设计-V2.md / {Name}-系统架构设计-V3.md | 资源中心/RBAC（V2）、数据分析/扩展市场/多租户（V3）架构 |
+| 实现参考 | [{Name}-技术方案与路线](../5、{Name}-技术方案与路线.md) | V1 平台能力与接口边界 |
+| 子 PRD | 工作台/设备中心/模型服务/设置（见 PRD §1.3） | 各一级菜单功能与验收 |
+| 总纲 | [{Name}-系统架构设计](../8、{Name}-系统架构设计.md)、[{Name}-技术方案与路线](../5、{Name}-技术方案与路线.md) | 多引擎管理总纲与引擎适配层 |
+
+---
+
+## 1.5 总纲：{Name} Desktop V1 架构（Tauri + OpenClaw/ZeroClaw）
+
+与 [{Name}-产品与版本规划](../6、{Name}-产品与版本规划.md) V1 范围一致：**{Name} Desktop**，管理 **OpenClaw + ZeroClaw**，单机。
+
+**应用层次**：前端（React/Vue）↔ **Tauri IPC** ↔ **Rust 后端**。
+
+**Rust 后端模块划分**：
+
+| 模块 | 职责 |
+|------|------|
+| engine_manager | 引擎适配层工厂，按 EngineType 返回 OpenClawAdapter / ZeroClawAdapter |
+| openclaw_adapter | OpenClaw CLI 调用封装与 Gateway 协议（若需）；detect/install/create/start/stop/status/logs |
+| zeroclaw_adapter | ZeroClaw CLI 调用封装；detect/install/create/start/stop/status/logs |
+| process_manager | spawn/detach、PID 文件、kill -0 监控、可选自动重启 |
+| config_generator | 根据 UI 表单生成 OpenClaw JSON / ZeroClaw TOML |
+| instance_store | 本地 SQLite（如 tauri-plugin-sql）存储实例元数据（ID、引擎类型、配置路径、PID、状态等） |
+
+**IPC 命令清单（`#[tauri::command]`）**：`detect_environment`、`install_engine`、`create_instance`、`start_instance`、`stop_instance`、`get_status`、`get_logs`、`list_instances`（及可选 `restart_instance`、`delete_instance`）。
+
+**数据模型（概要）**：`InstanceConfig`（实例配置表单）、`EnvCheckResult`（环境检测结果）、`InstanceStatus`（运行状态、PID、内存等）、`InstanceInfo`（实例元数据，持久化在 SQLite）。
+
+---
+
+## 2. 架构概述 (Architecture Overview) — V1
+
+### 2.1 系统定位
+
+**系统定位**：{Name} 管理后台 = **Claw 引擎多实例管理平台**（多实例、配置、渠道、模型、工作台）。管理后台作为外置 Web 系统，通过 **Gateway WebSocket 协议**连接多台底层 OpenClaw / ZeroClaw 实例进行管理，并承载配置基线/模板/一致性/下发、渠道与模型配置、会话与用量聚合、日志与状态观测等能力；OpenClaw / ZeroClaw 为底层引擎，技术方案为实现与接口参考。平台不承载具体业务场景能力。
+
+**系统目标（V1）**：与 PRD §2.1～2.3 一致。
+
+- 支持多 OpenClaw 实例的注册、分组、健康监控与批量操作。
+- 配置管理可落地：基线 + 模板 + 实例三层模型，一致性检测与批量下发，可审计；**基线版本冲突处理**（乐观锁，他人已更新则提示刷新并拦截保存）、**离线实例下发策略**（立即失败 / 自动重试，等待重试可查看与取消）。
+- 单实例管理覆盖 OpenClaw 全部能力（概览/对话测试/渠道/会话/Agent/技能/节点/用量/定时/配置/调试/上下文诊断/日志），并以可视化表单替代 JSON 编辑。
+- 工作台：在线实例数、总会话数、总消息数、告警数及异常实例告警待办（跳转设备中心）；会话与用量跨实例聚合；场景化运营由场景包提供。
+- **审计日志**：下发记录必含**操作人**；配置变更与敏感操作可追溯（PRD §5.4）。
+- **企微凭证加密存储**（PRD §5.2）；**错误响应与分页契约、时区**（PRD §5.7、§5.6）为架构约束。
+- 管理后台可独立于 OpenClaw 部署，支持水平扩展与多环境（开发/预发/生产）。
+
+### 2.2 架构原则
+
+- **领域驱动 (DDD)**：设备/实例、配置管理、渠道接入、模型服务、会话与用量观测等按限界上下文划分；核心逻辑收敛在领域层。
+- **依赖倒置**：应用层与领域层不依赖基础设施；通过 **Gateway WebSocket** 访问 OpenClaw 实例，数据库与缓存在 Infrastructure。
+- **配置可落地**：基线/模板存 {Name} 数据库；下发通过 **Gateway WebSocket**（config.set/config.apply）写入并触发热重载；一致性由「基线 vs 实例当前配置」计算；**不使用 management/ics 插件的 REST API**（PRD §5.7）。
+- **安全与审计**：管理后台鉴权（V1 Token）；配置与密钥不明文落日志；下发记录含操作人；企微凭证加密存储、前端全掩码。
+
+### 2.3 技术选型
+
+| 层次 | 选型 | 说明 |
+| :--- | :--- | :--- |
+| **管理后台前端** | Web：Element Plus / Avue / Echarts | B 端以 Web 为主，组件与 DNA 规范一致 |
+| **管理后台后端** | Spring Boot (推荐 DDD/CQRS) 或 Node.js/TypeScript | 与 OpenClaw 同栈可加快 MVP；长期复杂业务建议 Java |
+| **数据库** | PostgreSQL | {Name} 管理数据：实例、分组、基线、模板、下发任务、事件消息配置等 |
+| **缓存** | Redis | 会话、热点配置、聚合统计缓存（可选） |
+| **OpenClaw 插件** | TypeScript | openclaw_management、openclaw_ics、openclaw_wecom_kf（企微渠道） |
+| **LLM / 向量** | OpenClaw 内置 + 多提供商 | Anthropic/OpenAI/国内模型；BM25 + 向量混合检索在 OpenClaw 侧 |
+
+---
+
+## 3. 系统架构 (System Architecture)
+
+### 3.1 整体架构图
+
+```
+                    微信客户（C 端）
+                          │
+                ┌─────────▼─────────┐
+                │  企微·微信客服系统   │
+                └─────────┬─────────┘
+                          │ HTTP 回调 / kf/sync_msg / send_msg
+                          ▼
+┌─────────────────────────────────────────────────────────────────────┐
+│  OpenClaw Gateway（可多实例）                                         │
+│  ┌─────────────────┐ ┌─────────────────────────────────────────────┐   │
+│  │ openclaw_wecom_kf│ │ Gateway WebSocket（与官方 Control UI 一致）   │   │
+│  │ 企微消息收发      │ │ config.get/set、sessions.list、health 等    │   │
+│  │ 仅企微回调等 HTTP │ │ 配置/会话/健康等均通过 WS，无 management REST │   │
+│  └─────────────────┘ └────────┬───────────────────────────────────┘   │
+└────────────────────────────────┼───────────────────────────────────────┘
+                                 │
+                    WebSocket (Gateway 协议)
+                                 ▼
+┌─────────────────────────────────────────────────────────────────────┐
+│  {Name} 管理后台（独立部署）                                      │
+│  ┌───────────────────────────────────────────────────────────────┐  │
+│  │  Web 前端（Vue 3 + Element Plus / Avue）                        │  │
+│  └───────────────────────────────────────────────────────────────┘  │
+│                                 │                                    │
+│  ┌───────────────────────────────────────────────────────────────┐  │
+│  │  后端（Spring Boot 或 Node.js）                                 │  │
+│  │  Adapter → Application → Domain ← Infrastructure               │  │
+│  │  设备/配置/渠道/模型/会话观测 应用服务 + 领域模型                 │  │
+│  └───────────────────────────────────────────────────────────────┘  │
+│                                 │                                    │
+│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────────────┐   │
+│  │ PostgreSQL   │  │ Redis        │  │ OpenClaw 实例集群          │   │
+│  │ 实例/基线/   │  │ 缓存/会话    │  │ Gateway WebSocket 连接     │   │
+│  │ 模板/下发记录│  │ (可选)       │  │ 渠道配置/日志/状态观测服务 │   │
+│  └──────────────┘  └──────────────┘  └──────────────────────────┘   │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+### 3.2 逻辑架构 — COLA 分层
+
+| 层次 | 职责 | {Name} 对应 |
+| :--- | :--- | :--- |
+| **Adapter（适配层）** | 处理外部输入输出 | Web Controller（工作台/设备中心/配置管理/模型服务/设置）；调用 OpenClaw 的客户端封装在 Infrastructure |
+| **Application（应用层）** | 业务流程编排、用例 | 实例注册与分组、基线编辑与版本、一致性计算与展示、下发任务执行、渠道配置下发、会话/用量聚合查询 |
+| **Domain（领域层）** | 核心业务逻辑与模型 | Instance、Baseline、ConfigTemplate、DeploymentTask、ChannelConfig；ConsistencyService、DeploymentExecutor |
+| **Infrastructure（基础设施层）** | 技术实现 | PostgreSQL 仓储实现、Redis、**OpenClaw Gateway WebSocket 客户端**（按实例 WS 地址 + Token 连接，config.get/set、sessions.list、health 等）；日志采集、用量聚合、渠道回调校验等平台基础设施 |
+
+**依赖方向**：Adapter → Application → Domain ← Infrastructure；领域层不依赖具体数据库与 OpenClaw 客户端，通过接口注入。
+
+### 3.3 与 OpenClaw 的交互边界（与 PRD §5.7 一致）
+
+- **管理后台不直接读写**：不访问 OpenClaw 所在机器的文件系统（openclaw.json、AGENTS.md、工作区等）。
+- **以 Gateway WebSocket 协议为主**：管理后台与各 OpenClaw 实例的交互通过 **Gateway WebSocket 协议**（与官方 Control UI 一致），**不使用 management/ics 插件的 REST API**。配置读写、会话列表、健康检查等均通过 WS 方法（如 `config.get`/`config.set`/`config.apply`、`sessions.list`、`sessions.patch`、`health`、`status`）；bindings、eventMessages 通过 config 读写。
+- **平台能力扩展**：渠道连通性校验、配置审计、日志聚合、实例诊断等由管理后台自有 API 承接；仅渠道回调等 HTTP 由对应插件暴露。
+- **热重载**：配置类通过 config.set 写入后，由 OpenClaw 触发热重载（如 `gateway.reload.mode="hybrid"`），无需管理后台触发进程重启。
+
+---
+
+## 4. 核心 API 契约（以 Gateway WebSocket 为核心）— V1
+
+管理后台与各 OpenClaw 实例的交互以 **Gateway WebSocket 协议**为主（与 PRD §5.7 一致）；平台侧关注配置、状态、日志、用量与运维任务，不承载具体业务场景能力。
+
+### 5.1 Gateway WebSocket 方法
+
+| 分类 | 方法 | 用途 | 说明 |
+| :--- | :--- | :--- | :--- |
+| 配置 | config.get | 读取实例当前配置 | 用于一致性计算、单实例编辑 |
+| 配置 | config.set / config.apply | 写入配置并触发热重载 | 下发任务、从基线恢复、单实例保存 |
+| 配置 | bindings、eventMessages | 路由与事件消息 | 通过 config 读写（结构在 openclaw.json 内） |
+| 会话 | sessions.list | 会话列表 | 单实例会话查看、运行态排障 |
+| 会话 | sessions.patch | 会话状态变更 | 接管/释放/转给坐席等 |
+| 健康/状态 | health、status | 健康检查、版本、插件列表 | 工作台与设备中心状态展示 |
+
+**连接与认证**：connect 时 `params.auth.token` 携带实例 Gateway Token；实例注册时在 {Name} 数据库中存储「WS 地址 + Token」（加密或脱敏），Infrastructure 层按实例建立 WS 连接并注入 Token。
+
+### 5.2 管理后台自有 API 与扩展
+
+| 能力 | 实现方式 | 说明 |
+| :--- | :--- | :--- |
+| 渠道配置校验 | 管理后台 API | 渠道凭证校验、回调连通测试、保存前预检查 |
+| 日志与诊断 | 管理后台 API | 聚合日志、异常摘要、实例诊断结果 |
+| 用量统计 | 管理后台定时采集 | 消息量、Token 用量、失败率等平台指标 |
+
+### 5.3 接口契约（与 PRD §5.7、§5.6 一致）
+
+- **错误响应**：`{ code, message, detail? }`；前端按 code 展示 PRD §2.4 规范（表单校验、操作成功/失败、网络异常、空状态）。
+- **分页**：请求 `page`、`pageSize`；响应 `list`、`total`（或等价）；格式与 PRD 接口契约一致。
+- **时间格式**：接口侧使用 **ISO 8601**（UTC）；前端按用户时区转换展示（PRD §5.6）。
+
+---
+
+## 5. 数据架构 (Data Architecture) — V1
+
+### 5.1 管理后台自有库（PostgreSQL）
+
+| 领域 | 表/用途 | 说明 |
+| :--- | :--- | :--- |
+| 实例管理 | instance, instance_group, instance_tag | 实例注册信息、分组、标签 |
+| 配置管理 | baseline_version, config_template, deployment_task, deployment_task_result | 基线版本（含乐观锁版本号）、模板、下发任务及每实例结果；**deployment_task 必含操作人**（PRD §5.4） |
+| 企微应用 | wecom_app_credential（或等价） | 企微应用凭证；存储时**加密**（如 AES-256-GCM），密钥与库分离（PRD §5.2） |
+| 渠道配置 | channel_config_snapshot | 渠道凭证、回调地址、测试结果与下发快照 |
+| 运行诊断 | runtime_diagnosis_snapshot | 实例诊断结果、错误摘要、修复建议 |
+| 用量统计 | usage_metrics_snapshot | 消息量、Token 用量、失败率等平台指标快照 |
+| 审计 | audit_log、deployment_task.operator_id | 配置变更与敏感操作日志；**下发记录必含操作人**；保存期限与界面可见性与 PRD §5.4 一致 |
+
+基线/模板的「配置内容」建议 JSONB 或大字段存储，结构与 openclaw.json 对齐，便于 diff 与下发。
+
+### 5.2 缓存（Redis，可选）
+
+- 实例健康状态短 TTL 缓存，减少对多实例的频繁健康检查。
+- 聚合统计（工作台概览）短 TTL 缓存。
+- 会话列表/消息记录以实时查询 OpenClaw 为主，缓存按需引入。
+
+### 5.3 数据一致性
+
+- **基线/模板/下发记录**：强一致性，事务落库。
+- **实例当前配置**：通过 management API 实时读取，与基线 diff 得到一致性状态；下发后再次读取验证或由下发结果接口返回。
+- **跨实例会话/用量**：最终一致性；各实例数据源独立，管理后台聚合展示。
+
+---
+
+## 6. 安全架构 (Security Architecture) — V1
+
+### 6.1 认证与授权
+
+- **V1**：管理后台登录后使用 Token 或 Session；调用 OpenClaw 实例时使用各实例的 Gateway Token（存储与传递需加密或脱敏）。
+
+### 6.2 数据安全（与 PRD §5.2 一致）
+
+- 配置与密钥不明文写入日志；生产环境 HTTPS。
+- **企微凭证加密存储**：corpSecret、token、encodingAESKey 必须加密落库（如 AES-256-GCM），密钥与库分离；**前端全掩码**（仅末四位可见）。
+- 实例 Gateway Token 存库加密或脱敏；按实例调用时由 Infrastructure 注入。
+
+### 6.3 访问控制
+
+- 管理后台仅允许内网或 VPN 访问（视部署方式）；OpenClaw 实例的 endpoint 可为内网地址，通过管理后台所在网络可达即可。
+
+---
+
+## 7. 部署架构 (Deployment Architecture)
+
+### 7.1 部署方式
+
+- **{Name} 管理后台**：独立部署（单机或集群）；可容器化（Docker/K8s）；与 OpenClaw 实例无同机绑定。
+- **OpenClaw Gateway**：每台实例独立部署（见技术方案 §2.3、§8.3）；支持多 Profile、多端口；生产建议 systemd/launchd 守护。
+- **网络**：管理后台能访问各实例的 **Gateway WebSocket** 地址（与官方 Control UI 一致）；企微回调需公网可达，推荐 Nginx 反代 + HTTPS。
+
+### 7.2 高可用与扩展
+
+- 管理后台：无状态，可水平扩展；数据库与 Redis 做主从或集群。
+- OpenClaw 实例：按业务需要多实例部署；会话与配置由各实例本地或共享存储承担（见 OpenClaw 文档）；管理后台仅做「配置下发」与「读状态/会话/用量」。
+
+---
+
+## 8. 监控与运维
+
+### 8.1 监控
+
+- **管理后台**：应用监控（QPS、RT、错误率）、关键接口（下发、一致性计算）耗时与成功率。
+- **OpenClaw 实例**：各实例健康通过 **Gateway WebSocket** 的 `health`、`status` 获取；异常实例在「工作台」与「设备中心」告警展示。
+- **日志**：管理后台与 OpenClaw 分别落日志；下发失败原因记录在下发记录中便于排查。
+
+### 8.2 Gateway 部署检查清单（与技术方案 §8.3 一致）
+
+| # | 事项 | 说明 |
+| :--- | :--- | :--- |
+| 1 | 安装 OpenClaw | 确认版本并锁定 |
+| 2 | 配置 Gateway Token | 生产必须启用认证 |
+| 3 | 安装 wecom-kf 等插件；Gateway 支持 WS | 企微消息收发；管理后台通过 Gateway WebSocket 连接，无需 management/ics REST |
+| 4 | 外网可达 | 企微回调需公网 URL，推荐 Nginx + HTTPS |
+| 5 | 服务守护 | macOS launchd / Linux systemd |
+| 6 | 健康监控 | 集成 status/health 到监控与工作台 |
+| 7 | 热重载确认 | gateway.reload.mode=hybrid |
+| 8 | 备份 | 定期备份 ~/.openclaw/ 及 {Name} 数据库 |
+
+---
+
+## 9. 关键技术方案摘要 — V1
+
+### 9.1 配置下发流程（可落地，与 PRD §5.2、§6 一致）
+
+1. **基线编辑与保存**：用户在「配置管理」编辑基线；保存前**乐观锁校验**（后端基线版本 > 前端持有版本则提示「配置已被他人更新，请刷新后重新编辑」并拦截保存）；保存成功后版本递增。
+2. **下发任务**：选择来源（基线/模板）与目标实例列表；Application 层生成下发任务记录，**操作人必填**并写入 deployment_task。
+3. **离线实例策略**：若部分实例离线，支持 **模式 A 立即失败**（整任务失败或跳过离线实例由产品约定）或 **模式 B 自动重试**（最多 N 次，如 3 次）；等待重试的任务可查看与取消。
+4. **执行下发**：对每个目标实例，Infrastructure 层通过 **Gateway WebSocket** 调用 `config.set`/`config.apply` 写入配置，触发热重载；汇总每实例成功/失败写回 DeploymentTask；前端展示结果；失败可重试并记录原因。
+5. **一致性计算**：定时或按需对每个实例通过 WS `config.get` 拉取配置，与当前基线版本做 diff，更新「一致性状态」与差异项数。
+
+### 9.2 历史场景层能力归档
+
+历史业务场景能力已移出 {Name} 主线，本架构不再为其定义专属实现链路。
+
+### 9.3 跨实例会话与用量聚合（与 PRD §5.4、§5.7 一致）
+
+- 会话列表/消息记录：对每个实例通过 **Gateway WebSocket** 调用 `sessions.list`（及按需拉取单会话消息）；Application 层按实例/渠道/Agent/状态筛选与聚合后返回前端。
+- 用量/健康：各实例通过 WS `health`、`status` 获取；工作台总览汇总各实例指标。
+
+### 9.4 历史业务场景归档
+
+历史业务场景能力已移出 {Name} 主线。当前系统架构仅要求会话查询、日志调试、用量采集、配置下发与状态监控链路可落地。
+
+### 9.8 性能与压测（与 PRD §5.1 一致）
+
+以下指标为架构约束与压测依据，须在约定测试条件下达成（或超出部分在发布说明中标注并规划优化）：
+
+| 指标 | 目标值 | 测试条件 |
+| :--- | :--- | :--- |
+| 实例列表页首屏加载 | ≤ 2 秒 | 聚合 50 实例，每实例 3 个 Agent |
+| 配置表单打开时间 | ≤ 1.5 秒 | 基线配置（7 大类表单） |
+| 一致性总览加载 | ≤ 3 秒 | 100 实例，计算差异项 |
+| 下发任务执行 | 批量下发 10 实例 ≤ 5 秒 | 含 WS 调用 + 热重载 |
+| 单实例会话加载 | ≤ 2 秒 | 最近 50 条会话，单实例运行态查看 |
+| 并发管理后台用户 | ≥ 20 人同时操作 | 主要页面无卡顿 |
+
+### 9.9 时区与时间（与 PRD §5.6 一致）
+
+- **接口**：统一使用 UTC、ISO 8601（如 `2026-02-12T08:30:00Z`）。
+- **前端**：按用户浏览器时区转换展示；界面日期格式 `YYYY-MM-DD HH:mm:ss`（24 小时制）。
+
+---
+
+## 10. 历史桌面工作流归档
+
+历史桌面工作流系统架构已从 {Name} 主线移除，本文件不再承载其技术架构设计。
+
+## 11. 附录 (Appendix)
+
+### 11.1 术语表（与 PRD §7.1 对齐）
+
+| 术语 | 定义 |
+| :--- | :--- |
+| 实例 | 单台 OpenClaw Gateway，对应唯一 WebSocket 地址与 Gateway Token |
+| 基线 | 全局期望配置，版本化存储于 {Name} 数据库；可编辑、乐观锁、导出与从模板应用 |
+| 配置模板 | 可复用配置片段，用于应用到基线或实例；支持分类与版本管理 |
+| 一致性状态 | 实例相对基线的状态：已同步（绿）/已修改（黄）/待下发（蓝）/下发失败（红）/未纳管（灰） |
+| 下发任务 | 将基线或模板推送到选定实例的一次操作及结果记录；含操作人、离线实例策略 |
+| Command Queue | OpenClaw 命令队列，可合并短时内多条消息为一个 Agent turn |
+| 场景链接 | 带追踪参数的客服入口链接，用于多渠道引流和效果归因 |
+| 历史场景协同视图 | 已移出主线的历史消息聚合视图 |
+| 模型 Failover | 主模型超时/限流时自动切换备用模型 |
+| 历史时效指标 | 已移出主线的历史业务时效指标 |
+
+### 11.2 参考文档
+
+- [{Name} PRD 文档 V1](5、{Name}-PRD文档-V1.md)（功能、非功能与验收；子 PRD 见 PRD §1.3：工作台/设备中心/设置/模型服务）
+- [{Name} 需求分析文档 V1](2、{Name}-需求分析文档-V1.md)
+- [{Name} 需求调研文档 V1](1、{Name}-需求调研文档-V1.md)
+- 《{Name} 系统架构设计 V2》、《V3》
+
+
+---
+
+**文档版本**：V1.1.0  
+**创建时间**：2026-02-11  
+**最后更新**：2026-02-12  
+**文档状态**：✅ 设计中 / 待评审，已与 PRD 对齐

skills/document-skills/full-stack-doc/templates/version/4、功能与界面规划.md

@@ -0,0 +1,108 @@
+# {Name} 功能与界面规划（{V}）
+
+> **标准说明**：正文为 OctoPanel `V1/4` 实例；附录为 legacy 需求分析/PRD 问卷体节选。
+
+### 关联文档
+
+| 文档 | 说明 |
+| :--- | :--- |
+| `{V}/5、{Name}-PRD文档-{V}.md` | PRD |
+| `{V}/6、{Name}-功能菜单与版本规划-{V}.md` | 本版菜单 |
+| `10、{Name}-功能菜单与版本规划.md` | 总菜单 |
+
+---
+
+
+> 文件名保留历史名，仅用于兼容旧引用。正文产品名统一为 **{Name}**。
+
+## 1. V1 产品定位
+
+V1 是 {Name} Web 主控制台的第一阶段产品定义，不再围绕聊天壳或业务工作台组织界面。
+
+## 2. 一级模块
+
+1. 仪表盘
+2. 实例中心
+3. 安装向导
+4. 渠道与连接器
+5. 模型与凭证
+6. Agent 与 Skills
+7. MCP 与扩展
+8. 巡检与审计
+9. 任务中心
+10. 节点与远程主机
+11. 设置
+
+## 3. 首页规则
+
+- 默认首页：`仪表盘`
+- 主入口：`安装向导`
+- 聊天、消息、旧工作台不再作为首页中心
+
+## 4. 模块定位摘要
+
+- `仪表盘`：平台总览
+- `实例中心`：已纳管实例管理
+- `安装向导`：三引擎 6 步安装主链
+- `渠道与连接器`：连接器安装与配置入口
+- `模型与凭证`：模型提供商与凭证治理
+- `Agent 与 Skills`：Agent 套装与 Skills 市场
+- `MCP 与扩展`：MCP 市场与扩展入口
+- `巡检与审计`：巡检结果与审计事件
+- `任务中心`：部署、回滚、安装、巡检任务统一入口
+- `节点与远程主机`：执行节点与远程主机管理
+- `设置`：平台配置与外观
+
+
+---
+
+## 附录 A：需求分析模板节选（产品背景，legacy 4）
+
+## 2. 产品背景 (Product Background)
+
+### 2.1 业务背景
+> 描述为什么要做这个产品/功能，解决什么业务问题
+
+**业务痛点**：
+- {例如：门店订单处理效率低，经常出现订单遗漏}
+- {例如：师傅抢单流程不顺畅，导致订单响应慢}
+- {例如：门店无法实时掌握运营数据，影响决策}
+
+**业务目标**：
+- {例如：提升订单处理效率30%}
+- {例如：减少订单遗漏率至5%以下}
+- {例如：提升师傅接单率至80%以上}
+
+### 2.2 目标用户
+> 明确产品的目标用户群体
+
+| 用户角色 | 用户描述 | 使用场景 | 核心诉求 |
+| :--- | :--- | :--- | :--- |
+| {门店老板} | {拥有门店管理权限，负责门店日常运营} | {每日查看订单，处理待接单订单，指派师傅} | {快速处理订单，提升门店运营效率} |
+| {工作人员} | {门店普通员工，协助门店老板处理订单} | {查看订单列表，联系客户，协助处理订单} | {便捷查看订单信息，快速联系客户} |
+| {师傅} | {提供上门服务的师傅} | {抢单，上报到达，开始服务，完成服务} | {快速抢单，便捷上报服务进度} |
+
+### 2.3 产品定位
+> 一句话描述产品的定位和价值
+
+{例如：面向门店老板和师傅的XXX应用，帮助门店高效管理订单、师傅、客户等业务，提升门店运营效率和服务质量}
+
+---
+
+
+
+## 附录 B：PRD 模板节选（产品范围，legacy 5）
+
+### 2.3 产品范围
+> 明确本次迭代包含和不包含的功能范围
+
+**本次迭代包含**：
+- {例如：工单模块（订单列表、订单详情、订单操作）}
+- {例如：我的模块（门店信息、数据统计、待办事项）}
+- {例如：首页模块（搜索、Banner）}
+
+**本次迭代不包含**（后续迭代）：
+- {例如：数据报表详细分析}
+- {例如：客户管理模块}
+- {例如：商品管理模块}
+

skills/dev-utils-skills/full-stack-doc/templates/5、PRD文档模板.md → skills/document-skills/full-stack-doc/templates/version/5、PRD文档.md

@@ -1,4 +1,21 @@
-# {产品名称} - 产品需求文档 (PRD) V1.0
+# {Name} PRD 文档（{V}）
+
+> **标准说明**：本文由 原「PRD」阶段模板全文 全文合并。
+
+### 关联文档（Octo / PartMe）
+
+| 文档 | 说明 |
+| :--- | :--- |
+| `{V}/1、{Name}-需求调研文档-{V}.md` | 需求调研 |
+| `{V}/2、{Name}-需求分析文档-{V}.md` | 需求分析 |
+| `{V}/3、{Name}-系统架构设计-{V}.md` | 版本架构 |
+| `{V}/4、{Name}-功能与界面规划-{V}.md` | 功能与界面规划 |
+| `{V}/6、{Name}-功能菜单与版本规划-{V}.md` | 本版功能菜单 |
+| `{V}/7、{Name}-UI设计说明-{V}.md` | UI 设计说明 |
+| `other/10、技术细分模板.md` 或 `其他/` | 接口/表结构细节 |
+
+---
+
 
 > **文档说明**：
 > - 本文档用于描述产品功能需求，是产品设计、开发、测试的重要依据
@@ -26,10 +43,10 @@
 ### 1.3 关联文档
 | 文档类型 | 文档名称 | 版本 | 说明 |
 | :--- | :--- | :--- | :--- |
-| 技术文档 | {产品名称}-技术细分文档.md | V1.0.0 | 技术实现方案 |
-| UI设计稿 | {产品名称}-UI设计稿 | V1.0 | Figma/Sketch设计文件 |
-| 原型图 | {产品名称}-原型图 | V1.0 | 交互原型文件 |
-| 数据库设计 | {产品名称}-数据库设计.md | V1.0 | 表结构设计文档 |
+| 技术文档 | `other/10、技术细分模板.md` 或研发仓库 | V1.0.0 | 技术实现方案 |
+| UI设计稿 | 设计稿链接 | V1.0 | Figma/Sketch设计文件 |
+| 原型图 | {Name}-原型图 | V1.0 | 交互原型文件 |
+| 数据库设计 | {Name}-数据库设计.md | V1.0 | 表结构设计文档 |
 
 ---
 
@@ -705,10 +722,10 @@
 ### 10.2 参考文档
 > 列出参考的相关文档
 
-- [需求分析模板](4、需求分析模板.md)
-- [视觉与交互 DNA 规范模板](6、视觉与交互%20DNA%20规范模板.md)
-- [UI 设计说明模板](7、UI%20设计说明模板.md)
-- [技术细分模板](10、技术细分模板.md)
+- `{V}/2、{Name}-需求分析文档-{V}.md`
+- `9、{Name}-视觉与交互DNA规范.md`
+- `{V}/7、{Name}-UI设计说明-{V}.md`
+- `other/10、技术细分模板.md`
 - [UniApp官方文档](https://uniapp.dcloud.net.cn/)
 - [uView Pro官方文档](https://uviewpro.cn/)
 

skills/document-skills/full-stack-doc/templates/version/6、功能菜单与版本规划.md

@@ -0,0 +1,156 @@
+# {Name} 功能菜单与版本规划（{V}）
+
+> **标准说明**：一级菜单正文来自 OctoPanel `10、…` 实例；**`（V1）` 标题请改为 `（{V}）`** 与版本目录一致。附录为 PRD「产品概述」问卷体。
+
+### 关联文档
+
+| 文档 | 说明 |
+| :--- | :--- |
+| `{V}/5、{Name}-PRD文档-{V}.md` | PRD |
+| `10、{Name}-功能菜单与版本规划.md` | 全产品菜单 |
+
+---
+
+
+> 本文档用于冻结 `{Name} Web` 的最终菜单结构。
+>
+> 当前主语：`{Name} Web` 是服务器侧智能体（Agent）安装、纳管、配置、监控、审计与回滚控制面。
+
+---
+
+## 1. 一级菜单 (Top-level Menu)
+
+{Name} Web 一级菜单固定为：
+
+1. **概览 Dashboard**
+2. **实例 Instances**
+3. **智能体 Agents Management**
+4. **模型 Models**
+5. **技能 Skills**
+6. **工具 Tools**
+7. **自动化 Automation**
+8. **记忆库 Memory Management**
+9. **设置 Settings**
+10. **文档 Docs**
+
+---
+
+## 2. 菜单归位与整合规则
+
+- **监控 & 沙盒**：不再作为一级菜单。`监控` 功能分散至 `概览` 与 `实例`；`沙盒`（WASM/Docker）整合进 `工具 Tools` 的执行环境管理。
+- **日志审计**：功能拆分。`巡检与风险发现` 归入 `概览`；`操作审计与系统日志` 归入 `设置 Settings` 或 `概览` 的事件流。
+- **自动化 & 记忆库 & 文档**：从原有的二级或深层菜单提拔为一级菜单，以突出 AI 原生能力。
+- **安装向导 & 节点管理**：统一收敛至 `实例 Instances` 模块。
+
+---
+
+## 3. 详细功能分布
+
+### 3.1 概览 Dashboard
+- **平台总览**：全局资源、活跃实例、节点分布。
+- **健康看板**：实例健康、节点健康、服务状态（原“监控”模块内容）。
+- **风险告警**：巡检发现的风险、异常实例告警（原“日志审计”巡检部分）。
+- **任务简报**：最近失败任务、最近审计事件流。
+
+### 3.2 实例 Instances
+- **实例概览**：所有引擎（OpenClaw / ZeroClaw / OctoClaw）的列表与运行状态。
+- **创建与部署**：
+  - 安装向导：环境预检、安装依赖、配置生成、服务安装、启动验证。
+  - 批量部署：多目标主机的一键下发。
+- **运维控制**：升级、回滚、重启、日志查看、性能监控。
+- **节点管理**：远程主机管理、执行器（Node Agent）安装与状态。
+
+### 3.3 智能体 Agents Management
+- **Agent 市场**：官方及社区提供的智能体角色模板。
+- **我的智能体**：已配置的 Agent 列表。
+- **套装模板**：多 Agent 协作套装（Swarm / Team）。
+- **生命周期**：版本管理、分发至实例、升级/回滚策略。
+
+### 3.4 模型 Models
+- **全部模型**：统一的模型接入列表。
+- **凭证中心**：API Key 管理、多平台厂商接入。
+- **模型订阅**：官方/聚合平台接入模板、配额监控、注册引导。
+- **模型代理**：统一网关、服务端代理、故障转移（Failover）、熔断恢复。
+- **路由策略**：基于成本/速度/能力的自动路由。
+
+### 3.5 技能 Skills
+- **Skills 市场**：可供 Agent 调用的技能（Function Calling）商店。
+- **已安装技能**：技能的分类管理、启停控制。
+- **开发与调试**：技能在线测试、权限范围（Scope）定义。
+
+### 3.6 工具 Tools
+- **MCP 市场**：Model Context Protocol 兼容插件商店。
+- **连接器 Connectors**：渠道（WeCom, Slack, Telegram 等）接入管理。
+- **执行环境**：WASM 沙盒、Docker 隔离环境、OpenSandbox 配置。
+- **工具链集成**：外部 API 与 SDK 的连接配置。
+
+### 3.7 自动化 Automation
+- **工作流编排**：可视化或代码化的任务流水线。
+- **定时任务**：Cron 任务、周期性巡检触发。
+- **事件触发**：基于 Webhook 或系统事件的自动化响应。
+- **执行审计**：自动化任务的历史记录与成功率分析。
+
+### 3.8 记忆库 Memory Management
+- **记忆后端**：向量数据库（Vector DB）、图数据库（Neo4j）管理。
+- **知识索引**：文档上传、网页抓取、RAG 索引构建。
+- **记忆策略**：Recall 召回机制、记忆衰减与压缩、跨 Agent 共享。
+- **数据管理**：记忆片段查看、手动干预与清理。
+
+### 3.9 设置 Settings
+- **平台管理**：RBAC 权限、安全设置、更新与版本、系统备份。
+- **审计日志**：系统日志、操作审计、异常追踪（原“日志审计”核心）。
+- **存储与目录**：安装路径、数据卷、缓存清理。
+
+### 3.10 文档 Docs
+- **知识中心**：安装手册、接入文档、模型能力矩阵。
+- **帮助与支持**：FAQ、故障排查（Troubleshooting）、社区链接。
+- **API 引用**：控制面 API 定义与 Swagger 文档。
+
+
+---
+
+## 附录 A：PRD 模板节选（产品概述，legacy 5）
+
+## 2. 产品概述 (Product Overview)
+
+### 2.1 产品定位
+> 简要描述产品的定位、目标用户、核心价值
+
+**产品定位**：{例如：面向门店老板和师傅的XXX应用，帮助门店高效管理订单、师傅、客户等业务}
+
+**目标用户**：
+- **主要用户**：{例如：门店老板、工作人员}
+- **次要用户**：{例如：师傅、运营人员}
+
+**核心价值**：
+1. {例如：提升订单处理效率，减少人工操作}
+2. {例如：实时掌握门店运营数据，辅助决策}
+3. {例如：优化师傅工作流程，提升服务质量}
+
+### 2.2 产品目标
+> 明确本次迭代要达成的业务目标
+
+**业务目标**：
+- {例如：提升订单处理效率30%}
+- {例如：减少订单遗漏率至5%以下}
+- {例如：提升师傅接单率至80%以上}
+
+**用户目标**：
+- {例如：门店老板能够快速查看和处理订单}
+- {例如：师傅能够便捷抢单和上报服务进度}
+
+### 2.3 产品范围
+> 明确本次迭代包含和不包含的功能范围
+
+**本次迭代包含**：
+- {例如：工单模块（订单列表、订单详情、订单操作）}
+- {例如：我的模块（门店信息、数据统计、待办事项）}
+- {例如：首页模块（搜索、Banner）}
+
+**本次迭代不包含**（后续迭代）：
+- {例如：数据报表详细分析}
+- {例如：客户管理模块}
+- {例如：商品管理模块}
+
+---
+

skills/document-skills/full-stack-doc/templates/version/7、UI设计说明.md

@@ -0,0 +1,434 @@
+# {Name} UI 设计说明（{V}）
+
+> **标准说明**：本文由 原「UI 设计说明」阶段模板全文 全文合并（版本级总说明）。
+
+### 关联文档（Octo / PartMe）
+
+| 文档 | 说明 |
+| :--- | :--- |
+| `9、{Name}-视觉与交互DNA规范.md` | 全局 DNA |
+| `{V}/5、{Name}-PRD文档-{V}.md` | PRD |
+| `{V}/2、{Name}-需求分析文档-{V}.md` | 需求分析 |
+| 模块目录 `*-UI设计说明-{V}.md` | 模块细稿 |
+
+---
+
+
+> **文档说明**：
+> - 本文档是UI设计阶段的产出物，用于明确界面设计规范和交互细节
+> - 配合UI设计稿（Figma/Sketch）使用，详细说明设计规范和交互逻辑
+> - `{}` 包裹的内容为占位符，请替换为实际内容
+> - 引用块 `>` 中的文字为填写指导，填写后可删除
+
+---
+
+## 1. 文档信息 (Document Info)
+
+### 1.1 版本记录
+| 版本号 | 修改日期 | 修改人 | 修改内容 | 备注 |
+| :--- | :--- | :--- | :--- | :--- |
+| V1.0.0 | {YYYY-MM-DD} | {姓名} | 初始版本 | 对应设计稿 V1.0 |
+
+### 1.2 文档责任人
+| 角色 | 姓名 | 职责 |
+| :--- | :--- | :--- |
+| UI设计师 | {姓名} | UI设计、交互设计、设计规范输出 |
+| 产品经理 | {姓名} | 需求确认、设计评审 |
+| 前端开发 | {姓名} | 设计实现、设计还原度把控 |
+
+### 1.3 关联文档
+| 文档类型 | 文档名称 | 版本 | 说明 |
+| :--- | :--- | :--- | :--- |
+| 需求分析文档 | `{V}/2、{Name}-需求分析文档-{V}.md` | V1.0.0 | 功能需求和用户故事 |
+| UI设计稿 | {Name}-UI设计稿 | V1.0 | Figma/Sketch设计文件 |
+| 原型图 | {Name}-原型图 | V1.0 | 交互原型文件 |
+| DNA规范 | `9、{Name}-视觉与交互DNA规范.md` | V1.0.0 | 设计DNA规范 |
+
+---
+
+## 2. 设计规范参考 (Design System Reference)
+
+### 2.1 设计系统
+> 参考视觉与交互DNA规范
+
+本文档遵循《9、{Name}-视觉与交互DNA规范》，包括：
+- 色彩系统
+- 字体系统
+- 间距系统
+- 圆角系统
+- 阴影系统
+- 图标系统
+- 交互设计规范
+
+**详细规范请参考**：`9、{Name}-视觉与交互DNA规范.md`
+
+---
+
+## 3. 页面设计说明 (Page Design)
+
+### 3.1 {页面名称 - 例如：首页}
+
+#### 3.1.1 页面结构
+> 描述页面的整体布局结构
+
+**页面布局**：
+```
+┌─────────────────────────┐
+│  顶部导航栏（固定）      │
+├─────────────────────────┤
+│  搜索框                  │
+├─────────────────────────┤
+│  Banner轮播区            │
+├─────────────────────────┤
+│  内容区域（可滚动）      │
+│  ...                    │
+└─────────────────────────┘
+│  底部导航栏（固定）      │
+└─────────────────────────┘
+```
+
+#### 3.1.2 设计细节
+> 详细说明每个区域的设计规范，包含尺寸、间距、颜色等具体数值
+
+**顶部导航栏**：
+- **高度**：44px（状态栏高度 + 导航栏高度）
+- **背景色**：白色 `#FFFFFF`
+- **标题**：居中，20px，Semibold，颜色 `#000000`
+- **分割线**：底部1px，颜色 `#E5E5E5`
+
+**搜索框**：
+- **位置**：顶部导航栏下方，左右边距16px
+- **高度**：40px
+- **背景色**：`#F5F5F5`
+- **圆角**：20px（高度的一半，形成胶囊形状）
+- **图标**：搜索图标，16px，颜色 `#999999`，左侧内边距16px
+- **文字**：默认显示"全域用户运营课程"，18px，Regular，颜色 `#999999`
+
+**Banner轮播区**：
+- **高度**：180px（根据设计稿调整）
+- **左右边距**：16px
+- **圆角**：12px
+- **指示器**：底部居中，小圆点，当前Banner高亮（主色），其他灰色
+- **轮播间隔**：3秒
+
+> **【交互布局规范】**
+> *   **布局**: Header + KingKong + Content List
+> *   **Header (头部)**:
+>     *   高度 `120px` (含状态栏)。背景品牌色。
+>     *   元素: 用户头像 (48px), 消息入口 (24px), 今日概览文字。
+> *   **King Kong (金刚区)**:
+>     *   悬浮卡片样式，向上负 Margin `20px` 覆盖 Header。
+>     *   4宫格布局，图标 `40px`，文字 `12px`。
+> *   **Content (列表)**:
+>     *   卡片 Margin `16px`，圆角 `12px`，阴影 `blur 10px`。
+> *   **FAB**: 右下角 `Fixed`，距离底部 `80px`，直径 `56px`，阴影层级高。
+
+#### 3.1.3 交互说明
+> 说明页面的交互逻辑
+
+**搜索框交互**：
+- 点击搜索框：跳转到搜索结果页
+- 搜索框为只读状态，不可直接输入
+
+**Banner交互**：
+- 自动轮播：每3秒切换一张
+- 支持左右滑动切换
+- 点击Banner：跳转到配置的URL
+
+#### 3.1.4 设计稿链接
+> 提供设计稿链接
+
+- **Figma设计稿**：{Figma链接}
+- **Sketch设计稿**：{Sketch链接}
+- **设计稿版本**：V1.0
+
+---
+
+### 3.2 {页面名称 - 例如：工单}
+
+#### 3.2.1 页面结构
+> 描述页面的整体布局结构
+
+**页面布局**：
+```
+┌─────────────────────────┐
+│  顶部导航栏（固定）      │
+│  "首页"标题              │
+├─────────────────────────┤
+│  订单状态Tab（固定）      │
+│  待接单(10) 待服务(5)... │
+├─────────────────────────┤
+│  筛选排序栏（固定）      │
+│  综合排序 ▼              │
+├─────────────────────────┤
+│  订单列表（可滚动）      │
+│  ┌───────────────────┐  │
+│  │  订单卡片1         │  │
+│  └───────────────────┘  │
+│  ┌───────────────────┐  │
+│  │  订单卡片2         │  │
+│  └───────────────────┘  │
+│  ...                    │
+└─────────────────────────┘
+```
+
+#### 3.2.2 设计细节
+> 详细说明每个区域的设计规范
+
+**订单状态Tab**：
+- **高度**：44px
+- **背景色**：白色 `#FFFFFF`
+- **Tab项**：
+  - 正常状态：文字颜色 `#666666`，字体18px，Regular
+  - 选中状态：文字颜色 `#007AFF`，字体18px，Semibold，底部2px蓝色下划线
+- **数量标签**：显示在Tab文字右侧，格式"(10)"
+  - 正常状态：文字颜色 `#999999`，字体16px
+  - 选中状态：文字颜色 `#007AFF`，字体16px
+
+**订单卡片**：
+- **背景色**：白色 `#FFFFFF`
+- **圆角**：12px
+- **内边距**：16px
+- **间距**：卡片之间间距16px
+- **阴影**：小阴影 `0 2px 8px rgba(0,0,0,0.08)`
+
+**订单卡片内容布局**：
+```
+┌─────────────────────────┐
+│ [标签]         ¥52.8    │  ← 订单类型标签（左上）、订单金额（右上）
+├─────────────────────────┤
+│ [图片]  服务名称         │  ← 商品封面图（左侧）、服务名称（右侧）
+│         母乳护航         │
+├─────────────────────────┤
+│ 客户：张三               │  ← 客户信息
+│ 电话：138****8888        │
+├─────────────────────────┤
+│ 服务时间：今天 15:00-17:00│  ← 服务时间
+├─────────────────────────┤
+│ 服务地址：杭州市余杭区... │  ← 服务地址
+└─────────────────────────┘
+```
+
+#### 3.2.3 交互说明
+> 说明页面的交互逻辑
+
+**Tab切换交互**：
+- 点击Tab：切换订单列表数据
+- 切换时有动画效果（列表滑动）
+- 切换后自动滚动到列表顶部
+
+**订单卡片交互**：
+- 点击订单卡片：跳转到订单详情页
+- 下拉刷新：显示刷新动画，刷新当前Tab的订单列表
+- 上拉加载：显示加载动画，加载更多订单
+
+#### 3.2.4 设计稿链接
+> 提供设计稿链接
+
+- **Figma设计稿**：{Figma链接}
+- **Sketch设计稿**：{Sketch链接}
+- **设计稿版本**：V1.0
+
+---
+
+## 4. 组件设计说明 (Component Design)
+
+### 4.1 {组件名称 - 例如：订单卡片}
+
+#### 4.1.1 组件描述
+> 描述组件的用途和功能
+
+{例如：订单卡片用于展示订单的基本信息，包括订单类型、服务名称、订单金额、客户信息、服务时间、服务地址等。}
+
+#### 4.1.2 设计规范
+> 详细说明组件的设计规范
+
+**尺寸**：
+- **宽度**：屏幕宽度 - 32px（左右各16px边距）
+- **高度**：自适应（根据内容）
+
+**样式**：
+- **背景色**：白色 `#FFFFFF`
+- **圆角**：12px
+- **内边距**：16px
+- **阴影**：小阴影 `0 2px 8px rgba(0,0,0,0.08)`
+
+**内容布局**：
+- **顶部**：订单类型标签（左上角）、订单金额（右上角）
+- **中间**：商品封面图（左侧）、服务名称（右侧）
+- **底部**：客户信息、服务时间、服务地址
+
+#### 4.1.3 交互说明
+> 说明组件的交互逻辑
+
+- 点击卡片：跳转到订单详情页
+- 点击态：显示阴影加深效果
+
+#### 4.1.4 设计稿链接
+> 提供设计稿链接
+
+- **Figma设计稿**：{Figma链接}
+- **Sketch设计稿**：{Sketch链接}
+
+---
+
+## 5. 交互动效说明 (Animation Design)
+
+### 5.1 页面转场动画
+> 说明页面之间的转场动画
+
+**页面跳转**：
+- **进入动画**：从右侧滑入，时长300ms，缓动函数 `ease-out`
+- **退出动画**：向左侧滑出，时长300ms，缓动函数 `ease-in`
+
+**弹窗弹出**：
+- **进入动画**：从底部向上滑入，时长300ms，缓动函数 `ease-out`
+- **退出动画**：向底部滑出，时长300ms，缓动函数 `ease-in`
+- **背景遮罩**：淡入淡出，时长300ms
+
+### 5.2 列表动画
+> 说明列表的动画效果
+
+**下拉刷新**：
+- **动画**：下拉时显示刷新图标旋转动画
+- **颜色**：主色 `#007AFF`
+- **时长**：刷新完成后0.5秒后隐藏
+
+**上拉加载**：
+- **动画**：显示加载图标旋转动画
+- **颜色**：主色 `#007AFF`
+- **提示**：加载完成后显示"没有更多了"
+
+### 5.3 按钮动画
+> 说明按钮的动画效果
+
+**按钮点击**：
+- **按下动画**：背景色变深，缩放0.98，时长100ms
+- **释放动画**：恢复原状，时长100ms
+
+---
+
+## 6. 适配说明 (Adaptation)
+
+### 6.1 屏幕适配
+> 说明不同屏幕尺寸的适配方案
+
+**屏幕尺寸适配**：
+- **小屏**（iPhone SE，375×667）：内容正常显示，字体和间距按比例缩放
+- **中屏**（iPhone 12，390×844）：内容正常显示
+- **大屏**（iPhone 14 Pro Max，430×932）：内容正常显示，左右边距适当增加
+
+**安全区域适配**：
+- **底部安全区域**：操作按钮栏需要适配底部安全区域（iPhone X及以上机型）
+- **顶部安全区域**：状态栏高度适配（刘海屏、灵动岛）
+
+### 6.2 深色模式适配
+> 说明深色模式的适配方案（如需要）
+
+**深色模式**：
+- **背景色**：深色背景 `#000000`
+- **文字颜色**：浅色文字 `#FFFFFF`
+- **卡片背景**：深灰色 `#1C1C1E`
+- **分割线**：深灰色 `#38383A`
+
+---
+
+## 7. 切图规范 (Asset Export)
+
+### 7.1 图片格式
+> 说明图片的导出格式
+
+**图片格式**：
+- **图标**：PNG格式，支持透明背景
+- **Banner**：JPG格式，质量80%
+- **占位图**：PNG格式，支持透明背景
+
+### 7.2 图片尺寸
+> 说明图片的导出尺寸
+
+**图标尺寸**：
+- **1x**：原始尺寸（如16px × 16px）
+- **2x**：2倍尺寸（如32px × 32px）
+- **3x**：3倍尺寸（如48px × 48px）
+
+**Banner尺寸**：
+- **宽度**：750px（2倍图）或1125px（3倍图）
+- **高度**：根据设计稿确定
+- **比例**：16:9或根据设计稿确定
+
+### 7.3 命名规范
+> 说明图片的命名规范
+
+**命名格式**：`{模块}_{功能}_{状态}.{格式}`
+
+**示例**：
+- `home_banner_1.jpg` - 首页Banner第1张
+- `order_card_bg.png` - 订单卡片背景
+- `button_primary_normal.png` - 主要按钮正常状态
+- `button_primary_pressed.png` - 主要按钮按下状态
+
+---
+
+## 8. 开发还原度验收 (Design Implementation Review)
+
+### 8.1 设计还原度标准
+> 明确设计还原度的验收标准
+
+1. ✅ 所有页面按照设计稿实现，还原度≥95%
+2. ✅ 所有颜色、字体、间距按照设计规范实现
+3. ✅ 所有组件按照组件设计规范实现
+4. ✅ 所有交互动效按照交互动效说明实现
+5. ✅ 所有适配按照适配说明实现
+
+### 8.2 验收检查清单
+> 提供验收检查清单
+
+**视觉还原**：
+- [ ] 颜色值完全一致
+- [ ] 字体大小和字重一致
+- [ ] 间距和布局一致
+- [ ] 圆角和阴影一致
+- [ ] 图标和图片一致
+
+**交互还原**：
+- [ ] 页面转场动画一致
+- [ ] 按钮点击反馈一致
+- [ ] 列表动画一致
+- [ ] 弹窗动画一致
+
+**适配还原**：
+- [ ] 不同屏幕尺寸适配正确
+- [ ] 安全区域适配正确
+- [ ] 深色模式适配正确（如需要）
+
+---
+
+## 9. 附录 (Appendix)
+
+### 9.1 设计工具
+> 列出使用的设计工具
+
+- **UI设计**：Figma / Sketch
+- **原型设计**：Figma / Axure
+- **切图工具**：Figma / Sketch / Photoshop
+
+### 9.2 设计资源
+> 列出设计资源链接
+
+- **设计稿链接**：{Figma/Sketch链接}
+- **图标库**：{图标库链接}
+- **字体文件**：{字体文件下载链接}
+
+### 9.3 变更记录
+> 记录设计变更的历史
+
+| 变更日期 | 变更内容 | 变更原因 | 变更人 |
+| :--- | :--- | :--- | :--- |
+| {YYYY-MM-DD} | {变更内容描述} | {变更原因} | {姓名} |
+
+---
+
+**文档版本**：V1.0.0  
+**创建时间**：{YYYY-MM-DD}  
+**最后更新**：{YYYY-MM-DD}  
+**文档状态**：✅ 设计中 / ✅ 待评审 / ✅ 评审通过 / ✅ 已完成