第 9 章　接入小程序与 IM 助理

出差时想查看电脑上的任务，或在手机上继续交代工作，首先要确认任务运行在哪里。手机只是入口：本机模式依赖已连接电脑，云端模式在云端环境执行，两者能够访问的文件和技能可能不同。

本章介绍连接方式与只读测试。远程取文件和客户沟通的完整案例见第18章。

先分清本机与云端

从官方入口进入WorkBuddy小程序并登录，查看当前模式与已连接设备。本机模式适合处理电脑上的授权目录、当地安装的Skill和已有工作区，需要目标电脑在线并保持连接。云端模式适合独立的调研、写作或临时分析，不依赖该电脑持续在线，但也不能凭一句路径就取得电脑文件。

图9-1 小程序模式画面。使用前核对模式、账号及设备，不据入口名称推定文件范围。

如果找不到本机文件，先检查模式和目标电脑，再看目录授权。不要把某个案件资料夹整批上传云端来“试试是否能看见”。首先使用一份无敏感信息的测试文本，验证读取、执行、返回结果各环节。

绑定微信助理

入口为WorkBuddy左侧“助理”栏的齿轮，进入助理设置，找到微信助理集成并点击配置。按页面生成二维码后，用准备绑定的微信扫码。卡片显示已绑定，再发送只读任务。

二维码有时效。停在绑定中、扫码过期或绑定失败时，关闭配置窗口重新进入，重新生成后再试。切换账号前先解绑原账号，避免手机消息进入错误工作身份。二维码和账号绑定信息不应作为普通截图发到公开群里。

这是手机助理的只读连通测试。
请告诉我当前任务运行在本机还是云端，以及当前可确认的工作目录。
若为本机，只读取我指定练习目录中的“远程测试.txt”，返回其中三条测试内容。
不要读取其他目录，不上传整个文件夹，不修改文件，不安装工具，不发送消息给他人。
无法确认设备或模式时先停止，并说明需要检查的连接项。

任务返回后，在电脑端核对是否确实出现相应记录，文件内容是否一致。手机收到一句“完成”，并不证明任务在预期电脑上执行；要把设备、路径、文件和产物对应起来。

在飞书中发任务

从WorkBuddy设置进入助理设置，选择飞书，按当前指引创建企业自建应用、启用机器人能力、配置必要权限。取得App ID和App Secret后，填写到WorkBuddy指定配置入口，不把Secret写进普通对话、截图或教程正文。

接着按页面要求配置事件订阅、回调或当前支持的消息连接方式，添加必要事件，再创建版本并发布到允许范围。最后在飞书向机器人发送只读测试。教程中的“创建应用”与“在对话中读取飞书文档”用途不同，后者仍须按第8章接入连接器。

测试失败时按链路检查：消息有没有到机器人，应用是否发布给测试用户，事件是否生效，WorkBuddy有没有收到任务，任务是否能访问指定目录。先找断点，不要一次勾选所有权限。错误日志中可能含凭据或资源标识，反馈前先处理不应公开的内容。

钉钉等其他IM入口

接入流程包括在钉钉开发者后台创建应用、添加机器人能力、填写名称与说明并发布的基本步骤。完整事件、认证和接入方式以WorkBuddy当前页面与平台要求为准。优先在测试组织或测试群验证，确认消息可达、任务范围正确后再扩大使用。

不论入口是微信、飞书还是钉钉，都应为远程任务设置容易识别的名称和独立材料范围。手机上输入短，不等于授权应该含糊。特别是删除、覆盖和外发，应写明对象与范围，不能把“把文件处理一下”当成完整指令。

结束远程访问前的核对

换设备、离职交接或不再使用某个IM账号时，检查绑定、应用授权和工作目录权限，按需要解绑或撤销。撤销入口与删除任务成果是不同动作，先确认要停止哪一条链路。不要为了解绑而清空案件目录。

验收至少包含：身份匹配、设备匹配、模式明确、只读测试正确、产物能在预期位置找到。完成这几项后，再尝试复杂远程处理；遇到网络中断，回到电脑端检查实际执行状态，避免重复提交导致生成多份或重复写入。