用户指南 · 07
Service 渠道:让 Consumer 通过微信扫码使用
这是与 §6.8 管理员自接入 完全独立的另一套 WeChat 栈,专为 Consumer 服务。
7.1 启用流程
- 在 设置 → Service 管理 选中(或创建)一个 Service
- 切换到 WeChat Channel 标签页
- 配置:
- 启用 Switch
- 过期时间(QR 链接有效期)
- 最大会话数(同时连接的微信用户上限)
- 点击 复制 QR 链接 或直接打开
/wc/{service_id}中间页
7.2 Consumer 扫码流程
- Consumer 用微信扫描你分享的
/wc/{service_id}中间页 QR - 中间页提示用户在微信中关注 iLink Bot 并发送任意消息
- 后端
session_manager等待用户首次消息(捕获from_user_id) - 一旦捕获,为该用户创建独立的 conversation_id
- 后续消息通过 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 无活动清理)