第 8 章 随身助理：小程序与微信、飞书、钉钉
伙伴的意义在于随叫随到。buddyme 不只住在你电脑里：通过小程序，它能随身携带；通过微信、飞书、钉钉里的 IM 助理，它就住在你最常聊天的窗口里——一句话发过去，任务在后台跑起来，成果回到指尖。这一章讲清楚两种小程序模式如何取舍、消息链路的来龙去脉，以及三大 IM 平台的接入方法。
小程序的两种模式：身边带一位助理
buddyme 不只住在你电脑里。通过 buddyme 小程序，你可以把它带在身上——通勤路上想到一件事，掏出手机说一句，任务就开始跑了。而小程序里藏着两种工作模式，选对模式，体验会顺畅很多。
两种模式一览
| 模式 | 任务在哪里运行 | 是否依赖电脑在线 | 适合任务 |
|---|---|---|---|
| 本机模式 | 已连接的电脑 | 是 | 本地文件、本地 Skill、已有工作区 |
| 云端模式 | 隔离的云端环境 | 否 | 调研、写作、临时分析、并行任务 |
本机模式：任务实际在你的电脑上执行。手机上发出指令，指令传回本机的 buddyme，由它读取你授权的本地文件、调用本地 Skill、在熟悉的工作区里干活，产物也直接落在你电脑的目录里。它适合一切"离不开我电脑里那些东西"的任务：整理桌面发票、查找某个文件夹里的合同、在已有工作区里继续上次的活。代价是电脑必须开机在线——它本质上是"遥控你的电脑"。
云端模式：任务在隔离的云端环境里执行，不碰你的电脑。它适合从零开始的产出型任务：做一份行业调研、写一篇稿子、做一次临时分析，或者你不在电脑旁、却想并行推进一件事。云端模式不依赖电脑在线，随时随地都能发起。
首次使用
- 通过官方入口打开 buddyme 小程序并登录；
- 查看当前处于本机还是云端模式（界面上会明确标识当前连接的设备/环境）；
- 本机模式下，确认目标电脑在线且连接正确（首次连接需要在电脑端确认授权）。
怎么选
一个简单的判断口诀：要用我电脑里的东西，选本机；从零开始做一件事，选云端。如果任务需要读取本地文件、使用本地已装好的 Skill 或在既有工作区继续作业，本机模式是唯一选择；如果只是"帮我查、帮我写、帮我分析"，云端模式更自由——电脑关着也没关系。
IM 助理的工作链路：从一句话到一份产物
除了 buddyme 小程序，你还可以把助理直接"安顿"在微信、飞书、钉钉这些每天都要开的 IM 里。不需要新装一个 App，在熟悉的聊天窗口里发一句话，任务就跑起来了。要理解它有多可靠，值得看一眼消息走过的完整路径。
手机 IM → 应用机器人 ：发送任务 应用机器人 → buddyme 助理 ：回调或长连接传递消息 buddyme 助理 → 本机工作区 ：在授权目录执行 本机工作区 ⇢ buddyme 助理 ：产物与状态 buddyme 助理 ⇢ 应用机器人 ：返回结果 应用机器人 ⇢ 手机 IM ：手机查看与确认
一步步拆开看
1. 你在 IM 里发送任务。就像给同事发消息一样："帮我把上周的会议录音整理成纪要"。无需任何命令语法，自然语言即可。
2. 消息经应用机器人传递给本机 buddyme。IM 侧的机器人收到消息后，通过回调或长连接把它安全地送到你电脑上的 buddyme 助理。这条链路在你的 IM 账号与你的 buddyme 之间建立绑定——绑定的方式下一节详述，绑定完成后，只有你的账号能指挥你的 buddyme。
3. buddyme 在授权目录里执行任务。本机 buddyme 收到任务后，按惯常的方式工作：理解需求、规划步骤、读取授权范围内的文件、调用模型和 Skill。它能碰到哪些目录、哪些文件，都由你此前授予的权限决定——边界清晰，不会越界。
4. 产物与状态回传，你在手机上查看与确认。任务完成后，结果沿原路返回：产物（文档、表格、图片）会在 IM 对话里以卡片或文件形式出现，你可以在手机上直接预览、下载，或回复一句继续调整。长任务运行期间，你还可以随时询问进度，就像问同事"那边做得怎么样了"。
这条链路的安全边界
- 账号绑定：只有完成绑定的 IM 账号能给你的 buddyme 发任务，陌生人的消息进不来；
- 目录授权：buddyme 只能在你授权的目录范围内读写，IM 消息不会成为绕过权限的"后门"；
- 敏感操作拦截：高危指令（如删除、外发）依旧会被安全机制拦截，需要你在本机或手机上确认。
理解了这条链路，IM 助理就不再神秘：它不是把你的资料上传到某个云端的黑盒，而是一条把你的手机和你的电脑连起来的安全通道——消息进来，成果出去，边界始终在你手里。
要求：手机微信与 buddyme 助理的一段真实对话截图，可见任务指令与返回的结果卡片，无需标注
接入微信助理：扫码绑定即可
三种 IM 里，微信的接入最轻：一个二维码，扫完即用。整个过程不超过两分钟，不需要管理员权限，也不需要注册任何新账号。
绑定步骤
- 打开 buddyme，在左侧"助理"栏轻点齿轮，进入"助理设置"；
- 找到"微信助理集成"，轻点"配置"；
- 等待绑定二维码生成，用手机微信扫码；
- 卡片显示"已绑定"后，先发送一条只读测试指令；
- 需要切换微信账号时，先解绑当前账号，再重新扫码。
绑定后试一试
绑定的第一次对话，建议用一条只读指令热身，比如"帮我看看今天桌面上有哪些新文件"。确认消息有来有回、结果符合预期，再托付真正的任务。此后，你在微信里给助理发消息，就像给一位随叫随到的同事发消息：整理文件、查资料、跑调研，它在本机执行，把成果发回聊天窗口。
遇到小状况怎么办
二维码有时效限制。如果页面停留在"绑定中"、二维码过期或扫码失败，不必着急：关闭配置窗口后重新进入，必要时重启 buddyme 再生成一个二维码，重新扫一次即可。这类问题几乎都出在二维码过期，重新生成就能解决。
接入飞书
如果你的团队用飞书办公，把 buddyme 接入飞书后，助理就住进了你的飞书对话里。飞书的接入走"企业自建应用"路线：需要在飞书开放平台创建一个应用并发布，步骤比微信多一些，但一次配置，全流程受益。整个过程只需要跟着两边页面的引导照做即可。
配置步骤
- 在 buddyme 左侧"助理"栏轻点齿轮，进入"助理设置"，选择飞书；
- 在飞书开放平台创建企业自建应用；
- 为应用添加机器人能力；
- 按 buddyme 当前页面要求开通最小权限；
- 在"凭证与基础信息"获取 App ID 和 App Secret；
- 将凭证填写到 buddyme，生成或复制回调信息；
- 在飞书配置事件订阅与回调；
- 添加接收消息、卡片交互等当前指南要求的事件；
- 创建版本并发布应用；
- 在飞书内向机器人发送只读测试任务。
三个关键点
- 权限从简：第 4 步开通权限时，按 buddyme 页面列出的最小范围勾选即可，用不到的权限不开。后续不够可以随时补开，多开的权限收回来则麻烦得多；
- 凭证保管：App ID 和 App Secret 是应用的钥匙，Secret 只在飞书后台和 buddyme 配置页之间流转，不要发到任何群聊里；
- 回调配置要对齐：第 6 步在 buddyme 生成的回调信息，要与第 7、8 步在飞书侧的订阅配置完全一致，对不上消息就进不来——这是飞书接入中最常见的小状况，遇到消息无响应时，优先检查这里。
发布完成后，你（以及应用可用范围内的同事）就可以在飞书里直接和机器人对话了。第一次同样建议发一条只读测试任务，确认消息链路通畅，再托付正式工作。
接入钉钉
钉钉的接入思路与飞书一致：在钉钉开发者后台创建一个带机器人能力的应用，拿到凭证后与 buddyme 完成对接。如果你已经读过上一节飞书的配置，这一节会非常眼熟——平台的名称不同，流程的骨架相同。
配置步骤
- 创建应用与机器人：使用企业管理员账号登录钉钉开发者后台；
- 进入"应用开发"，创建应用；
- 为应用添加机器人能力，填写机器人名称、描述和头像并确认发布；
- 优先在测试组织或测试群完成验证。
几个值得留意的点
- 管理员账号：与飞书不同，钉钉创建应用的入口需要企业管理员账号。如果你不是管理员，先向 IT 或企业管理员申请，或请管理员协助完成创建；
- 先测试后铺开：第 4 步的建议非常重要——优先在测试组织或测试群里完成验证，确认消息收发、任务执行、结果回传都正常，再发布到正式组织。万一配置有出入，影响范围也只是测试群里的你自己；
- 凭证同样要保管好：应用凭证（AppKey/AppSecret 等）的作用与飞书的 App ID/Secret 一致，只在钉钉后台与 buddyme 配置页之间流转，不要外发。
验证通过之后
测试群里一切正常后，就可以把应用发布到正式环境。此后在钉钉里找到你的机器人，像给同事发消息一样派任务：整理文件、生成周报、跑一份调研，buddyme 在本机执行，把成果直接回传到钉钉对话里。