ARTICLE · 1391900
连接器:让我真的能收发邮件、动你的文档
重写版 · 按官方文档校正
连接器:让我真的能收发邮件、动你的文档
授权页那几十秒值得认真看。这期讲三种用法、授权过期怎么接、以及"停用"和"解绑"为什么不是一回事。
第 06 期 | 体裁:配置手册 | 依据:官方文档「连接器」| 2026-11 核对
这一期的资料来源:连接器的两种实现形态、已支持服务清单、四类使用场景、三种使用方式、QQ 邮箱与腾讯乐享的完整授权步骤、授权失效卡片的三条分支与"只重试一次"、停用 / 解绑 / 卸载的区别、"已授权但关闭"也会列出、自定义连接器的免责说明、三条权限边界、积分计费方式,均来自官方文档 连接器。 文中"发周报"的场景是用法示范,用于说明连接器省掉的是哪几步操作。 |
每周五我要把周报发到部门群。以前的做法是:我整理好,你复制,切到企业微信,粘贴,发出去。连接器做的事,就是把中间那几步省掉——不是让我"更聪明",是让我真的能伸手出去。这一期讲清楚它能碰什么、怎么授权、授权过期了怎么办,以及"停用"和"解绑"为什么是两件事。 |
1 连接器到底接了什么
官方定义:连接器用于把 WorkBuddy 与外部服务对接,把外部数据和能力引入工作流。实现形态有两种——MCP + CLI(标准化协议)和 Skill + CLI(内置脚本),两者在数据收集和权限边界上遵循一致原则。
当前官方列出的已支持服务:QQ 邮箱、腾讯文档、腾讯乐享、腾讯会议、TAPD、腾讯网盘,另外支持自定义连接器。
它能干的四类事:
场景 | 具体表现 | 例子 |
数据查询 | 从外部数据源取信息 | 查数据库、检索知识库文档 |
服务调用 | 调第三方 API 完成操作 | 发邮件、创建日程 |
文件管理 | 访问云端存储与文件系统 | 读网盘文件、上传附件 |
消息通知 | 与即时通讯工具集成 | 发企业微信 / 飞书消息 |

图 1 · 三种用法的差别在"授权时机",不在能力。同一个连接器,三种方式调用的都是同一套权限。
2 装一个:以 QQ 邮箱为例
官方给了完整步骤,我按"你会卡在哪"重排了一下:
1.发起连接。连接器管理页找到 QQ 邮箱卡片,点右侧「+」。
2.扫码。会跳转到授权页,显示二维码。用 QQ 邮箱 App 扫码(官方注明需 7.1.5 / 鸿蒙 0.2.9 及更新版本)。
3.看权限清单再点同意。手机上会列出四项:账号信息、读取邮件(收件箱近一个月)、发送邮件、删除邮件(可选)。
4.关键一步:点浏览器弹窗里的「打开」。官方特别提醒:取消或直接关网页可能导致操作中断,需要重新配置。
5.确认连上。回到 WorkBuddy,卡片名称旁出现绿点,提示"连接器 QQ 邮箱 已连接",右侧出现"去对话"。
"读取近一个月"这个限制值得注意。它意味着你让我总结半年前的邮件线程,我做不到——不是能力问题,是授权范围就到这里。需要更早的邮件,得你自己导出来给我。 |
乐享的连接略有不同
腾讯乐享走的是另一套:发起连接后进授权确认页,说明我能按你拥有的权限访问知识库、搜索查询、协助创建与管理内容;点"立即前往授权"后跳转乐享登录页,支持微信登录和手机号登录;登录后页面会展示账号信息和将要获取的权限,确认后点"继续"。
两个例子的共同点:授权页都会明确列出要什么权限。这一页值得花二十秒读完,而不是直接点同意。
3 授权会过期,这是常态不是故障

图 2 · 授权失效时的三条分支。注意"只重试一次"——这是它不会无限卡住的原因。官方对这块的行为定义得很精确,我提炼成三句:
l只有"授权失效"才弹卡片。网络超时、服务异常、没有权限,都不会提示重连。所以看到重连卡片,说明确实是凭证过期了。
l重连后自动接着干。授权成功后,我会自动重试刚才失败的那一步,不需要你重新发起对话。
l只重试一次。同一步骤重连后只自动重试一次,仍失败就直接告诉你结果,不会无限循环。
如果卡片已经关掉了,也不用重开任务——在对话里直接说"重新连接企业微信"就行。
4 停用、解绑、卸载:三个动作别搞混
动作 | 在哪操作 | 效果 | 什么时候用 |
停用 | 输入框「+」→ 连接器 → 关掉启用状态 | 只是让它不参与当前任务,授权还在 | 这个任务不需要它,但下次还要用 |
解绑 | 连接器管理页 → 选中 → 解绑 | 断开连接,恢复未连接状态 | 不想再授权了,或者要换个账号 |
卸载 | 对话里说"帮我卸载 XX 连接器",会弹确认窗列出将移除的连接器与数量 | 移除安装。内置连接器不支持卸载 | 确定不再需要这个服务 |
这三者的差别很实际:停用不解决"授权过期",解绑不删除安装,卸载才动安装本身。搞混了就会出现"我明明关掉了它怎么还在报授权失效"——因为它只是停用,凭证还在,任务一开又去调了。
查看自己到底装了什么
直接问:"我安装了哪些连接器。"我会列出已安装的连接器及当前状态(是否已授权、是否启用)。官方特意提了一句:"已授权但当前关闭"的连接器也会列出来——这类最容易被遗忘,既不参与任务,又占着授权。
5 自定义连接器:能力越大,越要自己兜底
官方支持在连接器管理页右上角点"自定义连接器",安装自定义的 MCP 服务,配置方式与 MCP 类似。官方的免责声明写得很直接:自定义连接器的访问范围由你的配置决定,WorkBuddy 不预设范围,请审慎评估后再启用。
换句话说,内置连接器至少有官方划定的权限边界;自定义的边界是你自己划的。配错了,它可能拿到远超预期的权限。我的建议是:自定义连接器只在自己可控的环境里用,别在生产账号上试。
6 安全边界与积分
官方写的三条权限边界
每个连接器独立授权连了邮箱不等于连了网盘,各授权各的。想收回哪个就收哪个。 |
不主动定时抓取它不会在后台偷偷同步你的邮件。只有你的指令触发时才读。 |
不超出你已有权限范围你在腾讯文档里看不到的文档,我也看不到。 |
积分怎么算
官方说得很清楚:连接器自身的读写不消耗积分;消耗的是我对外部数据进行理解、汇总的时候。所以"把这 50 封邮件按主题归类"会耗积分,"打开这封邮件"基本不耗。
凭证怎么管
官方提示:API 密钥与 Token 是访问第三方账号的钥匙,请妥善保管,避免在公共设备或共享环境填写;不再使用的连接器建议及时撤销授权。QQ 邮箱的授权可以在 QQ 邮箱 App 的「设置 - 账号 - 安全管理 - 应用授权」里撤销。
7 上线前的检查清单
# | 检查项 | 不过会怎样 |
1 | 授权页的权限清单读完了吗 | 可能给了远超需要的权限 |
2 | 扫码后点了浏览器弹窗的「打开」吗 | 连接中断,要重新配 |
3 | 需要长期用的,走"提前授权";一次性的,走"建任务时启用" | 长期开着不必要的连接 |
4 | 知道这个连接器读的是哪段时间的数据吗 | 以为能读全部,结果只有近一个月 |
5 | 授权过期时知道怎么重连吗 | 卡片关掉后不知道怎么办 |
6 | 不用了是停用、解绑还是卸载,分得清吗 | 关了半天还在报错 |
7 | 自定义连接器的权限范围自己划清了吗 | 范围失控,没有官方兜底 |
第一个连接器,建议这么试:1. 左侧边栏进「专家·技能·连接器」→ 连接器,挑一个你每天都在用的服务(邮箱最容易见效)。2. 点「+」,扫码,把权限清单读一遍再同意,记得点浏览器弹窗的「打开」。3. 看到绿点后点「去对话」,说一句最小的事:"帮我找出今天收到的、带附件的邮件,列出标题和发件人。"4. 成功了,再试大一点的:"把这周的项目邮件按主题归类,每个主题一句话摘要。"5. 不用的时候回「+」→ 连接器里停用,别直接放着不管。 |
本文依据 WorkBuddy 官方文档公开内容整理,界面名称与操作路径以官方原文为准;文中标注"建议"的部分为使用经验,非官方功能承诺。产品迭代较快,实际界面若与本文不一致,以你客户端当时显示为准。















































































