# 文档索引

## 当前推荐阅读顺序

1. `context-reset-brief.md`
   - 当前真实进度与下一步入口
2. `summary-mcp-service-design.md`
   - 当前 MCP 服务的职责、接口和边界
3. `filter-rule-engine-design.md`
   - 过滤层的输入输出、规则结构与当前实现
4. `markdown-sink-design.md`
   - 第一版 Markdown sink 的输入输出、目录结构与落地方式
5. `source-schema-design.md`
   - `source -> item -> document` 的对象设计
6. `reading-pipeline-design-notes.md`
   - 更上层的阅读流方案与阶段划分
7. `summary-loop-explained.md`
   - 当前 LLM 摘要校验闭环的解释

## 当前文档分层

### 1. 当前状态与导航

- `README.md`
  - 仓库入口与脚本运行方式
- `TODO.md`
  - 当前优先级、已完成项、下一阶段任务
- `docs/context-reset-brief.md`
  - 当前阶段状态的最短摘要
- `docs/README.md`
  - 文档索引与阅读顺序

### 2. 当前实现设计

- `docs/summary-mcp-service-design.md`
  - 当前内容提取 MCP 的真实设计
- `docs/summary-core-interface-design.md`
  - 摘要/提取内核的接口抽象
- `docs/source-schema-design.md`
  - `source`、`item`、`document` 三层 schema
- `docs/summary-loop-explained.md`
  - 提取 JSON -> LLM 摘要 JSON -> 校验 的闭环说明
- `docs/filter-rule-engine-design.md`
  - 第一版规则过滤引擎设计与落地位置
- `docs/markdown-sink-design.md`
  - 第一版 Markdown sink 设计与落地位置

### 3. 上下游方案设计

- `docs/reading-pipeline-design-notes.md`
  - 整体阅读流、规则、sink、push 的方案笔记

### 4. 历史归档

- `docs/content-extract-mcp-mvp-archive.md`
  - MVP 阶段归档，部分状态已被后续进展覆盖

## 当前文档维护原则

- `context-reset-brief.md` 记录当前最新状态
- `TODO.md` 记录任务优先级与下一步
- `content-extract-mcp-mvp-archive.md` 只当历史快照，不再作为最新事实来源
- 新增阶段性进展，优先更新 `README.md`、`TODO.md`、`context-reset-brief.md`