WeChat Daily Report Skill

项目介绍 / Project Introduction

中文介绍：微信群日报 Skill，用本地只读微信数据生成日报、长图和复盘素材，适合社群运营和信息整理。

English: A WeChat daily report skill that uses local read-only WeChat data to generate reports, long images, and review materials for community operations.

SEO 关键词 / SEO Keywords: WeChat daily report, community operations, AI summary, local data, 微信群日报

把微信群聊天记录整理成一份可阅读、可截图、可归档的「群日报」。

这版重点重做了 UI，也把数据入口调整为优先使用 jackwener/wx-cli：wx-cli 负责从本机微信获取聊天记录，本仓库负责把记录整理成日报 HTML/PNG。

预览

本仓库内置示例：

• 在线预览
• HTML 预览
• PNG 长图

能做到什么

• 生成微信群「每日聊天记录报告」
• 汇总今日话题、资源链接、重要消息、精彩对话、问答、成员输出
• 用聊天气泡还原关键对话，不只是统计数字
• 输出交互式 HTML 和可分享 PNG 长图
• 支持按成员过滤相关内容
• 默认用 jackwener/wx-cli 获取本地微信聊天记录
• 可以作为 Obsidian 归档素材：把 HTML/PNG/生成的 Markdown 放进 vault 即可

不能误解的地方

这不是 Obsidian 插件，也不是安装后自动打通微信的插件。

它是一个 Skill + 本地脚本工作流：先拿到微信聊天数据，再让 AI 生成结构化日报内容，最后渲染成 HTML/PNG。如果你想在 Obsidian 里长期查看聊天记录、附件和资料，需要再把导出的 Markdown/HTML/图片/附件目录放入 Obsidian vault。

数据来源怎么选

不是只能用 WeFlow。

方式	适合场景	说明
jackwener/wx-cli	推荐主路线	直接查询本地微信聊天记录，本仓库已内置 scripts/wx_cli_to_report.py 适配
本地 wechat-cli 包	备用路线	如果装不了 wx，可以用你本地的 wechat-cli 二进制，通过 --binary 指定
手工导出的聊天文本/JSON	快速试用	直接让 AI 按 references/ai_prompt.md 生成 ai_content.json，再渲染
WeFlow	后续扩展	适合做更完整的导出、解密、年报、本地 API
CipherTalk	底层参考	更适合参考微信数据库解密与读取思路
旧版本地解密脚本	兼容路线	仓库仍保留旧脚本，但优先推荐 wx-cli

更详细说明见 数据来源说明。

安装

git clone https://github.com/siuserxiaowei/wechat-daily-report-skill.git
cd wechat-daily-report-skill
python3 -m pip install -r requirements.txt
python3 -m playwright install chromium

安装 wx-cli：

npm install -g @jackwener/wx-cli

macOS 首次使用按 wx-cli 官方要求初始化：

codesign --force --deep --sign - /Applications/WeChat.app
killall WeChat && open /Applications/WeChat.app
sudo wx init
wx sessions

如果你要作为 Codex/Claude Skill 使用，也可以把仓库放到对应 skills 目录：

mkdir -p ~/.codex/skills
git clone https://github.com/siuserxiaowei/wechat-daily-report-skill.git ~/.codex/skills/wechat-daily-report-skill

先跑一遍示例

从 wx-cli JSON 样例生成日报输入：

python3 scripts/wx_cli_to_report.py \
  --input-json examples/wx_cli_history_sample.json \
  --chatroom "Dont哥 对谈群" \
  --date 2026-04-30 \
  --output-stats examples/wx_stats_from_sample.json \
  --output-text examples/wx_simplified_chat_sample.txt

渲染内置完整示例：

python3 scripts/generate_report.py \
  --stats examples/sample_stats.json \
  --ai-content examples/sample_ai_content.json \
  --output examples/qun-ribao-demo.html

生成 PNG 长图：

python3 scripts/generate_report.py \
  --stats examples/sample_stats.json \
  --ai-content examples/sample_ai_content.json \
  --output examples/qun-ribao-demo.png \
  --viewport-width 1180 \
  --viewport-height 1400 \
  --device-scale-factor 2

生成真实群日报

1. 用 wx-cli 获取微信聊天记录

确认能看到最近会话：

wx sessions

把某个群当天记录转成日报输入：

python3 scripts/wx_cli_to_report.py \
  --chatroom "群名称或 chatroom id" \
  --date 2026-04-30 \
  --limit 5000 \
  --output-stats stats.json \
  --output-text simplified_chat.txt \
  --raw-output raw_wx_history.json

产物：

• stats.json：消息数、活跃成员、话唠榜、词云等统计数据
• simplified_chat.txt：压缩后的聊天文本，给 AI 生成日报内容用
• raw_wx_history.json：原始 wx-cli 输出，便于排查

2. 如果只能用本地 wechat-cli 包

你提到的 wechat-cli-pkg.tar.gz 也能用。解压后直接把二进制路径传给适配器：

tar -xzf /path/to/wechat-cli-pkg.tar.gz -C /tmp/wechat-cli-pkg
python3 scripts/wx_cli_to_report.py \
  --binary /tmp/wechat-cli-pkg/wechat-cli-pkg/wechat-cli/node_modules/@canghe_ai/wechat-cli-darwin-arm64/bin/wechat-cli \
  --chatroom "群名称或 chatroom id" \
  --date 2026-04-30 \
  --limit 5000 \
  --output-stats stats.json \
  --output-text simplified_chat.txt

3. 生成 AI 内容

把下面三个东西一起交给 AI：

• references/ai_prompt.md
• stats.json
• simplified_chat.txt

要求 AI 只输出合法 JSON，保存为：

ai_content.json

4. 渲染日报

生成交互式网页：

python3 scripts/generate_report.py \
  --stats stats.json \
  --ai-content ai_content.json \
  --output report.html

生成可分享长图：

python3 scripts/generate_report.py \
  --stats stats.json \
  --ai-content ai_content.json \
  --output report.png \
  --viewport-width 1180 \
  --viewport-height 1400 \
  --device-scale-factor 2

放进 Obsidian

推荐目录：

YourVault/
  WeChat/
    DailyReports/
      2026-04-30-report.html
      2026-04-30-report.png
      2026-04-30-ai_content.json
      2026-04-30-stats.json

你可以在 Obsidian 里新建一篇笔记：

# 2026-04-30 群日报

![[2026-04-30-report.png]]

HTML 交互版：[[2026-04-30-report.html]]

项目结构

assets/report_template.html      # 新版日报 UI 模板
scripts/wx_cli_to_report.py      # wx-cli/wechat-cli 转日报输入
scripts/analyze_chat.py          # 从本地微信数据生成 stats/simplified_chat
scripts/generate_report.py       # Jinja2 渲染 HTML，并用 Playwright 输出 PNG
references/ai_prompt.md          # AI 生成 ai_content.json 的提示词
examples/                        # 示例数据、HTML 和长图截图
docs/data-sources.md             # 数据来源和 WeFlow/CipherTalk 接入说明
SKILL.md                         # 给 Codex/Claude 使用的 Skill 说明

参考来源

• 首选数据入口：jackwener/wx-cli
• UI 方向参考：群日报示例页面
• 原始 skill 思路参考：ADVISORYDZ/wechat-daily-report-skill
• 数据导出方向参考：hicccc77/WeFlow
• 微信解密思路参考：ILoveBingLu/CipherTalk

License

MIT

联系我 / Contact

想交流 AI 工具、内容自动化、SEO、私域增长或项目合作，可以扫码加我微信。

For collaboration on AI tools, content automation, SEO, private-domain growth, or product experiments, scan the WeChat QR code below.

关键词 / Keywords: WeChat daily report, community operations, AI summary, local data, AI tools, AI automation, GitHub Pages, SEO