# Brief: session-dedup-knowledge-map

## 背景

ISS-001：Executor 在单次对话中重复调用 `lookup_knowledge` 多达 20 次，同一文档被召回 13 次。原因是工具层无状态、Planner 无知识边界感知。

## 目标

1. 彻底消除 session 内重复文档召回（Part A）
2. 给 Planner 注入知识图谱，让其在规划阶段就能判断需要检索哪个域、只检索一次（Part B）

## 范围

- `LookupKnowledgeTool`：session 级去重
- `Frontmatter` / `KnowledgeEntry`：新增 covers + whenToRetrieve
- `DocumentManagementService`：上传时 LLM 生成文档级字段
- `KnowledgeDomainService`（新）：域级聚合与 DB 存储
- `knowledge_domain` 表（新）
- `ChatService` + `chat-planner-prompt.md`：注入 knowledge map

## 非目标（Phase 2）

- Executor 文档级 when_to_retrieve 细粒度筛选
- RRF 混合重排
- 文档 frontmatter 自动生成（手动覆盖 LLM 优先已支持）

## 分档

standard

## 关联 OpenSpec

openspec/changes/session-dedup-knowledge-map/