reader/plans/README.md

规划文档导航

使用原则

plans/ 目录保存架构设计、实施计划、专题方案和历史问题分析。

不要把所有 plan 都当成当前权威事实。 当前事实优先级应是：

1. README.md
2. docs/README.md
3. docs/openclaw/README.md
4. docs/openclaw/openclaw-handoff.md
5. docs/openclaw/openclaw-orchestration-flow.md
6. TODO.md

plans/ 更适合回答：

• 为什么这样设计
• 某个能力是怎么分阶段落地的
• 某次事故当时是怎么分析的

当前权威规划

这些文档仍然是当前协作时应优先阅读的规划基线：

• reader-mcp-architecture-design.md
  • MCP workflow service 的总体架构方向
• reader-mcp-implementation-plan.md
  • 实施分阶段计划
• ../TODO.md
  • 当前任务状态与落地进展

已完成能力的专题方案

这些方案主要用于回看设计取舍，相关能力已经基本落地：

• freshrss-pipeline-async-job-plan.md
  • 主日报 async job 方案
• article-summary-async-job-plan.md
  • 单篇总结 async job 方案
• resume-run-minimal-design.md
  • resume_run 最小恢复语义设计

仍有参考价值的专题设计

• keyword-cleanup-artifact-slimming-v1.md
• keyword-cleanup-review-suggestions-layer-design.md
• article-summary-prompt-independent.md
• article-deep-summary-skill.md
• docker-deployment-plan.md

历史问题分析

• issues/2026-04-06-reader-digest-sigterm.md
  • 一次真实运行事故的分析

建议阅读顺序

如果是新接手维护：

1. reader-mcp-architecture-design.md
2. reader-mcp-implementation-plan.md
3. ../TODO.md
4. ../docs/openclaw/README.md
5. ../docs/openclaw/openclaw-handoff.md

如果是在排查某一类能力：

• 主日报启动/轮询：看 freshrss-pipeline-async-job-plan.md
• 恢复：看 resume-run-minimal-design.md
• 单篇总结：看 article-summary-async-job-plan.md
• 历史故障：看 issues/2026-04-06-reader-digest-sigterm.md