wechat-radar/README.md

微信雷达（WeChat Radar）

本地优先的微信群聊情报看板。它从本机 wx-cli 或 demo 数据中提取趋势、关键链接、行动机会、人物雷达和内容选题，帮助你从大量微信群消息里发现真正有用的信号。

特性

• 首页情报工作台：今日值得出手、趋势升温、异常信号、链接精选、人物雷达、内容选题。
• 链接情报：聚合最近一天出现的文章、工具和资源，按重复度和跨群扩散排序。
• 话题雷达：按日期构建跨群话题，并查看相关原始消息。
• 群列表与群详情：查看群活跃度、每日趋势、Top 发言人和完整消息。
• 本地 SQLite：默认数据目录 ~/.wechat-radar。
• 首次启动向导：配置你的微信名、检查 wx-cli、确认隐私、可一键使用示例数据。

运行要求

• macOS
• Node.js 20+
• pnpm
• 可选：wx-cli，用于读取本机微信数据

没有 wx-cli 也可以使用 demo 模式预览界面。

快速开始

pnpm install
pnpm rebuild better-sqlite3
pnpm dev

访问 http://localhost:3000。首次访问会进入 /setup。

Demo 模式

如果你还没有配置 wx-cli，可以在 /setup 勾选“使用示例数据体验”。也可以命令行生成示例数据：

pnpm demo:seed
pnpm dev

示例数据会写入 ~/.wechat-radar/radar.db。

配置

可以通过 .env.local 配置：

WECHAT_RADAR_DATA_DIR=~/.wechat-radar
WECHAT_RADAR_MY_NAMES=你的微信名,你的群昵称
WECHAT_RADAR_DEMO=0
WECHAT_RADAR_CODEX_MODEL=

也可以在首次启动向导中配置，配置会保存在：

~/.wechat-radar/config.json

关键配置：

配置	说明
WECHAT_RADAR_DATA_DIR	本地数据目录，默认 ~/.wechat-radar
WECHAT_RADAR_MY_NAMES	用于识别 @我的多个昵称，逗号分隔
WECHAT_RADAR_DEMO	设置为 1 时启用 demo 模式
WECHAT_RADAR_CODEX_MODEL	可选，Codex CLI 话题/链接整理使用

wx-cli 接入

确认 wx 命令可用：

wx --version
wx daemon status
wx sessions -n 10 --json

如果 daemon 没运行，请按你的 wx-cli 文档启动或修复。

数据存储

默认数据目录：

~/.wechat-radar/
├── radar.db
└── config.json

数据库包含：

• messages：同步后的本地消息。
• daily_stats：每日聚合统计。
• mentions：@我的索引。
• groups / group_tags：本地分组。
• topics / topic_messages：话题雷达结果。
• link_intelligence_cache：链接情报缓存。

不要把 radar.db、.env.local 或日志提交到 Git。

常用命令

pnpm dev          # 本地开发
pnpm build        # 生产构建
pnpm lint         # 代码检查
pnpm demo:seed    # 写入示例数据

隐私说明

微信雷达默认只读本机数据，并把处理结果写入本地 SQLite。项目本身不提供云端服务，也不会自动上传聊天记录。

你需要自行确认读取、保存、处理聊天数据符合当地法律、平台规则和群成员预期。更多见 PRIVACY.md。

开源协议

MIT，见 LICENSE。