# 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 驱动: ```bash # 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: ```json { "data": [{ "id": 123, "url": "...", "title": "...", "createTime": 1783242197000, "report_id": 42, // 非 null = 摘要已缓存 "summary": "# 标题\n\n核心观点..." // 已缓存的 Markdown 摘要 }] } ``` ## Step 3: 补齐缺失摘要 对 `report_id` 为 null 的文章批量提交摘要: ```bash 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 上传。 ## 一键日报(全流程) ```bash # 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` - **`fuser` on Android**: root 下 `fuser` 不可用,用 `su -c 'netstat -tlnp | grep 5000'` 找 PID - **Gateway 必须运行**: cron 调度器在 Gateway 内,`hermes cron status` 检查。启动脚本自动拉起 - **异步摘要需等待**: summarize API 是异步的(Hermes 子进程),日报生成前确认摘要已返回(`report_id` 非 null)