daily-digest-workflow.md
5.34 KB
Per-Group Daily Digest Workflow (v4 — Verified Pipeline, 2026-07-10)
管道全链路(已验证 ✅)
Cron 预摘要(每30分钟)
POST /api/articles/extract → WeChat DB → articles + article_shares(URL 去重)
GET /api/articles/unsummarized → 找未缓存摘要的文章
POST /api/articles/summarize → 异步提交 Hermes 子进程摘要(写入 daily_reports)
日报生成(按需触发)
GET /api/articles/by-group?chatroom_id=X → 某群今日所有文章 + 摘要状态
LLM 按模板编撰 Markdown 日报
gpt-image-gen 生成复古报纸风格图片
wechat-image-sender 发送到微信群
验证结果(2026-07-10):extract 123 篇文章 + 460 条分享记录,by-group TGO群 30 篇,summarize 异步写入 daily_reports。全链路通。
Architecture
articles (URL 去重,一篇一行):
id, url (UNIQUE), title, first_seen_at
article_shares (谁在哪个群几点几分分享):
id, article_id, chatroom_id, talker, source_msg_id, msg_create_time, shared_at
daily_reports (摘要缓存):
id, article_url, report_date, content, dedup_key
Step 1: Cron 预摘要(持续补齐)
Cron job 每 30 分钟运行一次,用 scripts/scan_articles.py(零 token 消耗)或 LLM 驱动:
# Script 模式(推荐,零 token)
hermes cronjob create \
--name "TGO群文章预摘要" \
--script "skills/wechat-group-digest/scripts/scan_articles.py" \
--schedule "*/30 * * * *" \
--no_agent
# LLM 驱动模式(需要灵活判断时)
hermes cronjob create \
--name "TGO群文章预摘要" \
--skills wechat-group-digest \
--schedule "*/30 * * * *" \
--tools terminal,web,file \
--prompt "调用 scan_articles.py 或手动: POST /api/articles/extract → GET /api/articles/unsummarized → POST /api/articles/summarize"
Step 2: 获取群文章(含摘要状态)
GET /api/articles/by-group?chatroom_id=54655425669@chatroom&limit=50
Response:
{
"data": [{
"id": 123, "url": "...", "title": "...",
"createTime": 1783242197000,
"report_id": 42, // 非 null = 摘要已缓存
"summary": "# 标题\n\n核心观点..." // 已缓存的 Markdown 摘要
}]
}
Step 3: 补齐缺失摘要
对 report_id 为 null 的文章批量提交摘要:
for url_title in missing_articles:
curl -s -X POST http://127.0.0.1:5000/api/articles/summarize \
-H 'Content-Type: application/json' \
-d '{"url": "...", "title": "..."}'
Summarize API 自动去重:已有缓存直接返回,无缓存则起 Hermes 子进程异步抓取+摘要(2-4 分钟/篇)。结果写入 daily_reports,下次命中缓存。
Step 4: 编撰日报 Markdown
所有文章摘要就绪后,LLM 按模板编撰:
你是 TGO AGI 群日报编辑。根据以下文章列表生成今日日报。
## 文章列表
| 时间 | 标题 | 摘要 |
|------|------|------|
| 19:51 | Meta CTO 自爆Llama 4掉队真相 | ... |
## 日报模板
# 8-TGO和朋友们的AGI 日报 — YYYY-MM-DD
## 📰 头条
{最重要的1篇,150字}
## 📑 精选文章
{按主题分组,每篇摘要80-100字}
## 🔍 今日趋势
{提炼2-3个行业趋势}
## 📊 统计
- 今日文章: N 篇
- AI模型: X篇 | 开发工具: Y篇 | 行业动态: Z篇
Step 5: 生成图片
hermes chat -s gpt-image-gen -q "根据以下日报 Markdown 生成复古报纸风格信息图..."
风格要求(用户偏好):复古报纸风,泛黄做旧/铜版画蜀刻,黑色衬线字体,中文内容。非现代科技渐变。
Step 6: 发送微信群
hermes chat -s wechat-image-sender -q "发图片到 8-TGO和朋友们的AGI 群"
wechat-image-sender 通过 LSPosed hook 直接调微信内部发图管线,无 UI 模拟,全图 CDN 上传。
一键日报(全流程)
# 1. 确保文章已提取+摘要已缓存
python3 ~/pixelphone/digest/wechat-group-digest/scripts/scan_articles.py
# 2. 获取群文章 → LLM 编撰 Markdown → 生图 → 发送
hermes chat -s wechat-group-digest -q "给 TGO 群(54655425669@chatroom)生成今天的日报并发送图片"
Key APIs
| Endpoint | Method | Purpose |
|---|---|---|
/api/articles/extract |
POST | WeChat DB → articles + article_shares,URL 去重 + unescape &→& |
/api/articles/unsummarized?limit=N |
GET | 未缓存摘要的文章(JOIN articles+article_shares, LEFT JOIN daily_reports) |
/api/articles/summarize |
POST | 异步 Hermes 子进程摘要,自动去重(已有缓存直接返回) |
/api/articles/by-group?chatroom_id=X |
GET | 某群文章列表 + 摘要状态(daily_reports LEFT JOIN) |
/api/articles?date_from=&date_to= |
GET | 全局文章列表,按日期筛选 |
/api/articles/check-summaries |
POST | 批量去重查询 |
Pitfalls
&in URLs: WeChat XML 用&,extract API 自动html.unescape(url)后存储- pycache stale: 改 app.py/local_db.py 后删
__pycache__/再重启 Flask,或用python3 -B fuseron Android: root 下fuser不可用,用su -c 'netstat -tlnp | grep 5000'找 PID- Gateway 必须运行: cron 调度器在 Gateway 内,
hermes cron status检查。启动脚本自动拉起 - 异步摘要需等待: summarize API 是异步的(Hermes 子进程),日报生成前确认摘要已返回(
report_id非 null)