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

项目当前状态简报

当前结论

当前仓库已经具备交付给 OpenClaw 的基础条件。

当前主链路是：

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

OpenClaw 应通过 MCP 工具 run_freshrss_openclaw_pipeline 调用这条链路，而不是自行拼接脚本。

当前已完成

• 已完成 FreshRSS greader API 接入与未读拉取
• 已完成 FreshRSS 条目到标准化 item 的映射
• 已完成 RSS-first 提取策略
• 已完成 LLM 总结与校验闭环
• 已完成规则引擎过滤
• 已完成 ArticleCandidateRecord 与 OpenClawCandidateInput 分层
• 已完成 OpenClawDeliveryPayload 批量投递结构
• 已完成 FreshRSS 已读状态回写
• 已完成“仅在最终 payload 成功写盘后再标记已读”的语义
• 已完成 MCP 工具 run_freshrss_openclaw_pipeline
• 已完成默认精简输出模式，减少中间文件

当前 MCP 工具

当前服务入口：

• src/summary_mcp/server.py

当前暴露的 MCP 工具：

• extract_url_content
• extract_item_content
• filter_summary_result
• run_freshrss_openclaw_pipeline

其中生产主入口是：

• run_freshrss_openclaw_pipeline

当前关键文件

• MCP 服务入口
  • src/summary_mcp/server.py
• FreshRSS 统一工作流
  • src/summary_mcp/workflows/freshrss_pipeline.py
• 摘要循环
  • src/summary_mcp/core/summary_loop.py
• 提取主流程
  • src/summary_mcp/core/pipeline.py
• FreshRSS 集成
  • src/summary_mcp/integrations/freshrss.py
• 规则引擎
  • src/summary_mcp/filters/engine.py
• LLM 结果校验
  • src/summary_mcp/validators/llm_result.py
• OpenClaw candidate 模型
  • src/summary_mcp/models/article_candidate.py
• OpenClaw delivery 模型
  • src/summary_mcp/models/openclaw_delivery.py
• 生产脚本入口
  • scripts/run_freshrss_pipeline.py
• OpenClaw 交接说明
  • docs/openclaw/openclaw-handoff.md

当前输出规则

默认生产模式只输出：

• raw/freshrss.raw.json
• candidates/openclaw-delivery-payload.json
• run-report.json

如果需要排障，可开启：

• debug_artifacts=true
• 或脚本参数 --debug-artifacts

这样才会额外输出逐条中间文件。

当前验证状态

已经验证通过：

• FreshRSS 未读拉取成功
• 已读回写成功
• MCP 工具入口可直接触发完整链路
• 微信公众号样本可直接使用 RSS 提供的 summary 内容提取，不再回源抓网页
• 精简输出模式已实际跑通

当前已知限制

• 当前对 FreshRSS 条目采用 RSS-first 策略，不再回源抓原网页
• 如果 RSS 中没有足够正文内容，该条会直接跳过，不会进入后续总结
• 某些规则仍偏保守，部分内容可能落到 review
• paywall 相关启发式仍可能误判中文文本
• Webhook / 主动投递到 OpenClaw 外部接口尚未实现，当前是由 OpenClaw 通过 MCP 主动调用

当前最建议的交接阅读顺序

1. README.md
2. docs/openclaw/openclaw-handoff.md
3. docs/openclaw/openclaw-candidate-input-field-spec.md
4. docs/openclaw/openclaw-delivery-payload-spec.md
5. TODO.md

一句话结论

当前仓库已经从“提取 MCP 原型”演进到“可供 OpenClaw 调用的 FreshRSS -> OpenClaw payload 上游处理器”，可以开始交接，但后续仍建议继续补 webhook / delivery 接线与规则收敛。