WeChat Radar – 微信聊天情报看板丨聚合群聊信号、话题、链接和趋势

WeChat Radar 是一个本地优先的微信群聊情报看板。它把群消息、话题、链接、@我的消息和高信号人物聚合成一个可按日期查看的工作台。

Contents
  1. 功能介绍
  2. 快速开始
  3. 使用方式
  4. 数据与隐私
  5. 免责声明与禁止事项
  6. 常见问题
  7. 官方网站
  8. 下载地址

功能介绍

你得到的不是“聊天记录列表”，而是每天可以直接处理的情报：

  • 今日优先看：消息、文章、工具、异动分区展示
  • 话题雷达：用 Codex CLI 按天聚合跨群话题
  • 链接情报：文章/工具资源去重，生成可读标题
  • 群日报：每天活跃群可生成摘要报告，方便复制给 AI 继续处理
  • 本地存储：聊天数据落到你自己的 SQLite，不上传到第三方服务
  • 明暗主题：默认奶白色浅色主题，也支持深色模式

快速开始

git clone https://github.com/joeseesun/wechat-radar.git
cd wechat-radar
pnpm install
pnpm rebuild better-sqlite3
pnpm dev

打开 http://localhost:3000。首次进入会跳到 /setup，按页面提示填写你的微信名、确认隐私说明，也可以先启用 demo 数据体验。

前置条件

  •  macOS，且已登录微信 4.x
  •  建议使用注册半年以上的小号或测试号，不建议直接使用主力微信号
  •  已测试微信版本：4.1.9.58；不建议在更高版本上贸然测试
  •  Node.js 20+：node --version
  •  pnpm：corepack enable && pnpm --version
  •  wx-cli：wx --version
  •  wx daemon 正在运行：wx daemon status
  •  如果要让话题聚合更好，安装并登录 Codex CLI：codex --version

wx-cli 可参考原项目安装与初始化：jackwener/wx-cli。

配置

默认数据目录是 ~/.wechat-radar/，不会写进项目目录。

你可以用环境变量覆盖：

cp .env.example .env.local

常用配置：

WECHAT_RADAR_DATA_DIR=~/.wechat-radar
WECHAT_RADAR_MY_NAMES=张三,San Zhang,zhangsan
WECHAT_RADAR_DEMO=0
WECHAT_RADAR_CODEX_MODEL=

也可以直接在 /setup 页面配置。配置会写入 ~/.wechat-radar/config.json。

使用方式

  1. 进入首页，选择日期或时间范围。
  2. 点击“重扫”同步当前范围消息。
  3. 点击“全量同步”拉取更长历史。
  4. 打开“话题雷达”查看跨群主题。
  5. 打开“链接情报”查看文章和工具资源。
  6. 在活跃群列表点击“日报”查看单群日报。

你可以这样和 AI 配合：

  • “把今天所有 Codex 相关话题整理成一篇博客大纲。”
  • “复制这个群日报，帮我提炼值得回复的机会。”
  • “把链接情报里的工具做成一张试用优先级表。”

数据与隐私

WeChat Radar 默认只在本机读写数据：

  • ~/.wechat-radar/radar.db：SQLite 主数据库
  • ~/.wechat-radar/config.json：本地配置
  • ~/.wechat-radar/backups/：可选备份

安全设计：

  • wx-cli 调用使用 child_process.execFile 参数数组，不拼 shell
  • SQLite 使用 prepared statements
  • 页面只以 React 文本节点渲染聊天内容
  • 不把微信密钥、会话、数据库、模型缓存提交进仓库

重要风险提示：

  • 建议使用注册半年以上的小号或测试号，不建议使用主力微信号。
  • 当前只建议读取历史聊天记录，用于本地检索、聚合和摘要。
  • 不建议读取朋友圈，也不要自动点赞、评论、发消息、加好友、改资料或做任何写入/社交操作。
  • 已测试通过的微信版本是 4.1.9.58；不建议在更高版本上贸然测试，版本变化可能带来不可预期的账号风险。
  • 请确认你的使用方式符合微信客户端规则、当地法律、群成员隐私预期和你所在组织的合规要求。
  • 不要把包含真实聊天内容的数据库或截图上传到公开仓库。

免责声明与禁止事项

本项目仅供学习研究、个人评估和非商业实验使用。禁止用于商业盈利，包括但不限于 SaaS、托管服务、付费报表、咨询交付、商业监控、线索挖掘、数据售卖、企业内部生产系统或任何直接/间接商业收益场景。

本项目与腾讯、微信、wx-cli 均无官方关联，未获得腾讯或微信授权、认可、赞助或背书。微信、WeChat、腾讯、Tencent 等名称和商标归其权利人所有。

用户需要自行承担安装、配置、运行、修改、部署、数据处理和传播行为的全部责任。因使用或误用本项目导致的账号限制、数据丢失、隐私泄露、商业损失、法律纠纷、平台处罚、服务中断、误判摘要或其它后果，项目作者和贡献者不承担责任。

完整条款见 DISCLAIMER.md 和 LICENSE。

常见问题

问题解决方法
wx daemon 未运行先运行 wx daemon start，再刷新页面。
better-sqlite3 native 模块报错运行 pnpm rebuild better-sqlite3。
首页没有数据先完成 /setup，确认 wx sessions --json 有输出，然后点击“重扫”。
话题雷达为空打开对应日期会自动构建；也可以点击“构建话题”。需要本机可运行 codex。
不想读取真实微信在 /setup 勾选 demo 模式，或设置 WECHAT_RADAR_DEMO=1。

官方网站

https://github.com/joeseesun/wechat-radar

https://github.com/joeseesun/wechat-radar#中文

下载地址

https://pan.quark.cn/s/280c93a2510b

支持
标签
JameCling
JameCling