扫个码就把 WorkBuddy 装进微信：助理接入全流程
本篇涵盖的知识重点
- 微信助理用于通过手机微信远程控制电脑上的 WorkBuddy
- 前置条件：WorkBuddy >= 4.6.4、微信 >= 8.0.70、两者使用同一账号或已关联
- 接入无需填写 App ID、App Secret 等开发凭证，扫码即可完成
- 可在微信中发起任务、回答追问、批准命令执行与文件修改
- 所有项目、文件、凭证和工具均使用电脑本地环境，无需额外配置
- 当前为一对一绑定，换微信号需先解绑再重新扫码
绑定流程导览
绑定步骤详解
作用版本或账号不一致是绑定失败最常见的原因，先核对能省掉大量排查时间。
操作确认电脑上安装了 macOS 或 Windows 版 WorkBuddy 且版本 >= 4.6.4；手机上登录的微信版本 >= 8.0.70；WorkBuddy 与微信使用同一账号登录（或已关联）；电脑和手机均能正常访问互联网；且 WorkBuddy 保持运行状态。
注意微信助理接入无需填写 App ID、App Secret 等开发凭证，如果遇到要求填这些的界面，先确认走的是不是这条通道。
- WorkBuddy 版本：macOS / Windows 上安装 WorkBuddy >= 4.6.4，版本不达标先升级再绑。
- 微信版本：手机上已登录微信 >= 8.0.70，旧版本可能扫不出来或绑不上。
- 账号一致性：WorkBuddy 和微信需使用同一账号登录（或已关联），这是最容易漏掉的一项。
- 网络连接：电脑和手机都要能正常访问互联网，任一侧断网都会卡在绑定环节。
- WorkBuddy 运行中：绑定与后续远程执行都要求它保持运行状态。
作用微信助理集成的入口在助理设置里，找对位置才能开始绑定。
操作打开 WorkBuddy，在左侧「助理」栏点击齿轮图标进入「助理设置」，在集成列表中找到「微信助理集成」，点击右侧的「配置」按钮。
注意不同版本的入口位置可能略有差异，以页面实际展示为准。
- 启动新的任务，或继续助理板块中未完成的会话：外出时也能接着上次的活往下干。
- 发送后续指令、回答 WorkBuddy 的追问、指导进行中的工作：不需要守在电脑前答复。
- 批准命令执行、文件修改等需要确认的操作：手机上点一下即可放行。
- 查看任务输出、差异对比：改了哪些文件、结果如何，直接在聊天窗口里看。
- 收到通知：WorkBuddy 完成任务或需要你关注时，会在微信中推送提醒。
作用二维码是这次绑定的凭据，扫了码才算把手机微信和电脑上的 WorkBuddy 连起来。
操作点击「配置」后按钮会短暂显示为「绑定中...」，此时 WorkBuddy 正在生成二维码。二维码生成后会直接显示在卡片下方，打开手机微信扫描即可完成绑定。
注意二维码有时效限制。如果过期或扫码失败，重新点击「配置」生成新的二维码；若页面一直停在「绑定中...」，先确认 WorkBuddy 正在运行且网络正常，必要时重启后重绑。
作用状态是判断是否真正连上的唯一依据，只看扫码成功的提示并不够。
操作扫码完成后回到卡片，确认状态已变为「已绑定」。如果需要更换账号，点击「解绑」后重新绑定即可。
注意WorkBuddy 当前为一对一绑定，多个微信账号不能同时绑同一台电脑；换号必须先解绑。
作用远程访问的前提是电脑上的 WorkBuddy 活着，选错部署方式会导致任务频繁中断。
操作日常使用就把你常用的 Mac 或 Windows 电脑连上；如果有定时巡检、持续集成监控这类长期任务，改用一台专用电脑，装好依赖、凭证、插件和工具并保持 WorkBuddy 常开。
注意电脑休眠、断网或关闭 WorkBuddy 都会让远程访问暂时中断，不是掉线故障而是预期行为。
- 日常办公电脑：连接你日常使用 WorkBuddy 的 Mac 或 Windows，离开工位也能远程访问相同的项目、文件和工作线程。
- 专属常开主机：长期运行的任务（定时巡检、持续集成监控等）建议用专用电脑，即使你的主电脑离线仍可访问。
- Mac 笔记本建议：保持打开并接通电源；如果合盖使用，建议外接显示器使电脑不休眠。
- 锁屏远程：可在 WorkBuddy 设置中开启，防止长时间任务被中断。
作用只有真正跑通一次收发，才能确认凭证、网络、助理服务都正常。
操作在微信里直接发一条自然语言任务，例如「帮我总结今天桌面上最新的会议记录」。也可以发送图片、文件或语音（语音需微信的语音转文字功能）。WorkBuddy 会在电脑上执行并把结果同步回聊天窗口。
注意若发消息没有响应，先确认电脑上的 WorkBuddy 仍在运行、助理服务未关闭，再回「助理设置」检查集成状态是否仍为「已绑定」。
- 文字消息：发送自然语言任务指令，是最常用的方式。
- 图片消息：发送截图或文档照片，WorkBuddy 可识别图中内容。
- 文件消息：转发文件，WorkBuddy 可读取并分析。
- 语音消息：发送语音指令，需依赖微信的语音转文字功能。
作用手机上适合派活和看结果，需要深挖过程时回电脑端效率更高。
操作在微信中发起的任务，回到电脑上的 WorkBuddy 即可查看完整执行过程和结果；WorkBuddy 会在助理中显示微信中发起的会话，无需手动查找。你可以继续追问、细化任务，或在微信中随时查看进度。
注意微信消息到达时，WorkBuddy 会自动切换到助理标签页并加载对应会话，不要误以为界面被抢占而手动切走。
- 手机微信：仅发送指令、批准操作和后续消息，本身不参与计算。
- 您的电脑：提供 WorkBuddy 执行任务所需的全部环境。
- 项目与文件：所有仓库代码、本地文档均来自你的电脑。
- Shell 命令：终端命令在你的电脑上执行，使用本地的环境和依赖。
- 凭证与权限：已登录的网站、Git 仓库、云服务等均使用电脑上的凭证。
- 插件与工具：已安装的插件、MCP 服务器、浏览器扩展、Computer Use 能力均可远程使用。
- 安全策略：沙箱设置、操作审批规则仍然适用于远程发起的会话。
常见故障排查
- 整个流程无需填写 App ID、App Secret 等开发凭证，只需扫码即可完成绑定。
- 二维码有时效限制：过期或扫码失败时，重新点击「配置」生成新的二维码。
- 页面一直停留在「绑定中...」：确认 WorkBuddy 正在运行且网络正常；关闭配置窗口重新进入「微信助理集成」；仍不行则重启 WorkBuddy 后重新绑定。
- 扫码后没有显示「已绑定」：确认扫码用的是你想绑定的微信账号；等待几秒让状态同步；二维码失效则点击「重试」生成新码。
- 微信里发消息没有响应：确认电脑上的 WorkBuddy 仍在运行、助理服务未关闭；回「助理设置」检查状态是否仍为「已绑定」；必要时解绑后重新扫码。
- 微信助理和微信客服号功能相同，都是扫码即可的绑定通道，根据需要选一种使用即可。
要点练习
```markdown
我准备把 WorkBuddy 接入微信助理，请帮我生成一份接入前的检查清单。要求按表格输出，列包含：检查项（WorkBuddy 版本、微信版本、账号一致性、网络连接、WorkBuddy 运行状态）、具体要求、如何自查、不通过时的处理方式。每项要求写具体的版本号或状态描述。
```得到一份含具体版本号与自查方法的检查表，能逐项打勾确认接入条件是否满足。
```markdown
我在绑定微信助理时，页面一直停留在「绑定中...」。请给我一份按顺序执行的排查步骤清单：每一步写清楚要做什么、在哪儿看结果、如果这一步没解决该走下一步什么动作。至少 3 步，最后告诉我什么情况下应该放弃自查。
```得到一份可逐条执行的排查流程，含每一步的操作位置、判断依据与兜底动作。
```markdown
我准备在微信里给 WorkBuddy 派一个任务：整理 D:/工作/本周资料 文件夹里的文件，按类型归类。请帮我改写这条指令，要求：1）明确输入输出路径；2）要求执行前先列出待移动清单供我确认；3）要求完成后返回一份变动汇总，包含移动了哪些文件、跳过哪些文件及原因。只输出改写后的完整指令。
```得到一条可直接发到微信的指令，含确认环节与结构化回执要求，能在手机端判断任务是否成功。
本文基于官方文档再创作，具体以官方文档站实际展示为准。