docs(brand): 更新命名品牌说明和术语表文档

- 重写品牌定位、命名由来、产品边界等核心内容
- 新增核心公式和品牌家族关系说明
- 更新对外表达规范和品牌标识规范
- 重构术语表结构，按产品层、架构层、业务流程等分类
- 添加版本与状态术语章节
- 删除过时的历史术语和版本说明

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

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

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

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

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

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

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

@@ -1,118 +1,367 @@
-> **标准说明**：OctoPanel `10、…` 实例 + legacy PRD 产品范围问卷体。
+# {Name} 功能菜单与版本规划
+
+> **文档说明**：冻结产品导航结构、页面清单、路由规划、版本分布、核心用户旅程与详细功能清单（含优先级和版本归属）。本文包含原「详细功能清单」内容。
+>
+> **版本**：V1.0.0
+> **最后更新**：{YYYY-MM-DD}
 
 ---
 
-# {Name} 功能菜单
+## 1. 功能全景
 
-> 本文档用于冻结 `{Name} Web` 的最终菜单结构。
->
-> 当前主语：`{Name} Web` 是服务器侧智能体（Agent）安装、纳管、配置、监控、审计与回滚控制面。
+```mermaid
+mindmap
+  root(("{Name}"))
+    仪表盘
+      数据概览
+      趋势图表
+      快捷操作
+    商品管理
+      商品采集
+      商品编辑
+      批量上架
+      定价策略
+    订单管理
+      订单列表
+      订单详情
+      批量处理
+      退款管理
+    店铺管理
+      平台连接
+      店铺配置
+      授权管理
+    Agent 管理
+      Agent 列表
+      任务监控
+      执行日志
+      调度配置
+    数据报表
+      销售报表
+      流量分析
+      Agent 效率
+    系统设置
+      用户管理
+      角色权限
+      通知配置
+      系统日志
+```
+
+### 1.1 优先级与版本标注说明
+
+| 标注 | 含义 |
+| :--- | :--- |
+| P0 | 必须实现，阻塞发布 |
+| P1 | 重要，影响核心体验 |
+| P2 | 期望，提升用户体验 |
+| P3 | 可选，低优先级增强 |
+| 🆓 | 免费版可用 |
+| 👤 | 个人版 (Pro) 可用 |
+| 👥 | 专业版 (Team) 可用 |
+| 🏢 | 企业版 (Enterprise) 可用 |
 
 ---
 
-## 1. 一级菜单 (Top-level Menu)
+## 2. 一级导航结构
 
-{Name} Web 一级菜单固定为：
+```mermaid
+flowchart LR
+    NAV["侧栏导航"]
+    NAV --> DASH["📊 仪表盘"]
+    NAV --> PROD["📦 商品管理"]
+    NAV --> ORD["📋 订单管理"]
+    NAV --> STORE["🏪 店铺管理"]
+    NAV --> AGENT["🤖 Agent 管理"]
+    NAV --> REPORT["📈 数据报表"]
+    NAV --> SET["⚙️ 系统设置"]
+```
 
-1. **概览 Dashboard**
-2. **实例 Instances**
-3. **智能体 Agents Management**
-4. **模型 Models**
-5. **技能 Skills**
-6. **工具 Tools**
-7. **自动化 Automation**
-8. **记忆库 Memory Management**
-9. **设置 Settings**
-10. **文档 Docs**
+### 2.1 菜单归位规则
+
+| 规则 | 说明 |
+| :--- | :--- |
+| 频率优先 | 高频功能排在前面（仪表盘 → 商品 → 订单） |
+| 逻辑分组 | 同一业务域功能归入同一菜单 |
+| 版本控制 | 高版本功能在低版本中隐藏（非灰色禁用） |
+| 角色控制 | 无权限菜单不显示 |
 
 ---
 
-## 2. 菜单归位与整合规则
+## 3. 二级菜单、页面清单与功能明细
+
+### 3.1 {例如：仪表盘 (Dashboard)}
 
-- **监控 & 沙盒**：不再作为一级菜单。`监控` 功能分散至 `概览` 与 `实例`；`沙盒`（WASM/Docker）整合进 `工具 Tools` 的执行环境管理。
-- **日志审计**：功能拆分。`巡检与风险发现` 归入 `概览`；`操作审计与系统日志` 归入 `设置 Settings` 或 `概览` 的事件流。
-- **自动化 & 记忆库 & 文档**：从原有的二级或深层菜单提拔为一级菜单，以突出 AI 原生能力。
-- **安装向导 & 节点管理**：统一收敛至 `实例 Instances` 模块。
+| 二级菜单 | 路由 | 版本 | 优先级 | 说明 |
+| :--- | :--- | :---: | :---: | :--- |
+| {例如：数据概览} | {例如：`/dashboard`} | 🆓 | P0 | {例如：核心指标卡片 + 趋势图} |
+| {例如：快捷操作} | {例如：`/dashboard`} | 🆓 | P1 | {例如：常用操作入口} |
 
 ---
 
-## 3. 详细功能分布
+### 3.2 {例如：商品管理 (Products)}
 
-### 3.1 概览 Dashboard
-- **平台总览**：全局资源、活跃实例、节点分布。
-- **健康看板**：实例健康、节点健康、服务状态（原“监控”模块内容）。
-- **风险告警**：巡检发现的风险、异常实例告警（原“日志审计”巡检部分）。
-- **任务简报**：最近失败任务、最近审计事件流。
+| 二级菜单 | 路由 | 版本 | 优先级 | 说明 |
+| :--- | :--- | :---: | :---: | :--- |
+| {例如：商品列表} | {例如：`/products`} | 🆓 | P0 | {例如：全部商品 + 筛选 + 搜索} |
+| {例如：商品详情} | {例如：`/products/:id`} | 🆓 | P0 | {例如：基本信息 + SKU + 上架状态} |
+| {例如：商品采集} | {例如：`/products/scrape`} | 👤 | P0 | {例如：从源平台采集商品} |
+| {例如：批量上架} | {例如：`/products/batch-list`} | 👤 | P1 | {例如：批量发布到目标平台} |
+| {例如：定价策略} | {例如：`/products/pricing`} | 👥 | P1 | {例如：自动定价规则配置} |
 
-### 3.2 实例 Instances
-- **实例概览**：所有引擎（OpenClaw / ZeroClaw / OctoClaw）的列表与运行状态。
-- **创建与部署**：
-  - 安装向导：环境预检、安装依赖、配置生成、服务安装、启动验证。
-  - 批量部署：多目标主机的一键下发。
-- **运维控制**：升级、回滚、重启、日志查看、性能监控。
-- **节点管理**：远程主机管理、执行器（Node Agent）安装与状态。
+---
 
-### 3.3 智能体 Agents Management
-- **Agent 市场**：官方及社区提供的智能体角色模板。
-- **我的智能体**：已配置的 Agent 列表。
-- **套装模板**：多 Agent 协作套装（Swarm / Team）。
-- **生命周期**：版本管理、分发至实例、升级/回滚策略。
+### 3.3 {例如：订单管理 (Orders)}
 
-### 3.4 模型 Models
-- **全部模型**：统一的模型接入列表。
-- **凭证中心**：API Key 管理、多平台厂商接入。
-- **模型订阅**：官方/聚合平台接入模板、配额监控、注册引导。
-- **模型代理**：统一网关、服务端代理、故障转移（Failover）、熔断恢复。
-- **路由策略**：基于成本/速度/能力的自动路由。
+| 二级菜单 | 路由 | 版本 | 优先级 | 说明 |
+| :--- | :--- | :---: | :---: | :--- |
+| {例如：订单列表} | {例如：`/orders`} | 🆓 | P0 | {例如：全部订单 + 状态筛选} |
+| {例如：订单详情} | {例如：`/orders/:id`} | 🆓 | P0 | {例如：订单信息 + 物流 + 操作} |
+| {例如：批量处理} | {例如：`/orders/batch`} | 👤 | P1 | {例如：批量发货、批量备注} |
+| {例如：退款管理} | {例如：`/orders/refunds`} | 👤 | P1 | {例如：退款申请处理} |
 
-### 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.4 {例如：店铺管理 (Stores)}
 
-### 3.7 自动化 Automation
-- **工作流编排**：可视化或代码化的任务流水线。
-- **定时任务**：Cron 任务、周期性巡检触发。
-- **事件触发**：基于 Webhook 或系统事件的自动化响应。
-- **执行审计**：自动化任务的历史记录与成功率分析。
+| 二级菜单 | 路由 | 版本 | 优先级 | 说明 |
+| :--- | :--- | :---: | :---: | :--- |
+| {例如：店铺列表} | {例如：`/stores`} | 🆓 | P0 | {例如：已连接店铺 + 状态} |
+| {例如：添加店铺} | {例如：`/stores/add`} | 🆓 | P0 | {例如：选择平台 + 授权连接} |
+| {例如：店铺配置} | {例如：`/stores/:id/settings`} | 👤 | P1 | {例如：同步设置、通知规则} |
 
-### 3.8 记忆库 Memory Management
-- **记忆后端**：向量数据库（Vector DB）、图数据库（Neo4j）管理。
-- **知识索引**：文档上传、网页抓取、RAG 索引构建。
-- **记忆策略**：Recall 召回机制、记忆衰减与压缩、跨 Agent 共享。
-- **数据管理**：记忆片段查看、手动干预与清理。
+---
+
+### 3.5 {例如：Agent 管理 (Agents)}
+
+| 二级菜单 | 路由 | 版本 | 优先级 | 说明 |
+| :--- | :--- | :---: | :---: | :--- |
+| {例如：Agent 列表} | {例如：`/agents`} | 🆓 | P0 | {例如：可用 Agent + 状态} |
+| {例如：任务监控} | {例如：`/agents/tasks`} | 🆓 | P0 | {例如：执行中/已完成任务} |
+| {例如：执行日志} | {例如：`/agents/logs`} | 👤 | P1 | {例如：Agent 执行详细日志} |
+| {例如：调度配置} | {例如：`/agents/schedules`} | 👤 | P1 | {例如：定时任务配置} |
+| {例如：Agent 市场} | {例如：`/agents/marketplace`} | 👥 | P2 | {例如：社区 / Premium Agent} |
+
+---
+
+### 3.6 {例如：数据报表 (Reports)}
 
-### 3.9 设置 Settings
-- **平台管理**：RBAC 权限、安全设置、更新与版本、系统备份。
-- **审计日志**：系统日志、操作审计、异常追踪（原“日志审计”核心）。
-- **存储与目录**：安装路径、数据卷、缓存清理。
+| 二级菜单 | 路由 | 版本 | 优先级 | 说明 |
+| :--- | :--- | :---: | :---: | :--- |
+| {例如：销售报表} | {例如：`/reports/sales`} | 👤 | P1 | {例如：GMV、订单量、转化率} |
+| {例如：Agent 效率} | {例如：`/reports/agents`} | 👤 | P2 | {例如：Agent 执行成功率、耗时} |
+| {例如：导出报表} | {例如：`/reports/export`} | 👥 | P2 | {例如：Excel/PDF 导出} |
+
+---
 
-### 3.10 文档 Docs
-- **知识中心**：安装手册、接入文档、模型能力矩阵。
-- **帮助与支持**：FAQ、故障排查（Troubleshooting）、社区链接。
-- **API 引用**：控制面 API 定义与 Swagger 文档。
+### 3.7 {例如：系统设置 (Settings)}
 
+| 二级菜单 | 路由 | 版本 | 优先级 | 说明 |
+| :--- | :--- | :---: | :---: | :--- |
+| {例如：个人设置} | {例如：`/settings/profile`} | 🆓 | P0 | {例如：头像、密码、通知偏好} |
+| {例如：团队管理} | {例如：`/settings/team`} | 👥 | P1 | {例如：成员邀请、角色分配} |
+| {例如：角色权限} | {例如：`/settings/roles`} | 🏢 | P1 | {例如：自定义角色、权限配置} |
+| {例如：审计日志} | {例如：`/settings/audit`} | 🏢 | P1 | {例如：操作日志查询} |
+| {例如：API 密钥} | {例如：`/settings/api-keys`} | 👥 | P2 | {例如：API 密钥管理} |
 
 ---
 
-## 附录：PRD 模板节选（产品范围 legacy 5）
+## 4. CLI / IM 交互菜单（按需）
 
-### 2.3 产品范围
-> 明确本次迭代包含和不包含的功能范围
+```mermaid
+flowchart TD
+    CLI["{例如：opencli}"]
+    CLI --> PROD_CMD["product<br/>scrape / list / publish"]
+    CLI --> ORD_CMD["order<br/>sync / ship / list"]
+    CLI --> STORE_CMD["store<br/>connect / status"]
+    CLI --> AGENT_CMD["agent<br/>run / status / logs"]
+    CLI --> SYS_CMD["system<br/>config / health"]
+```
 
-**本次迭代包含**：
-- {例如：工单模块（订单列表、订单详情、订单操作）}
-- {例如：我的模块（门店信息、数据统计、待办事项）}
-- {例如：首页模块（搜索、Banner）}
+```bash
+# CLI 命令示例
+{例如：opencli} product scrape --platform taobao --keyword "手机壳"
+{例如：opencli} product publish --store my-store --ids 1,2,3
+{例如：opencli} order sync --store my-store --since 2026-01-01
+{例如：opencli} agent run product-selector --config ./config.yaml
+{例如：opencli} system health
+```
 
-**本次迭代不包含**（后续迭代）：
-- {例如：数据报表详细分析}
-- {例如：客户管理模块}
-- {例如：商品管理模块}
+---
+
+## 5. 页面版本分布
+
+### 5.1 版本 → 页面映射
+
+| 页面 | V1.0 | V2.0 | V3.0 | V4.0 |
+| :--- | :---: | :---: | :---: | :---: |
+| {例如：仪表盘} | ✅ | ✅ | ✅ | ✅ |
+| {例如：商品列表} | ✅ | ✅ | ✅ | ✅ |
+| {例如：商品采集} | ✅ | ✅ | ✅ | ✅ |
+| {例如：订单列表} | ✅ | ✅ | ✅ | ✅ |
+| {例如：店铺管理} | ✅ | ✅ | ✅ | ✅ |
+| {例如：Agent 列表} | ✅ | ✅ | ✅ | ✅ |
+| {例如：团队管理} | — | ✅ | ✅ | ✅ |
+| {例如：角色权限} | — | — | ✅ | ✅ |
+| {例如：审计日志} | — | — | ✅ | ✅ |
+| {例如：Agent 市场} | — | — | — | ✅ |
+| {页面} | — | — | — | — |
+
+---
+
+## 6. 导航状态规则
+
+### 6.1 角标规则
+
+| 角标类型 | 触发条件 | 样式 |
+| :--- | :--- | :--- |
+| 红点 | {例如：有未读通知} | {例如：8px 红色圆点} |
+| 数字角标 | {例如：待处理订单数} | {例如：红色圆角矩形 + 白色数字} |
+| NEW 标签 | {例如：新功能上线} | {例如：蓝色圆角标签，7 天后消失} |
+
+### 6.2 面包屑规则
+
+```
+首页 > 商品管理 > 商品详情 > SKU-12345
+```
+
+| 规则 | 说明 |
+| :--- | :--- |
+| 层级 | {例如：最多 4 级，超过省略中间层} |
+| 可点击 | {例如：除最后一级外均可点击跳转} |
+| 动态段 | {例如：ID 显示为名称（如商品名）} |
+
+### 6.3 搜索规则
+
+| 规则 | 说明 |
+| :--- | :--- |
+| 全局搜索 | {例如：顶栏搜索框，搜索商品/订单/Agent} |
+| 快捷键 | {例如：`Cmd+K` / `Ctrl+K` 唤起} |
+| 搜索范围 | {例如：商品名、订单号、Agent 名称} |
+
+---
+
+## 7. 核心用户旅程
+
+### 7.1 旅程一：{例如：新用户首次采集商品}
+
+```mermaid
+flowchart TD
+    START["注册登录"] --> CONNECT["连接店铺"]
+    CONNECT --> SCRAPE["采集商品"]
+    SCRAPE --> REVIEW["审核编辑"]
+    REVIEW --> PUBLISH["发布上架"]
+    PUBLISH --> MONITOR["查看状态"]
+    MONITOR --> DONE["✅ 完成"]
+```
+
+| 步骤 | 页面 | 关键操作 | 预期时间 |
+| :--- | :--- | :--- | :--- |
+| {例如：连接店铺} | {例如：店铺管理 → 添加} | {例如：选择平台 → 扫码授权} | {例如：2 分钟} |
+| {例如：采集商品} | {例如：商品采集} | {例如：输入关键词 → 选择来源 → 开始采集} | {例如：5 分钟} |
+| {例如：审核发布} | {例如：商品列表 → 批量上架} | {例如：勾选 → 编辑 → 确认发布} | {例如：3 分钟} |
+
+### 7.2 旅程二：{例如：日常 Agent 自动运营}
+
+```mermaid
+flowchart TD
+    CONFIG["配置 Agent 调度"] --> AUTO["Agent 自动执行"]
+    AUTO --> NOTIFY["执行结果通知"]
+    NOTIFY --> CHECK["查看报表"]
+    CHECK --> ADJUST["调整策略"]
+    ADJUST --> AUTO
+```
+
+---
+
+## 8. 版本发布节奏
+
+| 版本 | 发布日期 | 核心功能 | 页面数 |
+| :--- | :--- | :--- | :---: |
+| V1.0 MVP | {例如：2026 Q2} | {例如：基础采集 + 上架 + 订单} | {例如：15} |
+| V2.0 商业版 | {例如：2026 Q3} | {例如：多租户 + 团队 + Premium Agent} | {例如：22} |
+| V3.0 企业版 | {例如：2026 Q4} | {例如：RBAC + 审计 + 私有部署} | {例如：28} |
+| V4.0 生态版 | {例如：2027 Q1} | {例如：Agent 市场 + 插件 + 开放 API} | {例如：35} |
+
+---
+
+## 9. 详细功能清单（按业务域）
+
+### 9.1 {例如：商品采集}
+
+| # | 功能 | 描述 | 优先级 | 版本 | 状态 |
+| :---: | :--- | :--- | :---: | :---: | :---: |
+| F-PROD-01 | {例如：关键词采集} | {例如：输入关键词从源平台搜索采集} | P0 | 🆓 V1.0 | ⏳ |
+| F-PROD-02 | {例如：链接采集} | {例如：输入商品链接直接采集} | P0 | 🆓 V1.0 | ⏳ |
+| F-PROD-03 | {例如：批量采集} | {例如：Excel 导入链接批量采集} | P1 | 👤 V1.0 | ⏳ |
+| F-PROD-04 | {例如：智能推荐采集} | {例如：AI 推荐热销商品} | P2 | 👥 V2.0 | ⏳ |
+| F-PROD-NN | {功能} | {描述} | — | — | — |
+
+### 9.2 {例如：订单履约}
+
+| # | 功能 | 描述 | 优先级 | 版本 | 状态 |
+| :---: | :--- | :--- | :---: | :---: | :---: |
+| F-ORD-01 | {例如：订单同步} | {例如：定时从平台同步订单} | P0 | 🆓 V1.0 | ⏳ |
+| F-ORD-02 | {例如：自动发货} | {例如：匹配物流单号自动发货} | P1 | 👤 V1.0 | ⏳ |
+| F-ORD-03 | {例如：退款处理} | {例如：自动/手动处理退款} | P1 | 👤 V1.0 | ⏳ |
+| F-ORD-NN | {功能} | {描述} | — | — | — |
+
+### 9.3 {例如：Agent 调度}
+
+| # | 功能 | 描述 | 优先级 | 版本 | 状态 |
+| :---: | :--- | :--- | :---: | :---: | :---: |
+| F-AGT-01 | {例如：手动触发} | {例如：一键运行指定 Agent} | P0 | 🆓 V1.0 | ⏳ |
+| F-AGT-02 | {例如：定时调度} | {例如：Cron 定时执行} | P1 | 👤 V1.0 | ⏳ |
+| F-AGT-03 | {例如：执行日志} | {例如：查看 Agent 执行过程} | P0 | 🆓 V1.0 | ⏳ |
+| F-AGT-04 | {例如：Agent 市场} | {例如：浏览安装社区 Agent} | P2 | 👥 V4.0 | ⏳ |
+| F-AGT-NN | {功能} | {描述} | — | — | — |
+
+### 9.4 {例如：系统管理}
+
+| # | 功能 | 描述 | 优先级 | 版本 | 状态 |
+| :---: | :--- | :--- | :---: | :---: | :---: |
+| F-SYS-01 | {例如：用户注册/登录} | {例如：邮箱注册、社交登录} | P0 | 🆓 V1.0 | ⏳ |
+| F-SYS-02 | {例如：团队管理} | {例如：邀请成员、分配角色} | P1 | 👥 V2.0 | ⏳ |
+| F-SYS-03 | {例如：RBAC 权限} | {例如：自定义角色与权限} | P1 | 🏢 V3.0 | ⏳ |
+| F-SYS-04 | {例如：审计日志} | {例如：操作日志查询与导出} | P1 | 🏢 V3.0 | ⏳ |
+| F-SYS-NN | {功能} | {描述} | — | — | — |
+
+---
+
+## 10. 功能优先级统计
+
+```mermaid
+pie title 功能优先级分布
+    "P0 (必须)" : 12
+    "P1 (重要)" : 15
+    "P2 (期望)" : 8
+    "P3 (可选)" : 3
+```
+
+| 优先级 | 数量 | 占比 | V1.0 交付 | V2.0 交付 |
+| :--- | :---: | :---: | :---: | :---: |
+| P0 | {例如：12} | {例如：32%} | {例如：12} | {例如：0} |
+| P1 | {例如：15} | {例如：39%} | {例如：8} | {例如：7} |
+| P2 | {例如：8} | {例如：21%} | {例如：2} | {例如：4} |
+| P3 | {例如：3} | {例如：8%} | {例如：0} | {例如：1} |
+| **合计** | **38** | **100%** | **22** | **12** |
+
+---
+
+## 11. REST API 菜单（按需）
+
+| 方法 | 路径 | 版本 | 说明 | 状态 |
+| :--- | :--- | :---: | :--- | :---: |
+| GET | {例如：`/api/v1/products`} | 🆓 | {例如：商品列表} | ⏳ |
+| POST | {例如：`/api/v1/products/scrape`} | 👤 | {例如：商品采集} | ⏳ |
+| POST | {例如：`/api/v1/products/publish`} | 👤 | {例如：商品发布} | ⏳ |
+| GET | {例如：`/api/v1/orders`} | 🆓 | {例如：订单列表} | ⏳ |
+| POST | {例如：`/api/v1/agents/:id/run`} | 🆓 | {例如：运行 Agent} | ⏳ |
+| GET | {例如：`/api/v1/agents/tasks`} | 🆓 | {例如：任务列表} | ⏳ |
+| GET | {例如：`/healthz`} | 🆓 | {例如：健康检查} | ⏳ |
+| {方法} | {路径} | — | {说明} | — |
+
+---
 
+**文档版本**：V1.0.0
+**创建日期**：{YYYY-MM-DD}
+**最后更新**：{YYYY-MM-DD}
+**文档状态**：✅ 待评审

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

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

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

@@ -1,296 +1,149 @@
-> **标准说明**：OctoPanel 实例全文。
+# {Name} 术语表与词汇表
 
----
-
-# {Name} 术语表与词汇表 术语表与词汇表
-
-> **文档说明**：总纲 + 全量术语。正文正式产品名统一为 **{Name}**，`{Name}` 仅在历史术语或旧文件名兼容说明中保留。§2 为主线术语，§3 起为跨版本术语表。
+> **文档说明**：沉淀产品统一语言（Ubiquitous Language），用于产品、研发、设计、测试、运营跨角色对齐。所有文档、代码、UI 中的概念名称以本表为准。
+>
+> **版本**：V1.0.0
+> **最后更新**：{YYYY-MM-DD}
 
 ---
 
 ## 1. 文档信息 (Document Info)
 
 ### 1.1 版本记录
-| 版本号 | 修改日期 | 修改人 | 修改内容 | 备注 |
-| :--- | :--- | :--- | :--- | :--- |
-| V1.0.0 | 2026-02-25 | PartMe | 初始版本 | 建立跨版本统一术语表 |
+
+| 版本 | 日期 | 作者 | 变更说明 |
+| :--- | :--- | :--- | :--- |
+| V1.0.0 | {YYYY-MM-DD} | {姓名} | 初始版本 |
 
 ### 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 用量。 | 企业版 |
+## 2. 产品层术语
+
+| 术语 | 英文 | 定义 | 示例 |
+| :--- | :--- | :--- | :--- |
+| {例如：选品} | {例如：Product Selection} | {例如：从外部平台筛选合适商品的过程} | {例如：从 1688 采集商品到候选池} |
+| {例如：上架} | {例如：Product Listing} | {例如：将商品信息发布到目标平台} | {例如：将商品推送到淘宝店铺} |
+| {例如：定价策略} | {例如：Pricing Strategy} | {例如：根据规则自动计算销售价格} | {例如：成本 × 1.5 + 运费} |
+| {术语} | {English} | {定义} | {示例} |
 
 ---
 
-## 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 |
+## 3. 架构层术语
+
+### 3.1 编排层（{例如：OpenClaw}）
+
+| 术语 | 英文 | 定义 |
+| :--- | :--- | :--- |
+| {例如：Commander} | {例如：Commander} | {例如：任务编排入口，负责接收指令并拆解为子任务} |
+| {例如：TaskGraph} | {例如：Task Graph} | {例如：DAG 形式的任务依赖关系图} |
+| {例如：Cron Schedule} | {例如：Cron Schedule} | {例如：定时触发的编排任务配置} |
+| {术语} | {English} | {定义} |
+
+### 3.2 专家层（{例如：agency-agents}）
+
+| 术语 | 英文 | 定义 |
+| :--- | :--- | :--- |
+| {例如：Agent} | {例如：Agent} | {例如：具备特定领域能力的 AI 智能体} |
+| {例如：Premium Agent} | {例如：Premium Agent} | {例如：商业版独占的高级 Agent} |
+| {例如：Community Agent} | {例如：Community Agent} | {例如：社区贡献的开源 Agent} |
+| {术语} | {English} | {定义} |
+
+### 3.3 执行层（{例如：OpenCLI}）
+
+| 术语 | 英文 | 定义 |
+| :--- | :--- | :--- |
+| {例如：Platform Adapter} | {例如：Platform Adapter} | {例如：对接具体电商平台 API 的适配器} |
+| {例如：Browser Pool} | {例如：Browser Pool} | {例如：管理 Chrome 实例的连接池} |
+| {术语} | {English} | {定义} |
+
+### 3.4 企业层（{Name} 独有，按需）
+
+| 术语 | 英文 | 定义 |
+| :--- | :--- | :--- |
+| {例如：Tenant} | {例如：Tenant} | {例如：多租户模式下的独立租户} |
+| {例如：RBAC} | {例如：Role-Based Access Control} | {例如：基于角色的权限控制体系} |
+| {例如：Audit Log} | {例如：Audit Log} | {例如：关键操作的审计日志} |
+| {术语} | {English} | {定义} |
 
 ---
 
-## 4. 技术术语（技术词）
+## 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 |
+| {例如：采集} | {例如：Scraping} | {例如：从源平台抓取商品信息} | {例如：选品} |
+| {例如：铺货} | {例如：Bulk Listing} | {例如：批量将商品发布到多个店铺} | {例如：上架} |
+| {例如：跟卖} | {例如：Follow Sell} | {例如：跟随热销商品上架同款} | {例如：选品} |
+| {术语} | {English} | {定义} | {阶段} |
 
 ---
 
-## 5. 一致性状态术语
+## 5. 平台与集成术语
 
-| 状态 | 中文 | 英文 | 颜色 | 说明 |
-| :--- | :--- | :--- | :--- | :--- |
-| ● 已同步 | Synced | Synced | 绿色 | 实例配置与基线完全一致 |
-| ● 已修改 | Modified | Modified | 黄色 | 实例配置已被修改，与基线有差异 |
-| ● 待下发 | Pending | Pending | 蓝色 | 下发任务已创建但未执行 |
-| ● 下发失败 | Failed | Failed | 红色 | 下发任务执行失败 |
-| ● 未纳管 | Unmanaged | Unmanaged | 灰色 | 实例未关联基线 |
+| 术语 | 英文 | 适用平台 | 定义 |
+| :--- | :--- | :--- | :--- |
+| {例如：店铺令牌} | {例如：Store Token} | {例如：淘宝/拼多多} | {例如：平台授权的 API 访问令牌} |
+| {例如：商品 SKU} | {例如：SKU} | {例如：通用} | {例如：库存管理的最小商品单位} |
+| {术语} | {English} | {平台} | {定义} |
 
 ---
 
-## 6. 版本演进术语
+## 6. 企业治理术语（按需）
 
-| 版本 | 定位 | 关键能力 | 主要产品词 |
+| 术语 | 英文 | 定义 | 适用版本 |
 | :--- | :--- | :--- | :--- |
-| **V1** | 易用 | 多实例管理、配置基线/模板/下发、渠道与模型、工作台；工作模式（任务卡片基础、我的助理、助理库、岗位包） | 基线、模板、实例分组、任务卡片、助理、岗位包、知识库 |
-| **V2** | 规模 | 资源中心、配置增强（审批/灰度/MCP）、RBAC、模型增强、接口扩展；工作模式（配置包 Spec、技能市场完整、Agent 对话界面交互、环境检查与 CLI 管理） | 资源中心、话术库、素材库、角色、审批流程、灰度策略、配置包、扩展市场 |
-| **V3** | 生态 | 数据分析、扩展市场（技能/MCP 商店）、多租户、接口扩展、通信终端、消息网络、Agent 角色市场、Agent 审计时间线；工作模式（回写飞书/钉钉、助理工坊、团队版、Generative UI） | 扩展市场、多租户、租户、配额、用量账单、通信终端、消息网络、助理工坊、Generative UI |
+| {例如：配额} | {例如：Quota} | {例如：租户可使用的资源上限} | {例如：👥 专业版+} |
+| {例如：白标} | {例如：White Label} | {例如：企业自定义品牌展示} | {例如：🏢 企业版} |
+| {术语} | {English} | {定义} | {版本} |
+
+---
+
+## 7. 版本与状态术语
+
+| 术语 | 定义 | 标记 |
+| :--- | :--- | :--- |
+| P0 | 必须实现，阻塞发布 | 🔴 |
+| P1 | 重要，影响核心体验 | 🟠 |
+| P2 | 期望，提升用户体验 | 🟡 |
+| P3 | 可选，低优先级增强 | 🟢 |
+| MVP | Minimum Viable Product，最小可行产品 | — |
+| GA | General Availability，正式发布 | — |
+| RC | Release Candidate，发布候选 | — |
+| LTS | Long-Term Support，长期支持 | — |
 
 ---
 
-## 7. 首字母缩略词表
+## 8. 首字母缩略词
 
-| 缩略词 | 全称 | 中文 |
+| 缩写 | 全称 | 说明 |
 | :--- | :--- | :--- |
-| **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 | 虚拟专用网络 |
+| {例如：DDD} | {例如：Domain-Driven Design} | {例如：领域驱动设计} |
+| {例如：COLA} | {例如：Clean Object-oriented and Layered Architecture} | {例如：菱形分层架构} |
+| {例如：CQRS} | {例如：Command Query Responsibility Segregation} | {例如：命令查询职责分离} |
+| {例如：RBAC} | {例如：Role-Based Access Control} | {例如：基于角色的访问控制} |
+| {例如：SLA} | {例如：Service Level Agreement} | {例如：服务等级协议} |
+| {缩写} | {全称} | {说明} |
 
 ---
 
-## 7. 参考文档
+## 9. 使用规则
 
-- [{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/)
+1. **新术语必须先在本文定义**，再在其他文档中引用
+2. **代码中的命名应与本表英文一致**：类名、变量名、API 路径均使用英文术语
+3. **UI 中的标签使用中文术语**：按钮、标题、提示文字使用本表中文定义
+4. **术语变更需同步更新**：修改本文后，须检查 Doc 7（领域模型）和 Doc 8（系统架构）的一致性
+5. **中英混排**：中文与英文/数字间加空格（如 `Agent 调度` 而非 `Agent调度`）
 
 ---
 
-**文档版本**：V1.0.0  
-**创建日期**：2026-02-25  
-**最后更新**：2026-02-25  
+**文档版本**：V1.0.0
+**创建日期**：{YYYY-MM-DD}
+**最后更新**：{YYYY-MM-DD}
 **文档状态**：✅ 待评审

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

@@ -1,620 +1,205 @@
 # {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  
+> **版本**：V1.0.0
+> **最后更新**：{YYYY-MM-DD}
 
 ---
 
 ## 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 总纲：多引擎策略与商业共识
+| 版本 | 日期 | 作者 | 变更说明 |
+| :--- | :--- | :--- | :--- |
+| V1.0.0 | {YYYY-MM-DD} | {姓名} | 初始版本 |
 
-与 [{Name}-命名与品牌说明](1、{Name}-命名与品牌说明.md)、[{Name}-产品与版本规划](6、{Name}-产品与版本规划.md) 对齐。
+### 1.2 关联文档
 
-- **市场背景**：AI Agent 爆发，但部署与多实例管理门槛高；{Name} 统一管理 OpenClaw / ZeroClaw / OctoClaw 🐙，降低选型与运维成本。
-- **目标用户细分**：没有技术能力的个人用户、小微企业负责人、轻量团队运营者；他们想用 Claw 引擎，但缺少安装、部署和日常运维能力。
-- **竞品参考**：OpenClaw 原生工具、各类教程/脚本代装服务、宝塔/Coolify 等低门槛运维工具；{Name} 差异化在于把复杂安装与运维流程做成普通人也能使用的产品。
-- **商业模式**：以 {Name} Desktop / {Name} Web 的订阅制为主，先卖“能装上、能管住、少出错”的基础能力；在此基础上补充少量轻量企业客户的进阶付费。
-- **用户增长策略**：先用免费版和低价订阅吸引不会折腾技术的个人与小微企业，再通过易用性、稳定性和省时间形成付费转化；对有明确组织需求的客户提供轻量企业方案。
+| 文档 | 关联说明 |
+| :--- | :--- |
+| [1、命名与品牌说明](1、{Name}-命名与品牌说明.md) | 产品边界与品牌定位 |
+| [5、技术方案与路线](5、{Name}-技术方案与路线.md) | 技术可行性约束 |
+| [6、产品与版本规划](6、{Name}-产品与版本规划.md) | 版本矩阵与定价策略 |
 
 ---
 
-## 2. 市场调研与机会 (Market Research & Opportunities)
+## 2. 市场机会判断
 
-### 2.1 当前市场判断
+### 2.1 问题定义
 
-- {Name} 所处的不是“企微客服”或 “SCRM” 市场，而是更窄的 **AI Agent / Claw 引擎安装、部署、纳管与运维控制平面**。
-- 当前最真实的需求不是“业务场景功能更多”，而是让 **没有技术能力的人也能把 OpenClaw / ZeroClaw / OctoClaw 真正装起来、管起来、回滚得了**。
-- 用户愿意付费的核心前提，是减少安装失败、看不懂配置、升级失控、排障困难，以及“找技术的人帮忙”带来的时间和金钱成本。
-- 因此，市场分析必须围绕 **控制平面、运维效率、治理能力、交付确定性** 展开，而不是把 {Name} 误写成客服、SCRM 或私域运营产品。
+{例如：中小电商卖家面临多平台运营效率低、人工成本高、合规风险大三大痛点。}
 
-### 2.2 三个成立的市场机会
+### 2.2 机会假设
 
-**机会 1：Claw 引擎从“会跑”到“可交付”之间存在明显断层**
-- OpenClaw / ZeroClaw / OctoClaw 的真实门槛不只在运行时，而在安装、环境检查、配置渲染、服务启动、健康检查、纳管与失败回滚。
-- 一旦用户从“想试试看”进入“我真的要把它跑起来帮我做事”，这个断层就会立刻暴露出来。
-- {Name} 的机会在于把零散脚本、命令行和人工排障，收敛成非技术用户也能理解和完成的标准化控制流程。
+- **机会 1**：{例如：AI Agent 替代重复性运营操作，效率提升 5–10 倍}
+- **机会 2**：{例如：跨平台统一管理减少工具碎片化}
+- **机会 3**：{例如：开源生态吸引开发者，形成社区壁垒}
+- **机会 4**：{例如：企业级治理需求催生 SaaS 付费意愿}
 
-**机会 2：小白用户与小微企业缺少“代替技术能力”的产品**
-- 教程、脚本和原生命令行默认要求用户具备环境、部署、日志和配置知识，这正是目标用户最缺的能力。
-- 通用运维工具虽然更图形化，但仍然要求用户理解服务器、容器、端口、反向代理等概念。
-- {Name} 的价值在于把技术复杂度封装起来，让用户更像在使用软件，而不是在做运维。
+> 数据来源：{例如：Statista 2025, 艾瑞咨询, 行业访谈}
 
-**机会 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)
+| TAM (Total Addressable Market) | {例如：全球电商 SaaS 工具市场} | {例如：$150B} | {例如：Gartner 2025} |
+| SAM (Serviceable Available Market) | {例如：AI 电商运营工具市场} | {例如：$8B} | {例如：CB Insights} |
+| SOM (Serviceable Obtainable Market) | {例如：中国 + 东南亚中小卖家} | {例如：$200M, 3 年目标} | {例如：行业估算} |
 
-### 6.1 商业模式画布（摘要）
+> **估算方法**：{例如：自下而上 = 目标用户数 × ARPU × 付费率}
 
-- **客户细分**：个人用户（开箱即用）、小微企业（低门槛上线与基础纳管）、少量轻量企业客户（标准化部署与基础支持）；中大型重交付客户不作为当前主线。
-- **价值主张**：让不会技术的个人、小微企业和轻量企业客户也能完成安装、基础纳管、健康检查与问题恢复；先解决“能用且少踩坑”，再逐步扩展更多平台能力。
-- **收入来源**：以个人版和专业版订阅为主，并辅以少量标准化企业版收入；增值服务与更高阶治理能力为后续补充。
-- **成本结构**：研发约 40%、销售约 20%、客服与成功支持约 20%、基础设施约 10%、内容与获客约 10%。
-
-### 6.2 定价策略
-
-**版本定价（摘要）**：
-
-| 版本 | 年付价格 | 主要对象 | 包含能力                                                                         |
-| :--- | :--- | :--- |:-----------------------------------------------------------------------------|
-| 个人版 | 99 元/年 | 个人用户 | 1 实例、30个智能体、多渠道、智能体 + 技能配置，其他能力需用户自行处理                                        |
-| 专业版 | 199 元/年 | 进阶个人用户 / 小微团队 | 多实例、多智能体、多渠道、无限智能体、智能体配置技能、自动化、24 小时智能客服 + 12 小时人工客服、在线问题解答                                               |
-| 企业版 | 599 元/年 | 小微企业 / 轻量企业客户 | 多平台（Web、Desktop）、多实例、多智能体、多渠道、无限智能体、智能体配置技能、自动化、24 小时智能客服 + 12 小时人工客服、在线问题解答 |
-
-**定价原则**：定价应足够低，先验证真实转化与留存，不预设过高 ARPU；强调“比自己折腾更省时间、比找人代装更便宜、比不用更容易落地”。**优惠策略**：默认年付、首购优惠、升级抵扣，可保留短期试用但不依赖复杂价格体系。
+---
 
-### 6.2.1 三档定价模型
+## 4. 目标客户
 
-{Name} 当前更适合采用 **简单、克制、对非技术用户友好** 的三档年费模型，而不是复杂的月付/季付/企业报价体系。
+### 4.1 按规模细分
 
-| 档位 | 价格 | 适用对象 | 核心说明 |
+| 客户类型 | 特征 | 痛点 | 付费意愿 |
 | :--- | :--- | :--- | :--- |
-| 个人版 | 99 元/年 | 想自己用起来的个人用户 | 适合单实例起步，满足“能装上、能跑起来、能继续用” |
-| 专业版 | 199 元/年 | 有更多自动化和多实例需求的个人 / 小团队 | 适合已经进入持续使用阶段，希望减少重复操作 |
-| 企业版 | 599 元/年 | 小微企业 / 轻量企业客户 | 适合需要 Web + Desktop、多实例协作、支持服务和问题解答的客户 |
-
-**能力边界理解**：
-- **个人版（99/年）**：解决“从不会装到能用上”的问题，给最基本但完整的可用体验。
-- **专业版（199/年）**：解决“从能用到更省事”的问题，强调多实例、自动化和更高上限。
-- **企业版（599/年）**：解决“小微企业持续使用和服务保障”的问题，强调多平台、客服支持与问题解答。
-
-### 6.2.2 定价口径冻结（执行优先级）
-
-- **当前文档口径**：个人版 `99 元/年`，专业版 `199 元/年`，企业版 `599 元/年`。
-- **对外默认口径**：在下一版商业化文档更新前，以本章为准。
-- **实验空间**：可测试试用期、限时折扣与升级优惠，但不建议重新引入过高或过复杂的定价体系。
+| {例如：个人卖家} | {例如：1-2 人，月 GMV <10 万} | {例如：时间不够，多平台切换} | {例如：低，偏免费/低价} |
+| {例如：小微团队} | {例如：3-10 人，月 GMV 10-100 万} | {例如：人效低，缺自动化} | {例如：中，¥99-299/月} |
+| {例如：中型企业} | {例如：10-50 人，月 GMV >100 万} | {例如：合规、审计、多账号管理} | {例如：高，¥999+/月} |
 
-### 6.2.3 通信平台定价模型（远期，不计入当前主口径）
+### 4.2 按场景细分
 
-当 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 商业与竞争风险
-
-| 风险 | 应对 |
-| :--- | :--- |
-| 获客成本高、客户流失率高、现金流紧张 | 优化转化、客户成功、合理融资与成本控制 |
-| 原生引擎或通用平台快速跟进 | 快速迭代、强化易用性、沉淀安装与恢复体验差异化 |
-| 竞品价格战 | 强调价值、差异化定价、提高切换成本 |
+| {例如：跨境电商} | {例如：Amazon/Shopee 卖家} | {例如：多语言上架、汇率定价} |
+| {例如：国内电商} | {例如：淘宝/拼多多卖家} | {例如：批量铺货、自动改价} |
+| {场景} | {画像} | {需求} |
 
 ---
 
-## 8. 附录 (Appendix)
-
-### 8.1 参考文档
+## 5. 竞品分析
 
-- [1、{Name}-产品与版本规划](6、{Name}-产品与版本规划.md)
-- [6、{Name}-系统架构设计](8、{Name}-系统架构设计.md)
-- [7、{Name}-技术方案与路线](5、{Name}-技术方案与路线.md)
-- 历史调研归档文档（非主线）
-- 技术调研/OpenClaw-商业化路径评估.md
+### 5.1 竞品类型
 
-### 8.2 数据与假设来源
+| 类型 | 代表产品 | 与 {Name} 关系 |
+| :--- | :--- | :--- |
+| {例如：传统 ERP} | {例如：聚水潭、旺店通} | {例如：互补（ERP 管库存，{Name} 管运营）} |
+| {例如：AI 运营工具} | {例如：DataHunter, 店小蜜} | {例如：直接竞争} |
+| {例如：开源自动化} | {例如：n8n, Dify} | {例如：通用竞争（非电商专用）} |
 
-- 市场规模：企业微信官网与财报、艾瑞/易观/IDC；竞品官网与行业报告。
-- 财务假设：客户留存率、ARPU、渗透率、LTV/CAC 等见原商业计划文档。
+### 5.2 对比矩阵
 
----
+```mermaid
+quadrantChart
+    title 竞品定位矩阵
+    x-axis "通用" --> "电商专用"
+    y-axis "手动配置" --> "AI 自动化"
+    "聚水潭": [0.8, 0.2]
+    "n8n": [0.2, 0.5]
+    "店小蜜": [0.7, 0.6]
+    "{Name}": [0.9, 0.9]
+```
 
-**文档版本**：V1.3.0  
-**创建时间**：2026-02-21  
-**最后更新**：2026-03-09  
-**文档状态**：✅ 完成
+### 5.3 竞品功能矩阵
 
+| 能力 | {Name} | {例如：竞品 A} | {例如：竞品 B} | {例如：竞品 C} |
+| :--- | :---: | :---: | :---: | :---: |
+| {例如：多平台支持} | ✅ | ⚠️ | ✅ | ❌ |
+| {例如：AI Agent 编排} | ✅ | ❌ | ⚠️ | ❌ |
+| {例如：开源可自部署} | ✅ | ❌ | ❌ | ✅ |
+| {例如：企业级 RBAC} | ✅ | ✅ | ❌ | ❌ |
+| {能力} | — | — | — | — |
 
 ---
 
-## 附录 A：产品调研（legacy `1、产品调研模板.md` 全文）
-
+## 6. SWOT 分析
 
-> **文档说明**：
-> - 本文档是产品调研阶段的产出物，用于记录市场调研、用户调研、竞品分析等信息
-> - 通过调研收集信息，为产品定位和需求分析提供依据
-> - `{}` 包裹的内容为占位符，请替换为实际内容
-> - 引用块 `>` 中的文字为填写指导，填写后可删除
+| | 有利 | 不利 |
+| :--- | :--- | :--- |
+| **内部** | **Strengths**<br/>- {例如：开源生态获客成本低}<br/>- {例如：AI Agent 技术壁垒}<br/>- {例如：多平台执行层成熟} | **Weaknesses**<br/>- {例如：团队规模小}<br/>- {例如：品牌知名度不足}<br/>- {例如：企业级功能尚不完整} |
+| **外部** | **Opportunities**<br/>- {例如：AI 电商赛道快速增长}<br/>- {例如：中小卖家降本需求强烈}<br/>- {例如：竞品缺乏开源方案} | **Threats**<br/>- {例如：大厂入场（如阿里/字节）}<br/>- {例如：平台 API 政策变化}<br/>- {例如：开源竞品模仿} |
 
 ---
 
-## 1. 文档信息 (Document Info)
+## 7. 商业模式与定价
 
-### 1.1 版本记录
-| 版本号 | 修改日期 | 修改人 | 修改内容 | 备注 |
-| :--- | :--- | :--- | :--- | :--- |
-| V1.0.0 | {YYYY-MM-DD} | {姓名} | 初始版本 | - |
+### 7.1 商业模式画布
 
-### 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亿元}
+| 价值主张 | {例如：AI 驱动的电商全自动运营} |
+| 客户关系 | {例如：开源社区 → 免费用户 → 付费转化} |
+| 渠道 | {例如：GitHub、技术社区、KOL 推广} |
+| 关键资源 | {例如：AI 模型、平台 Adapter、社区} |
+| 收入来源 | {例如：订阅 + 增值 + 企业定制} |
 
-**市场趋势**：
-- {例如：XXX应用需求增长}
-- {例如：数据化运营成为趋势}
-- {例如：智能化服务管理需求增加}
+### 7.2 定价方案
 
-### 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年}
+| 档位 | 标签 | 月价 | 核心权益 |
+| :--- | :--- | :--- | :--- |
+| 免费版 | 🆓 Free | ¥0 | {例如：3 个 Agent、1 个店铺、社区支持} |
+| 个人版 | 👤 Pro | {例如：¥99} | {例如：10 个 Agent、5 个店铺、邮件支持} |
+| 专业版 | 👥 Team | {例如：¥299} | {例如：无限 Agent、20 个店铺、优先支持} |
+| 企业版 | 🏢 Enterprise | {例如：议价} | {例如：私有部署、RBAC、SLA、专属顾问} |
 
-**使用场景**：
-- **时间**：每天上午9:00-12:00，下午2:00-6:00
-- **地点**：门店办公室
-- **设备**：手机（iPhone 12）
-- **主要任务**：
-  1. 查看待接单订单，决定是否指派师傅
-  2. 查看门店运营数据，了解经营状况
-  3. 处理客户投诉，协调师傅工作
+### 7.3 增值收入
 
-**痛点**：
-- {例如：订单处理效率低，经常出现订单遗漏}
-- {例如：无法实时掌握订单状态，需要频繁刷新}
-- {例如：数据统计不准确，影响决策}
+- {例如：Premium Agent 市场（按 Agent 付费）}
+- {例如：数据分析增值包}
+- {例如：API 调用量计费}
 
-**期望**：
-- {例如：能够快速查看和处理订单}
-- {例如：能够实时掌握订单状态}
-- {例如：能够准确统计门店运营数据}
+### 7.4 开源转商业漏斗
 
+```mermaid
 ---
-
-### 3.3 用户访谈
-> 记录用户访谈的详细内容
-
-#### 访谈1：{例如：门店老板 - 张总}
-
-**访谈时间**：{YYYY-MM-DD HH:mm}  
-**访谈地点**：{门店办公室}  
-**访谈人员**：{产品经理 - 张三}  
-**访谈对象**：{门店老板 - 张总}
-
-**访谈问题**：
-1. **Q：您平时是如何处理订单的？**
-   - A：{我每天上午9点打开系统，查看待接单订单，根据订单信息决定是指派师傅还是等待师傅抢单。}
-
-2. **Q：您在订单处理过程中遇到的最大问题是什么？**
-   - A：{订单处理效率低，经常出现订单遗漏。有时候订单太多，我看不过来，就会漏掉一些订单。}
-
-3. **Q：您希望系统能够提供什么功能来帮助您？**
-   - A：{希望能够快速查看订单，能够实时掌握订单状态，能够准确统计门店运营数据。}
-
-**关键发现**：
-- {订单处理效率低是主要痛点}
-- {实时掌握订单状态是核心需求}
-- {数据统计准确性很重要}
-
+config:
+  sankey:
+    showValues: false
 ---
-
-### 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%}
-
-#### 关键发现
-- {订单处理效率低是普遍问题}
-- {订单实时提醒是核心需求}
-- {系统满意度较低，需要改进}
+sankey-beta
+    GitHub Star,开源用户,1000
+    开源用户,免费注册,400
+    免费注册,活跃使用,200
+    活跃使用,付费转化,40
+    付费转化,企业版,8
+```
 
 ---
 
-## 4. 竞品分析 (Competitive Analysis)
+## 8. 风险与应对
 
-### 4.1 竞品选择
-> 选择分析的竞品
+### 8.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元/月，定制功能}
-
----
+### 8.2 技术风险
 
-## 6. 调研结论 (Research Conclusions)
-
-### 6.1 关键发现
-> 总结调研的关键发现
-
-1. **市场机会明确**
-   - {例如：市场规模大，增长趋势明显}
-   - {例如：现有产品存在改进空间}
-
-2. **用户需求强烈**
-   - {例如：用户痛点明确，需求强烈}
-   - {例如：用户愿意为优质产品付费}
-
-### 6.2 产品建议
-> 基于调研结果提出产品建议
-
-**产品定位建议**：
-- {例如：面向中小型门店的XXX应用}
-- {例如：帮助门店提升运营效率和服务质量}
+| 风险 | 影响 | 概率 | 应对措施 |
+| :--- | :--- | :--- | :--- |
+| {例如：平台 API 限制/封号} | 高 | 中 | {例如：多通道降级、浏览器 fallback} |
+| {例如：AI 模型成本过高} | 中 | 中 | {例如：本地模型 + 缓存策略} |
 
-**功能优先级建议**：
-- **P0（必须做）**：{例如：订单管理、数据统计}
-- **P1（应该做）**：{例如：实时提醒、订单距离}
-- **P2（可以做）**：{例如：高级分析、定制功能}
+### 8.3 商业风险
 
-**差异化建议**：
-- {例如：结合订单指派和抢单功能}
-- {例如：优化订单距离显示}
-- {例如：完善数据统计}
+| 风险 | 影响 | 概率 | 应对措施 |
+| :--- | :--- | :--- | :--- |
+| {例如：付费转化率低于预期} | 高 | 中 | {例如：优化 onboarding、增加试用期} |
+| {例如：客户流失率过高} | 中 | 低 | {例如：增值功能锁定、社区粘性} |
 
 ---
 
-## 7. 附录 (Appendix)
+## 9. 里程碑与关键指标
 
-### 7.1 调研材料
-> 列出调研使用的材料
-
-- **市场调研报告**：{市场调研报告文件}
-- **用户访谈提纲**：{访谈提纲文件}
-- **问卷调查表**：{问卷文件}
-- **竞品分析报告**：{竞品分析文件}
-
-### 7.2 参考文档
-> 列出参考的相关文档
-
-- [需求调研模板](2、需求调研模板.md)
-- [技术调研模板](3、技术调研模板.md)
-- [需求分析模板](4、需求分析模板.md)
-- [PRD文档模板](5、PRD文档模板.md)
-
-### 7.3 变更记录
-> 记录调研变更的历史
-
-| 变更日期 | 变更内容 | 变更原因 | 变更人 |
-| :--- | :--- | :--- | :--- |
-| {YYYY-MM-DD} | {变更内容描述} | {变更原因} | {姓名} |
+| 里程碑 | 时间 | 关键指标 |
+| :--- | :--- | :--- |
+| {例如：开源版发布} | {例如：2026 Q2} | {例如：GitHub Stars >500, 周活 >100} |
+| {例如：商业版 Beta} | {例如：2026 Q3} | {例如：付费用户 >50, MRR >¥10K} |
+| {例如：商业版 GA} | {例如：2026 Q4} | {例如：付费用户 >200, MRR >¥50K} |
+| {里程碑} | {时间} | {指标} |
 
 ---
 
-**文档版本**：V1.0.0  
-**创建时间**：{YYYY-MM-DD}  
-**最后更新**：{YYYY-MM-DD}  
-**文档状态**：✅ 调研中 / ✅ 调研完成 / ✅ 待分析 / ✅ 已完成
+**文档版本**：V1.0.0
+**创建日期**：{YYYY-MM-DD}
+**最后更新**：{YYYY-MM-DD}
+**文档状态**：✅ 待评审

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

@@ -1,209 +1,231 @@
 # {Name} 技术与可行性分析
 
-> **标准说明**：本文由 原「技术调研」模板 **节选**（§1 文档信息、§3 可行性、§5 优劣势与风险、§6 验证）。选型对比、方案建议见 `5、{Name}-技术方案与路线.md`。完整过程稿建议落盘到仓库 `技术调研/` 目录。
+> **文档说明**：分析技术成熟度、实现成本、安全合规与性能扩展性，为技术方案与架构设计提供决策依据。按产品分层逐一评估可行性。
+>
+> **版本**：V1.0.0
+> **最后更新**：{YYYY-MM-DD}
 
 ---
 
+## 1. 文档信息
 
-> **文档说明**：
-> - 本文档是技术调研阶段的产出物，用于记录技术选型、技术可行性分析、技术对比等信息
-> - 通过技术调研，为技术方案设计和架构设计提供依据
-> - `{}` 包裹的内容为占位符，请替换为实际内容
-> - 引用块 `>` 中的文字为填写指导，填写后可删除
-
----
+### 1.1 版本记录
 
-## 1. 文档信息 (Document Info)
+| 版本 | 日期 | 作者 | 变更说明 |
+| :--- | :--- | :--- | :--- |
+| V1.0.0 | {YYYY-MM-DD} | {姓名} | 初始版本 |
 
-### 1.1 版本记录
-| 版本号 | 修改日期 | 修改人 | 修改内容 | 备注 |
-| :--- | :--- | :--- | :--- | :--- |
-| V1.0.0 | {YYYY-MM-DD} | {姓名} | 初始版本 | - |
+### 1.2 关联文档
 
-### 1.2 调研信息
-| 项目 | 内容 |
+| 文档 | 关联说明 |
 | :--- | :--- |
-| 调研时间 | {YYYY-MM-DD} ~ {YYYY-MM-DD} |
-| 调研人员 | {姓名1}、{姓名2} |
-| 调研对象 | {技术栈、框架、工具等} |
-| 调研方式 | {技术调研 / 技术对比 / 技术验证 / POC验证 / 技术评估} |
+| [3、市场与商业分析](3、{Name}-市场与商业分析.md) | 市场机会与商业约束 |
+| [5、技术方案与路线](5、{Name}-技术方案与路线.md) | 技术选型与实施方案 |
+| [8、系统架构设计](8、{Name}-系统架构设计.md) | 架构设计承接 |
 
-### 1.3 文档责任人
-| 角色 | 姓名 | 职责 |
-| :--- | :--- | :--- |
-| 技术负责人 | {姓名} | 技术方案评审、技术可行性评估 |
-| 架构师 | {姓名} | 架构设计、技术选型 |
-| 开发负责人 | {姓名} | 技术调研、技术验证 |
+### 1.3 评估标准
 
----
+| 等级 | 图标 | 定义 |
+| :--- | :---: | :--- |
+| 高可行 | ✅ | 技术成熟、团队有经验、风险可控 |
+| 中可行 | ⚠️ | 技术可用但需额外投入或验证 |
+| 低可行 | 🔴 | 技术不成熟或风险过高，需替代方案 |
 
-## 3. 技术可行性分析 (Technology Feasibility)
+---
 
-### 3.1 技术成熟度评估
+## 2. 编排层可行性（{例如：OpenClaw}）
 
-**成熟技术**：
-- {例如：Vue 3.0、Element Plus、Spring Boot等技术成熟，社区活跃}
-- {例如：MySQL、Redis等数据库技术成熟稳定}
-- {例如：Docker、Kubernetes等容器技术广泛应用}
+### 2.1 评估结论：✅ 高可行
 
-**新兴技术**：
-- {例如：UniApp-x相对较新，但基于Vue 3.0，技术栈成熟}
-- {例如：AI相关技术快速发展，需要持续关注}
+| 维度 | 评估 | 说明 |
+| :--- | :---: | :--- |
+| 技术成熟度 | ✅ | {例如：已有生产环境验证，稳定运行 6+ 月} |
+| 团队适配度 | ✅ | {例如：核心团队为框架原作者} |
+| 业务适配度 | ✅ | {例如：任务编排、DAG 调度完全匹配需求} |
 
-**技术风险**：
-- {例如：新技术可能存在兼容性问题}
-- {例如：第三方组件库可能存在维护风险}
-- {例如：微服务架构复杂度较高，需要团队具备相应能力}
+### 2.2 关键技术点
 
----
+- {例如：任务拆解（Divide & Conquer）}
+- {例如：状态机管理（Plan → Execute → Review → Finalize）}
+- {例如：多 Agent 并行调度}
 
-### 3.2 团队能力评估
+```mermaid
+flowchart TD
+    CMD["Commander<br/>接收指令"] --> PLAN["Plan<br/>任务拆解"]
+    PLAN --> EXEC["Execute<br/>Agent 执行"]
+    EXEC --> REV["Review<br/>结果审查"]
+    REV -->|通过| FIN["Finalize<br/>完成"]
+    REV -->|失败| RETRY["Retry<br/>重试/降级"]
+    RETRY --> EXEC
+```
 
-**团队技术栈熟悉度**：
-- **前端团队**：
-  - Vue 3.0：{例如：团队熟悉Vue技术栈，能够快速上手}
-  - Element Plus：{例如：团队有使用经验，学习成本低}
-  - UniApp-x：{例如：团队有UniApp经验，迁移成本低}
+---
 
-- **后端团队**：
-  - Spring Boot：{例如：团队熟悉Spring Boot，开发效率高}
-  - Spring Cloud：{例如：团队有微服务经验，能够快速上手}
-  - MyBatis-Plus：{例如：团队熟悉MyBatis，学习成本低}
+## 3. 专家层可行性（{例如：agency-agents}）
 
-**团队能力缺口**：
-- {例如：需要加强微服务架构设计能力}
-- {例如：需要提升AI技术应用能力}
-- {例如：需要加强DevOps能力}
+### 3.1 评估结论：✅ 高可行
 
-**培训计划**：
-- {例如：组织技术分享会，提升团队技术能力}
-- {例如：安排技术培训，补充能力缺口}
+| 维度 | 评估 | 说明 |
+| :--- | :---: | :--- |
+| 技术成熟度 | ✅ | {例如：LLM 调用链成熟，Prompt 模板体系完善} |
+| 团队适配度 | ✅ | {例如：团队有 AI 工程经验} |
+| 业务适配度 | ⚠️ | {例如：部分垂直场景 Agent 需要行业数据训练} |
 
----
+### 3.2 Agent 技术栈
 
-### 3.3 开发成本评估
-
-**开发时间**：
-- **前端开发**：{例如：预计X个月}
-- **后端开发**：{例如：预计X个月}
-- **测试**：{例如：预计X个月}
-- **总计**：{例如：预计X个月}
+| 组件 | 技术 | 说明 |
+| :--- | :--- | :--- |
+| {例如：LLM 调用} | {例如：OpenAI API / 本地 Ollama} | {例如：可切换模型} |
+| {例如：Prompt 管理} | {例如：Template + Few-shot} | {例如：版本化管理} |
+| {例如：工具调用} | {例如：Function Calling} | {例如：平台 API 映射} |
 
-**人力成本**：
-- **前端开发**：{例如：X人}
-- **后端开发**：{例如：X人}
-- **测试**：{例如：X人}
-- **总计**：{例如：X人}
+### 3.3 Agent 分级体系
 
-**技术成本**：
-- **开发工具**：{例如：IDE、开发工具等，成本可控}
-- **第三方服务**：{例如：云服务、AI服务等，按需付费}
-- **基础设施**：{例如：服务器、数据库等，成本可控}
+| 级别 | 来源 | 质量保证 | 可用范围 |
+| :--- | :--- | :--- | :--- |
+| {例如：Core Agent} | {例如：官方开发} | {例如：全量测试 + SLA} | {例如：全版本} |
+| {例如：Premium Agent} | {例如：官方 + 合作伙伴} | {例如：审核 + 测试} | {例如：商业版} |
+| {例如：Community Agent} | {例如：社区贡献} | {例如：社区评分} | {例如：开源版} |
 
 ---
 
-### 3.4 维护成本评估
+## 4. 执行层可行性（{例如：OpenCLI}）
 
-**技术维护**：
-- {例如：使用主流技术，维护成本较低}
-- {例如：技术栈成熟，社区支持好，问题解决快}
-- {例如：文档完善，新人上手快}
+### 4.1 评估结论：✅ 高可行
 
-**运维成本**：
-- {例如：容器化部署，运维成本较低}
-- {例如：监控告警完善，问题发现快}
-- {例如：自动化程度高，人工干预少}
+| 维度 | 评估 | 说明 |
+| :--- | :---: | :--- |
+| 技术成熟度 | ✅ | {例如：CLI + Adapter 模式已验证} |
+| 团队适配度 | ✅ | {例如：团队有 Puppeteer/Playwright 经验} |
+| 业务适配度 | ⚠️ | {例如：平台 API 变更频繁，需持续维护} |
 
-**升级成本**：
-- {例如：技术栈版本升级成本可控}
-- {例如：向后兼容性好，升级风险低}
+### 4.2 平台接入验证
 
----
+| 平台 | 接入方式 | 验证状态 | 备注 |
+| :--- | :--- | :---: | :--- |
+| {例如：淘宝} | {例如：开放 API + 浏览器} | ✅ | {例如：需商家授权} |
+| {例如：拼多多} | {例如：开放 API} | ✅ | {例如：API 限流较严} |
+| {例如：Amazon} | {例如：SP-API + MWS} | ⚠️ | {例如：需 Developer 注册} |
+| {平台} | {方式} | — | {备注} |
 
-## 5. 技术优势与风险 (Technology Advantages & Risks)
+### 4.3 浏览器控制方案
 
-### 5.1 技术优势
+```mermaid
+sequenceDiagram
+    participant Agent
+    participant CLI as OpenCLI
+    participant Browser as Chrome Pool
+    participant Platform as 电商平台
 
-**前端技术优势**：
-- {例如：Vue 3.0性能优秀，生态完善}
-- {例如：Element Plus组件丰富，开发效率高}
-- {例如：UniApp-x跨平台支持好，一套代码多端运行}
+    Agent->>CLI: 执行操作指令
+    CLI->>Browser: 获取 Chrome 实例
+    Browser->>Platform: 模拟用户操作
+    Platform-->>Browser: 返回页面结果
+    Browser-->>CLI: 解析结果
+    CLI-->>Agent: 返回结构化数据
+```
 
-**后端技术优势**：
-- {例如：Spring Cloud微服务架构，支持高并发和水平扩展}
-- {例如：MyBatis-Plus功能增强，开发效率高}
-- {例如：Redis高性能缓存，支持多种数据结构}
+---
 
-**基础设施优势**：
-- {例如：Docker容器化，部署标准化}
-- {例如：Kubernetes容器编排，支持自动扩缩容}
-- {例如：Prometheus监控，问题发现快}
+## 5. 企业层可行性（{Name} 独有，按需）
+
+### 5.1 评估结论：✅ 高可行
+
+| 维度 | 评估 | 说明 |
+| :--- | :---: | :--- |
+| 技术成熟度 | ✅ | {例如：多租户、RBAC 为成熟模式} |
+| 团队适配度 | ⚠️ | {例如：需补充 SaaS 运营经验} |
+| 业务适配度 | ✅ | {例如：企业客户明确需要审计与权限} |
+
+### 5.2 多租户隔离方案
+
+```mermaid
+flowchart TD
+    subgraph "租户 A"
+        A_DB[(DB Schema A)]
+        A_Agent["Agent Pool A"]
+    end
+    subgraph "租户 B"
+        B_DB[(DB Schema B)]
+        B_Agent["Agent Pool B"]
+    end
+    GW["API Gateway"] --> A_Agent
+    GW --> B_Agent
+    A_Agent --> A_DB
+    B_Agent --> B_DB
+```
+
+| 隔离策略 | 优点 | 缺点 | 推荐场景 |
+| :--- | :--- | :--- | :--- |
+| {例如：Schema 级隔离} | {例如：成本低，迁移简单} | {例如：大租户可能有噪声邻居} | {例如：专业版} |
+| {例如：Database 级隔离} | {例如：完全隔离} | {例如：运维成本高} | {例如：企业版} |
+
+### 5.3 RBAC 角色矩阵
+
+| 角色 | 查看 | 编辑 | 管理 Agent | 管理团队 | 审计日志 |
+| :--- | :---: | :---: | :---: | :---: | :---: |
+| {例如：Owner} | ✅ | ✅ | ✅ | ✅ | ✅ |
+| {例如：Admin} | ✅ | ✅ | ✅ | ✅ | ❌ |
+| {例如：Operator} | ✅ | ✅ | ✅ | ❌ | ❌ |
+| {例如：Viewer} | ✅ | ❌ | ❌ | ❌ | ❌ |
 
 ---
 
-### 5.2 技术风险
+## 6. 安全与合规可行性
 
-**技术风险**：
-1. **新技术风险**
-   - {例如：新技术可能存在兼容性问题}
-   - **应对策略**：{例如：进行POC验证，充分测试}
+### 6.1 评估结论：⚠️ 中可行（需持续建设）
 
-2. **第三方依赖风险**
-   - {例如：第三方组件库可能存在维护风险}
-   - **应对策略**：{例如：选择成熟稳定的组件库，关注社区动态}
+| 安全维度 | 现状 | 目标 | 差距 |
+| :--- | :--- | :--- | :--- |
+| {例如：数据加密} | {例如：传输 TLS 已实现} | {例如：静态 AES-256} | {例如：存储加密待实现} |
+| {例如：凭证管理} | {例如：环境变量} | {例如：Vault/KMS} | {例如：需引入密钥管理} |
+| {例如：审计} | {例如：无} | {例如：全操作审计} | {例如：需新建审计模块} |
+| {例如：合规认证} | {例如：无} | {例如：SOC2 / 等保} | {例如：V3.0 启动} |
 
-3. **架构复杂度风险**
-   - {例如：微服务架构复杂度较高，需要团队具备相应能力}
-   - **应对策略**：{例如：加强团队培训，引入架构师指导}
+---
 
-4. **性能风险**
-   - {例如：高并发场景下可能存在性能瓶颈}
-   - **应对策略**：{例如：进行性能测试，优化关键路径}
+## 7. 性能与扩展性评估
 
-5. **安全风险**
-   - {例如：新技术可能存在安全漏洞}
-   - **应对策略**：{例如：关注安全公告，及时更新版本}
+| 维度 | 目标 | 当前能力 | 差距 | 优化方向 |
+| :--- | :--- | :--- | :--- | :--- |
+| {例如：并发 Agent} | {例如：100 并发/租户} | {例如：10 并发} | {例如：10×} | {例如：Worker Pool + 队列} |
+| {例如：API 响应} | {例如：P99 < 500ms} | {例如：P99 ~800ms} | {例如：优化 DB 查询} | {例如：索引 + 缓存} |
+| {例如：存储扩展} | {例如：TB 级} | {例如：GB 级} | {例如：需分片} | {例如：对象存储 + 归档} |
 
 ---
 
-## 6. 技术验证 (Technology Validation)
-
-### 6.1 POC验证
-
-**验证目标**：
-- {例如：验证技术选型的可行性}
-- {例如：验证关键功能的实现方案}
-- {例如：验证性能是否满足需求}
+## 8. 技术风险总表
 
-**验证内容**：
-1. **前端POC**
-   - {例如：验证Vue 3.0 + Element Plus的集成}
-   - {例如：验证UniApp-x的跨平台能力}
-   - {例如：验证关键组件的性能}
+| # | 风险描述 | 影响 | 概率 | 缓解措施 | 负责人 |
+| :---: | :--- | :---: | :---: | :--- | :--- |
+| R1 | {例如：平台 API 限流导致任务堆积} | 高 | 中 | {例如：限流降级 + 队列缓冲} | {姓名} |
+| R2 | {例如：LLM 调用成本超预算} | 中 | 高 | {例如：本地模型 fallback + Token 缓存} | {姓名} |
+| R3 | {例如：浏览器指纹被平台识别} | 高 | 中 | {例如：指纹随机化 + IP 轮换} | {姓名} |
+| R4 | {例如：多租户数据泄露} | 高 | 低 | {例如：Schema 隔离 + 行级安全} | {姓名} |
+| RN | {风险} | — | — | {措施} | {姓名} |
 
-2. **后端POC**
-   - {例如：验证Spring Cloud微服务架构}
-   - {例如：验证Redis缓存性能}
-   - {例如：验证消息队列的可靠性}
+---
 
-**验证结果**：
-- {例如：技术选型可行，满足项目需求}
-- {例如：性能满足要求，无明显瓶颈}
-- {例如：开发效率高，学习成本低}
+## 9. 结论
 
----
+### 9.1 总体评估
 
-### 6.2 性能测试
+| 层级 | 可行性 | 核心优势 | 主要风险 |
+| :--- | :---: | :--- | :--- |
+| 编排层 | ✅ | {例如：成熟引擎，团队自研} | {例如：状态机复杂度} |
+| 专家层 | ✅ | {例如：LLM 能力成熟} | {例如：领域 Agent 需持续训练} |
+| 执行层 | ✅ | {例如：多平台 Adapter 验证} | {例如：平台 API 变更频繁} |
+| 企业层 | ✅ | {例如：多租户模式成熟} | {例如：安全合规需持续投入} |
 
-**测试场景**：
-- {例如：高并发场景测试}
-- {例如：大数据量场景测试}
-- {例如：长时间运行稳定性测试}
+### 9.2 建议
 
-**测试结果**：
-- {例如：QPS达到X，满足需求}
-- {例如：响应时间在Xms以内，满足要求}
-- {例如：系统稳定运行X小时，无异常}
+1. {例如：V1.0 优先交付编排层 + 执行层，专家层使用 Core Agent}
+2. {例如：V2.0 补齐企业层 RBAC + 审计}
+3. {例如：安全合规作为持续性投入，V3.0 前完成等保/SOC2 基线}
 
 ---
 
+**文档版本**：V1.0.0
+**创建日期**：{YYYY-MM-DD}
+**最后更新**：{YYYY-MM-DD}
+**文档状态**：✅ 待评审

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

@@ -1,495 +1,361 @@
 # {Name} 技术方案与路线
 
-> **标准说明**：本文由 原「技术调研」模板 **节选**（§2 选型、§4 对比、§7 方案建议、§8 附录）。可行性分析见 `4、{Name}-技术与可行性分析.md`。
+> **文档说明**：沉淀技术选型结论、分层方案设计、关键组件细节、ADR 决策记录与里程碑路线。为系统架构设计和版本研发提供技术基线。
+>
+> **版本**：V1.0.0
+> **最后更新**：{YYYY-MM-DD}
 
 ---
 
+## 1. 文档信息
 
-> **文档说明**：
-> - 本文档是技术调研阶段的产出物，用于记录技术选型、技术可行性分析、技术对比等信息
-> - 通过技术调研，为技术方案设计和架构设计提供依据
-> - `{}` 包裹的内容为占位符，请替换为实际内容
-> - 引用块 `>` 中的文字为填写指导，填写后可删除
-
----
+### 1.1 版本记录
 
-## 1. 文档信息 (Document Info)
+| 版本 | 日期 | 作者 | 变更说明 |
+| :--- | :--- | :--- | :--- |
+| V1.0.0 | {YYYY-MM-DD} | {姓名} | 初始版本 |
 
-### 1.1 版本记录
-| 版本号 | 修改日期 | 修改人 | 修改内容 | 备注 |
-| :--- | :--- | :--- | :--- | :--- |
-| V1.0.0 | {YYYY-MM-DD} | {姓名} | 初始版本 | - |
+### 1.2 关联文档
 
-### 1.2 调研信息
-| 项目 | 内容 |
+| 文档 | 关联说明 |
 | :--- | :--- |
-| 调研时间 | {YYYY-MM-DD} ~ {YYYY-MM-DD} |
-| 调研人员 | {姓名1}、{姓名2} |
-| 调研对象 | {技术栈、框架、工具等} |
-| 调研方式 | {技术调研 / 技术对比 / 技术验证 / POC验证 / 技术评估} |
-
-### 1.3 文档责任人
-| 角色 | 姓名 | 职责 |
-| :--- | :--- | :--- |
-| 技术负责人 | {姓名} | 技术方案评审、技术可行性评估 |
-| 架构师 | {姓名} | 架构设计、技术选型 |
-| 开发负责人 | {姓名} | 技术调研、技术验证 |
+| [4、技术与可行性分析](4、{Name}-技术与可行性分析.md) | 可行性评估结论 |
+| [6、产品与版本规划](6、{Name}-产品与版本规划.md) | 版本节奏对齐 |
+| [8、系统架构设计](8、{Name}-系统架构设计.md) | 架构设计承接 |
 
 ---
 
+## 2. 技术选型总览
 
-## 2. 技术选型 (Technology Selection)
-
-### 2.1 前端技术栈
-
-#### 2.1.1 管理后台技术选型
-
-**前端框架候选方案**：
-
-1. **LayUI of Vue 3.0**
-   - 官方地址：https://www.layui-vue.com/zh-CN/index
-   - 使用指南：https://www.layui-vue.com/zh-CN/guide/introduce
-   - 组件文档：https://www.layui-vue.com/zh-CN/components
-   - 后台模板：https://gitee.com/lunarlanding/layui-vue-admin
-   - Github: https://github.com/layui-vue/layui-vue
-   - **特点**：{例如：基于Vue 3.0，组件丰富，提供后台模板}
-
-2. **Ant Design of React**
-   - 官方地址：https://4x-ant-design.antgroup.com/index-cn
-   - 使用指南：https://4x-ant-design.antgroup.com/docs/react/introduce-cn
-   - 组件文档：https://4x-ant-design.antgroup.com/components/overview-cn/
-   - 后台模板：https://pro.ant.design/zh-CN/docs/overview
-   - Github: https://github.com/ant-design/ant-design/
-   - **特点**：{例如：企业级UI设计语言，组件完善，生态庞大}
-
-3. **Bootstrap of Vue 3.0**
-   - 官方地址：https://bootstrap-vue.org
-   - 使用指南：https://bootstrap-vue.org/docs
-   - 组件文档：https://bootstrap-vue.org/docs/components
-   - Github: https://github.com/bootstrap-vue/bootstrap-vue
-   - **特点**：{例如：基于Bootstrap，响应式设计，组件丰富}
-
-4. **Element Plus of Vue 3.0** ✅ **推荐选择**
-   - 官方地址：https://element-plus.org/zh-CN/
-   - 使用指南：https://element-plus.org/en-US/guide/design
-   - 组件文档：https://element-plus.org/en-US/component/overview
-   - Github: https://github.com/element-plus/element-plus
-   - **选择理由**：{例如：组件丰富、文档完善、社区活跃、Vue 3.0性能优秀、团队熟悉}
-
-**状态管理候选方案**：
-
-1. **Vuex of Vue 2.0**
-   - 官方地址：https://vuex.vuejs.org/zh/
-   - 使用指南：https://vuex.vuejs.org/zh/guide/
-   - API文档：https://vuex.vuejs.org/zh/api/
-   - VUE3兼容：https://vuex.vuejs.org/zh/guide/migrating-to-4-0-from-3-x.html
-   - **特点**：{例如：Vue 2.0官方状态管理，成熟稳定，但Vue 3.0推荐使用Pinia}
-
-2. **Pinia of Vue 3.0** ✅ **推荐选择**
-   - 官方地址：https://pinia.vuejs.org/
-   - 使用指南：https://pinia.vuejs.org/core-concepts/
-   - API文档：https://pinia.vuejs.org/api/
-   - **选择理由**：{例如：Vue 3.0官方推荐、TypeScript支持好、API简洁、性能优秀}
-
-**样式预处理**：
-- **Dart Sass** ✅ **推荐选择**
-  - 官方地址：https://sass-lang.com/dart-sass/
-  - 使用指南：https://sass-lang.com/install/
-  - API文档：https://sass-lang.com/documentation/
-  - **选择理由**：{例如：功能强大、编译速度快、社区支持好、Sass官方推荐实现}
-
-**构建工具**：
-- **Vite** ✅ **推荐选择**
-  - 官方地址：https://vite.dev/guide/
-  - **选择理由**：{例如：快速构建、开发体验好、支持Vue 3.0、热更新快}
-
-**表单/表格组件**：
-- **Avue** ✅ **推荐选择**
-  - 官方地址：https://avuejs.com/
-  - Github: https://github.com/avue/avue
-  - 表单组件：https://avuejs.com/form/form-doc.html
-  - 表格组件：https://avuejs.com/crud/crud-doc.html
-  - **选择理由**：{例如：基于Element Plus、配置化开发、提升开发效率、减少重复代码}
-
-**图表库**：
-- **Echarts**
-  - 官方地址：https://echarts.apache.org/
-  - **选择理由**：{例如：功能强大、图表类型丰富、性能优秀}
-
-#### 2.1.2 移动端技术选型
-
-**前端框架候选方案**：
-
-1. **UniApp + uView 2.0 of Vue 2.0**
-   - 官方地址：https://www.uviewui.com/
-   - 使用指南：https://www.uviewui.com/guide/demo.html
-   - 组件文档：https://www.uviewui.com/components/intro.html
-   - UniApp: https://ext.dcloud.net.cn/plugin?id=1593
-   - Github: https://github.com/umicro/uView2.0
-   - **特点**：{例如：基于Vue 2.0，成熟稳定，但版本较旧}
-
-2. **UniApp-x + uView Pro of Vue 3.0** ✅ **推荐选择**
-   - 官方地址：https://uviewpro.cn/
-   - 使用指南：https://uviewpro.cn/zh/guide/intro.html
-   - 组件文档：https://uviewpro.cn/zh/components/intro.html
-   - 工具文档：https://uviewpro.cn/zh/tools/intro.html
-   - 模板文档：https://uviewpro.cn/zh/layout/intro.html
-   - UniApp: https://ext.dcloud.net.cn/plugin?id=24633
-   - **选择理由**：{例如：跨平台支持好、一套代码多端运行、组件丰富、基于Vue 3.0性能优秀}
-
-3. **UniApp-x + Vant of Vue 3.0**
-   - 官方地址：https://vant-ui.github.io/
-   - 使用指南：https://vant-ui.github.io/vant/#/zh-CN
-   - **特点**：{例如：轻量级组件库，适合移动端}
-
-**状态管理**：
-- **Pinia of Vue 3.0**
-  - 官方地址：https://pinia.vuejs.org/
-  - **选择理由**：{例如：与UniApp-x兼容性好、API简洁}
-
-**样式预处理**：
-- **Dart Sass**
-  - 官方地址：https://sass-lang.com/dart-sass/
-  - **选择理由**：{例如：功能强大、编译速度快}
-
-**图表库候选方案**：
-
-1. **lime-echart** ✅ **推荐选择**
-   - UniApp: https://ext.dcloud.net.cn/plugin?id=4899
-   - **选择理由**：{例如：为UniApp和UniAppX提供ECharts图表兼容支持，使ECharts图表能在H5、小程序、App中运行，功能强大}
-
-2. **uCharts**
-   - UniApp: https://ext.dcloud.net.cn/plugin?id=271
-   - **特点**：{例如：支持H5及APP用ucharts echarts渲染图表，uniapp可视化首选组件，支持正负柱状图}
+### 2.1 核心技术栈
 
----
-
-### 2.2 后端技术栈
-
-**后端框架**：
-- **Spring Boot**
-  - 官方地址：https://spring.io/projects/spring-boot
-  - **选择理由**：{例如：生态完善、开发效率高、社区活跃}
-
-**微服务框架**：
-- **Spring Cloud**
-  - 官方地址：https://spring.io/projects/spring-cloud
-  - **选择理由**：{例如：微服务架构支持、服务治理完善}
-
-**ORM框架**：
-- **MyBatis-Plus**
-  - 官方地址：https://baomidou.com/
-  - **选择理由**：{例如：基于MyBatis、功能增强、开发效率高}
-
-**数据库**：
-- **MySQL 8.0+**
-  - 官方地址：https://www.mysql.com/
-  - **选择理由**：{例如：成熟稳定、性能优秀、社区支持好}
-
-**缓存**：
-- **Redis**（包括Redis GEO，如适用）
-  - 官方地址：https://redis.io/
-  - **选择理由**：{例如：高性能、数据结构丰富、支持多种场景}
-
-**消息队列**：
-- **RocketMQ / Kafka**
-  - RocketMQ: https://rocketmq.apache.org/
-  - Kafka: https://kafka.apache.org/
-  - **选择理由**：{例如：高吞吐量、可靠性好、支持分布式}
-
-**服务注册**：
-- **Nacos / Eureka**
-  - Nacos: https://nacos.io/
-  - Eureka: https://github.com/Netflix/eureka
-  - **选择理由**：{例如：服务发现、配置管理、高可用}
-
-**AI服务**（如适用）：
-- **大模型API**：{例如：OpenAI API、Claude API等}
-- **向量数据库**：{例如：Milvus、Chroma等}
-- **选择理由**：{例如：支持AI功能、性能优秀}
+| 层级 | 技术 | 版本 | 说明 |
+| :--- | :--- | :--- | :--- |
+| {例如：编排引擎} | {例如：OpenClaw (Rust)} | {例如：≥0.5} | {例如：任务编排与 Agent 调度} |
+| {例如：后端 API} | {例如：Go / Node.js} | {例如：≥1.22 / ≥20} | {例如：REST API 服务} |
+| {例如：AI 推理} | {例如：Python} | {例如：≥3.11} | {例如：LLM 调用、数据提取} |
+| {例如：前端 Web} | {例如：Vue 3 + Element Plus} | {例如：≥3.4} | {例如：管理控制台} |
+| {例如：移动端} | {例如：UniApp-x + uView Pro} | {例如：latest} | {例如：移动端适配} |
+| {例如：数据库} | {例如：PostgreSQL} | {例如：≥15} | {例如：元数据存储} |
+| {例如：缓存} | {例如：Redis} | {例如：≥7} | {例如：热数据缓存、任务队列} |
+| {例如：消息队列} | {例如：NATS / RabbitMQ} | {例如：latest} | {例如：异步任务分发} |
+| {例如：对象存储} | {例如：MinIO / S3} | {例如：latest} | {例如：文件与快照存储} |
+
+### 2.2 技术选型决策矩阵
+
+| 决策点 | 候选 A | 候选 B | 选择 | 理由 |
+| :--- | :--- | :--- | :--- | :--- |
+| {例如：后端语言} | {例如：Go} | {例如：Node.js} | {例如：Go} | {例如：并发性能、类型安全} |
+| {例如：数据库} | {例如：PostgreSQL} | {例如：MySQL} | {例如：PostgreSQL} | {例如：JSON 支持、扩展生态} |
+| {例如：前端框架} | {例如：Vue 3} | {例如：React} | {例如：Vue 3} | {例如：团队经验、生态成熟} |
+| {决策点} | {A} | {B} | {选择} | {理由} |
 
 ---
 
-### 2.3 桌面应用技术栈（如适用）
-
-**桌面应用框架候选方案**：
-
-1. **Electron**
-   - 官方地址：https://www.electronjs.org/zh/
-   - 使用文档：https://www.electronjs.org/zh/docs/latest/
-   - API文档：https://www.electronjs.org/zh/docs/latest/api/app
-   - 其他工具：https://www.electronforge.io、https://www.electronjs.org/zh/fiddle
-   - Github: https://github.com/electron/electron
-   - 实践文档：https://wiki.hiwepy.com/docs/electron
-   - **特点**：{例如：跨平台桌面应用框架，基于Chromium和Node.js，生态完善}
-
-2. **Electron EGG**
-   - 官方地址：https://www.kaka996.com/
-   - 使用文档：https://www.kaka996.com/pages/987b1c/
-   - API文档：https://www.kaka996.com/pages/a99b72/
-   - Gitee: https://gitee.com/dromara/electron-egg
-   - **特点**：{例如：基于Electron的企业级框架，提供完整解决方案}
-
-3. **UpgradeLink**
-   - 官方地址：https://www.toolsetlink.com/
-   - 使用文档：https://www.toolsetlink.com/upgrade/what-is-upgrade.html
-   - **特点**：{例如：升级工具，用于应用更新管理}
+## 3. 编排层技术方案
 
-### 2.4 硬件技术栈（如适用）
+### 3.1 编排引擎集成
 
-**主控芯片**：
-- {例如：ESP32-S3等}
-- **选择理由**：{例如：性能满足需求、成本可控}
+- {例如：基于 OpenClaw Commander 的任务编排}
+- {例如：DAG 式任务拆解，支持并行/串行/条件分支}
 
-**操作系统**：
-- {例如：FreeRTOS等}
-- **选择理由**：{例如：实时性好、资源占用少}
+```mermaid
+flowchart LR
+    INPUT["用户指令"] --> CMD["Commander"]
+    CMD --> PLAN["Task Planner"]
+    PLAN --> |"子任务 1"| A1["Agent A"]
+    PLAN --> |"子任务 2"| A2["Agent B"]
+    PLAN --> |"子任务 3"| A3["Agent C"]
+    A1 --> MERGE["Result Merger"]
+    A2 --> MERGE
+    A3 --> MERGE
+    MERGE --> OUTPUT["执行结果"]
+```
 
-**图形库**：
-- {例如：LVGL等}
-- **选择理由**：{例如：功能丰富、性能优秀}
+### 3.2 调度方案
 
-**通信协议**：
-- **MQTT**：{例如：用于设备与云端通信}
-- **WebSocket**：{例如：用于实时通信}
-- **BLE**：{例如：用于近距离通信}
-
----
-
-### 2.5 基础设施
-
-**容器化**：
-- **Docker**
-  - 官方地址：https://www.docker.com/
-  - **选择理由**：{例如：标准化部署、环境一致性}
-
-- **Kubernetes**
-  - 官方地址：https://kubernetes.io/
-  - **选择理由**：{例如：容器编排、自动扩缩容、高可用}
-
-**CI/CD**：
-- **Jenkins / GitLab CI**
-  - Jenkins: https://www.jenkins.io/
-  - GitLab CI: https://docs.gitlab.com/ee/ci/
-  - **选择理由**：{例如：自动化构建、持续集成、持续部署}
+| 调度类型 | 实现 | 示例 |
+| :--- | :--- | :--- |
+| {例如：即时任务} | {例如：REST API 触发} | {例如：用户点击「立即采集」} |
+| {例如：定时任务} | {例如：Cron 表达式} | {例如：每日 8:00 自动改价} |
+| {例如：事件触发} | {例如：Webhook / MQ} | {例如：新订单触发发货流程} |
 
-**监控**：
-- **Prometheus + Grafana**
-  - Prometheus: https://prometheus.io/
-  - Grafana: https://grafana.com/
-  - **选择理由**：{例如：指标收集、可视化展示、告警}
+### 3.3 多渠道输入
 
-**日志**：
-- **ELK Stack**
-  - Elasticsearch: https://www.elastic.co/elasticsearch/
-  - Logstash: https://www.elastic.co/logstash/
-  - Kibana: https://www.elastic.co/kibana/
-  - **选择理由**：{例如：日志收集、搜索、分析}
+```mermaid
+flowchart LR
+    WEB["Web Console"] --> GW["API Gateway"]
+    CLI_CMD["CLI 命令"] --> GW
+    IM["IM Bot<br/>（微信/飞书）"] --> GW
+    CRON["Cron 调度器"] --> GW
+    GW --> CMD["Commander"]
+```
 
 ---
 
-## 4. 技术对比分析 (Technology Comparison)
-
-### 4.1 前端框架对比
-
-#### 4.1.1 管理后台框架对比
-
-| 技术方案 | 优势 | 劣势 | 适用场景 | 选择结果 |
-| :--- | :--- | :--- | :--- | :--- |
-| **LayUI of Vue 3.0** | 组件丰富、提供后台模板、基于Vue 3.0 | 生态相对较小、社区活跃度一般 | 中小型后台管理系统 | ❌ 未选择 |
-| **Ant Design of React** | 企业级设计、组件完善、生态庞大 | 基于React、学习成本高 | 大型企业级应用 | ❌ 未选择 |
-| **Bootstrap of Vue 3.0** | 响应式设计、组件丰富 | 样式相对传统、定制化程度低 | 快速开发、标准样式 | ❌ 未选择 |
-| **Element Plus of Vue 3.0** | 组件丰富、文档完善、社区活跃、Vue 3.0性能优秀 | 相对React生态稍小 | 中小型项目、快速开发 | ✅ 选择 |
-
-**选择理由**：
-- {例如：团队熟悉Vue技术栈，开发效率高}
-- {例如：Vue 3.0性能优秀，满足项目需求}
-- {例如：Element Plus生态完善，组件库丰富，文档完善}
-- {例如：与移动端技术栈统一，降低学习成本}
-
-#### 4.1.2 移动端框架对比
-
-| 技术方案 | 优势 | 劣势 | 适用场景 | 选择结果 |
-| :--- | :--- | :--- | :--- | :--- |
-| **UniApp + uView 2.0** | 成熟稳定、生态完善 | 基于Vue 2.0、版本较旧 | Vue 2.0项目 | ❌ 未选择 |
-| **UniApp-x + uView Pro** | 跨平台支持好、一套代码多端运行、基于Vue 3.0 | 相对较新、生态在发展中 | 跨平台移动应用 | ✅ 选择 |
-| **UniApp-x + Vant** | 轻量级、组件丰富 | 功能相对简单 | 轻量级移动应用 | ❌ 未选择 |
-
-**选择理由**：
-- {例如：UniApp-x跨平台支持好，一套代码多端运行}
-- {例如：uView Pro组件丰富，基于Vue 3.0性能优秀}
-- {例如：与后台技术栈统一，降低学习成本}
-
-#### 4.1.3 状态管理对比
-
-| 技术方案 | 优势 | 劣势 | 适用场景 | 选择结果 |
-| :--- | :--- | :--- | :--- | :--- |
-| **Vuex** | 成熟稳定、Vue 2.0官方推荐 | Vue 3.0不推荐、API相对复杂 | Vue 2.0项目 | ❌ 未选择 |
-| **Pinia** | Vue 3.0官方推荐、TypeScript支持好、API简洁 | 相对较新 | Vue 3.0项目 | ✅ 选择 |
-
-**选择理由**：
-- {例如：Vue 3.0官方推荐，性能优秀}
-- {例如：TypeScript支持好，API简洁易用}
-- {例如：与Vue 3.0技术栈完美配合}
+## 4. 专家层技术方案
+
+### 4.1 Agent 模板规范
+
+```yaml
+# Agent 模板示例
+name: "{例如：product-selector}"
+version: "1.0.0"
+category: "{例如：选品}"
+tier: "{例如：core | premium | community}"
+description: "{例如：从源平台筛选合适商品}"
+inputs:
+  - name: "source_platform"
+    type: "string"
+    required: true
+  - name: "criteria"
+    type: "object"
+outputs:
+  - name: "product_list"
+    type: "array"
+tools:
+  - "{例如：platform.search}"
+  - "{例如：platform.getDetail}"
+llm:
+  model: "{例如：gpt-4o-mini}"
+  temperature: 0.3
+```
+
+### 4.2 Agent 分类体系
+
+| 类别 | 说明 | 示例 |
+| :--- | :--- | :--- |
+| {例如：Core Agent} | {例如：官方内置，覆盖核心流程} | {例如：选品、上架、定价} |
+| {例如：Premium Agent} | {例如：商业版专属，高级能力} | {例如：竞品监控、智能定价} |
+| {例如：Community Agent} | {例如：社区贡献，开放注册} | {例如：自定义选品规则} |
 
 ---
 
-### 4.2 图表库对比
-
-| 技术方案 | 优势 | 劣势 | 适用场景 | 选择结果 |
-| :--- | :--- | :--- | :--- | :--- |
-| **lime-echart** | ECharts兼容、功能强大、支持多端 | 相对较重 | UniApp图表需求 | ✅ 选择 |
-| **uCharts** | 轻量级、支持正负柱状图 | 功能相对简单 | 简单图表需求 | ❌ 未选择 |
-
-**选择理由**：
-- {例如：lime-echart为UniApp提供ECharts兼容支持，功能强大}
-- {例如：使ECharts图表能在H5、小程序、App中运行，统一图表方案}
-
-### 4.3 后端框架对比
-
-| 技术方案 | 优势 | 劣势 | 适用场景 | 选择结果 |
-| :--- | :--- | :--- | :--- | :--- |
-| **Spring Boot** | 生态完善、开发效率高、社区活跃 | 配置相对复杂 | Java项目、企业级应用 | ✅ 选择 |
-| **Node.js** | 开发速度快、前后端统一 | 性能相对较低、不适合CPU密集型 | 中小型项目、实时应用 | ❌ 未选择 |
-| **Go** | 性能优秀、并发能力强 | 生态相对较小、学习成本高 | 高并发、微服务 | ❌ 未选择 |
-
-**选择理由**：
-- {例如：团队熟悉Java技术栈，开发效率高}
-- {例如：Spring Boot生态完善，功能丰富}
-- {例如：企业级应用，稳定性要求高}
+## 5. 执行层技术方案
+
+### 5.1 命令规范
+
+```bash
+# CLI 命令示例
+{例如：opencli} platform list                    # 列出已连接平台
+{例如：opencli} product scrape --platform taobao  # 采集商品
+{例如：opencli} order sync --store my-store       # 同步订单
+{例如：opencli} agent run product-selector        # 运行 Agent
+```
+
+### 5.2 平台适配器接口
+
+```typescript
+// 平台适配器抽象接口示例
+interface PlatformAdapter {
+  /** 适配器唯一标识 */
+  readonly id: string;
+  /** 平台名称 */
+  readonly name: string;
+  /** 初始化连接 */
+  connect(credentials: Credentials): Promise<void>;
+  /** 搜索商品 */
+  searchProducts(query: SearchQuery): Promise<Product[]>;
+  /** 上架商品 */
+  listProduct(product: ProductDraft): Promise<ListingResult>;
+  /** 同步订单 */
+  syncOrders(since: Date): Promise<Order[]>;
+  /** 健康检查 */
+  healthCheck(): Promise<HealthStatus>;
+}
+```
+
+### 5.3 浏览器控制方案
+
+| 方案 | 适用场景 | 优点 | 缺点 |
+| :--- | :--- | :--- | :--- |
+| {例如：Playwright} | {例如：复杂页面操作} | {例如：API 稳定、多浏览器} | {例如：资源占用较高} |
+| {例如：CDP 直连} | {例如：轻量操作} | {例如：低开销} | {例如：需自行管理生命周期} |
 
 ---
 
-### 4.4 数据库对比
+## 6. 企业层技术方案
 
-| 技术方案 | 优势 | 劣势 | 适用场景 | 选择结果 |
-| :--- | :--- | :--- | :--- | :--- |
-| **MySQL** | 成熟稳定、性能优秀、社区支持好 | 高并发性能相对较低 | 关系型数据、事务处理 | ✅ 选择 |
-| **PostgreSQL** | 功能强大、扩展性好 | 学习成本高、生态相对较小 | 复杂查询、数据分析 | ❌ 未选择 |
-| **MongoDB** | 灵活、扩展性好 | 事务支持弱、一致性要求高时不适合 | 非关系型数据、文档存储 | ❌ 未选择 |
+### 6.1 多租户实现
 
-**选择理由**：
-- {例如：MySQL成熟稳定，满足项目需求}
-- {例如：团队熟悉MySQL，运维成本低}
-- {例如：项目以关系型数据为主}
+| 隔离级别 | 实现方式 | 适用版本 |
+| :--- | :--- | :--- |
+| {例如：Row-Level} | {例如：`tenant_id` 列 + RLS Policy} | {例如：👥 专业版} |
+| {例如：Schema-Level} | {例如：PostgreSQL Schema 隔离} | {例如：🏢 企业版} |
+
+### 6.2 RBAC 实现
+
+```mermaid
+erDiagram
+    TENANT ||--o{ USER : has
+    USER ||--o{ USER_ROLE : assigned
+    ROLE ||--o{ USER_ROLE : contains
+    ROLE ||--o{ ROLE_PERMISSION : grants
+    PERMISSION ||--o{ ROLE_PERMISSION : included_in
+
+    TENANT {
+        uuid id PK
+        string name
+        string plan
+    }
+    USER {
+        uuid id PK
+        uuid tenant_id FK
+        string email
+    }
+    ROLE {
+        uuid id PK
+        string name
+        string scope
+    }
+    PERMISSION {
+        uuid id PK
+        string resource
+        string action
+    }
+```
+
+### 6.3 审计日志方案
+
+| 字段 | 类型 | 说明 |
+| :--- | :--- | :--- |
+| `id` | UUID | 日志 ID |
+| `tenant_id` | UUID | 租户 |
+| `actor_id` | UUID | 操作者 |
+| `action` | string | 操作类型 |
+| `resource` | string | 操作对象 |
+| `payload` | JSON | 变更详情 |
+| `timestamp` | datetime | 操作时间 |
+| `ip` | string | 客户端 IP |
+
+### 6.4 Web Console 技术方案
+
+| 技术 | 版本 | 用途 |
+| :--- | :--- | :--- |
+| {例如：Vue 3} | {例如：3.4+} | {例如：UI 框架} |
+| {例如：Element Plus} | {例如：2.8+} | {例如：组件库} |
+| {例如：Pinia} | {例如：2.x} | {例如：状态管理} |
+| {例如：Vue Router} | {例如：4.x} | {例如：路由} |
+| {例如：Axios} | {例如：1.x} | {例如：HTTP 客户端} |
+| {例如：lime-echart} | {例如：latest} | {例如：图表组件} |
 
 ---
 
-### 4.5 缓存方案对比
+## 7. 技术决策记录 (ADR)
 
-| 技术方案 | 优势 | 劣势 | 适用场景 | 选择结果 |
+| ADR# | 决策 | 状态 | 背景 | 后果 |
 | :--- | :--- | :--- | :--- | :--- |
-| **Redis** | 高性能、数据结构丰富、支持多种场景 | 内存成本较高 | 缓存、会话存储、消息队列 | ✅ 选择 |
-| **Memcached** | 简单、性能好 | 功能单一、不支持持久化 | 简单缓存场景 | ❌ 未选择 |
-| **本地缓存** | 无网络开销、性能极好 | 不支持分布式、数据一致性差 | 单机缓存 | ❌ 未选择 |
-
-**选择理由**：
-- {例如：Redis功能强大，满足多种场景需求}
-- {例如：支持持久化，数据安全}
-- {例如：支持分布式，扩展性好}
+| ADR-001 | {例如：选择 Go 作为 API 层语言} | ✅ Accepted | {例如：需要高并发处理能力} | {例如：编译部署简单，但 AI 生态需通过 Python sidecar} |
+| ADR-002 | {例如：PostgreSQL 替代 MySQL} | ✅ Accepted | {例如：需 JSON 查询 + pgvector} | {例如：运维复杂度略增} |
+| ADR-003 | {例如：采用 Schema 级租户隔离} | ✅ Accepted | {例如：企业客户数据隔离要求} | {例如：迁移脚本需按租户执行} |
+| ADR-NNN | {决策} | — | {背景} | {后果} |
 
 ---
 
-## 7. 技术方案建议 (Technology Recommendations)
-
-### 7.1 推荐技术栈
-
-**前端技术栈**：
-- **管理后台**：Vue 3.0 + Element Plus + Pinia + Dart Sass + Avue + Echarts + Vite
-- **移动端**：UniApp-x + uView Pro + Pinia + Dart Sass + lime-echart
+## 8. 分阶段技术路线
 
-**技术选型说明**：
-- **前端框架**：Element Plus of Vue 3.0（管理后台）、UniApp-x + uView Pro of Vue 3.0（移动端）
-- **状态管理**：Pinia of Vue 3.0（统一使用）
-- **样式预处理**：Dart Sass（统一使用）
-- **构建工具**：Vite（管理后台）、UniApp-x构建工具（移动端）
-- **表单/表格组件**：Avue（管理后台，基于Element Plus）
-- **图表库**：Echarts（管理后台）、lime-echart（移动端，ECharts兼容）
-
-**后端技术栈**：
-- Spring Boot + Spring Cloud + MyBatis-Plus + MySQL + Redis + RocketMQ + Nacos
-
-**基础设施**：
-- Docker + Kubernetes + Jenkins + Prometheus + Grafana + ELK Stack
-
----
+### 8.1 技术路线 Gantt
 
-### 7.2 技术实施建议
+```mermaid
+gantt
+    title {Name} 技术路线
+    dateFormat YYYY-MM-DD
+    axisFormat %Y-%m
 
-**分阶段实施**：
-1. **第一阶段**：{例如：搭建基础框架，完成核心功能}
-2. **第二阶段**：{例如：完善功能，优化性能}
-3. **第三阶段**：{例如：扩展功能，提升体验}
+    section V1.0 MVP
+    编排层核心          :v1_1, 2026-04-01, 60d
+    执行层 Adapter ×3   :v1_2, 2026-04-15, 45d
+    Core Agent ×5       :v1_3, 2026-05-01, 30d
+    Web Console 基础    :v1_4, 2026-05-15, 30d
+    集成测试 & Beta     :v1_5, after v1_4, 15d
 
-**技术债务管理**：
-- {例如：定期review技术债务}
-- {例如：制定技术债务偿还计划}
-- {例如：避免过度设计}
+    section V2.0 商业版
+    多租户 + RBAC       :v2_1, 2026-07-01, 45d
+    审计日志            :v2_2, 2026-07-15, 30d
+    Premium Agent ×3    :v2_3, 2026-07-01, 45d
+    计费与定价          :v2_4, 2026-08-01, 30d
 
-**持续优化**：
-- {例如：关注技术发展趋势}
-- {例如：定期评估技术选型}
-- {例如：及时升级技术版本}
+    section V3.0 企业版
+    Schema 级隔离       :v3_1, 2026-10-01, 30d
+    私有部署支持        :v3_2, 2026-10-15, 45d
+    SOC2 / 等保基线     :v3_3, 2026-11-01, 60d
+```
 
----
+### 8.2 版本交付清单
 
-## 8. 附录 (Appendix)
-
-### 8.1 技术文档链接
-
-**前端技术文档**：
-- [Vue 3.0 官方文档](https://vuejs.org/)
-- [Element Plus 官方文档](https://element-plus.org/)
-- [LayUI of Vue 3.0 官方文档](https://www.layui-vue.com/zh-CN/index)
-- [Ant Design of React 官方文档](https://4x-ant-design.antgroup.com/index-cn)
-- [Bootstrap of Vue 3.0 官方文档](https://bootstrap-vue.org)
-- [UniApp-x + uView Pro 官方文档](https://uviewpro.cn/)
-- [UniApp + uView 2.0 官方文档](https://www.uviewui.com/)
-- [UniApp-x + Vant 官方文档](https://vant-ui.github.io/)
-- [Pinia 官方文档](https://pinia.vuejs.org/)
-- [Vuex 官方文档](https://vuex.vuejs.org/zh/)
-- [Vite 官方文档](https://vite.dev/guide/)
-- [Avue 官方文档](https://avuejs.com/)
-- [lime-echart UniApp插件](https://ext.dcloud.net.cn/plugin?id=4899)
-- [uCharts UniApp插件](https://ext.dcloud.net.cn/plugin?id=271)
-- [Electron 官方文档](https://www.electronjs.org/zh/)
-- [Electron EGG 官方文档](https://www.kaka996.com/)
-
-**后端技术文档**：
-- [Spring Boot 官方文档](https://spring.io/projects/spring-boot)
-- [Spring Cloud 官方文档](https://spring.io/projects/spring-cloud)
-- [MyBatis-Plus 官方文档](https://baomidou.com/)
-- [Redis 官方文档](https://redis.io/)
-
-**基础设施文档**：
-- [Docker 官方文档](https://www.docker.com/)
-- [Kubernetes 官方文档](https://kubernetes.io/)
-- [Prometheus 官方文档](https://prometheus.io/)
+| 版本 | 时间 | 关键交付 |
+| :--- | :--- | :--- |
+| V1.0 MVP | {例如：2026 Q2} | {例如：编排 + 执行 + 5 Core Agent + Web Console} |
+| V2.0 商业版 | {例如：2026 Q3} | {例如：多租户 + RBAC + 审计 + Premium Agent + 计费} |
+| V3.0 企业版 | {例如：2026 Q4} | {例如：Schema 隔离 + 私有部署 + 合规} |
+| V4.0 生态版 | {例如：2027 Q1} | {例如：Agent 市场 + 插件系统 + 开放 API} |
 
 ---
 
-### 8.2 参考文档
-
-> 列出参考的相关文档
-
-- [产品调研模板](1、产品调研模板.md)
-- [需求分析模板](4、需求分析模板.md)
-- [系统架构设计模板](9、系统架构设计模板.md)
-- [技术细分模板](10、技术细分模板.md)
+## 9. 部署方案
+
+### 9.1 部署架构
+
+```mermaid
+flowchart TD
+    subgraph "用户端"
+        WEB["Web Console"]
+        CLI["CLI"]
+        MOB["Mobile App"]
+    end
+
+    subgraph "接入层"
+        LB["Load Balancer<br/>Nginx / Caddy"]
+    end
+
+    subgraph "应用层"
+        API["API Server<br/>(Go/Node)"]
+        WORKER["Worker<br/>(Python)"]
+        CRON["Cron Scheduler"]
+    end
+
+    subgraph "数据层"
+        PG[(PostgreSQL)]
+        REDIS[(Redis)]
+        MQ["Message Queue"]
+        OSS["Object Storage"]
+    end
+
+    WEB --> LB
+    CLI --> LB
+    MOB --> LB
+    LB --> API
+    API --> PG
+    API --> REDIS
+    API --> MQ
+    MQ --> WORKER
+    WORKER --> PG
+    WORKER --> OSS
+    CRON --> MQ
+```
+
+### 9.2 部署选项
+
+| 部署模式 | 适用 | 技术 | 说明 |
+| :--- | :--- | :--- | :--- |
+| {例如：Docker Compose} | {例如：开发 / 小规模} | {例如：docker compose up} | {例如：单机部署，最快上手} |
+| {例如：Kubernetes} | {例如：生产 / SaaS} | {例如：Helm Chart} | {例如：自动扩缩容} |
+| {例如：私有化} | {例如：企业版} | {例如：离线安装包} | {例如：客户自有机房} |
 
 ---
 
-### 8.3 变更记录
-
-> 记录技术调研变更的历史
+## 10. 监控与可观测性
 
-| 变更日期 | 变更内容 | 变更原因 | 变更人 |
-| :--- | :--- | :--- | :--- |
-| {YYYY-MM-DD} | {变更内容描述} | {变更原因} | {姓名} |
+| 维度 | 工具 | 指标 |
+| :--- | :--- | :--- |
+| {例如：Metrics} | {例如：Prometheus + Grafana} | {例如：QPS、延迟、错误率} |
+| {例如：Logging} | {例如：ELK / Loki} | {例如：结构化日志、错误追踪} |
+| {例如：Tracing} | {例如：OpenTelemetry + Jaeger} | {例如：请求链路、Agent 执行跟踪} |
+| {例如：Alerting} | {例如：AlertManager / PagerDuty} | {例如：SLA 违约、任务堆积} |
 
 ---
 
-**文档版本**：V1.0.0  
-**创建时间**：{YYYY-MM-DD}  
-**最后更新**：{YYYY-MM-DD}  
-**文档状态**：✅ 调研中 / ✅ 调研完成 / ✅ 待评审 / ✅ 已完成
+**文档版本**：V1.0.0
+**创建日期**：{YYYY-MM-DD}
+**最后更新**：{YYYY-MM-DD}
+**文档状态**：✅ 待评审

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

@@ -1,156 +1,238 @@
-> **标准说明**：正文为 OctoPanel 实例；附录为 legacy PRD「产品概述」问卷体。
+# {Name} 产品与版本规划
+
+> **文档说明**：定义产品定位、版本体系、功能演进路线与商业化节奏，作为研发与商业协同基线。
+>
+> **版本**：V1.0.0
+> **最后更新**：{YYYY-MM-DD}
 
 ---
 
-# {Name} 产品与版本规划 产品与版本规划
+## 1. 文档信息
 
-> 文件名保留历史名，仅用于兼容旧引用。正文中的正式产品名统一为 **{Name}**。
+### 1.1 版本记录
 
-## 1. 产品定位
+| 版本 | 日期 | 作者 | 变更说明 |
+| :--- | :--- | :--- | :--- |
+| V1.0.0 | {YYYY-MM-DD} | {姓名} | 初始版本 |
 
-`{Name} = 多引擎智能体控制平面。`
+### 1.2 关联文档
 
-一句话：
+| 文档 | 关联说明 |
+| :--- | :--- |
+| [3、市场与商业分析](3、{Name}-市场与商业分析.md) | 商业模式与定价 |
+| [5、技术方案与路线](5、{Name}-技术方案与路线.md) | 技术路线与里程碑 |
+| [10、功能菜单与版本规划](10、{Name}-功能菜单与版本规划.md) | 功能清单与版本分布 |
 
-`面向 OpenClaw / ZeroClaw / OctoClaw 的安装、纳管、配置、运维、扩展与审计平台。`
+---
 
-## 2. 产品骨架来源
+## 2. 产品定位
 
-### 2.1 从 1Panel 借什么
+### 2.1 一句话定位
 
-- 借信息架构，不只借皮肤
-- 左侧一级导航 + 顶部状态栏 + 首页总览 + 列表页 + 详情页 + 安装向导
-- 一键安装脚本 + CLI 工具 + Web 面板 + 节点/主机管理 + 应用市场
-- 资源对象化：主机、应用、任务、备份、日志、商店都做成标准对象
+{例如：面向中小电商卖家的 AI 自动化运营平台，让 Agent 替你开店。}
 
-### 2.2 从 clawpanel 借什么
+### 2.2 核心价值主张
 
-- 安装 / 诊断 / 修复主链
-- AI 助手做“受控运维代理”而不是闲聊机器人
-- Web 控制面 + 同机执行代理分层
-- 多实例与远程实例代理思路
+| 价值 | 说明 |
+| :--- | :--- |
+| {例如：效率} | {例如：AI Agent 替代重复操作，降低 80% 人工成本} |
+| {例如：覆盖} | {例如：多平台统一管理，告别工具碎片化} |
+| {例如：智能} | {例如：AI 驱动选品、定价、客服，数据驱动决策} |
+| {例如：开放} | {例如：开源核心引擎，社区驱动创新} |
 
-## 3. {Name} 的差异化
+### 2.3 产品边界
 
-{Name} 不应只是 1Panel 或 clawpanel 的换壳版，而要强化：
+```mermaid
+graph LR
+    subgraph "{Name} 做"
+        A["选品采集"]
+        B["商品上架"]
+        C["智能定价"]
+        D["订单履约"]
+        E["客服回复"]
+        F["数据报表"]
+    end
 
-- 多引擎统一适配
-- 游戏化 6 步安装向导
-- 多实例批量纳管
-- 渠道 / Skill / MCP 卡片式安装
-- 模型订阅与代理平台目录
-- 受控 AI 安装助手
-- 审计、回滚、任务阶段结果
-- Web-only 控制台 + Go Core + Node Agent
+    subgraph "{Name} 不做"
+        X["进销存管理"]
+        Y["广告投放"]
+        Z["物流仓储"]
+    end
 
-## 4. 形态策略
+    style X fill:#fee,stroke:#f99
+    style Y fill:#fee,stroke:#f99
+    style Z fill:#fee,stroke:#f99
+```
 
-### 4.1 {Name} Web
+---
 
-- 唯一控制台形态
-- 面向服务器部署与远程访问
-- 负责登录、实例管理、模型订阅、渠道配置、技能 / 工具治理、监控、日志审计、任务回查
+## 3. 版本体系
+
+### 3.1 开源与商业关系（如适用）
+
+```mermaid
+graph TD
+    OPEN["{Name-Open}<br/>开源版"] -->|"共享核心"| CORE["编排 + 执行 + Core Agent"]
+    BIZ["{Name}<br/>商业版"] -->|"共享核心"| CORE
+    BIZ -->|"独占"| ENT["企业层<br/>多租户 / RBAC / 审计"]
+    BIZ -->|"独占"| PREM["Premium Agent"]
+    BIZ -->|"独占"| SUP["商业支持 / SLA"]
+```
+
+| 维度 | {Name-Open} 开源版 | {Name} 商业版 |
+| :--- | :--- | :--- |
+| 编排引擎 | ✅ 完整 | ✅ 完整 |
+| 执行层 | ✅ 完整 | ✅ 完整 |
+| Core Agent | ✅ 全部 | ✅ 全部 |
+| Premium Agent | ❌ | ✅ |
+| 多租户 | ❌ | ✅ |
+| RBAC | ❌ | ✅ |
+| 审计日志 | ❌ | ✅ |
+| 技术支持 | 社区 | 专属/SLA |
+
+### 3.2 版本功能矩阵
+
+| 功能 | 🆓 Free | 👤 Pro | 👥 Team | 🏢 Enterprise |
+| :--- | :---: | :---: | :---: | :---: |
+| {例如：Agent 数量} | {例如：3} | {例如：10} | {例如：无限} | {例如：无限} |
+| {例如：店铺数量} | {例如：1} | {例如：5} | {例如：20} | {例如：无限} |
+| {例如：平台数量} | {例如：2} | {例如：5} | {例如：全部} | {例如：全部} |
+| {例如：定时任务} | ❌ | ✅ | ✅ | ✅ |
+| {例如：Premium Agent} | ❌ | ❌ | ✅ | ✅ |
+| {例如：多租户} | ❌ | ❌ | ❌ | ✅ |
+| {例如：RBAC} | ❌ | ❌ | ❌ | ✅ |
+| {例如：私有部署} | ❌ | ❌ | ❌ | ✅ |
+| {例如：SLA} | ❌ | ❌ | ❌ | ✅ |
+| {功能} | — | — | — | — |
 
-### 4.2 {Name} Core
+---
 
-- `Go` 服务
-- 负责 API、任务编排、状态机、审计、权限、节点 / 实例注册、批量任务
-- 充当控制面与执行面的统一编排核心
+## 4. 版本路线图
 
-### 4.3 {Name} Node Agent
+### 4.1 V1.0 — MVP（{例如：2026 Q2}）
 
-- `Node.js + TypeScript` 执行代理
-- 部署在被管机器上，跟引擎同机
-- 负责安装、预检、配置生成、服务启停、日志采集、健康检查、回滚
+**目标**：{例如：核心流程跑通，验证 PMF}
 
-## 5. 版本层级
+| 功能 | 优先级 | 状态 |
+| :--- | :---: | :---: |
+| {例如：编排引擎集成} | P0 | ⏳ |
+| {例如：淘宝/拼多多 Adapter} | P0 | ⏳ |
+| {例如：选品 Agent} | P0 | ⏳ |
+| {例如：上架 Agent} | P0 | ⏳ |
+| {例如：Web Console 基础} | P1 | ⏳ |
+| {功能} | — | — |
 
-| 层级 | 名称 | 目标 |
-|------|------|------|
-| `P0` | 安装闭环 | 三引擎安装、健康检查、纳管、回滚 |
-| `P1` | 控制面骨架 | 首页、实例、模型、监控、设置 |
-| `P2` | 平台治理 | 沙盒、智能体、技能商店、工具商店、模型订阅 |
-| `P3` | 平台增强 | 日志审计、批量运维、平台扩展与高级协作 |
+### 4.2 V2.0 — 商业版基础（{例如：2026 Q3}）
 
-## 6. 一级导航冻结
+**目标**：{例如：商业化启动，付费用户增长}
 
-{Name} 一级导航固定为：
+| 功能 | 优先级 | 状态 |
+| :--- | :---: | :---: |
+| {例如：多租户 + 用户管理} | P0 | ⏳ |
+| {例如：RBAC 权限体系} | P0 | ⏳ |
+| {例如：Premium Agent ×3} | P1 | ⏳ |
+| {例如：计费与套餐管理} | P1 | ⏳ |
+| {功能} | — | — |
 
-1. 首页
-2. 实例
-3. 模型
-4. 监控
-5. 沙盒
-6. 智能体
-7. 技能商店
-8. 工具商店
-9. 日志审计
-10. 设置
+### 4.3 V3.0 — 企业版完整（{例如：2026 Q4}）
 
-说明：
+**目标**：{例如：满足企业客户安全与合规需求}
 
-- `实例` 承接安装向导、节点与远程主机、部署 / 升级 / 回滚 / 批量任务
-- `模型` 承接模型提供商、凭证、路由、模型代理与模型订阅目录，不拆分额外一级菜单
-- `日志审计` 承接巡检总览、操作审计、异常日志、实时事件流和任务阶段日志
+| 功能 | 优先级 | 状态 |
+| :--- | :---: | :---: |
+| {例如：Schema 级租户隔离} | P0 | ⏳ |
+| {例如：审计日志} | P0 | ⏳ |
+| {例如：私有部署支持} | P1 | ⏳ |
+| {例如：白标定制} | P2 | ⏳ |
+| {功能} | — | — |
 
-## 7. 与安装闭环文档的关系
+### 4.4 V4.0 — 生态版（{例如：2027 Q1}，可选）
 
-- [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. 当前技术冻结
+| 功能 | 优先级 | 状态 |
+| :--- | :---: | :---: |
+| {例如：Agent 市场} | P1 | ⏳ |
+| {例如：插件系统} | P1 | ⏳ |
+| {例如：开放 API} | P1 | ⏳ |
+| {功能} | — | — |
 
-- `前端`：`Vue 3 + TypeScript`
-- `控制面后端`：`Go`
-- `执行代理`：`Node.js + TypeScript`
-- 不再保留 `Desktop` 为主线产品形态；历史 Desktop 相关内容仅作为旧方案归档参考
+---
+
+## 5. 版本定价对照
 
+| 档位 | 月价 | 年价（折扣） | 适用版本 |
+| :--- | :--- | :--- | :--- |
+| 🆓 Free | ¥0 | ¥0 | V1.0+ |
+| 👤 Pro | {例如：¥99} | {例如：¥999 (¥83/月)} | V1.0+ |
+| 👥 Team | {例如：¥299} | {例如：¥2,999 (¥250/月)} | V2.0+ |
+| 🏢 Enterprise | {例如：议价} | {例如：议价} | V3.0+ |
 
 ---
 
-## 附录：PRD 模板节选（legacy 5 §2）
+## 6. 开源与商业协同策略（如适用）
 
-## 2. 产品概述 (Product Overview)
+### 6.1 开源版角色
 
-### 2.1 产品定位
-> 简要描述产品的定位、目标用户、核心价值
+- {例如：社区推广引擎，降低获客成本}
+- {例如：开发者生态入口，培养 Agent 贡献者}
+- {例如：核心引擎稳定性验证}
 
-**产品定位**：{例如：面向门店老板和师傅的XXX应用，帮助门店高效管理订单、师傅、客户等业务}
+### 6.2 商业版护城河
 
-**目标用户**：
-- **主要用户**：{例如：门店老板、工作人员}
-- **次要用户**：{例如：师傅、运营人员}
+- {例如：企业级治理（多租户、RBAC、审计）}
+- {例如：Premium Agent（更高质量、SLA 保证）}
+- {例如：商业支持与 SLA}
 
-**核心价值**：
-1. {例如：提升订单处理效率，减少人工操作}
-2. {例如：实时掌握门店运营数据，辅助决策}
-3. {例如：优化师傅工作流程，提升服务质量}
+### 6.3 功能墙策略
 
-### 2.2 产品目标
-> 明确本次迭代要达成的业务目标
+```mermaid
+graph TD
+    FREE["🆓 Free<br/>Core Agent + 基础编排"] -->|"升级"| PRO["👤 Pro<br/>更多 Agent + 定时任务"]
+    PRO -->|"升级"| TEAM["👥 Team<br/>Premium Agent + 团队协作"]
+    TEAM -->|"升级"| ENT["🏢 Enterprise<br/>私有部署 + 合规 + SLA"]
+```
 
-**业务目标**：
-- {例如：提升订单处理效率30%}
-- {例如：减少订单遗漏率至5%以下}
-- {例如：提升师傅接单率至80%以上}
+---
 
-**用户目标**：
-- {例如：门店老板能够快速查看和处理订单}
-- {例如：师傅能够便捷抢单和上报服务进度}
+## 7. 发布策略
 
-### 2.3 产品范围
-> 明确本次迭代包含和不包含的功能范围
+| 策略 | 说明 |
+| :--- | :--- |
+| 版本号规范 | SemVer：`MAJOR.MINOR.PATCH`（如 `1.2.3`） |
+| 发布节奏 | {例如：Major 每季度、Minor 每月、Patch 按需} |
+| 灰度策略 | {例如：内部 → 5% 灰度 → 50% → 全量} |
+| 回滚策略 | {例如：蓝绿部署，30 分钟内可回滚} |
+| 变更日志 | {例如：每版本 CHANGELOG.md + 用户通知} |
+
+---
+
+## 8. 生态协作路径（如适用）
+
+```mermaid
+flowchart LR
+    CONTRIB["社区贡献者"] -->|"提交 Agent"| REVIEW["官方审核"]
+    REVIEW -->|"通过"| MARKET["Agent 市场"]
+    REVIEW -->|"优质"| PREMIUM["Premium 邀请"]
+    MARKET -->|"安装"| USER["用户"]
+    USER -->|"评分/反馈"| REVIEW
+```
+
+---
 
-**本次迭代包含**：
-- {例如：工单模块（订单列表、订单详情、订单操作）}
-- {例如：我的模块（门店信息、数据统计、待办事项）}
-- {例如：首页模块（搜索、Banner）}
+## 9. 成功指标
 
-**本次迭代不包含**（后续迭代）：
-- {例如：数据报表详细分析}
-- {例如：客户管理模块}
-- {例如：商品管理模块}
+| 指标 | V1.0 目标 | V2.0 目标 | V3.0 目标 |
+| :--- | :--- | :--- | :--- |
+| {例如：GitHub Stars} | {例如：>500} | {例如：>2,000} | {例如：>5,000} |
+| {例如：注册用户} | {例如：>200} | {例如：>1,000} | {例如：>3,000} |
+| {例如：付费用户} | {例如：>20} | {例如：>100} | {例如：>300} |
+| {例如：MRR} | {例如：>¥5K} | {例如：>¥50K} | {例如：>¥200K} |
+| {例如：NPS} | {例如：>30} | {例如：>40} | {例如：>50} |
 
 ---
 
+**文档版本**：V1.0.0
+**创建日期**：{YYYY-MM-DD}
+**最后更新**：{YYYY-MM-DD}
+**文档状态**：✅ 待评审

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

@@ -1,87 +0,0 @@
-> **标准说明**：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/document-skills/full-stack-doc/templates/root/7、领域模型设计.md

@@ -1,871 +1,425 @@
 # {Name} 领域模型设计
 
-> **标准说明**：本文由 原「领域模型说明」阶段模板全文 全文合并（根目录总纲）。
-
-### 关联文档
-
-| 文档 | 说明 |
-| :--- | :--- |
-| `{V}/4、{Name}-领域模型设计-{V}.md` | 分版本领域增量（如有） |
-| `8、{Name}-系统架构设计.md` | 系统架构 |
-| `2、{Name}-术语表与词汇表.md` | 术语 |
+> **文档说明**：基于 DDD（战略 + 战术）定义限界上下文、聚合、实体和值对象，并说明上下文协作方式、领域事件与仓储接口。
+>
+> **版本**：V1.0.0
+> **最后更新**：{YYYY-MM-DD}
 
 ---
 
+## 1. 文档信息
 
-> **文档说明**：
-> - 本文档用于描述产品的领域模型设计，包括领域划分、实体关系、领域服务等
-> - 基于领域驱动设计（DDD）思想，明确业务领域边界和核心概念
-> - `{}` 包裹的内容为占位符，请替换为实际内容
-> - 引用块 `>` 中的文字为填写指导，填写后可删除
+### 1.1 版本记录
 
----
+| 版本 | 日期 | 作者 | 变更说明 |
+| :--- | :--- | :--- | :--- |
+| V1.0.0 | {YYYY-MM-DD} | {姓名} | 初始版本 |
 
-## 1. 文档信息 (Document Info)
+### 1.2 关联文档
 
-### 1.1 版本记录
-| 版本号 | 修改日期 | 修改人 | 修改内容 | 备注 |
-| :--- | :--- | :--- | :--- | :--- |
-| V1.0.0 | {YYYY-MM-DD} | {姓名} | 初始版本 | - |
+| 文档 | 关联说明 |
+| :--- | :--- |
+| [2、术语表与词汇表](2、{Name}-术语表与词汇表.md) | 统一语言定义 |
+| [6、产品与版本规划](6、{Name}-产品与版本规划.md) | 功能边界与版本范围 |
+| [8、系统架构设计](8、{Name}-系统架构设计.md) | 架构分层承接 |
+
+### 1.3 文档责任人
 
-### 1.2 文档责任人
 | 角色 | 姓名 | 职责 |
 | :--- | :--- | :--- |
-| 架构师 | {姓名} | 领域模型设计、架构评审 |
-| 产品经理 | {姓名} | 业务需求确认、领域边界确认 |
-| 开发负责人 | {姓名} | 领域模型实现、技术评审 |
+| 领域专家 | {姓名} | 业务规则与模型验证 |
+| 架构师 | {姓名} | 聚合划分与上下文映射 |
 
 ---
 
 ## 2. 战略设计 (Strategic Design)
 
-### 2.1 限界上下文 (Bounded Contexts)
-> 基于业务复杂度与团队协作边界，将系统划分为核心上下文
+### 2.1 核心公式映射
 
-**上下文划分原则**：
-- **高内聚**：相关业务概念聚合在一起
-- **低耦合**：不同领域之间通过接口交互
-- **业务边界清晰**：每个领域有明确的业务边界
-- **团队边界**：考虑团队组织结构和协作边界
+```
+{Name} = {例如：商品域 + 订单域 + 店铺域 + 智能体域 + 运营域}
+```
 
-**限界上下文列表**：
+### 2.2 限界上下文
 
 ```mermaid
 graph TB
-    subgraph Core["核心域 (Core Domain)"]
-        OrderContext[订单上下文]
-        ScheduleContext[日程上下文]
-        ExecutionContext[执行上下文]
+    subgraph "核心域 (Core)"
+        PROD["商品上下文<br/>Product Context"]
+        ORDER["订单上下文<br/>Order Context"]
     end
-    
-    subgraph Support["支撑域 (Supporting Domain)"]
-        UserContext[用户上下文]
-        GamificationContext[激励上下文]
-        ContentContext[内容上下文]
+
+    subgraph "支撑域 (Supporting)"
+        STORE["店铺上下文<br/>Store Context"]
+        AGENT_CTX["智能体上下文<br/>Agent Context"]
     end
-    
-    subgraph Generic["通用域 (Generic Domain)"]
-        AuthContext[认证上下文]
-        PaymentContext[支付上下文]
-        ReportContext[报表上下文]
+
+    subgraph "通用域 (Generic)"
+        USER_CTX["用户上下文<br/>User Context"]
+        NOTIFY["通知上下文<br/>Notification Context"]
     end
+
+    PROD -->|"商品事件"| ORDER
+    ORDER -->|"订单状态"| STORE
+    AGENT_CTX -->|"执行结果"| PROD
+    AGENT_CTX -->|"执行结果"| ORDER
+    USER_CTX -->|"权限"| STORE
 ```
 
-| 上下文名称 | 上下文类型 | 领域描述 | 核心职责 |
+| 上下文 | 类型 | 核心职责 | 关键聚合 |
 | :--- | :--- | :--- | :--- |
-| {订单上下文} | 核心域 | {订单相关的业务逻辑} | {订单创建、订单处理、订单状态管理} |
-| {门店上下文} | 核心域 | {门店相关的业务逻辑} | {门店信息管理、门店数据统计} |
-| {用户上下文} | 支撑域 | {用户相关的业务逻辑} | {用户认证、用户信息管理、用户关系管理} |
-| {激励上下文} | 支撑域 | {激励相关的业务逻辑} | {积分、勋章、愿望清单} |
+| {例如：商品上下文} | 核心域 | {例如：商品全生命周期管理} | {例如：Product, Category} |
+| {例如：订单上下文} | 核心域 | {例如：订单创建、履约、退款} | {例如：Order, Payment} |
+| {例如：店铺上下文} | 支撑域 | {例如：店铺连接与平台对接} | {例如：Store, PlatformConnection} |
+| {例如：智能体上下文} | 支撑域 | {例如：Agent 配置、执行、调度} | {例如：AgentConfig, Execution} |
+| {例如：用户上下文} | 通用域 | {例如：用户认证、角色、权限} | {例如：User, Role, Tenant} |
+| {上下文} | {类型} | {职责} | {聚合} |
 
-### 2.2 统一语言 (Ubiquitous Language)
-> 定义领域内的统一术语，确保团队沟通一致
+### 2.3 上下文映射 (Context Map)
 
-| 中文术语 | 英文术语 | 定义/说明 |
-| :--- | :--- | :--- |
-| **订单** | `Order` | 客户下单产生的服务订单 |
-| **工单** | `WorkOrder` | 需要师傅执行的服务工单 |
-| **任务** | `Task` | 具体的待办事项，如"早读"、"跳绳" |
-| **打卡** | `CheckIn` | 用户完成任务的动作记录 |
-| **专注会话** | `FocusSession` | 一次完整的专注过程（如番茄钟） |
-| **积分** | `Points` | 用于激励体系的虚拟货币（UI显示为"星星"） |
-| **勋章** | `Badge` | 达成特定成就后获得的虚拟荣誉 |
-| **愿望** | `Wish` | 使用积分兑换的奖励（如周末去公园） |
-
-## 3. 领域概述 (Domain Overview)
+```mermaid
+graph LR
+    PROD["商品上下文"] -->|"OHS/PL"| ORDER["订单上下文"]
+    ORDER -->|"ACL"| STORE["店铺上下文"]
+    AGENT_CTX["智能体上下文"] -->|"Conformist"| PROD
+    USER_CTX["用户上下文"] -->|"Shared Kernel"| STORE
+```
 
-### 3.1 业务领域
-> 描述产品的业务领域
+| 上游 | 下游 | 关系类型 | 说明 |
+| :--- | :--- | :--- | :--- |
+| {例如：商品} | {例如：订单} | OHS/PL | {例如：商品发布事件触发订单域商品快照} |
+| {例如：订单} | {例如：店铺} | ACL | {例如：订单通过防腐层调用店铺 API} |
+| {例如：智能体} | {例如：商品} | Conformist | {例如：Agent 遵循商品域协议} |
+| {上游} | {下游} | {类型} | {说明} |
 
-**核心业务领域**：
-{例如：门店管理、订单管理、师傅管理、客户管理等}
+> **关系类型说明**：OHS = Open Host Service, PL = Published Language, ACL = Anti-Corruption Layer, SK = Shared Kernel
 
-**业务目标**：
-- {例如：提升门店运营效率}
-- {例如：优化订单处理流程}
-- {例如：提升服务质量}
+---
 
-### 3.2 领域划分
-> 明确领域划分
+## 3. 统一语言 (Ubiquitous Language)
 
-**领域列表**：
+| 领域概念 | 英文 | 定义 | 所属上下文 |
+| :--- | :--- | :--- | :--- |
+| {例如：商品} | Product | {例如：可上架到平台的商品实体} | 商品上下文 |
+| {例如：SKU} | SKU | {例如：库存管理最小单位} | 商品上下文 |
+| {例如：订单} | Order | {例如：用户购买行为的交易记录} | 订单上下文 |
+| {例如：履约} | Fulfillment | {例如：订单从创建到完成的全流程} | 订单上下文 |
+| {例如：平台连接} | Platform Connection | {例如：与外部电商平台的授权连接} | 店铺上下文 |
+| {概念} | {English} | {定义} | {上下文} |
 
-| 领域名称 | 领域描述 | 核心职责 |
-| :--- | :--- | :--- |
-| {订单领域} | {订单相关的业务逻辑} | {订单创建、订单处理、订单状态管理} |
-| {门店领域} | {门店相关的业务逻辑} | {门店信息管理、门店数据统计} |
-| {师傅领域} | {师傅相关的业务逻辑} | {师傅管理、师傅工作流程} |
-| {客户领域} | {客户相关的业务逻辑} | {客户信息管理、客户关系管理} |
+> **注意**：本表中的术语定义须与 [术语表](2、{Name}-术语表与词汇表.md) 保持完全一致。
 
 ---
 
-## 4. 战术设计 (Tactical Design)
+## 4. 核心聚合设计
 
-## 5. 核心领域 (Core Domain)
+### 4.1 {例如：商品聚合 (Product Aggregate)}
 
-### 3.1 {领域名称 - 例如：订单领域}
+```mermaid
+classDiagram
+    class Product {
+        <<AggregateRoot>>
+        +ProductId id
+        +String title
+        +Money price
+        +ProductStatus status
+        +List~SKU~ skus
+        +publish()
+        +updatePrice(Money)
+        +delist()
+    }
 
-#### 5.1.1 领域描述
-> 描述领域的业务职责和边界
+    class SKU {
+        <<Entity>>
+        +SkuId id
+        +String spec
+        +Money cost
+        +Integer stock
+    }
 
-**领域职责**：
-- {例如：订单的创建、处理、状态管理}
-- {例如：订单的分配、转派、完成}
-- {例如：订单的数据统计和分析}
+    class Money {
+        <<ValueObject>>
+        +BigDecimal amount
+        +Currency currency
+    }
 
-**领域边界**：
-- **包含**：订单实体、订单状态、订单操作
-- **不包含**：门店信息（属于门店领域）、客户信息（属于客户领域）
+    class ProductStatus {
+        <<ValueObject>>
+        DRAFT
+        PUBLISHED
+        DELISTED
+    }
 
-#### 5.1.2 聚合根 (Aggregate Root)
-> 定义聚合根，作为聚合的入口
+    Product "1" --> "*" SKU : contains
+    Product --> Money : price
+    Product --> ProductStatus : status
+    SKU --> Money : cost
+```
 
-**订单聚合根 (Order Aggregate)**：
-- **聚合根**：`Order`
-- **职责**：管理订单的完整生命周期，确保订单数据的一致性
-- **边界**：包含订单主信息、订单明细、订单状态等
+**不变量 (Invariants)**:
+- {例如：商品至少包含一个 SKU}
+- {例如：已发布商品不可删除，只能下架}
+- {例如：售价不得低于成本价}
 
-#### 5.1.3 领域实体 (Domain Entities)
+### 4.2 {例如：订单聚合 (Order Aggregate)}
 
-**订单实体 (Order)**：
 ```mermaid
 classDiagram
     class Order {
-        +String orderId
-        +String shopId
-        +String workerId
-        +String userId
+        <<AggregateRoot>>
+        +OrderId id
+        +TenantId tenantId
+        +StoreId storeId
         +OrderStatus status
-        +OrderType type
-        +DateTime appointmentDate
-        +Time appointmentTime
-        +Address serviceAddress
-        +Money paymentPrice
-        +DateTime createTime
-        +DateTime updateTime
+        +List~OrderItem~ items
+        +Money totalAmount
         +create()
-        +assignWorker()
-        +transferOrder()
-        +completeOrder()
-        +cancelOrder()
+        +pay()
+        +ship()
+        +complete()
+        +cancel()
     }
-    
+
     class OrderItem {
-        +String itemId
-        +String orderId
-        +String goodsName
-        +String picUrl
-        +Money paymentPrice
+        <<Entity>>
+        +OrderItemId id
+        +ProductSnapshot product
+        +Integer quantity
+        +Money subtotal
+    }
+
+    class ProductSnapshot {
+        <<ValueObject>>
+        +ProductId productId
+        +String title
+        +Money price
     }
-    
+
     class OrderStatus {
-        <<enumeration>>
+        <<ValueObject>>
         PENDING
-        ASSIGNED
-        IN_SERVICE
+        PAID
+        SHIPPED
         COMPLETED
         CANCELLED
     }
-    
-    Order "1" *-- "N" OrderItem : contains
-    Order --> OrderStatus : has
-```
-
-**实体属性说明**：
-
-| 属性 | 类型 | 说明 | 约束 |
-| :--- | :--- | :--- | :--- |
-| orderId | String | 订单ID | 主键，唯一标识 |
-| shopId | String | 门店ID | 外键，关联门店 |
-| workerId | String | 师傅ID | 外键，关联师傅 |
-| userId | String | 客户ID | 外键，关联客户 |
-| status | OrderStatus | 订单状态 | 枚举值 |
-| type | OrderType | 订单类型 | 枚举值（上门订单/服务订单） |
-| appointmentDate | DateTime | 预约日期 | 必填 |
-| appointmentTime | Time | 预约时间 | 必填 |
-| serviceAddress | Address | 服务地址 | 值对象 |
-| paymentPrice | Money | 订单金额 | 值对象，保留2位小数 |
-
-**实体方法说明**：
-- **create()**：创建订单，初始化订单状态为PENDING
-- **assignWorker(workerId)**：指派师傅，更新订单状态为ASSIGNED
-- **transferOrder(newWorkerId)**：转派订单，更新师傅和状态
-- **completeOrder()**：完成订单，更新订单状态为COMPLETED
-- **cancelOrder()**：取消订单，更新订单状态为CANCELLED
-
-#### 5.1.4 值对象 (Value Objects)
-
-**地址值对象 (Address)**：
-```mermaid
-classDiagram
-    class Address {
-        +String province
-        +String city
-        +String district
-        +String detail
-        +Double longitude
-        +Double latitude
-        +getFullAddress()
-        +calculateDistance(target)
-    }
-```
 
-**值对象属性说明**：
-
-| 属性 | 类型 | 说明 |
-| :--- | :--- | :--- |
-| province | String | 省份 |
-| city | String | 城市 |
-| district | String | 区县 |
-| detail | String | 详细地址 |
-| longitude | Double | 经度 |
-| latitude | Double | 纬度 |
-
-**金额值对象 (Money)**：
-```mermaid
-classDiagram
-    class Money {
-        +BigDecimal amount
-        +String currency
-        +add(Money)
-        +subtract(Money)
-        +multiply(BigDecimal)
-        +compareTo(Money)
-    }
+    Order "1" --> "*" OrderItem : contains
+    OrderItem --> ProductSnapshot : snapshot
+    Order --> OrderStatus : status
+    Order --> Money : totalAmount
 ```
 
-#### 5.1.5 领域服务 (Domain Services)
-
-**订单分配服务 (OrderAssignmentService)**：
-- **职责**：处理订单分配逻辑
-- **方法**：
-  - `assignOrder(orderId, workerId)`: 指派订单给师傅
-  - `transferOrder(orderId, newWorkerId)`: 转派订单
-  - `calculateDistance(orderId, workerLocation)`: 计算订单距离
-
-**订单状态服务 (OrderStatusService)**：
-- **职责**：管理订单状态流转
-- **方法**：
-  - `updateStatus(orderId, newStatus)`: 更新订单状态
-  - `validateStatusTransition(currentStatus, newStatus)`: 验证状态流转是否合法
-  - `getAvailableStatuses(currentStatus)`: 获取可用的状态列表
+**不变量 (Invariants)**:
+- {例如：已支付订单不可修改商品}
+- {例如：取消订单需退款}
+- {例如：订单总额 = Σ(订单项小计)}
 
-#### 5.1.6 领域事件 (Domain Events)
+### 4.3 {例如：租户聚合 (Tenant Aggregate)（商业版）}
 
-**订单已创建事件 (OrderCreatedEvent)**：
-- **触发时机**：订单创建成功
-- **事件数据**：订单ID、门店ID、客户ID、订单类型
-- **订阅者**：订单通知服务、数据统计服务
-
-**订单已分配事件 (OrderAssignedEvent)**：
-- **触发时机**：订单分配成功
-- **事件数据**：订单ID、师傅ID、分配时间
-- **订阅者**：通知服务（通知师傅）
-
-**订单已完成事件 (OrderCompletedEvent)**：
-- **触发时机**：订单完成
-- **事件数据**：订单ID、完成时间、服务时长
-- **订阅者**：数据统计服务、结算服务
-
----
-
-### 5.2 {领域名称 - 例如：门店领域}
-
-#### 5.2.1 领域描述
-> 描述领域的业务职责和边界
-
-**领域职责**：
-- {例如：门店信息管理}
-- {例如：门店数据统计}
-- {例如：门店配置管理}
-
-**领域边界**：
-- **包含**：门店实体、门店数据统计、门店配置
-- **不包含**：订单信息（属于订单领域）、师傅信息（属于师傅领域）
-
-#### 5.2.2 领域实体 (Domain Entities)
-
-**门店实体 (Shop)**：
 ```mermaid
 classDiagram
-    class Shop {
-        +String shopId
-        +String shopName
-        +Address location
-        +ShopStatus status
-        +ShopConfig config
-        +DateTime createTime
-        +DateTime updateTime
-        +updateInfo()
-        +updateConfig()
-        +getStatistics()
-    }
-    
-    class ShopConfig {
-        +Integer maxWorkers
-        +Integer maxOrders
-        +Boolean autoAssign
-        +Distance maxCheckInDistance
-    }
-    
-    class ShopStatistics {
-        +Integer todayVisitors
-        +Integer todayOrders
-        +Money todayRevenue
-        +Integer yesterdayVisitors
-        +Integer yesterdayOrders
-        +Money yesterdayRevenue
+    class Tenant {
+        <<AggregateRoot>>
+        +TenantId id
+        +String name
+        +PlanType plan
+        +TenantStatus status
+        +Quota quota
+        +activate()
+        +upgradePlan(PlanType)
+        +suspend()
     }
-    
-    Shop "1" --> "1" ShopConfig : has
-    Shop --> ShopStatistics : generates
-```
-
-**实体属性说明**：
-
-| 属性 | 类型 | 说明 |
-| :--- | :--- | :--- |
-| shopId | String | 门店ID |
-| shopName | String | 门店名称 |
-| location | Address | 门店位置 |
-| status | ShopStatus | 门店状态 |
-| config | ShopConfig | 门店配置 |
-
-#### 5.2.3 领域服务 (Domain Services)
-
-**门店统计服务 (ShopStatisticsService)**：
-- **职责**：计算门店统计数据
-- **方法**：
-  - `calculateTodayStatistics(shopId)`: 计算今日统计数据
-  - `calculateYesterdayStatistics(shopId)`: 计算昨日统计数据
-  - `compareStatistics(today, yesterday)`: 对比统计数据
 
----
-
-## 6. 支撑领域 (Supporting Domain)
-
-### 6.1 {领域名称 - 例如：用户领域}
+    class Quota {
+        <<ValueObject>>
+        +Integer maxAgents
+        +Integer maxStores
+        +Integer maxPlatforms
+    }
 
-#### 6.1.1 领域描述
-> 描述支撑领域的职责
+    class PlanType {
+        <<ValueObject>>
+        FREE
+        PRO
+        TEAM
+        ENTERPRISE
+    }
 
-**领域职责**：
-- {例如：用户认证、用户授权}
-- {例如：用户信息管理}
-- {例如：角色权限管理}
+    Tenant --> Quota : quota
+    Tenant --> PlanType : plan
+```
 
-**领域边界**：
-- **包含**：用户实体、角色实体、权限实体
-- **不包含**：业务逻辑（属于核心领域）
+**不变量 (Invariants)**:
+- {例如：免费版配额不可超出}
+- {例如：降级版本需检查当前资源使用}
 
-#### 6.1.2 领域实体 (Domain Entities)
+### 4.4 {例如：平台连接聚合 (PlatformConnection Aggregate)}
 
-**用户实体 (User)**：
 ```mermaid
 classDiagram
-    class User {
-        +String userId
-        +String username
-        +String phone
-        +UserRole role
-        +UserStatus status
-        +DateTime createTime
-        +authenticate()
-        +authorize()
-    }
-    
-    class UserRole {
-        <<enumeration>>
-        SHOP_OWNER
-        SHOP_STAFF
-        WORKER
-        CUSTOMER
+    class PlatformConnection {
+        <<AggregateRoot>>
+        +ConnectionId id
+        +StoreId storeId
+        +PlatformType platform
+        +ConnectionStatus status
+        +Credentials credentials
+        +connect()
+        +refresh()
+        +disconnect()
+        +healthCheck()
     }
-    
-    User --> UserRole : has
-```
-
----
-
-## 7. 通用领域 (Generic Domain)
-
-### 7.1 {领域名称 - 例如：通知领域}
-
-#### 5.1.1 领域描述
-> 描述通用领域的职责
-
-**领域职责**：
-- {例如：消息通知、推送通知}
-- {例如：短信通知、邮件通知}
 
-**领域边界**：
-- **包含**：通知实体、通知服务
-- **不包含**：业务逻辑（属于核心领域）
-
-#### 7.1.2 领域实体 (Domain Entities)
-
-**通知实体 (Notification)**：
-```mermaid
-classDiagram
-    class Notification {
-        +String notificationId
-        +String userId
-        +NotificationType type
-        +String title
-        +String content
-        +DateTime sendTime
-        +NotificationStatus status
-        +send()
-        +markAsRead()
+    class Credentials {
+        <<ValueObject>>
+        +String accessToken
+        +String refreshToken
+        +DateTime expiresAt
     }
-    
-    class NotificationType {
-        <<enumeration>>
-        SMS
-        EMAIL
-        PUSH
-        IN_APP
+
+    class ConnectionStatus {
+        <<ValueObject>>
+        ACTIVE
+        EXPIRED
+        DISCONNECTED
+        ERROR
     }
-    
-    Notification --> NotificationType : has
+
+    PlatformConnection --> Credentials : credentials
+    PlatformConnection --> ConnectionStatus : status
 ```
 
 ---
 
-## 8. 领域关系图 (Domain Relationships)
+## 5. 领域事件
 
-### 8.1 领域关系总览
-> 使用Mermaid图展示领域之间的关系
+### 5.1 事件清单
 
-```mermaid
-graph TB
-    subgraph Core["核心领域 (Core Domain)"]
-        OrderDomain[订单领域]
-        ShopDomain[门店领域]
-        WorkerDomain[师傅领域]
-    end
-    
-    subgraph Support["支撑领域 (Supporting Domain)"]
-        UserDomain[用户领域]
-        AuthDomain[认证领域]
-    end
-    
-    subgraph Generic["通用领域 (Generic Domain)"]
-        NotificationDomain[通知领域]
-        StatisticsDomain[统计领域]
-    end
-    
-    OrderDomain --> ShopDomain
-    OrderDomain --> WorkerDomain
-    OrderDomain --> UserDomain
-    ShopDomain --> UserDomain
-    WorkerDomain --> UserDomain
-    OrderDomain --> NotificationDomain
-    ShopDomain --> StatisticsDomain
-    OrderDomain --> StatisticsDomain
-```
+| 事件名 | 触发条件 | 发布上下文 | 消费上下文 | 说明 |
+| :--- | :--- | :--- | :--- | :--- |
+| {例如：ProductPublished} | {例如：商品发布成功} | 商品 | 订单、店铺 | {例如：触发商品同步} |
+| {例如：OrderCreated} | {例如：新订单创建} | 订单 | 店铺、通知 | {例如：触发发货流程} |
+| {例如：OrderShipped} | {例如：订单发货} | 订单 | 通知 | {例如：通知买家} |
+| {例如：AgentExecutionCompleted} | {例如：Agent 执行完成} | 智能体 | 商品、订单 | {例如：更新执行结果} |
+| {例如：TenantPlanUpgraded} | {例如：租户升级套餐} | 用户 | 全局 | {例如：更新配额} |
+| {例如：ConnectionExpired} | {例如：平台授权过期} | 店铺 | 通知 | {例如：提醒重新授权} |
+| {事件} | {条件} | {发布} | {消费} | {说明} |
 
-### 8.2 实体关系图 (Entity Relationship Diagram)
-> 使用ER图展示实体之间的关系
+### 5.2 事件流示意
 
 ```mermaid
-erDiagram
-    SHOP ||--o{ ORDER : has
-    SHOP ||--o{ WORKER : has
-    USER ||--o{ ORDER : places
-    WORKER ||--o{ ORDER : services
-    ORDER ||--|{ ORDER_ITEM : contains
-    ORDER }o--|| ADDRESS : has
-    
-    SHOP {
-        string shop_id PK
-        string shop_name
-        string status
-        datetime create_time
-    }
-    
-    ORDER {
-        string order_id PK
-        string shop_id FK
-        string worker_id FK
-        string user_id FK
-        string status
-        datetime appointment_date
-        time appointment_time
-        decimal payment_price
-        datetime create_time
-    }
-    
-    WORKER {
-        string worker_id PK
-        string shop_id FK
-        string name
-        string phone
-        string level_id
-        decimal score
-        int status
-    }
-    
-    USER {
-        string user_id PK
-        string username
-        string phone
-        string role
-        int status
-    }
-    
-    ORDER_ITEM {
-        string item_id PK
-        string order_id FK
-        string goods_name
-        string pic_url
-        decimal payment_price
-    }
-    
-    ADDRESS {
-        string address_id PK
-        string province
-        string city
-        string district
-        string detail
-        decimal longitude
-        decimal latitude
-    }
+sequenceDiagram
+    participant User as 用户
+    participant Agent as Agent 上下文
+    participant Product as 商品上下文
+    participant Store as 店铺上下文
+    participant Notify as 通知上下文
+
+    User->>Agent: 下达采集指令
+    Agent->>Product: ProductScraped 事件
+    Product->>Product: 创建商品草稿
+    Product->>Agent: ProductDraftCreated 事件
+    Agent->>Product: 发布商品
+    Product->>Store: ProductPublished 事件
+    Store->>Store: 同步到平台
+    Store-->>Notify: SyncCompleted 事件
+    Notify-->>User: 推送通知
 ```
 
 ---
 
-## 9. 领域服务接口 (Domain Service Interfaces)
-
-### 9.1 订单领域服务接口
-
-**订单分配服务接口 (IOrderAssignmentService)**：
-```typescript
-interface IOrderAssignmentService {
-  /**
-   * 指派订单给师傅
-   * @param orderId 订单ID
-   * @param workerId 师傅ID
-   * @returns 分配结果
-   */
-  assignOrder(orderId: string, workerId: string): Promise<AssignmentResult>;
-  
-  /**
-   * 转派订单
-   * @param orderId 订单ID
-   * @param newWorkerId 新师傅ID
-   * @returns 转派结果
-   */
-  transferOrder(orderId: string, newWorkerId: string): Promise<TransferResult>;
-  
-  /**
-   * 计算订单距离
-   * @param orderId 订单ID
-   * @param workerLocation 师傅位置
-   * @returns 距离（公里）
-   */
-  calculateDistance(orderId: string, workerLocation: Location): Promise<number>;
-}
-```
+## 6. 领域服务
 
-### 9.2 门店领域服务接口
-
-**门店统计服务接口 (IShopStatisticsService)**：
-```typescript
-interface IShopStatisticsService {
-  /**
-   * 获取门店统计数据
-   * @param shopId 门店ID
-   * @param date 日期
-   * @returns 统计数据
-   */
-  getStatistics(shopId: string, date: Date): Promise<ShopStatistics>;
-  
-  /**
-   * 对比统计数据
-   * @param today 今日统计
-   * @param yesterday 昨日统计
-   * @returns 对比结果
-   */
-  compareStatistics(today: ShopStatistics, yesterday: ShopStatistics): ComparisonResult;
-}
-```
+| 服务名 | 所属上下文 | 职责 | 跨聚合 |
+| :--- | :--- | :--- | :---: |
+| {例如：PricingService} | 商品 | {例如：根据策略计算售价} | 否 |
+| {例如：OrderFulfillmentService} | 订单 | {例如：协调发货流程} | 是 |
+| {例如：AgentSchedulingService} | 智能体 | {例如：调度 Agent 执行任务} | 是 |
+| {例如：QuotaEnforcementService} | 用户 | {例如：检查租户配额} | 是 |
+| {服务} | {上下文} | {职责} | — |
 
 ---
 
-## 10. 领域事件定义 (Domain Events Definition)
-
-### 10.1 事件列表
-> 列出所有领域事件
-
-| 事件名称 | 事件类型 | 触发时机 | 事件数据 | 订阅者 |
-| :--- | :--- | :--- | :--- | :--- |
-| OrderCreatedEvent | 订单已创建 | 订单创建成功 | orderId, shopId, userId, type | 通知服务、统计服务 |
-| OrderAssignedEvent | 订单已分配 | 订单分配成功 | orderId, workerId, assignTime | 通知服务 |
-| OrderCompletedEvent | 订单已完成 | 订单完成 | orderId, completeTime, duration | 统计服务、结算服务 |
-| OrderCancelledEvent | 订单已取消 | 订单取消 | orderId, cancelTime, reason | 通知服务、统计服务 |
-
-### 10.2 事件定义
-> 定义事件的数据结构
+## 7. 仓储接口 (Repository)
 
-**订单已创建事件 (OrderCreatedEvent)**：
 ```typescript
-interface OrderCreatedEvent {
-  eventId: string;
-  eventType: 'OrderCreated';
-  timestamp: Date;
-  data: {
-    orderId: string;
-    shopId: string;
-    userId: string;
-    orderType: OrderType;
-    appointmentDate: Date;
-    appointmentTime: Time;
-    paymentPrice: Money;
-  };
+// 商品仓储
+interface ProductRepository {
+  findById(id: ProductId): Promise<Product | null>;
+  findByStore(storeId: StoreId, page: PageRequest): Promise<Page<Product>>;
+  save(product: Product): Promise<void>;
+  delete(id: ProductId): Promise<void>;
 }
-```
-
----
 
-## 11. 领域模型规则 (Domain Model Rules)
-
-### 11.1 业务规则
-> 定义领域模型的业务规则
-
-**订单领域规则**：
-1. **订单创建规则**：
-   - 订单必须关联门店
-   - 订单必须关联客户
-   - 订单金额必须大于0
-   - 预约时间必须晚于当前时间
-
-2. **订单分配规则**：
-   - 只有待接单状态的订单才能分配
-   - 师傅必须属于订单所在门店
-   - 师傅状态必须为可用
-
-3. **订单状态流转规则**：
-   - 待接单 → 待服务 → 服务中 → 已完成
-   - 待接单 → 已取消
-   - 待服务 → 已取消
-   - 不允许跨状态流转
-
-**门店领域规则**：
-1. **门店创建规则**：
-   - 门店名称不能为空
-   - 门店位置必须有效
-   - 门店状态必须为有效状态
-
-2. **门店统计规则**：
-   - 统计数据按门店隔离
-   - 统计数据按日期统计
-   - 统计数据实时更新
-
-### 11.2 数据一致性规则
-> 定义数据一致性规则
-
-**订单数据一致性**：
-- 订单状态变更必须记录操作日志
-- 订单金额变更必须记录变更历史
-- 订单分配必须更新师傅工作状态
-
-**门店数据一致性**：
-- 门店信息变更必须记录变更历史
-- 门店统计数据必须与订单数据一致
-- 门店配置变更必须生效
-
----
+// 订单仓储
+interface OrderRepository {
+  findById(id: OrderId): Promise<Order | null>;
+  findByTenant(tenantId: TenantId, filter: OrderFilter): Promise<Page<Order>>;
+  save(order: Order): Promise<void>;
+}
 
-## 12. 领域模型实现 (Domain Model Implementation)
-
-### 12.1 实体实现
-> 说明实体的实现方式
-
-**订单实体实现**：
-```java
-@Entity
-@Table(name = "work_order_info")
-public class Order {
-    @Id
-    private String orderId;
-    
-    @Column(name = "shop_id")
-    private String shopId;
-    
-    @Column(name = "worker_id")
-    private String workerId;
-    
-    @Enumerated(EnumType.STRING)
-    @Column(name = "status")
-    private OrderStatus status;
-    
-    @Embedded
-    private Address serviceAddress;
-    
-    @Embedded
-    private Money paymentPrice;
-    
-    public void assignWorker(String workerId) {
-        if (this.status != OrderStatus.PENDING) {
-            throw new IllegalStateException("只能分配待接单状态的订单");
-        }
-        this.workerId = workerId;
-        this.status = OrderStatus.ASSIGNED;
-        // 发布领域事件
-        DomainEventPublisher.publish(new OrderAssignedEvent(this.orderId, workerId));
-    }
-    
-    public void completeOrder() {
-        if (this.status != OrderStatus.IN_SERVICE) {
-            throw new IllegalStateException("只能完成服务中状态的订单");
-        }
-        this.status = OrderStatus.COMPLETED;
-        // 发布领域事件
-        DomainEventPublisher.publish(new OrderCompletedEvent(this.orderId));
-    }
+// 租户仓储（商业版）
+interface TenantRepository {
+  findById(id: TenantId): Promise<Tenant | null>;
+  findByApiKey(key: string): Promise<Tenant | null>;
+  save(tenant: Tenant): Promise<void>;
 }
-```
 
-### 12.2 领域服务实现
-> 说明领域服务的实现方式
-
-**订单分配服务实现**：
-```java
-@Service
-public class OrderAssignmentService implements IOrderAssignmentService {
-    
-    @Autowired
-    private OrderRepository orderRepository;
-    
-    @Autowired
-    private WorkerRepository workerRepository;
-    
-    @Override
-    public AssignmentResult assignOrder(String orderId, String workerId) {
-        Order order = orderRepository.findById(orderId)
-            .orElseThrow(() -> new OrderNotFoundException(orderId));
-        
-        Worker worker = workerRepository.findById(workerId)
-            .orElseThrow(() -> new WorkerNotFoundException(workerId));
-        
-        // 业务规则验证
-        if (!order.getShopId().equals(worker.getShopId())) {
-            throw new BusinessException("师傅必须属于订单所在门店");
-        }
-        
-        if (worker.getStatus() != WorkerStatus.AVAILABLE) {
-            throw new BusinessException("师傅状态必须为可用");
-        }
-        
-        // 执行分配
-        order.assignWorker(workerId);
-        orderRepository.save(order);
-        
-        return new AssignmentResult(true, "分配成功");
-    }
+// 平台连接仓储
+interface PlatformConnectionRepository {
+  findByStore(storeId: StoreId): Promise<PlatformConnection[]>;
+  findActive(platform: PlatformType): Promise<PlatformConnection[]>;
+  save(connection: PlatformConnection): Promise<void>;
 }
 ```
 
 ---
 
-## 13. 领域模型映射 (Domain Model Mapping)
+## 8. 上下文关系类型速查
 
-### 13.1 实体到数据库映射
-> 说明实体到数据库表的映射关系
-
-| 实体 | 数据库表 | 映射说明 |
-| :--- | :--- | :--- |
-| Order | work_order_info | 订单主表 |
-| OrderItem | work_order_item | 订单明细表 |
-| Shop | shop_info | 门店信息表 |
-| Worker | worker_user | 师傅表 |
-| User | user_info | 用户表 |
-
-### 13.2 值对象映射
-> 说明值对象到数据库字段的映射
-
-| 值对象 | 数据库字段 | 映射说明 |
-| :--- | :--- | :--- |
-| Address | service_address, service_address_lng, service_address_lat | 地址值对象映射到多个字段 |
-| Money | payment_price | 金额值对象映射到decimal字段 |
+| 关系类型 | 缩写 | 含义 | 适用场景 |
+| :--- | :--- | :--- | :--- |
+| Shared Kernel | SK | 共享代码/模型 | 紧密协作的上下文 |
+| Customer-Supplier | C/S | 上游供应，下游消费 | 有明确上下游关系 |
+| Conformist | CF | 下游完全遵循上游 | 下游无需变换 |
+| Anti-Corruption Layer | ACL | 下游添加防腐层 | 隔离外部系统变化 |
+| Open Host Service | OHS | 上游提供标准 API | 上游为多消费者服务 |
+| Published Language | PL | 标准化数据格式 | 跨上下文数据交换 |
 
 ---
 
-## 14. 领域模型演进 (Domain Model Evolution)
+## 9. 领域对象关系图
 
-### 14.1 版本历史
-> 记录领域模型的版本历史
-
-| 版本 | 日期 | 变更内容 | 变更原因 |
-| :--- | :--- | :--- | :--- |
-| V1.0.0 | {YYYY-MM-DD} | 初始版本 | 初始设计 |
-| V1.1.0 | {YYYY-MM-DD} | 新增订单转派功能 | 业务需求 |
-| V1.2.0 | {YYYY-MM-DD} | 优化订单状态流转 | 业务优化 |
-
-### 14.2 未来规划
-> 说明领域模型的未来规划
-
-**规划内容**：
-- {例如：增加订单评价领域}
-- {例如：增加客户关系管理领域}
-- {例如：优化订单分配算法}
+```mermaid
+classDiagram
+    Product "1" --> "*" SKU
+    Product "1" --> "1" ProductStatus
+    Order "1" --> "*" OrderItem
+    OrderItem --> ProductSnapshot
+    Tenant "1" --> "*" Store
+    Store "1" --> "*" PlatformConnection
+    Store "1" --> "*" Product
+    AgentConfig "1" --> "*" Execution
+    Execution --> Product
+    Execution --> Order
+```
 
 ---
 
-## 15. 附录 (Appendix)
+## 10. 演进与治理
 
-### 15.1 术语表
-> 定义文档中使用的专业术语
-
-| 术语 | 定义 |
+| 维度 | 规则 |
 | :--- | :--- |
-| 领域 (Domain) | 业务领域，一组相关的业务概念和规则 |
-| 实体 (Entity) | 有唯一标识的业务对象 |
-| 值对象 (Value Object) | 没有唯一标识，通过值相等判断的对象 |
-| 领域服务 (Domain Service) | 不属于特定实体的业务逻辑 |
-| 领域事件 (Domain Event) | 领域内发生的重要业务事件 |
-| 聚合 (Aggregate) | 一组相关对象的集合，有明确的边界 |
-| 仓储 (Repository) | 封装数据访问逻辑的接口 |
-
-### 15.2 参考文档
-> 列出参考的相关文档
-
-- [需求分析模板](4、需求分析模板.md)
-- [PRD文档模板](5、PRD文档模板.md)
-- [系统架构设计模板](9、系统架构设计模板.md)
-- [技术细分模板](10、技术细分模板.md)
-
-### 15.3 变更记录
-> 记录领域模型变更的历史
-
-| 变更日期 | 变更内容 | 变更原因 | 变更人 |
-| :--- | :--- | :--- | :--- |
-| {YYYY-MM-DD} | {变更内容描述} | {变更原因} | {姓名} |
+| 新增上下文 | {例如：需领域专家 + 架构师共同评审} |
+| 聚合拆分 | {例如：当聚合事务边界过大时考虑拆分} |
+| 事件版本 | {例如：使用 CloudEvents 规范，语义化版本} |
+| 模型同步 | {例如：每次 Sprint 结束同步更新领域模型文档} |
+| 代码一致 | {例如：代码中的 Entity/VO/Service 命名须与本文一致} |
 
 ---
 
-**文档版本**：V1.0.0  
-**创建时间**：{YYYY-MM-DD}  
-**最后更新**：{YYYY-MM-DD}  
-**文档状态**：✅ 设计中 / ✅ 待评审 / ✅ 评审通过 / ✅ 已完成
+**文档版本**：V1.0.0
+**创建日期**：{YYYY-MM-DD}
+**最后更新**：{YYYY-MM-DD}
+**文档状态**：✅ 待评审

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

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

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

@@ -1,704 +1,323 @@
 # {Name} 视觉与交互 DNA 规范
 
-> **标准说明**：本文由 原「视觉与交互 DNA」阶段模板全文 全文合并。
-
-### 关联文档
-
-| 文档 | 说明 |
-| :--- | :--- |
-| `{V}/7、{Name}-UI设计说明-{V}.md` | 版本 UI 总说明 |
-| `10、{Name}-功能菜单与版本规划.md` | 菜单 |
-
----
-
-
-> **文档说明**：
-> - 本文档定义产品的视觉设计语言和交互设计规范，确保产品设计的一致性和品牌识别度
-> - DNA（Design & Navigation Architecture）规范是产品设计的核心指导原则
-> - `{}` 包裹的内容为占位符，请替换为实际内容
-> - 引用块 `>` 中的文字为填写指导，填写后可删除
+> **文档说明**：定义视觉语言、交互原则、组件规范、页面布局与体验基线，确保产品在多版本、多端下保持一致性。
+>
+> **版本**：V1.0.0
+> **最后更新**：{YYYY-MM-DD}
 
 ---
 
-## 1. 文档信息 (Document Info)
+## 1. 文档信息
 
 ### 1.1 版本记录
-| 版本号 | 修改日期 | 修改人 | 修改内容 | 备注 |
-| :--- | :--- | :--- | :--- | :--- |
-| V1.0.0 | {YYYY-MM-DD} | {姓名} | 初始版本 | - |
 
-### 1.2 文档责任人
-| 角色 | 姓名 | 职责 |
-| :--- | :--- | :--- |
-| 设计负责人 | {姓名} | DNA规范制定、设计评审 |
-| UI设计师 | {姓名} | 设计规范执行、设计实现 |
-| 产品经理 | {姓名} | 需求确认、设计评审 |
+| 版本 | 日期 | 作者 | 变更说明 |
+| :--- | :--- | :--- | :--- |
+| V1.0.0 | {YYYY-MM-DD} | {姓名} | 初始版本 |
 
 ---
 
-## 2. 设计理念 (Design Philosophy)
-
-### 2.1 设计原则
-> 定义产品设计的核心原则
-
-**简洁高效**：
-- 界面简洁，信息层次清晰
-- 操作流程高效，减少用户操作步骤
-- 功能直达，减少导航层级
+## 2. 设计原则
 
-**专业可信**：
-- 视觉风格专业，体现产品专业性
-- 信息准确，数据可靠
-- 交互稳定，减少错误
-
-**友好易用**：
-- 交互友好，符合用户习惯
-- 反馈及时，操作有明确反馈
-- 容错性强，支持撤销和重试
-
-### 2.2 品牌调性
-> 定义产品的品牌调性和视觉风格
+| 原则 | 说明 | 体现 |
+| :--- | :--- | :--- |
+| {例如：清晰 (Clarity)} | {例如：信息层次分明，一眼可见核心内容} | {例如：大标题 + 关键指标卡片} |
+| {例如：效率 (Efficiency)} | {例如：减少操作步骤，常用功能一键触达} | {例如：批量操作、快捷键} |
+| {例如：一致 (Consistency)} | {例如：跨页面、跨版本视觉语言统一} | {例如：统一组件库 + Design Token} |
+| {例如：友好 (Friendly)} | {例如：温和色彩、流畅动效、清晰反馈} | {例如：操作确认、状态提示} |
 
-**品牌调性**：
-- **专业**：体现产品的专业性和可靠性
-- **高效**：体现产品的高效性和便捷性
-- **友好**：体现产品的友好性和易用性
-- **陪伴与成长**：{例如：partme-ai的设计不仅仅是工具，更是孩子的伙伴。设计语言应体现：趣味性、安全感、仪式感、简洁性}
+### 2.1 品牌气质
 
-**视觉风格**：
-- **现代简约**：采用现代简约的设计风格，突出内容
-- **清晰明确**：信息层次清晰，视觉引导明确
-- **统一协调**：色彩、字体、间距统一协调
-- **多主题支持**：{例如：支持探索版、梦幻版、少年版等多种主题，满足不同年龄段和性格偏好的用户需求}
+- {例如：专业而不冰冷 —— 科技蓝搭配暖色点缀}
+- {例如：高效而不压迫 —— 合理留白、渐进式信息展示}
+- {例如：智能而不神秘 —— Agent 执行过程可视化}
 
 ---
 
-## 3. 视觉设计规范 (Visual Design System)
-
-### 3.1 色彩系统 (Color System)
-
-#### 3.1.1 主色调
-> 定义产品的主色调，支持多主题模式
-
-**主题模式**：
-> 根据产品定位，可支持多种主题模式，满足不同用户群体需求
-
-| 模式 | 主色 (Primary) | 辅助色 (Secondary) | 强调色 (Accent) | 背景色 (Background) | 适用场景 |
-| :--- | :--- | :--- | :--- | :--- | :--- |
-| **现代清新 (推荐)** | #2ECC71 (薄荷绿) | #D5F5E3 (浅绿) | #FEF5E7 (浅橘) | #F8FBF9 (呼吸白) | 全年龄通用，高品质视觉 |
-| **通用版 (General)** | #FFD54F (品牌黄) | #FFFFFF (纯白) | #4CAF50 (成功绿) | #FFFFFF (白色) | 3-12岁基础视觉 |
-| **梦幻版 (Dream)** | #F8BBD0 (樱花粉) | #FFF9C4 (奶油黄) | #BA68C8 (淡雅紫) | #FFF0F5 (薰衣草) | 3-10岁感性向 |
-| **探索版 (Explore)** | #2196F3 (科技蓝) | #00BCD4 (青色) | #FF9800 (活力橙) | #E1F5FE (天蓝) | 7-12岁理性向 |
-| **少年版 (Teen)** | #000000 (纯黑) | #1A1A1A (深灰) | #00FF9D (霓虹绿) | #000000 (纯黑) | 12-18岁赛博风 |
-
-**主色**（默认主题）：
-- **主色-主**：`#007AFF`（蓝色）
-  - **使用场景**：主要按钮、链接、选中状态、重要信息
-  - **RGB**：`rgb(0, 122, 255)`
-  - **HSL**：`hsl(210, 100%, 50%)`
-
-**主色-浅**：`#E6F2FF`（浅蓝色）
-  - **使用场景**：背景、标签背景、选中状态背景
-  - **RGB**：`rgb(230, 242, 255)`
-
-**主色-深**：`#0051D5`（深蓝色）
-  - **使用场景**：按钮按下状态、链接悬停状态
-  - **RGB**：`rgb(0, 81, 213)`
-
-**色彩原则**：
-> 定义色彩使用的基本原则
-
-1. **状态关联**：完成/成功态使用绿色，待办/进行态使用淡橙色
-2. **分色管理**：不同功能入口采用淡彩色背景区分（如淡蓝、淡绿、淡紫）
-3. **文字对比**：主文字使用深灰，次要说明使用中灰
-
-#### 3.1.2 功能色
-> 定义功能色（成功、警告、错误、信息）
-
-**成功色**：
-- **成功-主**：`#34C759`（绿色）
-  - **使用场景**：成功提示、完成状态、正向操作
-- **成功-浅**：`#E6F7ED`（浅绿色）
-  - **使用场景**：成功状态背景
-
-**警告色**：
-- **警告-主**：`#FF9500`（橙色）
-  - **使用场景**：警告提示、待处理状态、注意信息
-- **警告-浅**：`#FFF4E6`（浅橙色）
-  - **使用场景**：警告状态背景
-
-**错误色**：
-- **错误-主**：`#FF3B30`（红色）
-  - **使用场景**：错误提示、失败状态、危险操作
-- **错误-浅**：`#FFE6E6`（浅红色）
-  - **使用场景**：错误状态背景
-
-**信息色**：
-- **信息-主**：`#5AC8FA`（浅蓝色）
-  - **使用场景**：信息提示、说明文字
-- **信息-浅**：`#E6F7FD`（浅蓝色）
-  - **使用场景**：信息状态背景
-
-#### 3.1.3 中性色
-> 定义中性色（文字、背景、分割线等）
-
-**文字颜色**：
-- **文字-主**：`#000000`（黑色）
-  - **使用场景**：主要文字、标题
-- **文字-次**：`#666666`（深灰色）
-  - **使用场景**：次要文字、正文
-- **文字-辅助**：`#999999`（灰色）
-  - **使用场景**：辅助文字、说明文字
-- **文字-禁用**：`#CCCCCC`（浅灰色）
-  - **使用场景**：禁用状态文字
-
-**背景颜色**：
-- **背景-主**：`#FFFFFF`（白色）
-  - **使用场景**：页面背景、卡片背景
-- **背景-次**：`#F5F5F5`（浅灰色）
-  - **使用场景**：列表背景、分割区域背景
-- **背景-遮罩**：`rgba(0, 0, 0, 0.5)`（半透明黑色）
-  - **使用场景**：弹窗遮罩、浮层遮罩
-
-**分割线颜色**：
-- **分割线-主**：`#E5E5E5`（浅灰色）
-  - **使用场景**：列表分割线、卡片分割线
-- **分割线-次**：`#F0F0F0`（浅灰色）
-  - **使用场景**：区域分割线
-
-### 3.2 字体系统 (Typography System)
-
-#### 3.2.1 字体家族
-> 定义字体家族
-
-**中文字体**：
-- **iOS**：PingFang SC
-- **Android**：Microsoft YaHei（微软雅黑）
-- **Web**：-apple-system, BlinkMacSystemFont, "Segoe UI", "Microsoft YaHei", sans-serif
-
-**英文字体**：
-- **iOS**：SF Pro Text
-- **Android**：Roboto
-- **Web**：-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif
-
-#### 3.2.2 字号规范
-> 定义字号规范
-
-| 字号 | 使用场景 | 示例 | 字重 |
-| :--- | :--- | :--- | :--- |
-| 32px | 页面主标题 | 首页标题 | Semibold (600) |
-| 28px | 模块标题 | 工单、我的 | Semibold (600) |
-| 24px | 卡片标题 | 订单卡片标题 | Medium (500) |
-| 20px | 正文内容 | 订单详情、列表内容 | Regular (400) |
-| 18px | 辅助文字 | 说明文字、提示文字 | Regular (400) |
-| 16px | 次要文字 | 标签文字、时间文字 | Regular (400) |
-| 14px | 小号文字 | 底部提示、状态文字 | Regular (400) |
-
-#### 3.2.3 行高规范
-> 定义行高规范
-
-- **单行文字**：行高 = 字号 × 1.2
-- **多行文字**：行高 = 字号 × 1.5
-- **列表项**：行高 = 字号 × 1.8
-
-### 3.3 图形与材质 (Graphics & Texture)
-> 定义图形风格和材质效果
-
-**3D 粘土质感 (Claymorphism)**：
-- **说明**：按钮和卡片应具有微小的内阴影和柔和的外阴影，模拟真实物理世界的触感
-- **应用场景**：按钮、卡片、弹窗等交互元素
-
-**圆角规范**：
-- **硬件端**：12px - 24px（甚至全圆）
-- **移动端**：16px（卡片），8px（小按钮）
-- **Web端**：8px（卡片），4px（小按钮）
-
-**图标风格**：
-- **风格**：圆润的粗线条图标，避免尖锐边缘，增加安全感
-- **尺寸**：16px（小图标）、24px（中图标）、32px（大图标）
+## 3. 色彩体系
 
-### 3.4 间距系统 (Spacing System)
-
-#### 3.3.1 基础间距单位
-> 定义基础间距单位
+### 3.1 品牌主色
 
-**基础间距单位**：8px（所有间距应为8px的倍数）
+| 色名 | 色值 | 用途 | 示例 |
+| :--- | :--- | :--- | :--- |
+| 主色 (Primary) | {例如：#1A73E8} | {例如：按钮、链接、选中态} | {例如：主操作按钮} |
+| 主色悬浮 | {例如：#1557B0} | {例如：Hover 状态} | — |
+| 主色按下 | {例如：#0D47A1} | {例如：Active 状态} | — |
+
+```css
+/* CSS 变量示例 */
+:root {
+  --color-primary: #1A73E8;
+  --color-primary-hover: #1557B0;
+  --color-primary-active: #0D47A1;
+  --color-primary-light: #E8F0FE;
+}
+```
 
-#### 3.3.2 间距规范
-> 定义间距规范
+### 3.2 状态色
 
-| 间距值 | 使用场景 | 示例 |
+| 状态 | 色值 | 用途 |
 | :--- | :--- | :--- |
-| 4px | 紧密元素间距 | 图标与文字间距 |
-| 8px | 小间距 | 列表项内元素间距 |
-| 12px | 中小间距 | 卡片内元素间距 |
-| 16px | 中等间距 | 卡片之间间距 |
-| 24px | 大间距 | 模块之间间距 |
-| 32px | 超大间距 | 页面上下边距 |
+| 成功 (Success) | {例如：#34A853} | {例如：操作成功、在线状态} |
+| 警告 (Warning) | {例如：#FBBC04} | {例如：注意提示、过期预警} |
+| 错误 (Error) | {例如：#EA4335} | {例如：操作失败、必填校验} |
+| 信息 (Info) | {例如：#4285F4} | {例如：提示信息、帮助} |
 
-#### 3.3.3 页面边距
-> 定义页面边距
+### 3.3 平台品牌色（图标标识）
 
-- **页面左右边距**：16px
-- **页面上下边距**：16px
-- **卡片内边距**：16px
-
-### 3.5 圆角系统 (Border Radius System)
-
-| 圆角值 | 使用场景 | 示例 |
+| 平台 | 色值 | 用途 |
 | :--- | :--- | :--- |
-| 4px | 小圆角 | 标签、小按钮 |
-| 8px | 中等圆角 | 卡片、输入框 |
-| 12px | 大圆角 | 大卡片、弹窗 |
-| 16px | 超大圆角 | 头像、特殊卡片 |
-| 50% | 圆形 | 头像、圆形按钮 |
+| {例如：淘宝} | {例如：#FF5000} | {例如：平台标识、连接卡片} |
+| {例如：拼多多} | {例如：#E02E24} | 同上 |
+| {例如：Amazon} | {例如：#FF9900} | 同上 |
+| {平台} | {色值} | — |
 
-### 3.6 阴影系统 (Shadow System)
+### 3.4 版本标识色
 
-| 阴影类型 | 使用场景 | 阴影参数 |
+| 版本 | 色值 | 标签 |
 | :--- | :--- | :--- |
-| 小阴影 | 卡片、列表项 | `0 2px 8px rgba(0,0,0,0.08)` |
-| 中阴影 | 弹窗、浮层 | `0 4px 16px rgba(0,0,0,0.12)` |
-| 大阴影 | 模态弹窗 | `0 8px 24px rgba(0,0,0,0.16)` |
-
-### 3.7 图标系统 (Icon System)
-
-#### 3.6.1 图标尺寸
-> 定义图标尺寸
-
-- **小图标**：16px × 16px（用于列表项、标签）
-- **中图标**：24px × 24px（用于按钮、卡片）
-- **大图标**：32px × 32px（用于页面标题、重要操作）
-
-#### 3.6.2 图标风格
-> 定义图标风格
-
-- **线性图标**：用于常规操作、导航
-- **填充图标**：用于选中状态、重要操作
-- **图标颜色**：跟随文字颜色或功能色
+| 🆓 Free | {例如：#9E9E9E} | 灰色 |
+| 👤 Pro | {例如：#1A73E8} | 蓝色 |
+| 👥 Team | {例如：#7B1FA2} | 紫色 |
+| 🏢 Enterprise | {例如：#FF6F00} | 橙色 |
 
 ---
 
-## 4. 交互设计规范 (Interaction Design System)
-
-### 4.1 交互原则
-> 定义交互设计原则
-
-**即时反馈**：
-- 用户操作后立即给出反馈
-- 加载状态明确显示
-- 操作结果清晰提示
-
-**容错设计**：
-- 支持撤销和重试
-- 错误提示友好明确
-- 操作确认机制完善
-
-**一致性**：
-- 相同功能使用相同交互方式
-- 交互模式统一
-- 操作习惯一致
-
-### 4.2 交互动效
-> 定义交互动效规范
-
-#### 4.2.1 页面转场动画
-- **进入动画**：从右侧滑入，时长300ms，缓动函数 `ease-out`
-- **退出动画**：向左侧滑出，时长300ms，缓动函数 `ease-in`
-
-#### 4.2.2 弹窗动画
-- **进入动画**：从底部向上滑入，时长300ms，缓动函数 `ease-out`
-- **退出动画**：向底部滑出，时长300ms，缓动函数 `ease-in`
-- **背景遮罩**：淡入淡出，时长300ms
-
-#### 4.2.3 按钮动画
-- **按下动画**：背景色变深，缩放0.98，时长100ms
-- **释放动画**：恢复原状，时长100ms
-
-### 4.3 交互反馈
-> 定义交互反馈方式
-
-**视觉反馈**：
-- **成功操作**：所有的成功操作必须伴随"撒花"或"星星飞入"动画
-- **按钮点击**：显示点击态（颜色变化或阴影效果）
-- **列表项点击**：显示点击态，跳转页面
-- **卡片点击**：显示点击态，跳转详情页
+## 4. 字体与排版
 
-**听觉反馈**：
-- **TTS语音**：温暖的TTS回应（非机械音），用于重要操作确认
-- **音效**：轻快的音效（如Cha-ching!），用于成功操作
+### 4.1 字体堆栈
 
-**触觉反馈**：
-- **线性马达**：短震动（Haptic），模拟真实按键感
-- **应用场景**：按钮点击、重要操作确认
-
-**加载反馈**：
-- 页面加载：显示Loading动画
-- 列表加载：显示下拉刷新动画、上拉加载动画
-- 操作提交：显示Loading提示，防止重复提交
-
-**成功反馈**：
-- 操作成功：显示Toast提示（如"抢单成功"、"切换成功"）
-- 数据更新：自动刷新页面或列表
-
-**失败反馈**：
-- 网络异常：显示Toast提示"网络异常，请稍后重试"，支持重试
-- 操作失败：显示Toast提示具体错误信息
-- 数据加载失败：显示空状态，支持重试
+| 用途 | 字体 | 备选 |
+| :--- | :--- | :--- |
+| 英文正文 | {例如：Inter} | {例如：-apple-system, Segoe UI} |
+| 中文正文 | {例如：思源黑体} | {例如：PingFang SC, Microsoft YaHei} |
+| 代码 | {例如：JetBrains Mono} | {例如：Menlo, Consolas} |
 
-### 4.4 跨端同步逻辑 (Cross-Terminal Logic)
-> 定义跨端同步的交互逻辑
+```css
+:root {
+  --font-sans: 'Inter', 'PingFang SC', 'Microsoft YaHei', sans-serif;
+  --font-mono: 'JetBrains Mono', 'Menlo', monospace;
+}
+```
 
-**同步策略**：
-- **毫秒级反馈**：{例如：家长在App修改设置后，硬件端需在3s内展示同步动效（如partme-ai点头并说"收到啦"）}
-- **冲突解决策略**：{例如：家长指令优先级最高（Parent-First），冲突时提示"妈妈修改了计划哦"}
+### 4.2 字号层级
 
-**同步场景**：
-- 设置同步：App端修改设置，设备端实时同步
-- 状态同步：设备端状态变更，App端实时更新
-- 数据同步：离线数据同步，支持断点续传
+| 层级 | 字号 | 行高 | 用途 |
+| :--- | :--- | :--- | :--- |
+| H1 | {例如：24px} | {例如：32px} | 页面标题 |
+| H2 | {例如：20px} | {例如：28px} | 区块标题 |
+| H3 | {例如：16px} | {例如：24px} | 卡片标题 |
+| Body | {例如：14px} | {例如：22px} | 正文 |
+| Caption | {例如：12px} | {例如：18px} | 辅助说明 |
 
----
+### 4.3 间距系统
 
-## 5. 组件设计规范 (Component Design System)
-
-### 5.1 按钮组件
-> 定义按钮组件规范
-
-**主要按钮（Primary Button）**：
-- 背景色：主色 `#007AFF`
-- 文字颜色：白色 `#FFFFFF`
-- 圆角：8px
-- 高度：44px（最小点击区域）
-- 字体：18px，Medium
-
-**次要按钮（Secondary Button）**：
-- 背景色：透明或浅灰色背景
-- 文字颜色：主色 `#007AFF`
-- 边框：1px，主色 `#007AFF`
-- 圆角：8px
-- 高度：44px
-
-### 5.2 输入框组件
-> 定义输入框组件规范
-
-**文本输入框**：
-- 背景色：白色 `#FFFFFF`
-- 边框：1px，颜色 `#E5E5E5`
-- 圆角：8px
-- 高度：44px
-- 字体：18px，Regular
-
-**搜索框**：
-- 背景色：`#F5F5F5`
-- 圆角：20px（高度的一半，形成胶囊形状）
-- 高度：40px
-
-### 5.3 卡片组件
-> 定义卡片组件规范
-
-**订单卡片**：
-- 背景色：白色 `#FFFFFF`
-- 圆角：12px
-- 内边距：16px
-- 阴影：小阴影 `0 2px 8px rgba(0,0,0,0.08)`
-- 间距：卡片之间间距16px
-
-### 5.4 列表组件
-> 定义列表组件规范
-
-**订单列表**：
-- 背景色：`#F5F5F5`（列表背景）、白色（卡片背景）
-- 间距：卡片之间间距16px
-- 下拉刷新：显示刷新动画，颜色主色 `#007AFF`
-- 上拉加载：显示加载动画，颜色主色 `#007AFF`
-
-### 5.5 弹窗组件
-> 定义弹窗组件规范
-
-**确认弹窗**：
-- 背景遮罩：`rgba(0,0,0,0.5)`，点击遮罩关闭弹窗
-- 弹窗背景：白色 `#FFFFFF`
-- 圆角：12px（顶部）
-- 宽度：屏幕宽度 - 64px（左右各32px边距）
-- 内边距：24px
+| Token | 值 | 用途 |
+| :--- | :--- | :--- |
+| `--space-xs` | {例如：4px} | 紧凑间距 |
+| `--space-sm` | {例如：8px} | 元素间距 |
+| `--space-md` | {例如：16px} | 区块内间距 |
+| `--space-lg` | {例如：24px} | 区块间间距 |
+| `--space-xl` | {例如：32px} | 页面级间距 |
 
 ---
 
-## 6. 适配规范 (Adaptation Guidelines)
-
-### 6.1 屏幕适配
-> 定义屏幕适配规范
+## 5. 布局规范
+
+### 5.1 Web Console 主布局
+
+```
+┌──────────────────────────────────────────────┐
+│  Logo    搜索框           通知 🔔  头像 ▾   │  顶栏 (56px)
+├────────┬─────────────────────────────────────┤
+│        │                                     │
+│  菜单   │  面包屑 > 当前页                    │
+│        │                                     │
+│  ─ 仪表盘│  ┌─────────┐ ┌─────────┐          │
+│  ─ 商品 │  │ 统计卡片  │ │ 统计卡片  │         │
+│  ─ 订单 │  └─────────┘ └─────────┘          │
+│  ─ 店铺 │                                     │
+│  ─ Agent│  ┌────────────────────────┐        │
+│  ─ 设置 │  │     数据表格 / 内容区     │       │
+│        │  │                          │       │
+│        │  └────────────────────────┘        │
+├────────┴─────────────────────────────────────┤
+│  © {组织}  版本 v1.0.0                        │  底栏 (可选)
+└──────────────────────────────────────────────┘
+```
+
+| 区域 | 宽度 | 高度 | 说明 |
+| :--- | :--- | :--- | :--- |
+| 顶栏 | 100% | {例如：56px} | Logo + 搜索 + 通知 + 用户 |
+| 侧栏 | {例如：220px (展开) / 64px (折叠)} | 满高 | 一级菜单 |
+| 内容区 | 自适应 | 自适应 | 面包屑 + 功能区 |
 
-**屏幕尺寸适配**：
-- **小屏**（iPhone SE，375×667）：内容正常显示，字体和间距按比例缩放
-- **中屏**（iPhone 12，390×844）：内容正常显示
-- **大屏**（iPhone 14 Pro Max，430×932）：内容正常显示，左右边距适当增加
+### 5.2 页面模式
 
-**安全区域适配**：
-- **底部安全区域**：操作按钮栏需要适配底部安全区域（iPhone X及以上机型）
-- **顶部安全区域**：状态栏高度适配（刘海屏、灵动岛）
+| 模式 | 说明 | 适用 |
+| :--- | :--- | :--- |
+| {例如：列表页} | {例如：筛选条 + 操作栏 + 数据表格 + 分页} | {例如：商品列表、订单列表} |
+| {例如：详情页} | {例如：信息卡片 + Tab 切换 + 操作按钮} | {例如：商品详情、订单详情} |
+| {例如：表单页} | {例如：步骤条 + 表单区 + 提交/取消} | {例如：新建商品、编辑设置} |
+| {例如：Dashboard} | {例如：统计卡片 + 图表 + 快捷操作} | {例如：首页仪表盘} |
 
-### 6.2 深色模式适配
-> 定义深色模式适配规范（如需要）
+### 5.3 响应式断点
 
-**深色模式**：
-- **背景色**：深色背景 `#000000`
-- **文字颜色**：浅色文字 `#FFFFFF`
-- **卡片背景**：深灰色 `#1C1C1E`
-- **分割线**：深灰色 `#38383A`
+| 断点 | 宽度 | 布局 |
+| :--- | :--- | :--- |
+| Desktop L | ≥ 1440px | {例如：侧栏展开 + 内容区最大宽度 1200px} |
+| Desktop | ≥ 1024px | {例如：侧栏展开} |
+| Tablet | ≥ 768px | {例如：侧栏折叠} |
+| Mobile | < 768px | {例如：底部导航替代侧栏} |
 
 ---
 
-## 6. 教育心理学应用 (Educational Strategy)
-> 定义基于教育心理学的设计策略
+## 6. 组件规范
 
-**去排名化**：
-- 不设排行榜，只设"自我超越"成就
-- 强调个人成长，而非与他人比较
+### 6.1 概览卡片
 
-**正面反馈**：
-- 失败时采用鼓励语（"下次再试试"），而非警示音
-- 强调过程而非结果，培养成长型思维
+```
+┌──────────────────┐
+│  📦 商品总数       │
+│  1,234            │  ← 大字号数值
+│  ↑ 12% vs 上月    │  ← 趋势指示
+└──────────────────┘
+```
 
-**延迟满足**：
-- 愿望清单需累积星星兑换，培养长期主义意识
-- 通过目标设定和倒计时，培养时间管理能力
-
-**仪式感设计**：
-- 打卡操作需要长按或特定手势，增强仪式感
-- 重要成就解锁时，使用动画和音效增强成就感
-
-## 7. 品牌应用 (Brand Application)
+| 属性 | 规范 |
+| :--- | :--- |
+| 圆角 | {例如：8px} |
+| 阴影 | {例如：0 1px 3px rgba(0,0,0,0.1)} |
+| 内边距 | {例如：16px 20px} |
+| 数值字号 | {例如：28px, font-weight: 600} |
 
-### 7.1 Logo使用规范
-> 定义Logo使用规范
+### 6.2 状态标签
 
-**Logo尺寸**：
-- **最小尺寸**：24px × 24px
-- **标准尺寸**：48px × 48px
-- **大尺寸**：96px × 96px
+| 状态 | 背景色 | 文字色 | 示例 |
+| :--- | :--- | :--- | :--- |
+| {例如：已发布} | {例如：#E6F4EA} | {例如：#137333} | `✅ 已发布` |
+| {例如：草稿} | {例如：#F1F3F4} | {例如：#5F6368} | `📝 草稿` |
+| {例如：已下架} | {例如：#FCE8E6} | {例如：#C5221F} | `⛔ 已下架` |
+| {例如：执行中} | {例如：#E8F0FE} | {例如：#1A73E8} | `🔄 执行中` |
 
-**Logo使用场景**：
-- 应用图标
-- 启动页
-- 关于页面
+### 6.3 操作确认
 
-### 7.2 品牌色彩应用
-> 定义品牌色彩应用规范
+| 场景 | 确认方式 | 说明 |
+| :--- | :--- | :--- |
+| {例如：删除} | {例如：二次确认弹窗} | {例如：「确定删除？此操作不可撤销」} |
+| {例如：批量操作} | {例如：确认弹窗 + 数量提示} | {例如：「确定上架 23 件商品？」} |
+| {例如：提交表单} | {例如：按钮 Loading + 成功提示} | {例如：「保存成功」Toast} |
 
-**主色应用**：
-- 主要按钮、链接、选中状态
-- 重要信息高亮
-- 品牌标识
+### 6.4 空状态
 
-**功能色应用**：
-- 成功状态使用成功色
-- 警告状态使用警告色
-- 错误状态使用错误色
-- 信息提示使用信息色
+| 场景 | 插图 | 文案 | 操作 |
+| :--- | :--- | :--- | :--- |
+| {例如：无商品} | {例如：空箱子插图} | {例如：还没有商品} | {例如：「去采集」按钮} |
+| {例如：无订单} | {例如：空购物车} | {例如：暂无订单数据} | — |
+| {场景} | {插图} | {文案} | {操作} |
 
 ---
 
-## 8. 设计工具与资源 (Design Tools & Resources)
+## 7. 图表规范
 
-### 8.1 设计工具
-> 列出使用的设计工具
+### 7.1 Dashboard 图表
 
-- **UI设计**：Figma / Sketch
-- **原型设计**：Figma / Axure
-- **切图工具**：Figma / Sketch / Photoshop
+| 图表类型 | 适用场景 | 组件 |
+| :--- | :--- | :--- |
+| {例如：折线图} | {例如：趋势数据（订单量、GMV）} | {例如：ECharts / lime-echart} |
+| {例如：柱状图} | {例如：对比数据（平台销量）} | 同上 |
+| {例如：饼图} | {例如：占比数据（平台分布）} | 同上 |
+| {例如：漏斗图} | {例如：转化数据（采集→上架→成交）} | 同上 |
 
-### 8.2 设计资源
-> 列出设计资源
+### 7.2 图表配色
 
-- **设计系统文件**：{Figma/Sketch链接}
-- **图标库**：{图标库链接}
-- **字体文件**：{字体文件下载链接}
-- **色彩工具**：{色彩工具链接}
+| 序号 | 色值 | 用途 |
+| :--- | :--- | :--- |
+| 1 | {例如：#1A73E8} | 第一数据系列 |
+| 2 | {例如：#34A853} | 第二数据系列 |
+| 3 | {例如：#FBBC04} | 第三数据系列 |
+| 4 | {例如：#EA4335} | 第四数据系列 |
+| 5 | {例如：#9C27B0} | 第五数据系列 |
 
 ---
 
-## 9. 附录 (Appendix)
-
-### 9.1 参考文档
-> 列出参考的相关文档
-
-- [需求分析模板](4、需求分析模板.md)
-- [PRD文档模板](5、PRD文档模板.md)
-- [UI 设计说明模板](7、UI%20设计说明模板.md)
+## 8. 动效规范
 
-### 9.2 变更记录
-> 记录设计规范变更的历史
-
-| 变更日期 | 变更内容 | 变更原因 | 变更人 |
+| 场景 | 动效 | 时长 | 缓动函数 |
 | :--- | :--- | :--- | :--- |
-| {YYYY-MM-DD} | {变更内容描述} | {变更原因} | {姓名} |
+| {例如：页面切换} | {例如：Fade + Slide} | {例如：300ms} | {例如：ease-in-out} |
+| {例如：弹窗出现} | {例如：Scale + Fade} | {例如：200ms} | {例如：ease-out} |
+| {例如：列表加载} | {例如：Skeleton → Fade in} | {例如：200ms} | {例如：ease-in} |
+| {例如：按钮悬浮} | {例如：Background transition} | {例如：150ms} | {例如：ease} |
+| {例如：通知滑入} | {例如：Slide from right} | {例如：300ms} | {例如：ease-out} |
+
+```css
+/* 动效变量 */
+:root {
+  --transition-fast: 150ms ease;
+  --transition-normal: 300ms ease-in-out;
+  --transition-slow: 500ms ease;
+}
+```
 
 ---
 
-**文档版本**：V1.0.0  
-**创建时间**：{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 | 琥珀金 / 深青系 |
+## 9. 暗色模式
 
-## 4. 布局规范
+### 9.1 暗色配色
 
-### 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：
-
-- 左侧步骤栏
-- 中间主表单
-- 右侧目标信息与风险说明
-- 底部固定操作区
+| Token | 亮色值 | 暗色值 |
+| :--- | :--- | :--- |
+| `--bg-primary` | {例如：#FFFFFF} | {例如：#1E1E1E} |
+| `--bg-secondary` | {例如：#F5F5F5} | {例如：#2D2D2D} |
+| `--text-primary` | {例如：#1F1F1F} | {例如：#E0E0E0} |
+| `--text-secondary` | {例如：#5F6368} | {例如：#9E9E9E} |
+| `--border` | {例如：#E0E0E0} | {例如：#424242} |
 
-### 5.5 任务抽屉
+### 9.2 切换策略
 
-用于展示任务执行详情，固定包含：
+| 策略 | 说明 |
+| :--- | :--- |
+| 自动跟随 | {例如：默认跟随系统偏好 prefers-color-scheme} |
+| 手动切换 | {例如：设置页 + 顶栏快捷切换} |
+| 持久化 | {例如：localStorage 存储用户偏好} |
 
-- 当前状态
-- 阶段列表
-- 日志区
-- 重试 / 回滚 / 复制错误信息操作
+---
 
-## 6. 排版与间距
+## 10. 品牌差异化（如适用）
 
-- 页面标题：20px / 600
-- 模块标题：16px / 600
-- 正文：14px / 400
-- 标签与辅助说明：12px / 400
-- 卡片圆角：12px
-- 按钮圆角：8px
-- 页面常规间距：16px / 24px / 32px
+### 10.1 与同系产品的视觉区分
 
-## 7. 动效与反馈
+| 维度 | {Name} | {例如：OctoPanel} |
+| :--- | :--- | :--- |
+| 主色 | {例如：#1A73E8（蓝）} | {例如：#6D28D9（紫）} |
+| 图标风格 | {例如：电商相关（购物车、商品）} | {例如：管理相关（仪表盘、齿轮）} |
+| 品牌标识 | {例如：购物袋 + 触手} | {例如：章鱼 + 面板} |
 
-- 所有异步操作必须有 loading 状态
-- 成功、失败、警告必须有清晰反馈
-- 危险操作必须二次确认
-- 长任务必须能进入任务抽屉查看阶段进度
+### 10.2 白标定制（企业版）
 
-## 8. 明确不再使用的旧风格
+| 可定制项 | 范围 | 实现方式 |
+| :--- | :--- | :--- |
+| Logo | {例如：顶栏 + 登录页} | {例如：管理后台上传} |
+| 主色 | {例如：全局品牌色} | {例如：CSS 变量覆盖} |
+| 域名 | {例如：自定义域名} | {例如：CNAME 配置} |
+| Favicon | {例如：浏览器标签图标} | {例如：管理后台上传} |
 
-以下旧风格不再作为 {Name} 主线视觉依据：
+---
 
-- 以客服感为中心的配色与文案
-- 以聊天页作为首页的布局
-- 旧工作台式“工具集合页”信息架构
-- 强业务化、场景化、运营化页面表达
+## 11. 无障碍规范
 
-## 9. 冻结结论
+| 维度 | 标准 | 说明 |
+| :--- | :--- | :--- |
+| 对比度 | WCAG 2.1 AA (≥ 4.5:1) | {例如：正文文字与背景色对比度} |
+| 键盘导航 | 全键盘可操作 | {例如：Tab 聚焦、Enter 确认、Esc 取消} |
+| 屏幕阅读器 | aria-label 标注 | {例如：图标按钮、状态标签} |
+| 焦点指示 | 可见焦点环 | {例如：2px solid 主色} |
+| 色觉友好 | 不仅靠颜色传达信息 | {例如：图标 + 颜色双重标识状态} |
 
-{Name} 从本轮开始采用：
+---
 
-- **1Panel 式控制台骨架**
-- **自有蓝青深色平台配色**
-- **四类固定页面范式：概览 / 列表 / 详情 / 向导**
-- **右侧上下文抽屉 + 任务抽屉** 作为核心交互层
+**文档版本**：V1.0.0
+**创建日期**：{YYYY-MM-DD}
+**最后更新**：{YYYY-MM-DD}
+**文档状态**：✅ 待评审

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

@@ -6,7 +6,7 @@
 
 | 文档 | 说明 |
 | :--- | :--- |
-| `9、`9、{Name}-视觉与交互DNA规范.md`` | 全局 DNA |
+| `9、{Name}-视觉与交互DNA规范.md` | 全局 DNA |
 | `{V}/5、{Name}-PRD文档-{V}.md` | PRD |
 | `{V}/2、{Name}-需求分析文档-{V}.md` | 需求分析 |
 | 模块目录 `*-UI设计说明-{V}.md` | 模块细稿 |
@@ -60,7 +60,7 @@
 - 图标系统
 - 交互设计规范
 
-**详细规范请参考**：`9、`9、{Name}-视觉与交互DNA规范.md``
+**详细规范请参考**：`9、{Name}-视觉与交互DNA规范.md`
 
 ---