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

小程序的两种模式

首次使用：通过官方入口打开 WorkBuddy 小程序并登录 → 查看当前处于本机还是云端模式 → 本机模式下确认目标电脑在线且连接正确。

IM 助理的工作链路

在手机 IM 里发任务后，消息的流转过程是：

1. 手机 IM 发送任务给应用机器人
2. 机器人通过回调或长连接把消息传给 WorkBuddy 助理
3. 助理在授权目录内执行任务
4. 工作区返回产物与状态
5. 助理把结果交给机器人
6. 手机端查看结果并确认

接入微信助理：扫码绑定即可

1. 进入助理设置打开 WorkBuddy，在左侧“助理”栏点击齿轮，进入“助理设置”。
2. 选择微信助理集成找到“微信助理集成”，点击“配置”。
3. 扫码绑定等待绑定二维码生成，用手机微信扫码。
4. 只读测试卡片显示“已绑定”后，先发送一条只读测试指令（例如列出某个目录的文件名）。
5. 换号要解绑需要切换微信账号时，先解绑当前账号，再重新扫码。

接入飞书助理

本节介绍在飞书聊天窗口中向 WorkBuddy 助理发送任务的方法。在 WorkBuddy 中读取飞书群聊、文档和日程的连接器用法，见第 8 章。

1. 打开助理设置并选择飞书WorkBuddy → 设置 → 助理设置 → 选择飞书。
2. 创建企业自建应用在飞书开放平台创建企业自建应用。
3. 添加机器人能力为应用添加机器人能力。
4. 开通最小权限按 WorkBuddy 当前页面要求开通最小权限（支持批量导入权限）。
5. 获取凭证在“凭证与基础信息”获取 App ID 和 App Secret。
6. 回填凭证将凭证填写到 WorkBuddy，生成或复制回调信息。
7. 配置事件订阅在飞书配置事件订阅与回调。
8. 添加事件添加接收消息、卡片交互等当前指南要求的事件。
9. 发布应用创建版本并发布应用。
10. 只读测试在飞书内向机器人发送只读测试任务。（来源：WorkBuddy 官方指南）

接入钉钉助理

1. 创建应用与机器人使用企业管理员账号登录钉钉开发者后台，进入“应用开发”，创建应用。
2. 添加机器人能力为应用添加机器人能力，填写机器人名称、描述和头像并确认发布。
3. 获取凭证在应用详情中获取应用凭证并填入 WorkBuddy。
4. 先在测试环境验证优先在测试组织或测试群完成验证。（来源：WorkBuddy 官方指南）