Merge branch 'feat/local-http-api'

2026-08-17 03:27:00 +08:00 · 2026-07-09 10:37:20 +08:00
parent 4d14ce867c 3eb4438f4c
commit f9e629948d
20 changed files with 2501 additions and 279 deletions
@@ -83,6 +83,74 @@ MAC系统 获取微信聊天记录 AI一键生成群聊总结
 1. 从 WeFlow/Chatlog 设置中导出
 2. 使用内存扫描工具从微信进程中自动提取（待实现）

+## 🤖 AI 集成（本地 HTTP API）
+
+WechatExplorer 内置了一个本地 HTTP API 服务，默认监听 `127.0.0.1:6131`（纯本地，无鉴权），让你能够从 **Claude Desktop / Claude Code / Codex / curl / 任何脚本** 读取已经解锁的微信聊天记录。
+
+### 启用本地 API
+
+API 服务在 WechatExplorer 启动时自动启用，**不需要任何配置**。只需要：
+1. 安装并启动 WechatExplorer
+2. 完成首次密钥配置（主窗口第一步），解锁 WCDB 数据库
+3. API 即在 `http://127.0.0.1:6131` 可用
+
+### 7×24 提供 API（菜单栏常驻模式）
+
+默认情况下，关闭主窗口时 macOS 会让 app 继续运行，但 Windows / Linux 会退出。如果希望主窗口关闭后 API 服务仍可用，启用菜单栏模式：
+
+```bash
+# 任选一种方式
+WXE_TRAY=1 open /Applications/WechatExplorer.app
+/Applications/WechatExplorer.app/Contents/MacOS/WechatExplorer --tray
+```
+
+启用后：
+- macOS dock 图标自动隐藏
+- 菜单栏出现 WechatExplorer 图标（可点击重新打开主窗口、查看 API 状态）
+- 主窗口关闭后 API 服务继续运行
+
+### API 端点一览
+
+| 端点 | 说明 |
+|------|------|
+| `GET /api/v1/health` | 健康检查 |
+| `GET /api/v1/current_time` | 获取当前本地时间（用于"今天/昨天"换算） |
+| `GET /api/v1/contact?filter=xxx` | 联系人 / 群聊列表 |
+| `GET /api/v1/chatroom?keyword=xxx` | 搜索群聊 |
+| `GET /api/v1/chatlog?talker=xxx&time=2026-07-03` | 聊天记录 |
+| `GET /api/v1/group_snapshot?md5=xxx` | 群成员快照 |
+| `GET /api/v1/resolve?q=群昵称` | 把昵称/wxid/md5 解析成 md5 |
+
+详细参数、返回结构、时间格式见 [`docs/skill/wechatexplorer-reader/SKILL.md`](./docs/skill/wechatexplorer-reader/SKILL.md)。
+
+### 让 Claude 自动总结你的群聊
+
+复制 [`docs/skill/wechatexplorer-reader/SKILL.md`](./docs/skill/wechatexplorer-reader/SKILL.md) 到 `~/.claude/skills/`，然后在 Claude Desktop 里说：
+
+> "今天 技术交流群 聊了啥？"
+
+Claude 会自动：
+1. 调 `current_time` 拿到今天日期
+2. 调 `chatroom` 找到目标群
+3. 调 `chatlog` 拿 JSON 聊天记录
+4. 自己用 LLM 生成总结报告
+
+### curl 示例
+
+```bash
+# 健康检查
+curl http://127.0.0.1:6131/api/v1/health
+
+# 今天 摸鱼交流群 的聊天记录
+curl -G "http://127.0.0.1:6131/api/v1/chatlog" \
+  --data-urlencode "talker=摸鱼交流群" \
+  --data-urlencode "time=$(date +%Y-%m-%d)"
+
+# 把群昵称解析成 md5
+curl -G "http://127.0.0.1:6131/api/v1/resolve" \
+  --data-urlencode "q=摸鱼交流群"
+```
+
 ## ⚠️ 免责声明

 本项目仅供学习和研究使用。请勿用于非法用途。开发者不对使用本项目造成的任何后果负责。请遵守相关法律法规和微信使用协议。