docs: 更新文档

docs/agent/agent-hub.md

@@ -0,0 +1,67 @@
+# Agent Hub：让微信机器人参与实时工作
+
+Agent Hub 是 WechatExplorer 内置的实时微信交互入口。你先在应用中扫码登录一个微信机器人账号，之后向这个机器人发送文字；本机 Agent Hub 会接收消息、读取已经连接的微信数据，必要时调用已配置的 AI，再把结果回复给发消息的人。
+
+它和 Reader Skill 是两条不同的路径：
+
+- Reader Skill / Local HTTP API：外部 Agent 主动查询历史微信数据；
+- Agent Hub / 微信机器人：机器人收到实时消息后处理并回复。
+
+## 连接器和 Agent Hub 是什么关系
+
+你不需要单独部署这些组件。扫码后，后台的微信连接器负责登录机器人、保持连接、接收微信消息和发送回复；Agent Hub 负责判断消息要做什么、查询 WechatExplorer 本地数据、调用 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 和二维码数据，不记录微信密码。
+
+## 需要满足的条件
+
+- WechatExplorer 的微信数据库已经连接，并且数据 API 可以查询；
+- 依赖总结或自然语言理解的任务，需要在“设置 → AI 模型”配置可用的 AI 服务；
+- WechatExplorer 和 Agent Hub 需要保持运行，机器人才能接收和回复消息。
+
+## 安全与边界
+
+- Hub 使用本机通信，不把数据库直接暴露到公网；
+- 机器人账号和个人微信账号是不同的登录边界，请确认你连接的是正确账号；
+- 机器人回复会发送给当前发消息的人；开发者 API 另有受保护的测试发送入口，使用前必须确认接收者；
+- Hub 生成群聊总结时仍可能调用你配置的 AI Provider；
+- 当前实时自然语言入口主要处理文字消息。底层连接器可以接收图片、语音、文件和视频，但 Agent Hub 尚未为这些媒体提供同等的实时意图处理；
+- 当前没有实现群发、广播、定时任务或通用自主操作微信；
+- 本页面的“Agent Hub 状态”可以通过 Local HTTP API 查询，但不要把它误认为外部 Agent 的实时消息订阅接口或 MCP Server。
+
+## 无法连接时
+
+先检查 Hub、连接器和数据库三项状态，再查看日志。二维码过期、连接器不存在、凭证失效和数据 API 未就绪分别需要重新扫码、修复安装、重新登录或先完成微信数据库连接。