reader/docs/current/context-reset-brief.md

项目当前状态简报

当前结论

当前仓库已经具备作为 OpenClaw 上游服务的正式基础能力。

当前正式主链路是：

FreshRSS 未读 -> RSS 内容提取 -> LLM 总结 -> 规则过滤 -> OpenClaw delivery payload

当前正式控制面已经收口为异步 job：

• 主日报：start_freshrss_pipeline_job -> poll -> get result
• 恢复：inspect_resume_plan -> start_resume_job -> poll -> get result
• 单篇总结：start_article_summary_job -> poll -> get result

同步 run_freshrss_openclaw_pipeline、resume_run、generate_article_summaries 仍保留，但只用于 debug / fallback。

当前权威入口

先看这些文档：

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. plans/README.md
7. TODO.md

如果问题是 OpenClaw 集成、状态分支或恢复策略，优先看 docs/openclaw/，不要先翻历史计划。

当前正式能力

• FreshRSS 主日报 run 会落地 run-state.json
• get_run_status / list_runs / list_run_artifacts 提供 run 级观测
• get_delivery_payload / get_run_report 提供正式结果读取
• 查询层已经支持 stale state 与终态 artifacts 的状态收敛
• 主日报正式启动已切到 async job
• resume 已切到 async job，并在执行前先做 inspect_resume_plan
• 生产恢复依赖 summary/summary-batch.json 与 candidates/candidate-batch.json
• 单篇总结也已补齐 async job 形态

当前关键代码入口

• MCP 服务入口：src/summary_mcp/server.py
• 主日报 workflow：src/summary_mcp/workflows/freshrss_pipeline.py
• run / artifact 查询：src/summary_mcp/runtime/query_service.py
• 主日报 async job：src/summary_mcp/runtime/freshrss_pipeline_jobs.py
• resume 预检与恢复：src/summary_mcp/runtime/resume_service.py
• resume async job：src/summary_mcp/runtime/resume_jobs.py
• 单篇总结 async job：src/summary_mcp/runtime/article_summary_jobs.py
• 关键词治理：src/summary_mcp/core/keyword_index.py

当前核心产物

主日报稳定产物：

• outputs/freshrss/rerun/<run_dir>/run-state.json
• outputs/freshrss/rerun/<run_dir>/raw/freshrss.raw.json
• outputs/freshrss/rerun/<run_dir>/summary/summary-batch.json
• outputs/freshrss/rerun/<run_dir>/candidates/candidate-batch.json
• outputs/freshrss/rerun/<run_dir>/candidates/openclaw-delivery-payload.json
• outputs/freshrss/rerun/<run_dir>/candidates/digest-brief.json
• outputs/freshrss/rerun/<run_dir>/run-report.json
• outputs/freshrss/rerun/<run_dir>/extracted/item-XX.extracted.json

job 状态目录：

• outputs/freshrss/pipeline_jobs/<job_id>/
• outputs/freshrss/resume_jobs/<job_id>/
• outputs/freshrss/article_summary_jobs/<job_id>/

关键词运行数据：

• data/term_index/daily/YYYY-MM-DD.json
• data/term_index/term_stats.json

当前已验证

• FreshRSS 未读拉取与已读回写可用
• RSS-first 提取策略可用
• 主日报 MCP 主链路可触发并写出正式产物
• 状态查询与结果读取接口可用
• stale state / artifacts 收敛逻辑已落地
• resume 的 artifact-first 判定已落地
• start_resume_job -> poll -> result 已做本地 synthetic 验证
• 单篇总结 async job 可跑通
• 关键词 review bundle 与建议写回脚本可用

当前主要限制

• 某些源 RSS 正文不足时会被直接跳过
• 规则仍然偏保守，部分内容会落到 review
• paywall 启发式对中文仍可能误判
• 关键词治理还没有接入周期性调度
• digest-brief.json 仍没有独立 MCP 读取工具
• resume 目前的剩余主风险不再是恢复点判定，而是缺少真实生产环境的完整恢复验证

当前建议

• 把 docs/openclaw/openclaw-orchestration-flow.md 当成正式编排手册
• 把 docs/openclaw/openclaw-handoff.md 当成接手总览
• 把 plans/README.md 当成规划文档导航
• 把 docs/openclaw/archive/ 和 docs/archive/ 当成历史资料，不要当当前事实源