Refine OpenClaw payloads and reorganize docs

This commit is contained in:
zhuyongxin
2026-03-26 10:20:07 +08:00
parent cecf4d3ae7
commit 27fe1e8882
155 changed files with 8999 additions and 87 deletions
+29 -10
View File
@@ -1,8 +1,8 @@
# TODO
# TODO
## 当前状态
项目当前处于 `Content Extract MCP` 的 MVP 完成,已进入规则过滤与 Markdown sink 阶段。
项目当前处于 `Content Extract MCP` 的 MVP 完成阶段,已验证 `规则过滤 + Markdown sink`,下一阶段将转向 `OpenClaw 日报聚合 + 知识沉淀` 改造。
已完成:
@@ -25,6 +25,8 @@
- [x] 实现第一版规则引擎与过滤 MCP tool
- [x] 定义 sink 输入输出 schema
- [x] 实现第一版 Markdown sink 与本地写入脚本
- [x] 明确下一阶段主路径应调整为 `候选材料 -> 日报 -> 人工确认 -> 知识沉淀`
- [x] 明确 `ArticleCandidateRecord` 与 `OpenClawCandidateInput` 需要分层设计
---
@@ -45,14 +47,26 @@
- [x] 跑通 `FreshRSS -> item -> content extraction` 单条链路
- [x] 定义规则过滤层的输入输出 schema
- [x] 设计知识库入库格式
- [ ] 设计 webhook / 推送格式
- [x] 在文档层定义 `ArticleCandidateRecord`、`OpenClawCandidateInput` 与 `DailyDigest`
- [x] 在代码里把当前 `article_candidate` 重新定位为 `ArticleCandidateRecord`
- [x] 新增 `OpenClawCandidateInput` 模型与转换逻辑
- [x] 给 `OpenClawCandidateInput` 增加 `canonical_url` 与 `language`
- [x] 输出面向 OpenClaw 的精简 `OpenClawCandidateInput` 批量载荷
- [x] 将“人工确认状态”拆成独立模型,不回写到 candidate 输入对象
- [ ] 设计 OpenClaw webhook / delivery payload 的实际传输方式
- [ ] 设计“人工确认后再沉淀知识库”的状态流转
- [ ] 给提取结果增加更多正文清洗策略,比如尾部噪音清理
- [ ] 细化过滤规则并引入更多个性化上下文
- [ ] 收敛 `paywall` 误判规则,避免仅因正文提到“付费/收费”就进入高优先级 `review`
---
## P2 - 后续增强项
- [ ] 将当前 `Markdown sink` 调整为 debug / fallback 能力,而非主路径
- [ ] 增加按天批量收集 `ArticleCandidateRecord` 的脚本
- [ ] 让 OpenClaw 聚合候选内容并生成日报
- [ ] 将日报写入知识库,并同步生成面向用户的汇报消息
- [ ] 增加批量提取能力
- [ ] 引入 Playwright 作为动态页面兜底抓取方案
- [ ] 支持更多 `content_kind`,例如 `release`、`thread`、`video`
@@ -65,16 +79,21 @@
## 当前建议的下一步
优先做这两件事:
优先做这三件事:
1. 设计 webhook / 推送格式
2. 细化过滤规则并引入更多个性化上下文
1. 设计 OpenClaw webhook / delivery payload 的实际传输方式
2. 收敛 `paywall` 误判规则
3. 设计人工确认后进入知识库的状态流转
---
## 收束上下文后建议先看
- docs/context-reset-brief.md
- docs/filter-rule-engine-design.md
- docs/markdown-sink-design.md
- TODO.md
- docs/current/context-reset-brief.md
- docs/openclaw/openclaw-candidate-input-field-spec.md
- docs/openclaw/openclaw-delivery-payload-spec.md
- docs/openclaw/openclaw-daily-digest-refactor.md
- docs/openclaw/article-candidate-daily-digest-schema.md
- docs/design/filter-rule-engine-design.md
- docs/design/markdown-sink-design.md
- TODO.md