# [主题] — 头脑风暴设计文档

**日期**：YYYY-MM-DD  
**知识来源**：[项目 .deepwiki 路径，例如：`项目根/.deepwiki/` 或具体索引路径]  
**来源统计**：[DW]: X 条 | [SRC]: Y 条 | [EXT]: Z 条  

> 说明：`[DW]` 来自 DeepWiki/项目知识库；`[SRC]` 来自仓库源码引用；`[EXT]` 来自外部或 Agent 推断，需在 grounding 协议中控制占比。

---

## 1. 知识上下文

（由 context-building 协议加载；本节概括与主题相关的已加载知识，便于后续决策可追溯。）

### [DW] 来源：pages/[XX-topic].md

- 关键点：[从该页提取的架构/术语/约束，1～3 条]
- …

### [DW] 来源：pages/[另一文档].md

- …

### [SRC] 来源（如适用）

- 文件：`[path/to/relevant/file]`
- 摘录要点：…

---

## 2. 需求摘要

（由需求澄清阶段产出。）

- **核心目标**：[用一句话或条目列出主要交付/能力]
- **约束条件**：[技术栈、时间、合规、兼容性等]
- **成功标准**：[可验证的完成定义，含度量或验收条件]

---

## 3. 多路径分析（ToT）

### 方向 1：[名称]

- **[DW]**：[与本方向相关的 wiki/知识库依据]
- **[SRC]**：[与实现路径相关的代码或模块依据]
- **优势**：…
- **风险**：…
- **前提条件**：…

### 方向 2：[名称]

- **[DW]**：…
- **[SRC]**：…
- **优势**：…
- **风险**：…
- **前提条件**：…

### 方向 3：[名称]

- **[DW]**：…
- **[SRC]**：…
- **优势**：…
- **风险**：…
- **前提条件**：…

> 可按实际需要增删「方向」小节数量；每个方向应保持与 `[DW]`/`[SRC]` 的对应关系可追溯。

---

## 4. 评估矩阵

| 维度 | 方向 1 | 方向 2 | 方向 3 |
|------|--------|--------|--------|
| 知识契合度 | [高/中/低 + 一句理由] | | |
| 可行性 | | | |
| 创新性/风险 | | | |
| **综合** | | | |

---

## 5. 选定方向

（筛选理由：为何淘汰其他路径；选定方案的一句话概括与边界说明。）

**选定**：[方向 N — 名称]

**理由**：…

**方案概要**：…

---

## 6. 设计详述

（按模块/组件分节展示设计细节；可与后续 planning 输出对齐。）

### 6.1 [模块名]

- 职责：…
- 接口/数据：…
- 与知识库对照：`[DW: pages/…]`

### 6.2 [模块名]

- …

---

## 7. 未采纳方向

（保留备查，标注「已评估，未采纳」。）

### ~~方向 X：[名称]~~（已评估，未采纳）

- **未采纳原因**：…

### ~~方向 Y：[名称]~~（已评估，未采纳）

- **未采纳原因**：…