open-source/WechatExplorer
1
0
Fork 0
mirror of https://wget.la/https://github.com/Wxw-Gu/WechatExplorer synced 2026-08-17 03:27:00 +08:00
Code Issues Packages Projects Releases Wiki Activity

docs: 更新文档

Browse Source
This commit is contained in:
电摇小子
2026-08-08 14:54:54 +08:00
parent cd2c3cfaee
commit f2c58f39b0
23 changed files with 713 additions and 182 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/agent/agent-hub.md
+6 -4
View File
@@ -1,6 +1,8 @@
# Agent Hub：让微信机器人参与实时工作
# 在微信里向 WechatExplorer 提问（Agent Hub）
Agent Hub 是 WechatExplorer 内置的实时微信交互入口。你先在应用中扫码登录一个微信机器人账号，之后向这个机器人发送文字；本机 Agent Hub 会接收消息、读取已经连接的微信数据，必要时调用已配置的 AI，再把结果回复给发消息的人。
Agent Hub 是 WechatExplorer 内置的微信机器人入口，也是应用一级导航中的“Agent”页面。你先扫码登录一个微信机器人账号，再用微信账号向机器人发送文字；本机 Agent Hub 会接收消息、读取已经连接的微信数据，必要时调用已配置的 AI，再把结果回复给发送者。
普通用户不需要安装 Reader Skill，也不需要配置 API Token。先连接微信数据库，再扫码登录机器人即可开始；需要总结或自然语言理解的任务还要配置 AI Provider。
它和 Reader Skill 是两条不同的路径：
@@ -15,7 +17,7 @@ Agent Hub 是 WechatExplorer 内置的实时微信交互入口。你先在应用
连接 Agent Hub 后，可以在微信中询问：
- “最近 5 条消息是谁？”
- “最近 5 个会话”；
- “帮我看看最近跟某人聊了些什么。”
- “生成产品交流群今天的群聊总结图片。”
@@ -38,7 +40,7 @@ Agent Hub 是 WechatExplorer 内置的实时微信交互入口。你先在应用
2. 确认 Hub 显示“运行中”，数据库状态为“可查询”。
3. 点击“扫码登录微信机器人”。
4. 用微信扫描二维码；如果页面显示“已扫码，等待手机确认”，在手机上确认。
5. 状态变为“在线”后，从该机器人账号发送测试问题。
5. 状态变为“在线”后，用另一个微信账号向机器人发送测试问题。
可以重新扫码登录或断开连接。登录凭证失效时，需要重新扫码。
docs/agent/overview.md
+35 -30
View File
@@ -1,47 +1,52 @@
# 连接 Agent：你能用它做什么
# 在微信机器人或外部 Agent 中使用 WechatExplorer
WechatExplorer 的 Agent 能力分成“查询过去的数据”和“处理实时微信消息”两条路径。先按你想完成的任务选择，不需要先学习内部模块名称。
WechatExplorer 提供两条不同路径。先按你实际想做的事选择，不需要先理解 Agent、Skill 或 API 等术语。
## 两种不同的使用方式
| 你想做什么 | 使用方式 | 需要什么 |
| ---------------------------------------------------- | ----------------------------- | --------------------------------------------------------- |
| 直接在微信里发文字，让本机查询聊天并回复 | 微信机器人（Agent Hub） | 在应用“Agent”页面扫码登录机器人；部分任务需要 AI Provider |
| 在 Codex、Claude Code、OpenClaw 等工具里查询微信历史 | Reader Skill + Local HTTP API | 安装 Skill，并配置本机 API Token |
### 让外部 Agent 查询历史微信
## 直接在微信里提问
连接 Reader Skill 后，你可以在本机的 Codex、Claude Code、OpenClaw 或其他 Agent 中询问自己的微信历史，例如：
打开应用一级导航中的“Agent”，进入“Agent Hub”，扫码登录一个微信机器人账号。之后用另一个微信账号向机器人发送文字，它会调用 WechatExplorer 的本机数据，必要时使用已配置的 AI，再把结果回复给发送者。
可以先尝试：
- “最近 5 个会话”；
- “帮我看看最近跟张三聊了些什么”；
- “生成产品交流群今天的群聊总结图片”。
这条路径不要求安装 Reader Skill，也不要求用户配置 API Token。它主要处理文字请求，不支持群发、定时任务或与文字同等的任意媒体理解。
连接步骤、当前任务清单和安全边界见[Agent Hub](./agent-hub.md)。
## 在外部 Agent 中查询历史微信
Reader Skill 是给外部 Agent 的操作说明。安装后，Codex、Claude Code、OpenClaw 或其他本地 Agent 可以通过 WechatExplorer Local HTTP API 按需读取联系人、群聊、最近会话、指定时间范围的聊天和群成员信息。
典型问题包括：
- “总结今天技术交流群讨论的内容。”
- “帮我找上个月讨论过的项目地址。”
- “过去一周有没有人提到退款？”
Agent 会按需读取 WechatExplorer 提供的联系人、群聊和聊天记录；它不会直接打开微信数据库文件。
外部 Agent 不会直接打开微信数据库文件，但它能取得本机 API 返回的聊天内容。Agent 是否继续把结果发送给云端模型，取决于 Agent 自己的模型和工具配置。
| 方式 | 适合谁 | 作用 | 是否需要外部 Agent 配置 |
| --- | --- | --- | --- |
| Reader Skill + Local HTTP API | 想在 Codex/Claude Code/OpenClaw 中查微信的人 | Agent 通过本机 HTTP 请求读取聊天 | 是，需要安装 Skill 和 Token |
| Agent Hub | 想从微信机器人账号发消息、让本机处理并回复的人 | 微信连接器把消息送到本机 Hub，Hub 调用数据和 AI | 不使用外部 Reader Skill，但需要扫码连接机器人 |
这两条路径不要混写：Reader Skill/API 是外部 Agent 主动读取历史；Agent Hub 是机器人收到实时消息后处理并回复。`127.0.0.1:6131` 是 Local HTTP API，不是 MCP Server。
## 外部 Agent 的安装路径
## 外部 Agent 的安装步骤
1. 启动 WechatExplorer 并完成微信数据库连接。
2. 打开“API Center”，确认本地 API、数据库和 Reader Skill 都显示可用。
3. 在 API Center 选择目标 Agent（Codex、Claude Code、OpenClaw 或其他 Agent），点击“复制安装指令”。
4. 在 Agent 自己的本地 Skill/配置目录执行或粘贴指令。
2. 打开一级导航“API”（页面为“API Center”），确认本地 API、数据库和 Reader Skill 都可用。
3. 选择目标 Agent，点击“复制安装指令”。
4. 在 Agent 自己的 Skill/配置目录执行或粘贴指令。
5. 在 API Center 复制当前 Token，并在 Agent 运行环境中设置 `WECHATEXPLORER_API_TOKEN`。
6. 先让 Agent 调用 health，再尝试查询联系人或最近会话。
6. 先让 Agent 调用 health，再尝试查询最近会话。
详细说明：[Reader Skill](./reader-skill.md)、[Local HTTP API](./api.md)、[API 安全](./api-security.md)。
## Agent 能看到什么
## 不要混淆两条路径
外部 Agent 通过 API 按需读取联系人、群聊、最近会话、指定时间范围聊天和群成员快照，也可以请求生成群聊总结图片。API 本身不提供任意文件系统浏览，也不会把完整数据库自动上传到网络。
Agent 是否把读取结果再次交给云端模型，取决于 Agent 的模型配置和它如何处理工具结果。使用前请检查 Agent 自己的隐私设置。
## 什么时候用 Agent Hub
如果你希望直接在微信里问“最近 5 条消息是谁？”或“生成产品交流群今天的群聊总结图片”，打开应用主导航中的“Agent”，进入“Agent Hub”，扫码登录一个微信机器人账号。机器人收到文字后，会调用本地数据和已配置的 AI，再把结果回复给发消息的人。
当前实时入口支持最近会话、联系人近期聊天、联系人近 7 天总结、群聊总结图片、群成员发言总结和有限的普通自然语言回复。它不等于通用聊天机器人，也不提供群发、定时或任意媒体理解。
详细流程见[Agent Hub](./agent-hub.md)。
- Agent Hub：微信机器人收到实时文字后处理并回复；
- Reader Skill/API：外部 Agent 主动查询历史数据；
- `127.0.0.1:6131` 是 Local HTTP API，不是 MCP Server；
- Local HTTP API 当前没有对外提供实时入站消息订阅。