mirror of
https://wget.la/https://github.com/Wxw-Gu/WechatExplorer
synced 2026-08-17 03:27:00 +08:00
Wxw-Gu
55c6fb8cd3
- 将用户可见品牌升级为 TraceMemo（迹忆） - 增加最早期 userData/sessionData 兼容路径选择 - 保留 WechatExplorer runtime identity 以兼容 safeStorage - 继续使用旧 Knowledge、Settings、API Token 和 Provider 配置 - 新日志写入 TraceMemo 目录并保留历史日志 - 保留旧 API、Skill、环境变量和导出目录兼容标识 - 更新相关文档、界面文案与自动化测试
70 lines
4.2 KiB
Markdown
70 lines
4.2 KiB
Markdown
# 在微信里向 TraceMemo 提问（Agent Hub）
|
||
|
||
Agent Hub 是 TraceMemo 内置的微信机器人入口，也是应用一级导航中的“Agent”页面。你先扫码登录一个微信机器人账号，再用微信账号向机器人发送文字；本机 Agent Hub 会接收消息、读取已经连接的微信数据，必要时调用已配置的 AI，再把结果回复给发送者。
|
||
|
||
普通用户不需要安装 Reader Skill，也不需要配置 API Token。先连接微信数据库，再扫码登录机器人即可开始；需要总结或自然语言理解的任务还要配置 AI Provider。
|
||
|
||
它和 Reader Skill 是两条不同的路径：
|
||
|
||
- Reader Skill / Local HTTP API：外部 Agent 主动查询历史微信数据；
|
||
- Agent Hub / 微信机器人：机器人收到实时消息后处理并回复。
|
||
|
||
## 连接器和 Agent Hub 是什么关系
|
||
|
||
你不需要单独部署这些组件。扫码后，后台的微信连接器负责登录机器人、保持连接、接收微信消息和发送回复；Agent Hub 负责判断消息要做什么、查询 TraceMemo 本地数据、调用 AI 并组织结果。可以把它理解为：连接器负责“和微信通信”，Hub 负责“处理任务”。
|
||
|
||
## 你能做什么
|
||
|
||
连接 Agent Hub 后，可以在微信中询问：
|
||
|
||
- “最近 5 个会话”；
|
||
- “帮我看看最近跟某人聊了些什么。”
|
||
- “生成产品交流群今天的群聊总结图片。”
|
||
|
||
当前已实现的实时任务包括：
|
||
|
||
- 查看最近会话（数量限制为 1–20）；
|
||
- 查询你和某位联系人的近期聊天；
|
||
- 用已配置的 AI 总结你和某位联系人近 7 天的聊天；
|
||
- 生成今天、昨天或近 7 天的群聊总结图片；
|
||
- 总结指定群成员在群里的近期发言；
|
||
- 对不需要读取聊天的普通文字请求返回简短 AI 回复。
|
||
|
||
任务完成后，回复会发送回触发这次请求的微信用户。群聊总结会先发送进度提示，完成后发送图片。
|
||
|
||
这些任务会在后台查询联系人、群聊和聊天记录，但当前机器人没有单独的“列出所有联系人”或“列出所有群聊”命令；需要完整浏览或按条件查询时，请使用档案页面或 Reader Skill / Local HTTP API。
|
||
|
||
## 连接步骤
|
||
|
||
1. 打开应用主导航中的“Agent”；页面标题为“Agent Hub”。
|
||
2. 确认 Hub 显示“运行中”，数据库状态为“可查询”。
|
||
3. 点击“扫码登录微信机器人”。
|
||
4. 用微信扫描二维码；如果页面显示“已扫码，等待手机确认”，在手机上确认。
|
||
5. 状态变为“在线”后，用另一个微信账号向机器人发送测试问题。
|
||
|
||
可以重新扫码登录或断开连接。登录凭证失效时，需要重新扫码。
|
||
|
||
## 运行日志
|
||
|
||
Agent Hub 页面会记录系统、Agent Hub 和微信连接器日志。日志支持筛选、复制和清空，并会隐藏 Token 和二维码数据，不记录微信密码。
|
||
|
||
## 需要满足的条件
|
||
|
||
- TraceMemo 的微信数据库已经连接，并且数据 API 可以查询；
|
||
- 依赖总结或自然语言理解的任务，需要在“设置 → AI 模型”配置可用的 AI 服务；
|
||
- TraceMemo 和 Agent Hub 需要保持运行，机器人才能接收和回复消息。
|
||
|
||
## 安全与边界
|
||
|
||
- Hub 使用本机通信，不把数据库直接暴露到公网；
|
||
- 机器人账号和个人微信账号是不同的登录边界，请确认你连接的是正确账号；
|
||
- 机器人回复会发送给当前发消息的人；开发者 API 另有受保护的测试发送入口，使用前必须确认接收者；
|
||
- Hub 生成群聊总结时仍可能调用你配置的 AI Provider；
|
||
- 当前实时自然语言入口主要处理文字消息。底层连接器可以接收图片、语音、文件和视频，但 Agent Hub 尚未为这些媒体提供同等的实时意图处理；
|
||
- 当前没有实现群发、广播、定时任务或通用自主操作微信；
|
||
- 本页面的“Agent Hub 状态”可以通过 Local HTTP API 查询，但不要把它误认为外部 Agent 的实时消息订阅接口或 MCP Server。
|
||
|
||
## 无法连接时
|
||
|
||
先检查 Hub、连接器和数据库三项状态，再查看日志。二维码过期、连接器不存在、凭证失效和数据 API 未就绪分别需要重新扫码、修复安装、重新登录或先完成微信数据库连接。
|