mirror of
https://github.com/joeseesun/wechat-radar.git
synced 2026-09-09 11:58:29 +09:00
121 lines
3.2 KiB
Markdown
121 lines
3.2 KiB
Markdown
# 微信雷达（WeChat Radar）
|
||
|
||
本地优先的微信群聊情报看板。它从本机 `wx-cli` 或 demo 数据中提取趋势、关键链接、行动机会、人物雷达和内容选题，帮助你从大量微信群消息里发现真正有用的信号。
|
||
|
||
## 特性
|
||
|
||
- 首页情报工作台：今日值得出手、趋势升温、异常信号、链接精选、人物雷达、内容选题。
|
||
- 链接情报：聚合最近一天出现的文章、工具和资源，按重复度和跨群扩散排序。
|
||
- 话题雷达：按日期构建跨群话题，并查看相关原始消息。
|
||
- 群列表与群详情：查看群活跃度、每日趋势、Top 发言人和完整消息。
|
||
- 本地 SQLite：默认数据目录 `~/.wechat-radar`。
|
||
- 首次启动向导：配置你的微信名、检查 `wx-cli`、确认隐私、可一键使用示例数据。
|
||
|
||
## 运行要求
|
||
|
||
- macOS
|
||
- Node.js 20+
|
||
- pnpm
|
||
- 可选：[`wx-cli`](https://github.com/jackwener/wx-cli)，用于读取本机微信数据
|
||
|
||
没有 `wx-cli` 也可以使用 demo 模式预览界面。
|
||
|
||
## 快速开始
|
||
|
||
```bash
|
||
pnpm install
|
||
pnpm rebuild better-sqlite3
|
||
pnpm dev
|
||
```
|
||
|
||
访问 [http://localhost:3000](http://localhost:3000)。首次访问会进入 `/setup`。
|
||
|
||
## Demo 模式
|
||
|
||
如果你还没有配置 `wx-cli`，可以在 `/setup` 勾选“使用示例数据体验”。也可以命令行生成示例数据：
|
||
|
||
```bash
|
||
pnpm demo:seed
|
||
pnpm dev
|
||
```
|
||
|
||
示例数据会写入 `~/.wechat-radar/radar.db`。
|
||
|
||
## 配置
|
||
|
||
可以通过 `.env.local` 配置：
|
||
|
||
```env
|
||
WECHAT_RADAR_DATA_DIR=~/.wechat-radar
|
||
WECHAT_RADAR_MY_NAMES=你的微信名,你的群昵称
|
||
WECHAT_RADAR_DEMO=0
|
||
WECHAT_RADAR_CODEX_MODEL=
|
||
```
|
||
|
||
也可以在首次启动向导中配置，配置会保存在：
|
||
|
||
```text
|
||
~/.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` 命令可用：
|
||
|
||
```bash
|
||
wx --version
|
||
wx daemon status
|
||
wx sessions -n 10 --json
|
||
```
|
||
|
||
如果 daemon 没运行，请按你的 `wx-cli` 文档启动或修复。
|
||
|
||
## 数据存储
|
||
|
||
默认数据目录：
|
||
|
||
```text
|
||
~/.wechat-radar/
|
||
├── radar.db
|
||
└── config.json
|
||
```
|
||
|
||
数据库包含：
|
||
|
||
- `messages`：同步后的本地消息。
|
||
- `daily_stats`：每日聚合统计。
|
||
- `mentions`：@我的索引。
|
||
- `groups` / `group_tags`：本地分组。
|
||
- `topics` / `topic_messages`：话题雷达结果。
|
||
- `link_intelligence_cache`：链接情报缓存。
|
||
|
||
不要把 `radar.db`、`.env.local` 或日志提交到 Git。
|
||
|
||
## 常用命令
|
||
|
||
```bash
|
||
pnpm dev # 本地开发
|
||
pnpm build # 生产构建
|
||
pnpm lint # 代码检查
|
||
pnpm demo:seed # 写入示例数据
|
||
```
|
||
|
||
## 隐私说明
|
||
|
||
微信雷达默认只读本机数据，并把处理结果写入本地 SQLite。项目本身不提供云端服务，也不会自动上传聊天记录。
|
||
|
||
你需要自行确认读取、保存、处理聊天数据符合当地法律、平台规则和群成员预期。更多见 [PRIVACY.md](./PRIVACY.md)。
|
||
|
||
## 开源协议
|
||
|
||
MIT，见 [LICENSE](./LICENSE)。
|