用户指南 · 07

Service 渠道:让 Consumer 通过微信扫码使用

这是与 §6.8 管理员自接入 完全独立的另一套 WeChat 栈,专为 Consumer 服务。

7.1 启用流程

  1. 设置 → Service 管理 选中(或创建)一个 Service
  2. 切换到 WeChat Channel 标签页
  3. 配置:
    • 启用 Switch
    • 过期时间(QR 链接有效期)
    • 最大会话数(同时连接的微信用户上限)
  4. 点击 复制 QR 链接 或直接打开 /wc/{service_id} 中间页

7.2 Consumer 扫码流程

  1. Consumer 用微信扫描你分享的 /wc/{service_id} 中间页 QR
  2. 中间页提示用户在微信中关注 iLink Bot 并发送任意消息
  3. 后端 session_manager 等待用户首次消息(捕获 from_user_id
  4. 一旦捕获,为该用户创建独立的 conversation_id
  5. 后续消息通过 Consumer Agent 处理 + 通过 iLink 回复

7.3 Consumer 体验

  • 收到的所有消息都通过 Service 配置的 Consumer Agent 处理
  • Agent 仅有 Service capabilities + allowed_docs/scripts 的权限
  • 多模态:支持收/发图片、语音
  • 友好工具状态:Agent 调用工具时显示「思考中…」或白名单友好文案,不暴露真实工具名

7.4 会话管理

在 Service 管理 → WeChat Channel Tab 可以:

  • 查看活跃会话:每个微信用户的最近活动时间、消息数
  • 断开会话:主动断开某个用户
  • 查看对话:进入某个微信用户的对话历史

7.5 频率限制

  • 单用户:10 条消息 / 60 秒
  • QR 生成:5 次 / 60 秒
  • 全局:Service 配置的 max_sessions 上限

7.6 注意事项

  • iLink Bot(国内)网络要求直连,不走代理
  • 多 Admin 隔离:每个 Service 的 sessions 不会跨 Admin 越权
  • 消息会话长期保留(有 from_user_id 的会话不参与 24h 无活动清理)