98 lines
3.6 KiB
Markdown
98 lines
3.6 KiB
Markdown
# 文档索引
|
|
|
|
## 当前目录结构
|
|
|
|
- `docs/README.md`
|
|
- 文档总索引
|
|
- `docs/current/`
|
|
- 当前状态、收束入口、阶段导航
|
|
- `docs/design/`
|
|
- 当前实现的设计文档
|
|
- `docs/openclaw/`
|
|
- OpenClaw 日报聚合与下游对象设计
|
|
- `docs/notes/`
|
|
- 较上层的方案笔记与非最终设计
|
|
- `docs/archive/`
|
|
- 历史归档，不作为最新事实来源
|
|
|
|
## 当前推荐阅读顺序
|
|
|
|
1. `docs/current/context-reset-brief.md`
|
|
- 当前真实进度与下一步入口
|
|
2. `docs/openclaw/openclaw-candidate-input-field-spec.md`
|
|
- 提供给 OpenClaw 的单篇结构化输入字段说明
|
|
3. `docs/openclaw/openclaw-delivery-payload-spec.md`
|
|
- 提供给 OpenClaw 的批量投递 envelope 说明
|
|
4. `docs/design/summary-mcp-service-design.md`
|
|
- 当前 MCP 服务的职责、接口和边界
|
|
5. `docs/design/filter-rule-engine-design.md`
|
|
- 过滤层的输入输出、规则结构与当前实现
|
|
6. `docs/design/markdown-sink-design.md`
|
|
- 第一版 Markdown sink 的输入输出、目录结构与落地方式
|
|
7. `docs/openclaw/openclaw-daily-digest-refactor.md`
|
|
- 为什么要从单篇入库改成 OpenClaw 日报聚合链路
|
|
8. `docs/openclaw/article-candidate-daily-digest-schema.md`
|
|
- `ArticleCandidateRecord`、`OpenClawCandidateInput` 与 `DailyDigest` 的正式设计
|
|
9. `docs/design/source-schema-design.md`
|
|
- `source -> item -> document` 的对象设计
|
|
10. `docs/notes/reading-pipeline-design-notes.md`
|
|
- 更上层的阅读流方案与阶段划分
|
|
11. `docs/design/summary-loop-explained.md`
|
|
- 当前 LLM 摘要校验闭环的解释
|
|
|
|
## 当前文档分层
|
|
|
|
### 1. 当前状态与导航
|
|
|
|
- `README.md`
|
|
- 仓库入口与脚本运行方式
|
|
- `TODO.md`
|
|
- 当前优先级、已完成项、下一阶段任务
|
|
- `docs/current/context-reset-brief.md`
|
|
- 当前阶段状态的最短摘要
|
|
- `docs/README.md`
|
|
- 文档索引与阅读顺序
|
|
|
|
### 2. 当前实现设计
|
|
|
|
- `docs/design/summary-mcp-service-design.md`
|
|
- 当前内容提取 MCP 的真实设计
|
|
- `docs/design/summary-core-interface-design.md`
|
|
- 摘要/提取内核的接口抽象
|
|
- `docs/design/source-schema-design.md`
|
|
- `source`、`item`、`document` 三层 schema
|
|
- `docs/design/summary-loop-explained.md`
|
|
- 提取 JSON -> LLM 摘要 JSON -> 校验 的闭环说明
|
|
- `docs/design/filter-rule-engine-design.md`
|
|
- 第一版规则过滤引擎设计与落地位置
|
|
- `docs/design/markdown-sink-design.md`
|
|
- 第一版 Markdown sink 设计与落地位置
|
|
|
|
### 3. OpenClaw 与下游设计
|
|
|
|
- `docs/openclaw/openclaw-candidate-input-field-spec.md`
|
|
- 提供给 OpenClaw 的单篇结构化输入字段说明
|
|
- `docs/openclaw/openclaw-delivery-payload-spec.md`
|
|
- 提供给 OpenClaw 的批量投递 envelope 说明
|
|
- `docs/openclaw/openclaw-daily-digest-refactor.md`
|
|
- 改造为 OpenClaw 日报聚合链路的原因与目标结构
|
|
- `docs/openclaw/article-candidate-daily-digest-schema.md`
|
|
- `ArticleCandidateRecord`、`OpenClawCandidateInput` 与 `DailyDigest` 的字段设计与对象关系
|
|
|
|
### 4. 方案笔记
|
|
|
|
- `docs/notes/reading-pipeline-design-notes.md`
|
|
- 整体阅读流、规则、sink、push 的方案笔记
|
|
|
|
### 5. 历史归档
|
|
|
|
- `docs/archive/content-extract-mcp-mvp-archive.md`
|
|
- MVP 阶段归档，部分状态已被后续进展覆盖
|
|
|
|
## 当前文档维护原则
|
|
|
|
- `docs/current/context-reset-brief.md` 记录当前最新状态
|
|
- `TODO.md` 记录任务优先级与下一步
|
|
- `outputs/README.md` 记录当前输出目录约定
|
|
- `docs/archive/content-extract-mcp-mvp-archive.md` 只当历史快照，不再作为最新事实来源
|
|
- 新增阶段性进展，优先更新 `README.md`、`TODO.md`、`docs/current/context-reset-brief.md` |