docs(document): 更新文档模板结构并添加品牌说明

- 删除了产品调研模板文件
- 新增命名与品牌说明文档，明确产品定位和品牌迁移策略
- 重命名技术细分模板至delivery目录下
- 重命名需求调研模板至version目录下，并更新关联文档引用
- 重命名功能提测模板至delivery目录下
- 新增术语表与词汇表文档，建立统一术语体系
- 更新需求调研文档中的参考文档链接路径

.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` 目前仅存在于仓库目录中。
 
 ### 阅读路径建议
@@ -475,10 +475,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: Provides comprehensive guidance for Chinese product documentation generation including product documentation creation, formatting, and documentation best practices. Use when the user asks about product documentation in Chinese, needs to generate product docs, or create Chinese documentation.
----
-
-# 项目文档生成技能
-
-## 概述
-
-本技能提供了一套完整的项目文档模板集合，帮助快速生成软件开发项目所需的各种文档。模板基于 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/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,111 @@
+---
+name: full-stack-doc
+description: Enforces the PartMe/Octo-style product documentation layout—11 root standard docs, 7 per version folder, optional module triplets (PRD/Stitch/UI), plus 技术调研/其他/special dirs. Markdown templates live under templates/ as root/, version/, module/, delivery/ (merged legacy 1–14 + OctoPanel examples). Use when organizing partme-docs, Octo* projects, scaffolding doc trees, or aligning repo docs to this standard.
+---
+
+## 概述
+
+本技能将 **产品文档目录与文件命名** 固化为可复用标准（与 `partme-docs` 下 Octo 系列实践一致）。**正文模板** 位于 [`templates/`](templates/) 下四个子目录 [`root/`](templates/root/)、[`version/`](templates/version/)、[`module/`](templates/module/)、[`delivery/`](templates/delivery/)（已合并原全生命周期 14 阶段模板与 OctoPanel 实例结构）；不再维护单独的 `legacy-lifecycle` 或 `project-standard` 嵌套目录。
+
+**关键词**: 产品文档、版本目录、PRD、功能菜单、技术调研、其他目录、Octo、partme-docs
+
+## 占位符
+
+- `{Name}`：产品或项目英文名/品牌名（如 `OctoPanel`、`OctoClaw-4j`），用于文件名前缀。
+- `{V}`：版本目录名（如 `V1`、`V2`、`V1.5`），用于版本级文件名后缀。
+
+生成实际文件时：将 `{Name}`、`{V}` 替换为真实值；**根目录与「详细功能清单」允许两个文件同用序号 `6、`**（与现网约定一致）。
+
+## 一、项目根目录：11 份标准文档
+
+路径：`{项目根}/`
+
+| 序号 | 文件名 |
+|------|--------|
+| 1 | `1、{Name}-命名与品牌说明.md` |
+| 2 | `2、{Name}-术语表与词汇表.md` |
+| 3 | `3、{Name}-市场与商业分析.md` |
+| 4 | `4、{Name}-技术与可行性分析.md` |
+| 5 | `5、{Name}-技术方案与路线.md` |
+| 6 | `6、{Name}-产品与版本规划.md` |
+| 6 | `6、{Name}-详细功能清单.md` |
+| 7 | `7、{Name}-领域模型设计.md` |
+| 8 | `8、{Name}-系统架构设计.md` |
+| 9 | `9、{Name}-视觉与交互DNA规范.md` |
+| 10 | `10、{Name}-功能菜单与版本规划.md` |
+
+**骨架模板目录**: [`templates/root/`](templates/root/)（每个文件对应上表一项，正文内含 `{Name}` 占位）。
+
+## 二、版本目录：7 份标准文档
+
+路径：`{项目根}/{V}/`（如 `V1/`、`V2/`）
+
+| 序号 | 文件名 |
+|------|--------|
+| 1 | `1、{Name}-需求调研文档-{V}.md` |
+| 2 | `2、{Name}-需求分析文档-{V}.md` |
+| 3 | `3、{Name}-系统架构设计-{V}.md` |
+| 4 | `4、{Name}-功能与界面规划-{V}.md` |
+| 5 | `5、{Name}-PRD文档-{V}.md` |
+| 6 | `6、{Name}-功能菜单与版本规划-{V}.md` |
+| 7 | `7、{Name}-UI设计说明-{V}.md` |
+
+**骨架模板目录**: [`templates/version/`](templates/version/)
+
+**注意**: 版本目录内若还有对象字典、错误码、研发拆解等非标准文档，**不得占用** 1–7 序号与上述文件名语义；应使用 `8、` 及以后序号，或放入 `其他/`。
+
+## 三、功能模块：每个模块 3 份文档（可选）
+
+路径示例：`{项目根}/{V}/{序号}、{模块中文名}/`
+
+每个功能点模块建议具备：
+
+- `{Name}-{模块简称}-PRD-{V}.md`
+- `{Name}-{模块简称}-Stitch设计提示词.md`（或无 `-{V}`，按项目约定）
+- `{Name}-{模块简称}-UI设计说明-{V}.md`
+
+**示例**（OctoPanel V1 用户登录）：
+
+- `OctoPanel-登录页-PRD-V1.md`
+- `OctoPanel-登录页-Stitch设计提示词.md`
+- `OctoPanel-登录页-UI设计说明-V1.md`
+
+**骨架模板**: [`templates/module/`](templates/module/) 下三个文件；复制后按模块改名。
+
+## 四、技术调研目录
+
+路径：`{项目根}/技术调研/`
+
+凡技术选型、方案对比、协议与第三方集成调研等 **非版本定稿叙述**，放此目录（可再分子目录）。
+
+## 五、其他目录
+
+路径：`{项目根}/其他/`
+
+凡 **非版本特定**、**非技术调研**、且 **不属于** 根 11 份 / 版本 7 份 / 模块 3 份 的文档（任务单、门禁清单、对标报告、临时索引等），统一放 `其他/`。
+
+**技术细分模板**（接口/库表级细节）：[`templates/delivery/1、技术细分模板.md`](templates/delivery/1、技术细分模板.md)；落地时建议放入项目 `其他/` 或研发仓库。
+
+## 五之一、交付阶段模板（可选）
+
+不占用根目录标准序号时，可使用 [`templates/delivery/`](templates/delivery/)：`1、技术细分`，以及 `2～5`（功能提测、测试结果、上线通知、项目运维）。
+
+## 六、特殊目录（保持不动）
+
+已按约定组织的目录 **不要强行迁入标准序号**，例如：`demo/`、`assets/`、`article/`、`article-cn/`、`archive/`、`.stitch/`、`stitch_*`、`实施指南/` 等——除非用户明确要求重构。
+
+## 七、与旧版「14 模板」的关系
+
+原 **14 阶段模板** 已 **合并进** [`templates/`](templates/) 下 `root/`、`version/`、`module/`、`delivery/`，与 OctoPanel 实例正文同一套目录即可扩写；**独立 `templates/legacy-lifecycle/` 与 `templates/project-standard/` 目录已移除**，避免重复维护。
+
+## 八、相关技能
+
+- `documentation-builder`：通用文档编写与格式（[`../dev-utils-skills/documentation-builder`](../dev-utils-skills/documentation-builder)）
+- `api-doc-generator`：OpenAPI 等 API 文档（同组 `document-skills`）
+
+## 九、校验清单（Agent 自检）
+
+1. 项目根是否存在 11 份标准文件（含两个 `6、`）与 `10、` 功能菜单。
+2. 每个活跃版本目录是否存在 7 份标准文件，且 UI 为 `7、`、功能菜单为 `6、`。
+3. 技术调研与其它目录是否未混放根级标准文档。
+4. 模块目录是否具备 PRD / Stitch / UI 三件套（若该项目约定模块级文档）。

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

@@ -0,0 +1,20 @@
+# full-stack-doc 模板目录
+
+与 `SKILL.md` 中 **根目录 11 份 + 版本目录 7 份 + 模块 3 份** 对齐；正文已合并原全生命周期 14 阶段模板与 **OctoPanel**（`partme-docs/1、OctoPanel/`）实例结构。
+
+本目录 **直接** 包含四类子目录（复制到产品仓库时按子目录拷贝即可）：
+
+| 子目录 | 说明 |
+| :--- | :--- |
+| [`root/`](root/) | 产品根目录 11 个 Markdown（含两个 `6、`） |
+| [`version/`](version/) | 每个版本目录 7 个 Markdown（占位 `{Name}`、`{V}`） |
+| [`module/`](module/) | 单功能模块 PRD / Stitch / UI 三件套 |
+| [`delivery/`](delivery/) | 技术细分（原 10）+ 提测 / 测试 / 上线 / 运维（原 11–14；本仓库内文件名为 `1～5`） |
+
+原 `templates/project-standard/` 与 `templates/legacy-lifecycle/` 已废弃：内容已迁入上述四类目录，**不再**嵌套一层 `project-standard`。
+
+## 使用步骤（摘要）
+
+1. 将 `{Name}` 替换为实际产品名；`version/` 下的 `{V}` 同步进文件名（如 `V1`）。
+2. 根目录标准文件由 `root/` 中文件重命名为 `1、{Name}-命名与品牌说明.md` 等形式后放到项目根。
+3. 版本标准文件放入 `{项目根}/{V}/`；模块三件套放入 `{项目根}/{V}/{序号}、{模块名}/`。

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,118 @@
+> **标准说明**：OctoPanel `10、…` 实例 + legacy PRD 产品范围问卷体。
+
+---
+
+# {Name} 功能菜单
+
+> 本文档用于冻结 `{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 文档。
+
+
+---
+
+## 附录：PRD 模板节选（产品范围 legacy 5）
+
+### 2.3 产品范围
+> 明确本次迭代包含和不包含的功能范围
+
+**本次迭代包含**：
+- {例如：工单模块（订单列表、订单详情、订单操作）}
+- {例如：我的模块（门店信息、数据统计、待办事项）}
+- {例如：首页模块（搜索、Banner）}
+
+**本次迭代不包含**（后续迭代）：
+- {例如：数据报表详细分析}
+- {例如：客户管理模块}
+- {例如：商品管理模块}
+

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

@@ -0,0 +1,63 @@
+> **标准说明**：以下为 OctoPanel 实例全文（`partme-docs/1、OctoPanel/1、…`），`{Name}` 为占位符。
+
+---
+
+# {Name} 命名与品牌说明
+
+> 文件名保留历史名，仅用于兼容旧引用。正文中的正式产品名统一为 **{Name}**。
+
+## 1. 品牌迁移结论
+
+- **正式产品名**：`{Name}`
+- **产品定位**：`多引擎智能体控制平面`
+- **一句话定义**：`面向 OpenClaw / ZeroClaw / OctoClaw 的安装、纳管、配置、运维、扩展与审计平台`
+- `{Name}` 退为历史名、早期代号、旧文档兼容说明
+
+## 2. 为什么从 {Name} 迁移到 {Name}
+
+`{Name}` 更像早期辅助工具名，而 `{Name}` 更适合作为：
+
+- 多引擎统一控制平面品牌
+- Web 主导的控制台品牌
+- 后续承载实例、节点、任务、扩展、审计等平台能力的母品牌
+
+## 3. 产品与引擎边界
+
+### 3.1 平台
+
+`{Name}` 是平台，不是引擎。
+
+负责：
+
+- 安装与预检
+- 纳管与配置
+- 运维与任务
+- 扩展与审计
+
+### 3.2 被管理引擎
+
+| 类型 | 名称 | 角色 |
+|------|------|------|
+| 引擎 | `OpenClaw` | 被 {Name} 安装、纳管与运维 |
+| 引擎 | `ZeroClaw` | 被 {Name} 安装、纳管与运维 |
+| 引擎 | `OctoClaw` | 被 {Name} 安装、纳管与运维 |
+
+## 4. 交付形态命名
+
+| 形态 | 标准名 | 定位 |
+|------|--------|------|
+| Web 控制台 | `{Name} Web` | 团队控制平面，更像 1Panel 的企业形态 |
+| 桌面控制壳 | `{Name} Desktop` | 本地桌面壳，管理本机和远程实例 |
+| 同机执行进程 | `{Name} Node` | Node.js 独立进程，负责安装、预检、配置生成、服务管理、日志采集、健康检查 |
+
+## 5. 对外表达规范
+
+- 首次出现：`{Name}（多引擎智能体控制平面）`
+- 历史兼容说明：`{Name}（原 {Name}）`
+- 不再使用 `{Name}` 作为当前主产品名
+
+## 6. 品牌关系说明
+
+- `1Panel`：借鉴信息架构与控制台范式
+- `clawpanel`：借鉴安装 / 诊断 / 修复主链、三形态与多实例代理思路
+- `{Name}`：在两者启发上形成自己的平台品牌与产品边界

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

@@ -0,0 +1,296 @@
+> **标准说明**：OctoPanel 实例全文。
+
+---
+
+# {Name} 术语表与词汇表 术语表与词汇表
+
+> **文档说明**：总纲 + 全量术语。正文正式产品名统一为 **{Name}**，`{Name}` 仅在历史术语或旧文件名兼容说明中保留。§2 为主线术语，§3 起为跨版本术语表。
+
+---
+
+## 1. 文档信息 (Document Info)
+
+### 1.1 版本记录
+| 版本号 | 修改日期 | 修改人 | 修改内容 | 备注 |
+| :--- | :--- | :--- | :--- | :--- |
+| V1.0.0 | 2026-02-25 | PartMe | 初始版本 | 建立跨版本统一术语表 |
+
+### 1.2 文档责任人
+| 角色 | 职责 |
+| :--- | :--- |
+| 产品经理 | 术语定义、英文对照、版本演进 |
+| 技术负责人 | 技术术语校准、API 契约对齐 |
+| UI/UX | 产品词映射、用户体验术语 |
+
+---
+
+## 2. 总纲术语（按层次）
+
+以下术语为 {Name} 总纲与系统架构的核心词汇，每条含**中英文**、**定义**与**所属范围**。详见 [{Name} 系统架构设计](8、{Name}-系统架构设计.md)、[{Name} 领域模型设计](7、{Name}-领域模型设计.md)。
+
+### 2.1 平台层
+
+| 术语（中文） | 英文 | 定义 | 范围 |
+|--------------|------|------|------|
+| {Name} | {Name} | 多引擎智能体控制平面，负责 OpenClaw / ZeroClaw / OctoClaw 的安装、纳管、配置、运维、扩展与审计；正式产品名。 | 产品/品牌 |
+| {Name} Web | {Name} Web | 团队控制平面，支持远程访问、多实例纳管、任务中心与平台治理。 | 产品形态 |
+| {Name} Core | {Name} Core | 控制面核心服务，负责 API、任务编排、状态机、审计、权限、节点 / 实例注册与批量任务。 | 产品形态 |
+| {Name} Node Agent | {Name} Node Agent | 同机执行进程，负责预检、安装、配置生成、服务管理、日志采集、健康检查与回滚。 | 产品形态 |
+| 引擎适配层 | Engine Adapter | 对 OpenClaw/ZeroClaw/OctoClaw 🐙 等引擎的抽象接口层，统一 detect/install/create/start/stop/status/logs 等操作。 | 架构 |
+| 实例 | Instance | 由 {Name} 管理的一个引擎运行实例，含唯一 ID、引擎类型、配置、进程、状态。 | 领域 |
+
+### 2.1.1 形态命名冻结
+
+以下旧称统一废弃，不再作为主线文档正式术语：
+
+- `Claw Web`、`Server 版`、`服务版` -> `{Name} Web`
+- `Claw Desktop`、`Desktop 版`、`桌面版` -> `历史归档术语，不再进入当前主线`
+- `Node sidecar`、`Node 同机执行层` -> `{Name} Node Agent`
+- `双形态`、`三形态` -> `{Name} Web + Core + Node Agent`
+
+> 说明：§3 起保留大量 V1/V2/V3 历史术语，仅用于追溯旧方案，不代表当前研发主线。
+
+### 2.2 引擎层
+
+| 术语（中文） | 英文 | 定义 | 范围 |
+|--------------|------|------|------|
+| OpenClaw | OpenClaw | Node.js 实现的 AI Agent 引擎，生态丰富、免费，可被 {Name} 管理。 | 引擎 |
+| ZeroClaw | ZeroClaw | Rust 实现的轻量高性能 Agent 引擎，低内存、高并发，可被 {Name} 管理。 | 引擎 |
+| OctoClaw 🐙 | OctoClaw 🐙 | PartMe 自研 Rust 引擎（基于 ZeroClaw 演进），混合记忆、企业特性，可被 {Name} 管理。 | 引擎 |
+| OctoClaw 🐙-Pi | OctoClaw 🐙-Pi | OctoClaw 🐙 的 Python 实现，面向树莓派等边缘设备。 | 引擎 |
+| OctoClaw 🐙-ESP32 | OctoClaw 🐙-ESP32 | 面向 ESP32 等嵌入式板的 C 实现（可选纳入生态）。 | 引擎 |
+| 引擎类型 | EngineType | 枚举：openclaw / zeroclaw / octoclaw，用于适配层与配置。 | 技术 |
+| OctoClaw 🐙-4j | OctoClaw 🐙-4j | OctoClaw 🐙 的 Java 实现，面向企业级 Java 生态，集成 LangChain4j 和 Spring Boot。 | 引擎 |
+| OctoClaw 🐙-Zig | OctoClaw 🐙-Zig | OctoClaw 🐙 的 Zig 极简实现，<1MB 体积，探索性项目。 | 引擎 |
+| OctoClaw 🐙-Nats | OctoClaw 🐙-Nats | OctoClaw 🐙 生态集群通信中枢，基于 NATS 封装，提供服务注册发现、任务分发、状态同步。 | 基础设施 |
+| OctoClaw 🐙-Memory | OctoClaw 🐙-Memory | 独立记忆服务，多实例共享记忆池，支持多级存储（本地+远程）。 | 基础设施 |
+
+### 2.3 运行时层
+
+| 术语（中文） | 英文 | 定义 | 范围 |
+|--------------|------|------|------|
+| Agent | Agent | 智能体，具备人设、技能、记忆的对话角色，运行在引擎内。 | 引擎运行时 |
+| Channel | Channel | 渠道，如企业微信、WebSocket，负责消息接入与下发。 | 引擎运行时 |
+| Provider | Provider | 模型提供商，如 OpenAI、Ollama，提供 LLM 能力。 | 引擎运行时 |
+| Tool | Tool | 工具，Agent 可调用的函数或 MCP 等能力。 | 引擎运行时 |
+| Memory | Memory | 记忆，引擎内对话/知识存储与检索抽象。 | 引擎运行时 |
+| Gateway | Gateway | 网关，OpenClaw 等引擎对外暴露的 WebSocket/HTTP 管理接口。 | 引擎运行时 |
+| Session | Session | 会话，一次用户与 Agent 的多轮对话上下文。 | 引擎运行时 |
+| Commander | Commander | OctoClaw 🐙 指挥官模块，负责意图拆解、任务编排、反思审计、主动聊天，实现 3 秒内快速响应。 | OctoClaw 🐙 架构 |
+| 专家层 | Expert Layer | OctoClaw 🐙 第 2 层，可插拔技能市场（Skills），Agent 执行具体任务的模块。 | OctoClaw 🐙 架构 |
+| 管理平面 | Management Plane | OctoClaw 🐙 第 4 层，由 {Name} 接管，负责引擎实例的生命周期管理。 | OctoClaw 🐙 架构 |
+
+### 2.4 架构层
+
+| 术语（中文） | 英文 | 定义 | 范围 |
+|--------------|------|------|------|
+| 混合记忆 | Hybrid Memory | OctoClaw 🐙 的记忆方案：Markdown 为真相源 + Tantivy BM25 + SQLite 向量索引，支持全文与语义检索。 | OctoClaw 🐙 架构 |
+| Markdown 真相源 | Markdown as Source of Truth | 记忆内容以 Markdown 文件持久化，可版本管理、可读，索引异步更新。 | OctoClaw 🐙 架构 |
+| SQLite 索引 | SQLite Index | 向量与元数据索引存于 SQLite，用于语义检索与快速查询。 | OctoClaw 🐙 架构 |
+| Tantivy/BM25 | Tantivy / BM25 | 全文检索引擎与算法，用于关键词检索，与向量搜索混合。 | OctoClaw 🐙 架构 |
+| 向量搜索 | Vector Search | 基于 Embedding 的相似度检索，用于语义召回。 | 通用 |
+| FSWatcher | File System Watcher | 文件系统监控器（`notify` crate），监听 Markdown 文件变化并触发异步索引更新。 | OctoClaw 🐙 架构 |
+| OctoSwarm | OctoSwarm | OctoClaw 🐙 多实例/多设备协同的群体智能形态，与 ClawSwarm（管理平台集群）区分。 | OctoClaw 🐙 生态 |
+
+### 2.5 集群层
+
+| 术语（中文） | 英文 | 定义 | 范围 |
+|--------------|------|------|------|
+| ClawSwarm | ClawSwarm | {Name} 分布式/多节点形态的统称（与 OctoClaw 🐙 的 OctoSwarm 区分：前者为管理平台集群）。 | 平台 V4 |
+| NATS | NATS | 轻量消息系统，用于控制面信令、心跳、配置下发。 | 基础设施 |
+| Etcd | Etcd | 分布式键值存储，用于服务注册与发现。 | 基础设施 |
+| mDNS | mDNS | 局域网服务发现，适用于边缘/树莓派等场景。 | 基础设施 |
+| P2P 节点 | P2P Node | 去中心化组网下的对等节点，用户自建 {Name} 可与其他节点组网。 | 平台 V4 |
+| Libp2p | Libp2p | P2P 网络库，用于身份、发现、NAT 穿透，可选承载 NATS 隧道。 | 基础设施 |
+| gRPC | gRPC | 高性能 RPC 框架，用于数据面服务调用、流式数据传输。 | 基础设施 |
+| NATS Leaf Node | NATS Leaf Node | NATS 叶节点模式，用于将用户私有集群接入全球 OctoClaw 🐙 World 网络。 | 基础设施 |
+| OctoClaw 🐙 World | OctoClaw 🐙 World | 全球 NATS 超级集群网络，各用户节点通过 Leaf Node 加入。 | OctoClaw 🐙 生态 |
+
+### 2.6 企业层
+
+| 术语（中文） | 英文 | 定义 | 范围 |
+|--------------|------|------|------|
+| 多租户 | Multi-tenant | 多租户隔离，租户间数据与配置完全隔离，按租户计费与配额。 | 企业版 |
+| RBAC | Role-Based Access Control | 基于角色的访问控制，如 Admin/Manager/Operator/Viewer。 | 企业版 |
+| 审计日志 | Audit Log | 记录操作人、时间、操作对象与结果的日志，支持导出与合规。 | 企业版 |
+| 许可证 | License | 企业版功能授权，通过 License 文件或订阅控制多租户/审计/SSO 等能力。 | 商业 |
+| SSO | Single Sign-On | 单点登录，支持 LDAP / OAuth2 / SAML 集成。 | 企业版 |
+| 条件编译 | Conditional Compilation | Rust `#[cfg(feature = "enterprise")]`，企业版功能通过编译条件控制。 | 技术 |
+| 资源配额 | Resource Quota | 租户可使用的资源上限，如实例数、会话数、Token 用量。 | 企业版 |
+
+---
+
+## 3. 产品核心术语（产品词 → 技术语）
+
+| 产品词（对外展示） | 英文术语（内部/代码） | 技术语（底层实现） | 定义 | 版本 |
+| :--- | :--- | :--- | :--- | :--- |
+| **助理** | Assistant | Agent | 用户对话的角色，代表一个 AI 智能体。包含人设（SOUL/IDENTITY/USER.md）、技能、知识库等。 | V1 |
+| **任务卡片** | Task Card | Workflow / Skill | 一个具体要完成的工作入口，绑定工作流与输入 Schema。用户填写表单后执行，得到可下载的交付物。 | V1 |
+| **知识库** | Knowledge Base | RAG / Embedding Index | 助理"知道"的文件与数据。支持本地文件夹/URL 导入，后台自动分块与向量化，对话中可引用并展示来源。 | V1 |
+| **工具连接** | Tool Connection | Tools / MCP | 助理具备的能力。内置工具（网页检索/文件读写）与 MCP（Model Context Protocol）连接器。 | V1 |
+| **浏览器已登录态访问** | Browser Logged-in Access | 借用用户已登录的浏览器状态（Cookie / Session / 已打开站点）访问网页或执行轻量操作的能力。适合热榜读取、站内搜索、趋势研究，不等于稳定 API。 | V2 增强 |
+| **Browser-native Skill** | Browser-native Skill | 基于浏览器环境封装的 Skill，常见形式为 CLI Bridge 或 Chrome 扩展桥接。适合研究型网页访问与轻量操作。 | V2 增强 |
+| **技能** | Skill | Skill | 可复用的 SOP 或能力包。安装后成为助理的一部分，可对话触发或作为任务卡片的基础。 | V1 |
+| **岗位包** | Job Bundle | Spec / Skill Collection | 为某个岗位一键配置的助理 + 任务卡片 + 技能集合。用户选择岗位包后立即可用，无需手动配置。 | V1 |
+| **配置包** | Config Package / Spec | Spec | 可导出/导入/分享的工作环境包。包含助理、知识库、工具连接、任务卡片等配置，但不包含明文 API Key。 | V1 |
+| **工作模式** | Work Mode | — | {Name} Desktop 的日用工作台模式，以任务卡片和助理为核心，与管理模式共享知识库、技能、模型、MCP。 | V1 |
+| **管理模式** | Admin Mode | — | {Name} Desktop / {Name} Web 的管理后台模式，负责引擎实例的安装、配置、启停与多 profile 管理。 | V1 |
+| **基线** | Baseline | Baseline Config | 全局期望配置，所有实例应遵循的标准配置。可编辑、版本管理、导出 JSON、从模板应用。 | V1 |
+| **配置模板** | Config Template | Config Template | 可复用的配置片段（Agent/渠道/插件/自定义），分类与版本管理。 | V1 |
+| **一致性总览** | Consistency Overview | Diff View | 表格/矩阵展示「实例 × 一致性状态」及差异项数。 | V1 |
+| **下发任务** | Deployment Task | Config Deployment | 将基线或模板推送到选定实例的操作流程。含选择来源、选择目标、预览 diff、确认下发与结果记录。 | V1 |
+| **下发记录** | Deployment Record | Deployment History | 历史下发任务列表（操作人、时间、目标、变更摘要、结果、可回滚若支持）。 | V1 |
+| **实例** | Instance | OpenClaw Instance | 已注册的 OpenClaw 部署实例。每个实例有唯一 ID、地址、状态、版本、标签、分组。 | V1 |
+| **实例分组** | Instance Group | Group | 按业务线/地域/环境等维度给实例分组、打标签。支持按分组批量操作。 | V1 |
+| **集群概览** | Cluster Overview | Cluster Metrics | 多实例聚合指标：健康状态、会话量、用量、渠道状态。 | V1 |
+| **工作搭子** | WorkMate | — | PartMe Desktop 对外产品名，英文 WorkMate；白领每日打开的 AI 工作台。 | V1 |
+| **资源中心** | Resource Center | — | 统一管理知识库、话术库、素材库并批量下发到实例。 | V2 |
+| **话术库** | Script Library | Prompt Library | 预置的回复模板，支持分类管理、版本控制、按渠道或账号差异化配置。 | V2 |
+| **素材库** | Asset Library | Asset Library | 图片/视频/文档等营销素材，支持分类管理、引用统计、批量下发。 | V2 |
+| **角色** | Role | Role | RBAC 中的权限集合，如超级管理员、运维、只读、审批人等。 | V2 |
+| **成员** | Member | User | 系统中的用户，包含账号、密码、角色、所属租户等。 | V2 |
+| **菜单权限** | Menu Permission | Route Guard | 控制用户可访问的一级/二级菜单，如工作台、设备中心、设置等。 | V2 |
+| **审批流程** | Approval Workflow | Approval Flow | 配置变更需经过审批流程才能生效。支持单人/多人审批、超时自动通过/拒绝。 | V2 |
+| **灰度策略** | Canary Strategy | Gradual Rollout | 配置变更先小范围试运行（如 5% 实例），验证通过后再逐步推广到全部实例。 | V2 |
+| **模型池** | Model Pool | Key Pool | 按提供商或全局展示 API Key（掩码）；添加 Key、健康检查、失效告警。 | V2 |
+| **扩展市场** | Extension Marketplace | Skill/MCP Marketplace | 技能商店、MCP 商店的统称。用户可浏览、安装、配置、更新技能或 MCP 服务器。 | V3 |
+| **技能商店** | Skill Store | Skill Store | 发现、安装、更新技能的在线市场。支持搜索、分类、评分、一键部署到实例。 | V3 |
+| **MCP 商店** | MCP Store | MCP Store | 发现、安装、配置 MCP 服务器的在线市场。 | V3 |
+| **多租户** | Multi-tenant | Tenant | 企业版功能，支持多个租户共享同一平台但数据与配置完全隔离。 | V3 |
+| **租户** | Tenant | Tenant | 多租户中的独立组织，有独立的配额、用量账单、RBAC 配置。 | V3 |
+| **配额** | Quota | Quota | 租户或用户可使用的资源上限，如实例数、会话数、Token 数。 | V3 |
+| **用量账单** | Usage Billing | Usage Invoice | 按月生成的用量账单，包含实例数、会话数、Token 数、费用明细。 | V3 |
+| **通信终端** | Communication Terminal | PartMe Chat | PartMe 的统一对话入口，支持 Web/Mobile/Desktop 三端。用户可与 OpenClaw 世界对话。 | V3 |
+| **消息网络** | Message Network | NATS / Connector | 基于 NATS 的消息路由系统，支持 Human↔Agent↔Agent 三种消息流。 | V3 |
+| **connector** | openclaw-connector | Connector | OpenClaw 实例与消息网络的连接器，负责消息转发、认证、QoS。 | V3 |
+| **编程 Agent 指挥中心** | Coding Agent Orchestration Center | — | 40+ 编程 Agent 的通信与编排中心。OpenClaw 作为指挥大脑，按任务拆分调度多 Agent。 | V3 |
+| **记忆平台** | Memory Platform | Memory Service | 记忆策略与平台选型（MEMORY.md/向量库/外部服务），数据永不丢失。 | V3 |
+| **Agent 角色市场** | Agent Role Market | Agent Marketplace | 预制角色（System Prompt + Skills 组合），一键部署到实例，社区角色分享。 | V3 |
+| **Agent 审计时间线** | Agent Audit Timeline | Audit Log | Agent 操作记录、时间线可视化、搜索筛选导出、效能统计。 | V3 |
+| **助理工坊** | Agent Studio | Workflow Editor | 高级用户/管理员的工作流可视化编排器，支持拖拽式编辑、调试、发布。 | V3 |
+| **Skill 双态** | Skill Dual Mode | Skill Dual Mode | 同一 Skill 支持对话触发 + 独立 Web GUI 运行，共享数据目录、单实例锁。 | V2 |
+| **凭证中心** | Credential Center | Vault | 用户级/实例级凭证、加密存储、Skill 声明式绑定、跨实例自动注入。 | V2 |
+| **一键部署** | One-Click Deploy | Deployment Wizard | 本地 Docker / 阿里云 ECS / 腾讯云 / SSH 一键部署 OpenClaw 实例，选角色+注入凭证+选渠道。 | V2 |
+| **Generative UI** | Generative UI | AG-UI Protocol | 工具调用驱动的动态 UI 组件生成。Agent 返回工具调用事件，前端渲染对应组件。 | V3 |
+| **Shared State** | Shared State | State Sync | Agent 与 UI 状态实时同步机制。 | V3 |
+| **环境检查** | Environment Check | env_checker | Desktop 专属：检测 OpenClaw/Claude Code/Gemini CLI/Codex 等编程 Agent 的安装与版本。 | V2 |
+| **CLI 管理** | CLI Management | env_manager | Desktop 专属：环境变量冲突检测与安全删除/恢复、Skills SSOT 管理（同步多 CLI skills 目录）。 | V2 |
+| **Skills SSOT** | Skills SSOT | — | 单一事实来源（Single Source of Truth）。所有编程 Agent 的 skills 目录统一由 {Name} 管理。 | V2 |
+
+---
+
+## 4. 技术术语（技术词）
+
+| 英文术语 | 中文术语 | 定义 | 版本 |
+| :--- | :--- | :--- | :--- |
+| **OpenClaw** | OpenClaw | 底层对话引擎与渠道实现平台。提供会话管理、Agent、技能、知识库、多轮对话、工具调用等能力。 | V1 |
+| **Gateway** | 网关 | OpenClaw 的 WebSocket 网关服务，对外暴露配置与会话等能力。{Name} 通过 Gateway 协议纳管多实例。 | V1 |
+| **Gateway Protocol** | 网关协议 | {Name} 与 OpenClaw 实例之间的通信协议，基于 WebSocket，支持 config.get/config.set/sessions.list/health 等 RPC。 | V1 |
+| **RAG** | 检索增强生成 | Retrieval-Augmented Generation。结合向量检索与大模型生成，使助理能够基于知识库回答问题。 | V1 |
+| **Embedding** | 向量化 | 将文本转换为向量表示，用于语义检索。 | V1 |
+| **MCP** | Model Context Protocol | 模型上下文协议。一种标准化的工具调用协议，允许 LLM 调用外部服务。 | V1 |
+| **MCP Server** | MCP 服务器 | 提供 MCP 协议接口的服务，可以是本地进程或远程 HTTP 服务。 | V2 |
+| **MCP Client** | MCP 客户端 | 连接到 MCP 服务器的客户端，通常集成在 OpenClaw 或 {Name} 中。 | V2 |
+| **CLI Bridge** | CLI Bridge | 通过命令行工具封装浏览器或站点操作能力，并向 Agent / Skill 暴露统一接口的桥接方式。`opencli-skill` 属于此类。 | V2 增强 |
+| **AI-friendly Markdown 输出** | AI-friendly Markdown Output | 面向 AI 读取而优化的 Markdown 页面输出形态，用于降低 token 成本、提高 AI 阅读稳定性。 | V2 增强 |
+| **WebMCP** | WebMCP | 面向浏览器内 Agent 的前端工具暴露协议，使网页可注册并暴露可调用能力。当前在 PartMe 中只作为未来预研方向。 | V3 预研 |
+| **Skill** | 技能 | 可复用的代码/配置包，扩展 OpenClaw 的能力。每个技能有 SKILL.md 和可选的 skill.toml。 | V1 |
+| **Spec** | 配置规范 | Specification 的缩写。定义工作环境的标准格式，用于导入/导出配置包。 | V1 |
+| **Agent** | 智能体 | AI 代理，代表一个具有人设、技能、知识库的对话角色。 | V1 |
+| **Skill.toml** | 技能配置文件 | Skill 的元数据配置文件，包含名称、版本、作者、依赖、参数等。 | V1 |
+| **SKILL.md** | 技能说明文件 | Skill 的文档文件，包含功能描述、使用方法、参数说明等。 | V1 |
+| **Session** | 会话 | 一次完整的对话过程，包含多条消息和上下文。 | V1 |
+| **Turn** | 轮次 | 对话中的一个回合，包含用户消息和 AI 回复。 | V1 |
+| **Context** | 上下文 | 会话的历史消息、知识库引用、变量等状态信息。 | V1 |
+| **Tool Call** | 工具调用 | Agent 调用外部工具（如网页检索、文件读写、MCP）的操作。 | V1 |
+| **Command Queue** | 命令队列 | OpenClaw 的消息队列，可合并短时间内的多条消息为一个 Agent turn。 | V1 |
+| **RBAC** | 基于角色的访问控制 | Role-Based Access Control。通过角色控制用户权限。 | V2 |
+| **JWT** | JSON Web Token | JSON Web Token。用于身份认证的令牌。 | V1 |
+| **AES-256-GCM** | AES-256-GCM 加密 | 高级加密标准 256 位 GCM 模式。用于敏感数据加密存储。 | V1 |
+| **Tauri** | Tauri | 跨平台桌面应用框架，使用 Rust 后端和 Web 前端。 | V1 |
+| **Vue 3** | Vue 3 | 渐进式 JavaScript 框架，用于构建用户界面。 | V1 |
+| **NestJS** | NestJS | Node.js 企业级后端框架，基于 TypeScript。 | V1 |
+| **Prisma** | Prisma | 数据库 ORM 工具，支持 TypeScript。 | V1 |
+| **Drizzle ORM** | Drizzle ORM | 类型安全的 SQL 工具包，轻量级替代 Prisma。 | V2 |
+| **better-sqlite3** | better-sqlite3 | SQLite 的同步 Node.js 绑定，性能优异。 | V2 |
+| **SQLite** | SQLite | 轻量级嵌入式数据库。 | V2 |
+| **MongoDB** | MongoDB | 文档型 NoSQL 数据库。 | V2 |
+| **NATS** | NATS | 高性能消息系统，用于 {Name} 的消息网络。 | V3 |
+| **OpenTelemetry** | OpenTelemetry | 可观测性框架，用于链路追踪。 | V3 |
+| **Prometheus** | Prometheus | 时序数据库和监控系统。 | V3 |
+| **ELK** | ELK | Elasticsearch + Logstash + Kibana，日志聚合解决方案。 | V3 |
+| **SOC2** | SOC 2 | 服务组织控制报告，信息安全合规认证。 | V3 |
+| **ISO 27001** | ISO 27001 | 信息安全管理体系国际标准。 | V3 |
+
+---
+
+## 5. 一致性状态术语
+
+| 状态 | 中文 | 英文 | 颜色 | 说明 |
+| :--- | :--- | :--- | :--- | :--- |
+| ● 已同步 | Synced | Synced | 绿色 | 实例配置与基线完全一致 |
+| ● 已修改 | Modified | Modified | 黄色 | 实例配置已被修改，与基线有差异 |
+| ● 待下发 | Pending | Pending | 蓝色 | 下发任务已创建但未执行 |
+| ● 下发失败 | Failed | Failed | 红色 | 下发任务执行失败 |
+| ● 未纳管 | Unmanaged | Unmanaged | 灰色 | 实例未关联基线 |
+
+---
+
+## 6. 版本演进术语
+
+| 版本 | 定位 | 关键能力 | 主要产品词 |
+| :--- | :--- | :--- | :--- |
+| **V1** | 易用 | 多实例管理、配置基线/模板/下发、渠道与模型、工作台；工作模式（任务卡片基础、我的助理、助理库、岗位包） | 基线、模板、实例分组、任务卡片、助理、岗位包、知识库 |
+| **V2** | 规模 | 资源中心、配置增强（审批/灰度/MCP）、RBAC、模型增强、接口扩展；工作模式（配置包 Spec、技能市场完整、Agent 对话界面交互、环境检查与 CLI 管理） | 资源中心、话术库、素材库、角色、审批流程、灰度策略、配置包、扩展市场 |
+| **V3** | 生态 | 数据分析、扩展市场（技能/MCP 商店）、多租户、接口扩展、通信终端、消息网络、Agent 角色市场、Agent 审计时间线；工作模式（回写飞书/钉钉、助理工坊、团队版、Generative UI） | 扩展市场、多租户、租户、配额、用量账单、通信终端、消息网络、助理工坊、Generative UI |
+
+---
+
+## 7. 首字母缩略词表
+
+| 缩略词 | 全称 | 中文 |
+| :--- | :--- | :--- |
+| **AG-UI** | Agent-Generated UI | Agent 生成的 UI |
+| **ADR** | Architecture Decision Record | 架构决策记录 |
+| **API** | Application Programming Interface | 应用程序接口 |
+| **CLI** | Command Line Interface | 命令行界面 |
+| **CRUD** | Create Read Update Delete | 增删改查 |
+| **DDL** | Data Definition Language | 数据定义语言 |
+| **E2E** | End-to-End | 端到端 |
+| **FRT** | First Response Time | 首次响应时间 |
+| **JSON** | JavaScript Object Notation | JavaScript 对象表示法 |
+| **MVP** | Minimum Viable Product | 最小可行产品 |
+| **OIDC** | OpenID Connect | 开放身份连接 |
+| **PTO** | Paid Time Off | 带薪休假 |
+| **QoS** | Quality of Service | 服务质量 |
+| **RBAC** | Role-Based Access Control | 基于角色的访问控制 |
+| **RPO** | Recovery Point Objective | 恢复点目标 |
+| **RTO** | Recovery Time Objective | 恢复时间目标 |
+| **SLA** | Service Level Agreement | 服务等级协议 |
+| **SOP** | Standard Operating Procedure | 标准操作流程 |
+| **SSO** | Single Sign-On | 单点登录 |
+| **SSOT** | Single Source of Truth | 单一事实来源 |
+| **TAM** | Total Addressable Market | 总可寻址市场 |
+| **TTL** | Time To Live | 存活时间 |
+| **UI** | User Interface | 用户界面 |
+| **UX** | User Experience | 用户体验 |
+| **V1/V2/V3** | Version 1/2/3 | 版本 1/2/3 |
+| **VM** | Virtual Machine | 虚拟机 |
+| **VPN** | Virtual Private Network | 虚拟专用网络 |
+
+---
+
+## 7. 参考文档
+
+- [{Name} 产品与版本规划](6、{Name}-产品与版本规划.md)
+- [{Name} 需求调研文档 V1](V1/1、{Name}-需求调研文档-V1.md)
+- [{Name} 需求分析文档 V1](V1/2、{Name}-需求分析文档-V1.md)
+- [{Name} PRD 文档 V1](V1/5、{Name}-PRD文档-V1.md)
+- [OpenClaw 文档](../../docs/)
+
+---
+
+**文档版本**：V1.0.0  
+**创建日期**：2026-02-25  
+**最后更新**：2026-02-25  
+**文档状态**：✅ 待评审

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

@@ -0,0 +1,620 @@
+# {Name} 市场与商业分析
+
+> **标准说明**：§1 起为 **OctoPanel 实例**（`partme-docs/1、OctoPanel/3、…`）结构提取，产品名已替换为 `{Name}`。下文 **附录 A** 为 原「产品调研」阶段模板全文 全文，便于问卷体扩写。
+
+---
+
+> **文档说明**（Octo 实例正文）：**{Name} 是 AI Agent 引擎统一管理平台（管理 OpenClaw / ZeroClaw / OctoClaw 🐙），同时作为 OpenClaw 生态连接器与 OctoClaw 🐙 企业版的商业化载体**，**主打卖点：简单好用**。面向最终业务的场景能力不在 {Name} 范围，本文档仅描述 {Name} 平台侧市场与商业。
+>
+> **版本**：V1.4.1  
+> **创建时间**：2026-02-21  
+> **最后更新**：2026-03-14  
+
+---
+
+## 1. 文档信息 (Document Info)
+
+### 1.1 版本记录
+| 版本号 | 修改日期 | 修改人 | 修改内容 | 备注 |
+| :--- | :--- | :--- | :--- | :--- |
+| V1.0.0 | 2026-02-21 | PartMe | 产品调研 + 市场分析 + 商业计划 合并为本文档 | 见 文档目录合并说明 |
+| V1.1.0 | 2026-02-24 | PartMe | 新增 §6.2.1 C 端定价分析与双轨定价模型、§6.2.2 企业买断方案分析 | {Name} 全景规划落地 |
+| V1.2.0 | 2026-02-24 | PartMe | 新增机会 4 通信即平台、§6.2.3 通信平台定价模型、竞品 Goodable、SWOT 通信网络效应与通信基础设施蓝海 | 通信基础设施 + Goodable 结论落地 |
+| V1.3.0 | 2026-03-09 | PartMe | 与 20/21/23 执行文档对齐，定价口径收敛为“正式价 + 实验价 + 企业报价” | 商业执行口径收口 |
+| V1.4.0 | 2026-03-14 | PartMe | 重写市场规模、目标客户、竞品与 SWOT，删除企微/SCRM 口径，改为围绕三引擎安装与运维控制平面的窄口径分析 | 与 6/20/24 文档边界重新对齐 |
+| V1.4.1 | 2026-03-14 | PartMe | 根据最新 ICP 澄清，收敛为面向无技术能力个人、小微企业与少量轻量企业客户，重写市场与客群口径 | 与最新用户定位对齐 |
+
+### 1.2 关联文档
+| 文档 | 说明 |
+| :--- | :--- |
+| [1、{Name}-产品与版本规划](6、{Name}-产品与版本规划.md) | 产品定位、边界、版本路线 |
+| [20、{Name}-商业化与套餐策略](其他/20、{Name}-商业化与套餐策略.md) | 套餐矩阵、定价口径、授权策略 |
+| [21、{Name}-增长与指标看板定义](其他/21、{Name}-增长与指标看板定义.md) | 漏斗、指标、看板与转化目标 |
+| [23、{Name}-研发与运维交付质量门槛](其他/23、{Name}-研发与运维交付质量门槛.md) | 付费放量前置健康度门槛 |
+| [4、{Name}-领域模型设计](7、{Name}-领域模型设计.md) | 限界上下文与协同关系 |
+| [6、{Name}-系统架构设计](8、{Name}-系统架构设计.md) | 技术架构 |
+| [7、{Name}-技术方案与路线](5、{Name}-技术方案与路线.md) | 技术可行性与路线 |
+
+### 1.3 总纲：多引擎策略与商业共识
+
+与 [{Name}-命名与品牌说明](1、{Name}-命名与品牌说明.md)、[{Name}-产品与版本规划](6、{Name}-产品与版本规划.md) 对齐。
+
+- **市场背景**：AI Agent 爆发，但部署与多实例管理门槛高；{Name} 统一管理 OpenClaw / ZeroClaw / OctoClaw 🐙，降低选型与运维成本。
+- **目标用户细分**：没有技术能力的个人用户、小微企业负责人、轻量团队运营者；他们想用 Claw 引擎，但缺少安装、部署和日常运维能力。
+- **竞品参考**：OpenClaw 原生工具、各类教程/脚本代装服务、宝塔/Coolify 等低门槛运维工具；{Name} 差异化在于把复杂安装与运维流程做成普通人也能使用的产品。
+- **商业模式**：以 {Name} Desktop / {Name} Web 的订阅制为主，先卖“能装上、能管住、少出错”的基础能力；在此基础上补充少量轻量企业客户的进阶付费。
+- **用户增长策略**：先用免费版和低价订阅吸引不会折腾技术的个人与小微企业，再通过易用性、稳定性和省时间形成付费转化；对有明确组织需求的客户提供轻量企业方案。
+
+---
+
+## 2. 市场调研与机会 (Market Research & Opportunities)
+
+### 2.1 当前市场判断
+
+- {Name} 所处的不是“企微客服”或 “SCRM” 市场，而是更窄的 **AI Agent / Claw 引擎安装、部署、纳管与运维控制平面**。
+- 当前最真实的需求不是“业务场景功能更多”，而是让 **没有技术能力的人也能把 OpenClaw / ZeroClaw / OctoClaw 真正装起来、管起来、回滚得了**。
+- 用户愿意付费的核心前提，是减少安装失败、看不懂配置、升级失控、排障困难，以及“找技术的人帮忙”带来的时间和金钱成本。
+- 因此，市场分析必须围绕 **控制平面、运维效率、治理能力、交付确定性** 展开，而不是把 {Name} 误写成客服、SCRM 或私域运营产品。
+
+### 2.2 三个成立的市场机会
+
+**机会 1：Claw 引擎从“会跑”到“可交付”之间存在明显断层**
+- OpenClaw / ZeroClaw / OctoClaw 的真实门槛不只在运行时，而在安装、环境检查、配置渲染、服务启动、健康检查、纳管与失败回滚。
+- 一旦用户从“想试试看”进入“我真的要把它跑起来帮我做事”，这个断层就会立刻暴露出来。
+- {Name} 的机会在于把零散脚本、命令行和人工排障，收敛成非技术用户也能理解和完成的标准化控制流程。
+
+**机会 2：小白用户与小微企业缺少“代替技术能力”的产品**
+- 教程、脚本和原生命令行默认要求用户具备环境、部署、日志和配置知识，这正是目标用户最缺的能力。
+- 通用运维工具虽然更图形化，但仍然要求用户理解服务器、容器、端口、反向代理等概念。
+- {Name} 的价值在于把技术复杂度封装起来，让用户更像在使用软件，而不是在做运维。
+
+**机会 3：小微企业愿意为“少折腾、快上线、有人兜底”付费**
+- 小微企业通常没有专职开发或运维，最怕的是装不上、配不对、出了问题没人救。
+- 这类用户不会先为复杂平台能力买单，而会先为“省时间、省外包费、降低试错成本”买单。
+- 这意味着 {Name} 的商业化起点应该是易上手、低门槛、可托底，而不是先讲大型平台化故事。
+
+## 3. 市场规模 (TAM / SAM / SOM)
+
+### 3.1 TAM（总潜在市场，窄口径）
+
+| 客群 | 核心购买原因 | 假设客户数 | 对应价格口径 | 年市场规模 |
+| :--- | :--- | :--- | :--- | :--- |
+| 个人版用户 | 想直接用上 AI Agent，不想研究环境与命令行 | 10 万 | 99 元/年 | 约 990 万/年 |
+| 专业版用户（进阶个人 / 小微团队） | 需要多实例、自动化和更高使用上限 | 3 万 | 199 元/年 | 约 597 万/年 |
+| 企业版用户（小微企业 / 轻量企业） | 需要多平台协作、支持服务与问题解答 | 1 万 | 599 元/年 | 约 599 万/年 |
+| **TAM 总计** | **以个人、小微企业和轻量企业客户为主的可寻址市场** | - | - | **约 2186 万元/年（可写作约 2200 万元/年）** |
+
+说明：这里的 TAM 是按当前三档年费模型反推的窄口径市场，不是整个 AI 应用、客服或 SCRM 大市场。价格更保守后，市场规模也会相应收缩，这反而更客观。
+
+### 3.2 SAM（可服务市场，未来 24 个月）
+
+- 过滤条件：
+  - 只计算没有技术能力、但确实有 AI Agent 使用意愿的个人、小微企业与轻量企业客户；
+  - 只计算可以通过产品自助上手、内容渠道触达、轻客服支撑完成转化的用户；
+  - 不把需要长周期重销售、重交付的大客户收入提前计入。
+- 估算口径：
+  - 个人版：2 万个可触达付费个人用户 × 99 元/年 = 约 198 万/年；
+  - 专业版：5000 个可触达进阶用户 / 小微团队 × 199 元/年 = 约 99.5 万/年；
+  - 企业版：2000 家可服务小微企业 / 轻量企业 × 599 元/年 = 约 119.8 万/年。
+- **SAM 总计：约 417.3 万元/年（可写作约 420 万元/年）。**
+
+### 3.3 SOM（可获取市场，3 年目标）
+
+| 年度 | 个人版 | 专业版 | 企业版 | 年收入估算 |
+| :--- | :--- | :--- | :--- | :--- |
+| 第 1 年 | 1000 | 200 | 50 | 约 17 万 |
+| 第 2 年 | 4000 | 800 | 200 | 约 68 万 |
+| 第 3 年 | 12000 | 2500 | 500 | 约 199 万 |
+
+- 以上 SOM 假设成立的前提，是产品先把“安装成功率、回滚成功率、纳管稳定性”做到可复制交付。
+- 在 `99 / 199 / 599` 的保守价格前提下，**第 3 年做到约 200 万级年收入** 会比夸大收入更客观，也更符合先验证产品与留存的阶段目标。
+
+### 3.4 市场增长趋势（对 {Name} 真正有意义的指标）
+
+| 维度 | 当前判断 | 对 {Name} 的影响 |
+| :--- | :--- | :--- |
+| Claw / Agent 引擎采用增加 | 上升 | 新装、迁移、升级、纳管需求随之增加 |
+| 从“看别人演示”走向“自己要用起来” | 上升 | 易安装、易维护的需求会持续增长 |
+| 小微企业对低代码/免代码工具的接受度 | 上升 | 有利于图形化安装与运维产品普及 |
+| 用户对“业务平台”的兴趣 | 存在，但不应提前写入主线收入 | 属于远期机会，不应覆盖当前产品边界 |
+
+## 4. 目标客户与竞品 (Target Customers & Competitors)
+
+### 4.1 目标客户（按规模）
+
+| 细分 | 占比判断 | 典型状态 | 决策者 / 使用者 | 对应套餐 |
+| :--- | :--- | :--- | :--- | :--- |
+| 个人用户 / 超级个体 | 65% | 想直接把 AI Agent 用起来，但不会命令行、环境配置和排障 | 决策者与使用者同一人 | 个人版 |
+| 小微企业 / 个体门店 / 小团队 | 30% | 有明确业务需求，但没有专职技术，通常依赖外包或兼职人员 | 老板 / 运营负责人 / 助理 | 专业版 |
+| 轻量企业客户 | 5% | 已有明确组织需求，希望标准化部署、基础权限和稳定支持，但还不走重型私有化 | 创始人 / 业务负责人 / IT 负责人 | 企业版 |
+
+### 4.2 目标客户（按购买场景）
+
+- **场景 A：个人快速上手**
+  - 用户想尽快把 AI Agent 用起来，但不会配置环境、服务和命令。
+  - {Name} 提供向导式安装、默认配置、健康检查与失败回滚。
+- **场景 B：小微企业低成本上线**
+  - 团队有使用需求，但没有专职技术人员，不希望长期依赖外包。
+  - {Name} 提供更低门槛的部署、日常管理和问题排查入口。
+- **场景 C：从单机走向轻量多实例**
+  - 用户开始出现多账号、多设备、多环境需求，但还没到重型企业治理阶段。
+  - {Name} 提供统一纳管、状态回查和基础配置治理。
+- **场景 D：轻量企业标准化使用**
+  - 客户已有小规模团队协作需求，希望统一安装、稳定运行，并获得基础支持。
+  - {Name} 提供标准化部署、基础权限能力和轻量企业付费方案。
+
+### 4.3 竞品概览
+
+| 竞品 / 替代方案 | 类型 | 对 {Name} 的意义 |
+| :--- | :--- | :--- |
+| OpenClaw 原生 CLI / Control UI | 直接替代 | 面向会折腾的用户，但对非技术人群门槛仍高 |
+| 教程文章 / 视频教程 / 社群答疑 | 最常见替代方案 | 免费但不稳定，用户需要自己理解并排错 |
+| 代装服务 / 外包技术支持 | 人工替代方案 | 能解决一次性问题，但成本高、不可复制、后续维护依赖人 |
+| 宝塔 / Coolify / Portainer 等低门槛运维工具 | 间接竞品 | 比命令行友好，但仍然要求用户理解服务器和部署概念 |
+
+### 4.4 竞品功能矩阵（摘要）
+
+| 能力 | 原生引擎工具 | 通用运维工具 | {Name} |
+| :--- | :--- | :--- | :--- |
+| 非技术用户可上手性 | 弱 | 弱 | 强 |
+| 三引擎统一安装闭环 | 弱 | 无 | 强 |
+| 引擎语义级健康检查 | 中 | 弱 | 强 |
+| 安装失败回滚 | 弱 | 弱 | 强 |
+| 轻量多实例纳管 | 弱 | 中 | 强 |
+| 对 Claw 生态的理解 | 强（单引擎） | 弱 | 强（多引擎） |
+
+### 4.5 竞争判断
+
+- {Name} 的主要竞争，不是和大厂平台争采购预算，而是和“用户先看教程自己折腾”以及“花钱找人代装”竞争。
+- 只要 {Name} 能让非技术用户更快装上、更少踩坑、更容易恢复，就有稳定付费基础。
+- 真正的护城河来自 **把技术复杂度产品化封装**，让普通人也能安全使用 Claw 引擎。
+
+## 5. SWOT 分析
+
+| 维度 | 要点 |
+| :--- | :--- |
+| **优势 (S)** | 明确面向无技术能力个人、小微企业与少量轻量企业客户；直接解决“不会装、不会配、出问题没人管”的高频痛点；比教程、脚本和通用运维工具更适合普通用户上手。 |
+| **劣势 (W)** | 目标用户教育成本高，对易用性要求极高；客单价不会像大企业软件那样高；如果首装体验不顺，转化会直接受影响。 |
+| **机会 (O)** | AI Agent 兴趣增长，但非技术用户仍缺乏真正可用的安装和运维工具；小微企业对低门槛工具接受度提升；可先用个人与小微企业市场验证付费模型，再逐步承接少量标准化企业客户。 |
+| **威胁 (T)** | 原生产品逐步变简单；教程、社群和代装服务会持续分流；若产品设计仍偏技术化，会与目标人群错位。 |
+
+## 6. 商业模式与定价 (Business Model & Pricing)
+
+### 6.1 商业模式画布（摘要）
+
+- **客户细分**：个人用户（开箱即用）、小微企业（低门槛上线与基础纳管）、少量轻量企业客户（标准化部署与基础支持）；中大型重交付客户不作为当前主线。
+- **价值主张**：让不会技术的个人、小微企业和轻量企业客户也能完成安装、基础纳管、健康检查与问题恢复；先解决“能用且少踩坑”，再逐步扩展更多平台能力。
+- **收入来源**：以个人版和专业版订阅为主，并辅以少量标准化企业版收入；增值服务与更高阶治理能力为后续补充。
+- **成本结构**：研发约 40%、销售约 20%、客服与成功支持约 20%、基础设施约 10%、内容与获客约 10%。
+
+### 6.2 定价策略
+
+**版本定价（摘要）**：
+
+| 版本 | 年付价格 | 主要对象 | 包含能力                                                                         |
+| :--- | :--- | :--- |:-----------------------------------------------------------------------------|
+| 个人版 | 99 元/年 | 个人用户 | 1 实例、30个智能体、多渠道、智能体 + 技能配置，其他能力需用户自行处理                                        |
+| 专业版 | 199 元/年 | 进阶个人用户 / 小微团队 | 多实例、多智能体、多渠道、无限智能体、智能体配置技能、自动化、24 小时智能客服 + 12 小时人工客服、在线问题解答                                               |
+| 企业版 | 599 元/年 | 小微企业 / 轻量企业客户 | 多平台（Web、Desktop）、多实例、多智能体、多渠道、无限智能体、智能体配置技能、自动化、24 小时智能客服 + 12 小时人工客服、在线问题解答 |
+
+**定价原则**：定价应足够低，先验证真实转化与留存，不预设过高 ARPU；强调“比自己折腾更省时间、比找人代装更便宜、比不用更容易落地”。**优惠策略**：默认年付、首购优惠、升级抵扣，可保留短期试用但不依赖复杂价格体系。
+
+### 6.2.1 三档定价模型
+
+{Name} 当前更适合采用 **简单、克制、对非技术用户友好** 的三档年费模型，而不是复杂的月付/季付/企业报价体系。
+
+| 档位 | 价格 | 适用对象 | 核心说明 |
+| :--- | :--- | :--- | :--- |
+| 个人版 | 99 元/年 | 想自己用起来的个人用户 | 适合单实例起步，满足“能装上、能跑起来、能继续用” |
+| 专业版 | 199 元/年 | 有更多自动化和多实例需求的个人 / 小团队 | 适合已经进入持续使用阶段，希望减少重复操作 |
+| 企业版 | 599 元/年 | 小微企业 / 轻量企业客户 | 适合需要 Web + Desktop、多实例协作、支持服务和问题解答的客户 |
+
+**能力边界理解**：
+- **个人版（99/年）**：解决“从不会装到能用上”的问题，给最基本但完整的可用体验。
+- **专业版（199/年）**：解决“从能用到更省事”的问题，强调多实例、自动化和更高上限。
+- **企业版（599/年）**：解决“小微企业持续使用和服务保障”的问题，强调多平台、客服支持与问题解答。
+
+### 6.2.2 定价口径冻结（执行优先级）
+
+- **当前文档口径**：个人版 `99 元/年`，专业版 `199 元/年`，企业版 `599 元/年`。
+- **对外默认口径**：在下一版商业化文档更新前，以本章为准。
+- **实验空间**：可测试试用期、限时折扣与升级优惠，但不建议重新引入过高或过复杂的定价体系。
+
+### 6.2.3 通信平台定价模型（远期，不计入当前主口径）
+
+当 PartMe 通信终端与消息网络真正上线并形成独立价值后，可在现有订阅基础上叠加新的收入模型；但在当前阶段，这部分**不计入正式市场规模与主收入假设**。
+
+| 收入项 | 说明 | 当前处理方式 |
+| :--- | :--- | :--- |
+| 节点连接费 | 每个实例接入消息网络的收费 | 远期保留 |
+| 消息量计费 | 超额度后的按量收费 | 远期保留 |
+| Agent / Skill 商城抽成 | 平台抽成 | 远期保留 |
+| 企业频道 | 企业消息治理与审计 | 远期保留 |
+| Interaction API | 第三方终端接入 | 远期保留 |
+
+### 6.2.4 付费转化策略
+
+- **个人版转化**：强调低门槛，让用户先跨过“不敢开始”和“不会安装”这两个门槛。
+- **专业版转化**：强调多实例、无限智能体和自动化，适合已形成持续使用习惯的用户。
+- **企业版转化**：强调多平台使用、客服支持、问题解答和更完整的服务保障。
+- **升级路径**：个人版 → 专业版 → 企业版，随着实例数、自动化需求和支持需求提升自然升级。
+
+### 6.2.5 企业买断方案分析
+
+- 当前阶段不主推永久买断。
+- 企业版本质上仍应保持标准化订阅服务，而不是提前进入重交付、重定制模式。
+- 如果未来出现强合规或私有化需求，再单独设计买断与私有化策略。
+
+### 6.3 成本效益与 ROI（客户视角）
+
+- **个人版**：花 `99 元/年`，核心价值是少走弯路、少踩坑、少求助。
+- **专业版**：花 `199 元/年`，核心价值是节省重复操作时间，提高多实例与自动化效率。
+- **企业版**：花 `599 元/年`，核心价值是获得更完整的平台能力与客服支持，降低团队使用门槛。
+- {Name} 的核心 ROI 不是替代大型企业系统，而是**用更低成本让个人和小微企业真正把 AI Agent 用起来**。
+
+## 7. 风险与应对 (Risks & Mitigation)
+
+### 7.1 市场与政策风险
+
+| 风险 | 应对 |
+| :--- | :--- |
+| 上游引擎接口或依赖变化 | 紧跟 OpenClaw / ZeroClaw / OctoClaw 与关键依赖的版本变化；通过适配层与兼容测试降低影响 |
+| 竞品与同质化 | 强化非技术用户可上手性、安装回滚能力、统一纳管体验与标准化支持边界 |
+
+### 7.2 技术风险
+
+| 风险 | 应对 |
+| :--- | :--- |
+| OpenClaw 与上游依赖升级不兼容 | 遵循官方插件规范；锁定可用版本并做兼容测试；版本锁定、降级方案 |
+| 大规模并发/性能瓶颈 | 架构优化、压力测试、弹性扩容 |
+| 数据安全与隐私合规 | 合规审查、数据加密、权限隔离 |
+
+### 7.3 商业与竞争风险
+
+| 风险 | 应对 |
+| :--- | :--- |
+| 获客成本高、客户流失率高、现金流紧张 | 优化转化、客户成功、合理融资与成本控制 |
+| 原生引擎或通用平台快速跟进 | 快速迭代、强化易用性、沉淀安装与恢复体验差异化 |
+| 竞品价格战 | 强调价值、差异化定价、提高切换成本 |
+
+---
+
+## 8. 附录 (Appendix)
+
+### 8.1 参考文档
+
+- [1、{Name}-产品与版本规划](6、{Name}-产品与版本规划.md)
+- [6、{Name}-系统架构设计](8、{Name}-系统架构设计.md)
+- [7、{Name}-技术方案与路线](5、{Name}-技术方案与路线.md)
+- 历史调研归档文档（非主线）
+- 技术调研/OpenClaw-商业化路径评估.md
+
+### 8.2 数据与假设来源
+
+- 市场规模：企业微信官网与财报、艾瑞/易观/IDC；竞品官网与行业报告。
+- 财务假设：客户留存率、ARPU、渗透率、LTV/CAC 等见原商业计划文档。
+
+---
+
+**文档版本**：V1.3.0  
+**创建时间**：2026-02-21  
+**最后更新**：2026-03-09  
+**文档状态**：✅ 完成
+
+
+---
+
+## 附录 A：产品调研（legacy `1、产品调研模板.md` 全文）
+
+
+> **文档说明**：
+> - 本文档是产品调研阶段的产出物，用于记录市场调研、用户调研、竞品分析等信息
+> - 通过调研收集信息，为产品定位和需求分析提供依据
+> - `{}` 包裹的内容为占位符，请替换为实际内容
+> - 引用块 `>` 中的文字为填写指导，填写后可删除
+
+---
+
+## 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/document-skills/full-stack-doc/templates/root/4、技术与可行性分析.md

@@ -0,0 +1,209 @@
+# {Name} 技术与可行性分析
+
+> **标准说明**：本文由 原「技术调研」模板 **节选**（§1 文档信息、§3 可行性、§5 优劣势与风险、§6 验证）。选型对比、方案建议见 `5、{Name}-技术方案与路线.md`。完整过程稿建议落盘到仓库 `技术调研/` 目录。
+
+---
+
+
+> **文档说明**：
+> - 本文档是技术调研阶段的产出物，用于记录技术选型、技术可行性分析、技术对比等信息
+> - 通过技术调研，为技术方案设计和架构设计提供依据
+> - `{}` 包裹的内容为占位符，请替换为实际内容
+> - 引用块 `>` 中的文字为填写指导，填写后可删除
+
+---
+
+## 1. 文档信息 (Document Info)
+
+### 1.1 版本记录
+| 版本号 | 修改日期 | 修改人 | 修改内容 | 备注 |
+| :--- | :--- | :--- | :--- | :--- |
+| V1.0.0 | {YYYY-MM-DD} | {姓名} | 初始版本 | - |
+
+### 1.2 调研信息
+| 项目 | 内容 |
+| :--- | :--- |
+| 调研时间 | {YYYY-MM-DD} ~ {YYYY-MM-DD} |
+| 调研人员 | {姓名1}、{姓名2} |
+| 调研对象 | {技术栈、框架、工具等} |
+| 调研方式 | {技术调研 / 技术对比 / 技术验证 / POC验证 / 技术评估} |
+
+### 1.3 文档责任人
+| 角色 | 姓名 | 职责 |
+| :--- | :--- | :--- |
+| 技术负责人 | {姓名} | 技术方案评审、技术可行性评估 |
+| 架构师 | {姓名} | 架构设计、技术选型 |
+| 开发负责人 | {姓名} | 技术调研、技术验证 |
+
+---
+
+## 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 维护成本评估
+
+**技术维护**：
+- {例如：使用主流技术，维护成本较低}
+- {例如：技术栈成熟，社区支持好，问题解决快}
+- {例如：文档完善，新人上手快}
+
+**运维成本**：
+- {例如：容器化部署，运维成本较低}
+- {例如：监控告警完善，问题发现快}
+- {例如：自动化程度高，人工干预少}
+
+**升级成本**：
+- {例如：技术栈版本升级成本可控}
+- {例如：向后兼容性好，升级风险低}
+
+---
+
+## 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小时，无异常}
+
+---
+

skills/dev-utils-skills/full-stack-doc/templates/3、技术调研模板.md → skills/document-skills/full-stack-doc/templates/root/5、技术方案与路线.md

@@ -1,4 +1,9 @@
-# {产品名称} - 技术调研文档 V1.0
+# {Name} 技术方案与路线
+
+> **标准说明**：本文由 原「技术调研」模板 **节选**（§2 选型、§4 对比、§7 方案建议、§8 附录）。可行性分析见 `4、{Name}-技术与可行性分析.md`。
+
+---
+
 
 > **文档说明**：
 > - 本文档是技术调研阶段的产出物，用于记录技术选型、技术可行性分析、技术对比等信息
@@ -32,6 +37,7 @@
 
 ---
 
+
 ## 2. 技术选型 (Technology Selection)
 
 ### 2.1 前端技术栈
@@ -282,89 +288,6 @@
 
 ---
 
-## 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 前端框架对比
@@ -467,93 +390,6 @@
 
 ---
 
-## 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 推荐技术栈

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

@@ -0,0 +1,156 @@
+> **标准说明**：正文为 OctoPanel 实例；附录为 legacy PRD「产品概述」问卷体。
+
+---
+
+# {Name} 产品与版本规划 产品与版本规划
+
+> 文件名保留历史名，仅用于兼容旧引用。正文中的正式产品名统一为 **{Name}**。
+
+## 1. 产品定位
+
+`{Name} = 多引擎智能体控制平面。`
+
+一句话：
+
+`面向 OpenClaw / ZeroClaw / OctoClaw 的安装、纳管、配置、运维、扩展与审计平台。`
+
+## 2. 产品骨架来源
+
+### 2.1 从 1Panel 借什么
+
+- 借信息架构，不只借皮肤
+- 左侧一级导航 + 顶部状态栏 + 首页总览 + 列表页 + 详情页 + 安装向导
+- 一键安装脚本 + CLI 工具 + Web 面板 + 节点/主机管理 + 应用市场
+- 资源对象化：主机、应用、任务、备份、日志、商店都做成标准对象
+
+### 2.2 从 clawpanel 借什么
+
+- 安装 / 诊断 / 修复主链
+- AI 助手做“受控运维代理”而不是闲聊机器人
+- Web 控制面 + 同机执行代理分层
+- 多实例与远程实例代理思路
+
+## 3. {Name} 的差异化
+
+{Name} 不应只是 1Panel 或 clawpanel 的换壳版，而要强化：
+
+- 多引擎统一适配
+- 游戏化 6 步安装向导
+- 多实例批量纳管
+- 渠道 / Skill / MCP 卡片式安装
+- 模型订阅与代理平台目录
+- 受控 AI 安装助手
+- 审计、回滚、任务阶段结果
+- Web-only 控制台 + Go Core + Node Agent
+
+## 4. 形态策略
+
+### 4.1 {Name} Web
+
+- 唯一控制台形态
+- 面向服务器部署与远程访问
+- 负责登录、实例管理、模型订阅、渠道配置、技能 / 工具治理、监控、日志审计、任务回查
+
+### 4.2 {Name} Core
+
+- `Go` 服务
+- 负责 API、任务编排、状态机、审计、权限、节点 / 实例注册、批量任务
+- 充当控制面与执行面的统一编排核心
+
+### 4.3 {Name} Node Agent
+
+- `Node.js + TypeScript` 执行代理
+- 部署在被管机器上，跟引擎同机
+- 负责安装、预检、配置生成、服务启停、日志采集、健康检查、回滚
+
+## 5. 版本层级
+
+| 层级 | 名称 | 目标 |
+|------|------|------|
+| `P0` | 安装闭环 | 三引擎安装、健康检查、纳管、回滚 |
+| `P1` | 控制面骨架 | 首页、实例、模型、监控、设置 |
+| `P2` | 平台治理 | 沙盒、智能体、技能商店、工具商店、模型订阅 |
+| `P3` | 平台增强 | 日志审计、批量运维、平台扩展与高级协作 |
+
+## 6. 一级导航冻结
+
+{Name} 一级导航固定为：
+
+1. 首页
+2. 实例
+3. 模型
+4. 监控
+5. 沙盒
+6. 智能体
+7. 技能商店
+8. 工具商店
+9. 日志审计
+10. 设置
+
+说明：
+
+- `实例` 承接安装向导、节点与远程主机、部署 / 升级 / 回滚 / 批量任务
+- `模型` 承接模型提供商、凭证、路由、模型代理与模型订阅目录，不拆分额外一级菜单
+- `日志审计` 承接巡检总览、操作审计、异常日志、实时事件流和任务阶段日志
+
+## 7. 与安装闭环文档的关系
+
+- [28、{Name}-三引擎安装闭环总表](./28%E3%80%81{Name}-%E4%B8%89%E5%BC%95%E6%93%8E%E5%AE%89%E8%A3%85%E9%97%AD%E7%8E%AF%E6%80%BB%E8%A1%A8.md) 是 `P0` 主合同
+- 它不是整个产品的全部定义，只是当前优先交付主链
+- 平台总定义由本文件、架构文档、IA 文档共同冻结
+
+## 8. 当前技术冻结
+
+- `前端`：`Vue 3 + TypeScript`
+- `控制面后端`：`Go`
+- `执行代理`：`Node.js + TypeScript`
+- 不再保留 `Desktop` 为主线产品形态；历史 Desktop 相关内容仅作为旧方案归档参考
+
+
+---
+
+## 附录：PRD 模板节选（legacy 5 §2）
+
+## 2. 产品概述 (Product Overview)
+
+### 2.1 产品定位
+> 简要描述产品的定位、目标用户、核心价值
+
+**产品定位**：{例如：面向门店老板和师傅的XXX应用，帮助门店高效管理订单、师傅、客户等业务}
+
+**目标用户**：
+- **主要用户**：{例如：门店老板、工作人员}
+- **次要用户**：{例如：师傅、运营人员}
+
+**核心价值**：
+1. {例如：提升订单处理效率，减少人工操作}
+2. {例如：实时掌握门店运营数据，辅助决策}
+3. {例如：优化师傅工作流程，提升服务质量}
+
+### 2.2 产品目标
+> 明确本次迭代要达成的业务目标
+
+**业务目标**：
+- {例如：提升订单处理效率30%}
+- {例如：减少订单遗漏率至5%以下}
+- {例如：提升师傅接单率至80%以上}
+
+**用户目标**：
+- {例如：门店老板能够快速查看和处理订单}
+- {例如：师傅能够便捷抢单和上报服务进度}
+
+### 2.3 产品范围
+> 明确本次迭代包含和不包含的功能范围
+
+**本次迭代包含**：
+- {例如：工单模块（订单列表、订单详情、订单操作）}
+- {例如：我的模块（门店信息、数据统计、待办事项）}
+- {例如：首页模块（搜索、Banner）}
+
+**本次迭代不包含**（后续迭代）：
+- {例如：数据报表详细分析}
+- {例如：客户管理模块}
+- {例如：商品管理模块}
+
+---
+

skills/document-skills/full-stack-doc/templates/root/6、详细功能清单.md

@@ -0,0 +1,87 @@
+> **标准说明**：OctoPanel 实例树状清单；请按产品改写。
+
+---
+
+# {Name} 详细功能清单
+
+## {Name} 形态：
+
+基于 1Panel + clawpanerl 的 {Name} 开发
+
+1Panel 的简单布局
+clawpanerl 的完整管理功能
+
+### {Name} Web：
+
+- 登录：账号密码登录
+- 首页
+- 实例: 等同于宝塔面板的网站
+    - 概览
+    - OpenClaw
+        - 安装环境未就绪
+            - 未安装 Git 版本管理，点击安装
+            - 未安装 Node 版本管理器，点击安装
+        - 创建实例
+        - 实例列表
+            - 序号、名称、端口、管理
+            - 渠道：各种渠道的快捷绑定
+    - ZeroClaw
+        - 安装环境未就绪
+            - 未安装 Git 版本管理，点击安装
+            - 未安装 Rust 版本管理器，点击安装
+        - 创建实例
+        - 实例列表
+    - OctoClaw
+        - 安装环境未就绪
+            - 未安装 Git 版本管理，点击安装
+            - 未安装 Rust 版本管理器，点击安装
+        - 创建实例
+        - 实例列表
+- 模型
+    - 全部模型
+    - 模型订阅
+        - 官方平台
+        - 聚合 / 代理平台
+        - 合作推广平台
+        - 分销链接绑定
+        - 分销活动
+        - 注册 / 开 Key 入口
+        - 平台能力矩阵
+        - 接入模板生成
+        - 平台健康状态
+        - 统一网关
+        - 服务端代理接管
+        - 故障转移队列
+    - 免费模型
+    - 限额模型
+    - 模型厂商
+    - 模型代理
+        - 统一网关列表
+        - 代理状态
+        - 接管状态
+        - 熔断 / 恢复
+- 监控：本机监控
+    - 系统监控
+        - 平均负责、CPU、内存、磁盘 IO、网络 IO
+    - 实例监控
+        - OpenClaw 监控
+        - ZeroClaw 监控
+- 沙盒：各种沙盒
+    - WASM
+        - 默认安装
+        - 沙盒池
+    - OpenSandbox
+        - 未安装 OpenSandbox 环境，点击安装
+        - 沙盒池
+    - Docker
+        - 未安装 Docker 环境，点击安装
+        - 沙盒池
+- 智能体：各种智能体市场，安装时选择一个实例
+    - 热门
+    - 团队
+- 技能商店：各种打包的技能，安装时选择一个实例
+- 工具商店：各种集成的工具，安装时选择一个实例
+- 日志审计
+    - 按实例区分
+- 设置
+- 退出

skills/dev-utils-skills/full-stack-doc/templates/8、领域模型说明模板.md → skills/document-skills/full-stack-doc/templates/root/7、领域模型设计.md

@@ -1,4 +1,17 @@
-# {产品名称} - 领域模型说明文档 V1.0
+# {Name} 领域模型设计
+
+> **标准说明**：本文由 原「领域模型说明」阶段模板全文 全文合并（根目录总纲）。
+
+### 关联文档
+
+| 文档 | 说明 |
+| :--- | :--- |
+| `{V}/4、{Name}-领域模型设计-{V}.md` | 分版本领域增量（如有） |
+| `8、{Name}-系统架构设计.md` | 系统架构 |
+| `2、{Name}-术语表与词汇表.md` | 术语 |
+
+---
+
 
 > **文档说明**：
 > - 本文档用于描述产品的领域模型设计，包括领域划分、实体关系、领域服务等

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

@@ -1,4 +1,17 @@
-# {产品名称} - 系统架构设计文档 V1.0
+# {Name} 系统架构设计
+
+> **标准说明**：本文由 原「系统架构设计」阶段模板全文 全文合并（根目录总纲）。分版本见 `{V}/3、{Name}-系统架构设计-{V}.md`。
+
+### 关联文档
+
+| 文档 | 说明 |
+| :--- | :--- |
+| `5、{Name}-技术方案与路线.md` | 技术路线 |
+| `7、{Name}-领域模型设计.md` | 领域模型 |
+| `{V}/3、{Name}-系统架构设计-{V}.md` | 分版本架构 |
+
+---
+
 
 > **相关文档导航**：
 > *   [产品需求文档 (PRD)]({PRD文档路径})

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

@@ -1,4 +1,16 @@
-# {产品名称} - 视觉与交互 DNA 规范 V1.0
+# {Name} 视觉与交互 DNA 规范
+
+> **标准说明**：本文由 原「视觉与交互 DNA」阶段模板全文 全文合并。
+
+### 关联文档
+
+| 文档 | 说明 |
+| :--- | :--- |
+| `{V}/7、{Name}-UI设计说明-{V}.md` | 版本 UI 总说明 |
+| `10、{Name}-功能菜单与版本规划.md` | 菜单 |
+
+---
+
 
 > **文档说明**：
 > - 本文档定义产品的视觉设计语言和交互设计规范，确保产品设计的一致性和品牌识别度
@@ -529,3 +541,164 @@
 **创建时间**：{YYYY-MM-DD}  
 **最后更新**：{YYYY-MM-DD}  
 **文档状态**：✅ 设计中 / ✅ 待评审 / ✅ 评审通过 / ✅ 已完成
+
+
+---
+
+## 附录 A：控制台类产品 DNA 示例（OctoPanel 原文节选，结构对齐用）
+
+> 文件名保留历史名，仅用于兼容旧引用。正文产品名统一为 **{Name}**。
+
+## 1. 设计目标
+
+{Name} 的界面不是聊天应用，也不是业务工作台，而是 **1Panel 风格的多引擎控制台**。
+
+设计目标：
+
+- 专业、稳定、可扫描
+- 对新手友好，对运维场景可执行
+- 统一承载安装、实例、节点、任务、审计、扩展等页面
+- 保持自有品牌视觉，不沿用旧“旧客服感配色”
+
+## 2. 核心设计原则
+
+- **平台优先**：导航与页面结构以控制台为中心
+- **状态优先**：健康、任务、风险、回滚等状态必须比装饰更醒目
+- **路径清晰**：列表、详情、向导三种页面模式要稳定
+- **操作克制**：主操作固定、危险操作突出、日志与上下文就近可见
+
+## 3. 主题色体系
+
+### 3.1 品牌主色
+
+| 名称 | 色值 | 用途 |
+|------|------|------|
+| Octo Navy | `#0F172A` | 顶栏、侧栏、标题深色 |
+| Octo Blue | `#2563EB` | 主按钮、链接、选中态 |
+| Octo Teal | `#14B8A6` | 平台高亮、进度、次主操作 |
+| Octo Sky | `#E0F2FE` | 轻背景、信息区块 |
+| Octo Amber | `#F59E0B` | 引擎强调、警告、向导高亮 |
+
+### 3.2 状态色
+
+| 状态 | 色值 |
+|------|------|
+| Success | `#16A34A` |
+| Warning | `#F59E0B` |
+| Danger | `#DC2626` |
+| Info | `#0EA5E9` |
+| Muted | `#64748B` |
+
+### 3.3 引擎徽章色
+
+| 引擎 | 推荐色系 |
+|------|----------|
+| OpenClaw | 橙红系 |
+| ZeroClaw | 亮蓝系 |
+| OctoClaw | 琥珀金 / 深青系 |
+
+## 4. 布局规范
+
+### 4.1 Web 主布局
+
+- 顶部：Logo、工作区、全局状态、搜索、用户菜单
+- 左侧：一级导航
+- 中间：页面主内容区
+- 右侧：上下文抽屉 / 日志 / 风险 / 最近事件
+
+### 4.2 页面模式
+
+- **概览页**：Dashboard、节点总览、巡检总览
+- **列表页**：Instances、Nodes、Channels、Models、Tasks
+- **详情页**：实例详情、节点详情、任务详情
+- **向导页**：安装向导、连接器安装、扩展安装
+
+### 4.3 Desktop 跟随
+
+Desktop 复用相同页面语义，差异只在：
+
+- 窗口更紧凑
+- 本地日志与调试入口更近
+- 可增加命令确认面板
+
+## 5. 组件规范
+
+### 5.1 概览卡片
+
+用于首页关键指标，固定包含：
+
+- 标题
+- 数值
+- 趋势或状态
+- 快捷动作（可选）
+
+### 5.2 资源列表
+
+用于实例、节点、任务、连接器、模型等页面，固定包含：
+
+- 筛选区
+- 搜索区
+- 表格或卡片切换（按模块需要）
+- 批量操作区
+
+### 5.3 详情页
+
+固定包含：
+
+- 页头摘要
+- Tab 区
+- 右侧上下文抽屉
+- 状态时间线或日志面板
+
+### 5.4 向导步骤栏
+
+固定用于 Install Wizard：
+
+- 左侧步骤栏
+- 中间主表单
+- 右侧目标信息与风险说明
+- 底部固定操作区
+
+### 5.5 任务抽屉
+
+用于展示任务执行详情，固定包含：
+
+- 当前状态
+- 阶段列表
+- 日志区
+- 重试 / 回滚 / 复制错误信息操作
+
+## 6. 排版与间距
+
+- 页面标题：20px / 600
+- 模块标题：16px / 600
+- 正文：14px / 400
+- 标签与辅助说明：12px / 400
+- 卡片圆角：12px
+- 按钮圆角：8px
+- 页面常规间距：16px / 24px / 32px
+
+## 7. 动效与反馈
+
+- 所有异步操作必须有 loading 状态
+- 成功、失败、警告必须有清晰反馈
+- 危险操作必须二次确认
+- 长任务必须能进入任务抽屉查看阶段进度
+
+## 8. 明确不再使用的旧风格
+
+以下旧风格不再作为 {Name} 主线视觉依据：
+
+- 以客服感为中心的配色与文案
+- 以聊天页作为首页的布局
+- 旧工作台式“工具集合页”信息架构
+- 强业务化、场景化、运营化页面表达
+
+## 9. 冻结结论
+
+{Name} 从本轮开始采用：
+
+- **1Panel 式控制台骨架**
+- **自有蓝青深色平台配色**
+- **四类固定页面范式：概览 / 列表 / 详情 / 向导**
+- **右侧上下文抽屉 + 任务抽屉** 作为核心交互层

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、`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、`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}  
+**文档状态**：✅ 设计中 / ✅ 待评审 / ✅ 评审通过 / ✅ 已完成