WeChat Daily Report Skill

Repository Guide

What This Repository Does

微信群日报 Skill：把微信群聊整理成社区运营日报和 AI 摘要报告。

English summary: WeChat group daily-report skill for turning chats into community operation reports and AI summaries.

Online Entry Points

GitHub repository: https://github.com/siuserxiaowei/wechat-daily-report-skill
Live / GitHub Pages: https://siuserxiaowei.github.io/wechat-daily-report-skill/
Default branch: main
Primary language: HTML
Topics: daily-report, jinja2, obsidian, playwright, wechat, chat-report

How To Read / Learn This Repository

先读本 README，确认项目目标、在线入口和本地运行方式。
打开上方 Live / GitHub Pages 链接，先从最终效果理解项目。
优先查看 SKILL.md、README.md 和示例脚本，理解这个 skill 解决什么问题。
如果要修改内容，先小范围改动，再运行本 README 中的验证命令。

Clone This Repository

git clone https://github.com/siuserxiaowei/wechat-daily-report-skill.git
cd wechat-daily-report-skill

Run Or View Locally

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Repository Map

Path	Purpose
`README.md`	项目入口说明，先读这里。
`SKILL.md`	Skill 的核心说明、触发条件和使用步骤。
`index.html`	静态站首页或页面入口。
`docs/`	文档或 GitHub Pages 输出目录。
`assets/`	图片、样式、字体或页面资源。
`scripts/`	构建、同步、生成或维护脚本。
`LICENSE`	项目文件。
`agents/`	项目目录。
`examples/`	项目目录。
`references/`	项目目录。
`reports/`	项目目录。
`requirements.txt`	项目文件。

Maintenance Notes

Keep this README in sync when the project purpose, live link, or run commands change.
Prefer small, focused commits when changing code, data, or generated pages.
Run the relevant build or validation command before publishing changes.
If this is a generated/static archive, update the source data first, then regenerate the public files.

Privacy And Safety

Do not commit API keys, tokens, passwords, cookies, private URLs, or internal account data.
Keep private source material out of public GitHub Pages output unless it has been explicitly cleared for publication.
When in doubt, run a quick secret scan such as rg -n "token|secret|password|access_key|authorization" before pushing.

项目介绍 / 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 长图
支持按成员过滤相关内容
默认用 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

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

WeChat Daily Report Skill

Repository Guide

What This Repository Does

Online Entry Points

How To Read / Learn This Repository

Clone This Repository

Run Or View Locally

Repository Map

Maintenance Notes

Privacy And Safety

项目介绍 / Project Introduction

预览

能做到什么

不能误解的地方

数据来源怎么选

安装

先跑一遍示例

生成真实群日报

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

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

3. 生成 AI 内容

4. 渲染日报

放进 Obsidian

项目结构

参考来源

License

联系我 / Contact

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Name		Name	Last commit message	Last commit date
Latest commit History 19 Commits
agents		agents
assets		assets
docs		docs
examples		examples
references		references
reports		reports
scripts		scripts
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
SKILL.md		SKILL.md
index.html		index.html
requirements.txt		requirements.txt

Folders and files

Latest commit

History

Repository files navigation

WeChat Daily Report Skill

Repository Guide

What This Repository Does

Online Entry Points

How To Read / Learn This Repository

Clone This Repository

Run Or View Locally

Repository Map

Maintenance Notes

Privacy And Safety

项目介绍 / Project Introduction

预览

能做到什么

不能误解的地方

数据来源怎么选

安装

先跑一遍示例

生成真实群日报

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

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

3. 生成 AI 内容

4. 渲染日报

放进 Obsidian

项目结构

参考来源

License

联系我 / Contact

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages