# TODO

## 当前状态

项目当前已经进入“可交付给 OpenClaw 调用”的阶段。

当前主链路：

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

当前已经完成：

- [x] FreshRSS `greader` API 接入
- [x] `entry -> item` 标准化映射
- [x] RSS-first 内容提取策略
- [x] LLM 摘要与校验闭环
- [x] 第一版规则引擎
- [x] `ArticleCandidateRecord` / `OpenClawCandidateInput` 分层
- [x] `OpenClawDeliveryPayload` 批量投递结构
- [x] 最终 payload 成功后才标记 FreshRSS 已读
- [x] MCP 工具 `run_freshrss_openclaw_pipeline`
- [x] 默认精简输出模式

---

## P0 - 交接前后最优先

- [x] 为 OpenClaw 补齐交接文档
- [x] 将 MCP 工具作为统一生产入口
- [x] 将默认输出收敛为最小必要文件
- [ ] 设计 OpenClaw webhook / delivery payload 的主动推送方式
- [ ] 明确 OpenClaw 侧如何注册和启动本 MCP 服务

---

## P1 - 下一阶段推进

- [ ] 设计“人工确认后再沉淀知识库”的状态流转
- [ ] 收敛 `paywall` 误判规则，降低中文文本误报
- [ ] 细化过滤规则并引入更多个性化上下文
- [ ] 增加批量 run 的保留策略与历史清理策略
- [ ] 为 OpenClaw 补一份更正式的 MCP 调用示例和接线说明

---

## P2 - 后续增强

- [ ] 将 `Markdown sink` 进一步降级为 debug / fallback 能力
- [ ] 增加按天聚合 `ArticleCandidateRecord` 的批处理能力
- [ ] 让 OpenClaw 聚合候选内容并生成日级摘要
- [ ] 将日级摘要写入知识库，并同步生成面向用户的日报消息
- [ ] 支持更多 `content_kind`
- [ ] 增加提取缓存、重试和更细粒度日志
- [ ] 整理历史 rerun 目录与调试产物保留策略

---

## 当前建议的下一步

优先做这三件事：

1. 明确 OpenClaw 侧的 MCP 接线方式
2. 设计主动投递 / webhook 机制
3. 收敛规则误判，尤其是 `paywall` 相关启发式

---

## 交接时优先阅读

- `README.md`
- `docs/openclaw/openclaw-handoff.md`
- `docs/openclaw/openclaw-candidate-input-field-spec.md`
- `docs/openclaw/openclaw-delivery-payload-spec.md`
- `docs/current/context-reset-brief.md`