连接微信：扫码、权限与私聊验证
扫码绑定个人微信，配置项目与允许名单，验证私聊回复并处理连接恢复。
渠道微信渠道适合什么#
通过个人微信扫码连接 Onevium，在私聊中向项目助手发任务并接收结果。当前使用 iLink 接入，支持单个机器人和私聊；微信群不在支持范围内。
开始前准备#
准备可扫码的微信账号、演示项目，以及已经能在 Onevium 正常对话的模型。电脑和 Onevium 需保持运行并能联网。
登录凭据由扫码过程取得，不需要手填微信 App ID 或 API Key。扫码确认只完成登录，后面还要保存机器人配置。验证码只填登录表单的专用字段，不发进普通聊天。
扫码并创建第一个连接#
- 从侧栏打开「渠道」，点「新建渠道」，创建类型选机器人，平台选微信。
- 点「生成二维码」，用需要绑定的微信账号扫码，并在手机确认。若提示验证码，将微信显示的数字填入「微信验证码」后点验证。
- 看到「微信已连接」后点「继续配置」。二维码或登录票据过期时重新生成，再完成后续保存。
- 在配置表单填写下列内容，点「创建机器人」。创建后应用会尝试启动连接；查看最终状态，不能只看扫码成功。
| 字段 | 第一次建议 |
|---|---|
| 机器人名称 | 例如“微信项目助手”，便于在 Onevium 中识别 |
| 模型 | 选择已经验证可用的提供商与模型 |
| 工作目录 | 选无敏感资料的演示项目 |
| 会话模式 | 保留“每人独立会话” |
| 自动批准操作 | 先保留默认询问档；具体调用仍受工具规则约束 |
| 聊天范围 | 微信固定为“仅私聊”，不能切换到群聊 |
| 私聊策略 | 保留“仅允许名单用户”；扫码账号会自动加入 |
| 系统提示 | 写清职责，例如“回答项目文档问题，不修改文件” |
同一连接凭据已被另一机器人使用时，先打开提示中的现有连接，不要重复绑定。重新连接现有机器人也不能换成另一个微信账号；需要另一账号时新建机器人。
谁能发消息，如何批准操作#
默认允许名单已包含扫码账号。添加其他允许用户时填写平台用户 ID，一行一个，不是昵称；不要为了排错直接开放给所有人。
微信的工具审批使用文字提示。核对工具、输入与目标后，在提示所在的私聊回复 允许／拒绝，英文 allow／deny 也可识别。它不是钉钉那样的卡片按钮；没有待审批请求时，不能把这几个词当作全局授权。
自动批准操作、私聊准入和会话模式是不同设置。共享会话选项也不会让微信支持群聊。
验证两轮私聊#
在微信端打开扫码关联的私聊，先发送：
本次测试代号是 wechat-demo-1。
只回复这个代号，不执行其他操作。
收到回复后追问“刚才的测试代号是什么？”确认：
- Onevium 对应微信连接出现这段私聊与消息。
- 两轮回复回到正确的微信账号，第二轮能使用本次上下文。
- 如果触发工具审批，处理后任务确实继续；文字出现不等于文件操作已经成功。
当前接入不提供联系人昵称。需要易读名称时，在该连接的聊天设置中选中私聊，填写「本地名称」并保存；它只改变 Onevium 显示，不修改微信昵称。
消息与恢复的边界#
| 内容或情况 | 当前处理 |
|---|---|
| 文字、图片、文件 | 可以收发；附件先用小文件测试，单个上限为 20 MiB |
| 带转写文字的语音 | 使用平台提供的文字；不是在此自动识别所有语音 |
| 无转写语音、视频 | 当前不支持；改发文字、图片或文件 |
| 长回复 | 可能拆成多条文字；不提供飞书／钉钉式流式卡片 |
| 主动发送 | 需要该私聊已建立的回复上下文；提示要求时先从微信发送新消息 |
| 普通网络中断 | 自动重试，并保存已收到消息与游标用于恢复 |
| 登录失效或本地保存失败 | 需要处理错误；不能把重新扫码当作修复所有故障 |
恢复后先看已有消息和执行状态，不要连发同一任务来“催回复”。停止连接或关闭电脑期间不能承诺持续接收、执行；本地恢复记录也不等于跨系统绝不重复。
常见问题#
| 现象 | 先检查 |
|---|---|
| 没有微信平台 | 核对顶部适用版本，创建类型选择机器人 |
| 扫码后仍等待 | 手机是否已确认；是否需要验证码；二维码是否过期 |
| 提示账号不匹配／凭据已占用 | 是否扫了另一个账号，或已有对应机器人 |
| 已连接却不回复 | 是否保存并运行、是否为私聊、发送账号是否在允许名单、模型是否可用 |
| 一直提示重连 | 网络与登录状态；要求重新登录时用“重新连接微信”扫码并保存 |
| 提示先发新消息 | 从同一微信私聊发一条新消息，建立有效回复上下文 |
| 保存或恢复消息失败 | 检查本地存储并保留错误记录，不先删除机器人或数据库 |