夜雨聆风学习资料网

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 官方文档公开内容整理,界面名称与操作路径以官方原文为准;文中标注"建议"的部分为使用经验,非官方功能承诺。产品迭代较快,实际界面若与本文不一致,以你客户端当时显示为准。

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料