feat: add freshrss openclaw pipeline and clean repo

docs/current/context-reset-brief.md

@@ -1,102 +1,112 @@
 # 项目当前状态简报
 
+## 当前结论
+
+当前仓库已经具备交付给 OpenClaw 的基础条件。
+
+当前主链路是：
+
+`FreshRSS 未读 -> RSS 内容提取 -> LLM 总结 -> 规则过滤 -> OpenClaw delivery payload`
+
+OpenClaw 应通过 MCP 工具 `run_freshrss_openclaw_pipeline` 调用这条链路，而不是自行拼接脚本。
+
 ## 当前已完成
 
-- 已明确整体链路：`来源 -> 聚合池 -> 内容提取 MCP -> LLM 摘要 -> 校验 -> 过滤 -> 入库/推送`
-- 已确定当前 MCP 的职责边界：
-  - 只负责内容提取
-  - 不负责摘要、分类、价值判断
-- 已完成 Python MCP 骨架
-- 已实现三个 tool：
-  - `extract_url_content`
-  - `extract_item_content`
-  - `filter_summary_result`
-- 已完成真实 URL 提取验证
-- 已完成 LLM 摘要 prompt
-- 已完成 LLM 摘要结果 schema 校验器
-- 已完成“提取 JSON -> LLM 摘要 JSON -> 校验”的最小闭环脚本
-- 已完成 LLM 摘要校验 skill 封装
-- 已清理旧的启发式 `summarizer.py`
-- 已将旧的 MCP 设计文档更新为当前“Content Extract MCP”语义
-- 已完成 FreshRSS `greader` API 接入
-- 已完成 FreshRSS entry -> `item` 映射
-- 已产出真实 `item` 样例文件
-- 已跑通 `FreshRSS -> item -> content extraction` 单条链路
-- 已定义过滤层输入输出 schema
-- 已完成第一版规则引擎、本地脚本和 MCP tool
-- 已定义 sink 输入输出 schema
-- 已完成第一版 Markdown sink 与本地写入脚本
+- 已完成 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 入口：
+- 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`
-- LLM 结果模型：
-  - `src/summary_mcp/models/llm_result.py`
-- LLM 校验器：
-  - `src/summary_mcp/validators/llm_result.py`
-- 过滤模型：
-  - `src/summary_mcp/models/filtering.py`
-- 过滤引擎：
+- FreshRSS 集成
+  - `src/summary_mcp/integrations/freshrss.py`
+- 规则引擎
   - `src/summary_mcp/filters/engine.py`
-- sink 模型：
-  - `src/summary_mcp/models/sink.py`
-- Markdown sink：
-  - `src/summary_mcp/sinks/markdown.py`
-- 默认过滤规则：
-  - `configs/filter_rules.json`
-- 校验 CLI：
-  - `src/summary_mcp/validate_llm_result.py`
-- 最小闭环脚本：
-  - `scripts/run_summary_loop.py`
-- FreshRSS 拉取脚本：
-  - `scripts/pull_freshrss_items.py`
-- FreshRSS 提取脚本：
-  - `scripts/run_freshrss_extract.py`
-- 过滤脚本：
-  - `scripts/run_filter_rules.py`
-- Markdown sink 脚本：
-  - `scripts/run_markdown_sink.py`
-- Markdown sink 文档：
-  - `docs/design/markdown-sink-design.md`
-- 当前提示词：
-  - `outputs/prompts/llm-summary-prompt.txt`
-- 过滤结果样例：
-  - `outputs/reference/filter/filter-decision.json`
-- 文档索引：
-  - `docs/README.md`
-- 当前 TODO：
-  - `TODO.md`
+- 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`
 
-## 当前已经验证通过
+## 当前输出规则
 
-- 参考文章 URL 可提取为结构化 JSON
-- LLM 可根据提取结果生成摘要 JSON
-- validator 可校验摘要 JSON
-- 最小闭环脚本可直接调用 LLM 接口并产出通过校验的结果
-- FreshRSS API 可拉取真实 entry
-- 真实 entry 可映射为标准化 `item`
-- 标准化 `item` 可继续进入内容提取流程
-- 规则引擎可对结构化摘要结果输出 `keep / drop / review` 决策
-- MCP tool 可承接“由上层 LLM/Agent 调用过滤”的模式
-- Markdown sink 可将过滤后的结果写入本地知识库目录
+默认生产模式只输出：
 
-## 当前未开始的下一阶段
+- `raw/freshrss.raw.json`
+- `candidates/openclaw-delivery-payload.json`
+- `run-report.json`
 
-- 设计 webhook / 推送格式
-- 把 FreshRSS 拉取与提取流程进一步批量化/调度化
-- 迭代更细的过滤规则与个性化上下文
-- 决定是否扩展 Notion / Webhook / 其他 sink
+如果需要排障，可开启：
 
-## 收束后建议从这里继续
+- `debug_artifacts=true`
+- 或脚本参数 `--debug-artifacts`
 
-优先从这两个问题继续：
+这样才会额外输出逐条中间文件。
 
-1. 先设计 webhook / 推送格式
-2. 再决定是否扩展其他 sink，而不是继续深化 Markdown sink 本身
+## 当前验证状态
+
+已经验证通过：
+
+- 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`
 
 ## 一句话结论
 
-当前 MVP 已完成，FreshRSS 上游、第一版规则过滤层和第一版 Markdown sink 都已接通，下一阶段应转向推送层与更完整的下游集成。
+当前仓库已经从“提取 MCP 原型”演进到“可供 OpenClaw 调用的 FreshRSS -> OpenClaw payload 上游处理器”，可以开始交接，但后续仍建议继续补 webhook / delivery 接线与规则收敛。