WeChat Viewer — 开发日志 2026-07-08

环境

• 设备: Pixel 10 Pro Fold, Android 16
• 路径: ~/wechat-viewer/
• 访问: http://192.168.110.174:5000 (局域网 Mac)
• 进程: python3 app.py (proc_2a6f885e1cfb)
• 重启脚本: bash ~/wechat-viewer/restart.sh

架构原则

• Skill 驱动: 所有智能任务通过 Hermes CLI 子进程 + skill 执行，不写死 Python 逻辑
• 子进程模式: hermes chat -q "prompt" -s <skill> --yolo -t terminal,web,file
• Skill 迭代优于代码迭代: 改 skill 不需要重启 Flask

今日完成的功能

1. 文章列表 (articles)

• 导航栏「数据中心」→「文章列表」
• 从 WeChat DB 提取所有 type=49 公众号文章
• 去重: 用 __biz|mid|idx|sn 四元组，解决同一文章不同追踪参数导致的重复
• 热度: 显示每个文章被几个群引用过，列出群名
• 筛选: 按标题搜索、按群筛选
• 排序: 时间正倒序、热度正倒序
• 按钮: 📝摘要 🔧学习 🖼图片

2. 日报系统 (reports)

• 三种类型标签: 群日报、文章摘要、学习记录
• 生成日报: 从消息浏览页或聊天页触发 → Hermes CLI + wechat-group-digest skill
• 生成图片: 每个日报→Hermes CLI + gpt-image-gen skill → 19世纪复古铜版画风格 → 存日报图片列表
• 筛选: 全部/群日报/文章摘要/学习记录
• 搜索 + 时间排序

3. 日报图片 (report-images)

• 查看/删除/发送微信
• 发送微信: 直接调 wechat_hook_send.send_image_via_hook，不走 Hermes 子进程
• 图片弹窗预览，点击空白关闭
• 联系人选择弹窗，按最新消息排序

4. 文章摘要 + 学习构建

• /api/articles/summarize → Hermes CLI → 提取核心观点 → 存日报
• /api/articles/learn → Hermes CLI + learn-and-build skill → 分类处理 → 存日报
• /api/articles/generate-image → Hermes CLI + gpt-image-gen → 存日报图片

5. 聊天页增强

• 文章卡片下方增加 📝摘要 🔧学习 🖼图片 按钮
• 视频号完整解析（提取昵称/描述/封面/时长）
• CDATA 全局清理

6. 创建的 Skill

• learn-and-build — 学习文章 → 构建/迭代 Hermes skill
• headroom-context-compressor — Headroom 上下文压缩集成方案

7. UI 改造

• 所有列表页可滚动 (body overflow-y:auto)
• 按钮移至卡片底部，大号适合移动端
• 日报类型彩色标签

关键 bug 修复

• 文章去重: URL 追踪参数 → 四元组 key
• 发送图片: closeSendModal 先清空 currentImageId 导致 fetch URL 为 null → 先保存后关闭
• 发图超时: Hermes 子进程 60s TIMEOUT → 改直调 wechat_hook_send
• 聊天页文章卡片空白: patch 误删 HTML 主体 → 重写

技术栈

• Flask + Jinja2 + SQLite
• wechat_db (su sqlcipher 读微信加密数据库)
• local_db (circle.db 存日报/图片/记录)
• Hermes CLI 子进程调度
• wechat_hook_send (LSPosed hook 发图)