4.7 KiB
在微信里向 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 个会话”；
- “帮我看看最近跟某人聊了些什么。”
- “生成产品交流群今天的群聊总结图片。”
Hub 把入站文字分成两类处理。
确定性的快捷动作（不经过模型，命中就执行）：
- 查看最近会话：数量限制为 1–20；
- 生成群聊总结图片：今天、昨天或近 7 天（需要同时提到“群”和“图片 / 长图 / 日报 / 报告”）；
- 分析某个群成员的近期发言：可以指定“今天 / 昨天 / 最近 N 天”。
其余问题交给本机的 Query Agent：它和桌面端“问问微信”使用的是同一个实现，可以按需读取联系人、会话和时间范围来回答，必要时调用你在“设置 → AI 模型”里配置的 AI。例如“帮我看看最近跟某人聊了些什么”“上个月讨论过的项目地址在哪里”。
任务完成后，回复会发送回触发这次请求的微信用户。群聊总结会先发送进度提示，完成后发送图片。
这些任务会在后台查询联系人、群聊和聊天记录，但当前机器人没有单独的“列出所有联系人”或“列出所有群聊”命令；需要完整浏览或按条件查询时，请使用档案页面或 Reader Skill / Local HTTP API。
连接步骤
- 打开应用主导航中的“Agent”；页面标题为“Agent Hub”。
- 确认 Hub 显示“运行中”，数据库状态为“可查询”。
- 点击“扫码登录微信机器人”。
- 用微信扫描二维码；如果页面显示“已扫码，等待手机确认”，在手机上确认。
- 状态变为“在线”后，用另一个微信账号向机器人发送测试问题。
可以重新扫码登录或断开连接。登录凭证失效时，需要重新扫码。
运行日志
Agent Hub 页面会记录系统、Agent Hub 和微信连接器日志。日志支持筛选、复制和清空，并会隐藏 Token 和二维码数据，不记录微信密码。
需要满足的条件
- TraceMemo 的微信数据库已经连接，并且数据 API 可以查询；
- 依赖总结或自然语言理解的任务，需要在“设置 → AI 模型”配置可用的 AI 服务；
- TraceMemo 和 Agent Hub 需要保持运行，机器人才能接收和回复消息。
安全与边界
- Hub 在主进程内运行，不开放本地监听端口；它不会把数据库暴露到公网；
- 机器人账号和个人微信账号是不同的登录边界，请确认你连接的是正确账号；
- 机器人回复会发送给当前发消息的人；开发者 API 另有受保护的测试发送入口，使用前必须确认接收者；
- Hub 理解请求或生成总结时，会调用你在“设置 → AI 模型”配置的 Provider；
- 当前实时入口只处理文字消息。连接器会归一化收到的消息条目，但 Agent Hub 只把文本条目当作意图处理，尚未为图片、语音、文件和视频提供同等能力；
- 当前没有实现群发、广播、定时任务或通用自主操作微信（定时日报属于「自动化」，不是 Agent Hub）；
- 本页面的“Agent Hub 状态”可以通过 Local HTTP API 查询，但不要把它误认为外部 Agent 的实时消息订阅接口或 MCP Server。
无法连接时
先检查 Hub、连接器和数据库三项状态，再查看日志。二维码过期、连接器不存在、凭证失效和数据 API 未就绪分别需要重新扫码、修复安装、重新登录或先完成微信数据库连接。