02 · 连接器
连接器是什么
连接器是 WorkBuddy 与外部服务之间的桥。 配好之后，WorkBuddy 就能直接访问和操作第三方服务——读你的邮件、写你的腾讯文档、查你的会议安排。
技术形态上分两种：
- MCP + CLI（标准化协议）
- Skill + CLI（内置脚本）
两者在数据收集和权限边界上遵循一致的原则，你日常使用时感受不到区别。
当前官方支持 QQ 邮箱、腾讯文档、腾讯乐享、腾讯会议、TAPD、腾讯网盘，并支持自定义连接器。
四类典型用法
| 场景 | 说明 | 示例 |
|---|---|---|
| 数据查询 | 从外部数据源获取信息 | 查数据库、检索文档 |
| 服务调用 | 调用第三方 API 完成操作 | 发送邮件、创建日程 |
| 文件管理 | 访问云端存储与文件系统 | 读网盘文件、上传附件 |
| 消息通知 | 与即时通讯工具集成 | 发企业微信 / 飞书消息 |
在哪管理
左侧导航栏点「连接器」进入管理页面，能看到所有可用连接器。输入框上也有快捷管理入口，不用来回切页面。
示例：连接 QQ 邮箱
QQ 邮箱连接器支持收发、搜索和整理 QQ 邮件——用自然语言读取邮件内容、汇总邮件线程、管理文件夹。
流程五步：
- 点添加——在连接器管理页找到 QQ 邮箱卡片，点右侧的
+发起连接。 - 扫码授权——系统跳转到 QQ 邮箱授权页显示二维码。用 QQ 邮箱 App（7.1.5 / 鸿蒙 0.2.9 及更新版本）扫码。
- 确认权限——在手机端确认申请的访问权限：
- 账号信息：获取邮箱账号基础信息
- 读取邮件：读取收件箱内近一个月的邮件
- 发送邮件：代为发送邮件
- 删除邮件（可选）：已删除邮件会移入「已删除」文件夹
- 授权成功——手机端显示成功。后续可在「设置 - 账号 - 安全管理 - 登录设备和授权码 - 应用授权」中管理。
- 连接完成——回到 WorkBuddy，卡片旁出现绿色圆点，右侧显示启用 / 禁用开关。
授权成功时别关网页
授权成功时要点浏览器弹窗中的「打开」完成连接。取消或直接关掉网页可能导致操作中断，需要重新配置连接器。
示例：连接腾讯乐享
腾讯乐享连接器支持搜索、创建和管理乐享知识库中的文档，支持导入 Markdown、按标签整理内容、追踪团队文档的更新动态。
- 点添加——找到腾讯乐享卡片，点
+。 - 确认授权——授权确认页会说明通过乐享知识库 MCP，WorkBuddy 将能够：按你拥有的权限访问知识库、搜索查询内容、协助创建与管理内容。确认后点「立即前往授权」。
- 登录乐享——支持微信登录、手机号登录。
- 授权成功——页面显示账号信息和 WorkBuddy 将获取的权限，确认后点「继续」。
- 连接完成——回到 WorkBuddy，卡片旁出现绿色圆点。
其它官方连接器的流程大同小异：找卡片 → 点 + → 跳转授权 → 确认权限 → 回到客户端看绿点。
自定义连接器
需要接入其它外部服务时，点连接器管理页右上角的「自定义连接器」，安装自定义的 MCP 服务。
配置方式与 MCP 配置类似，详见 MCP 与插件。
自定义连接器的范围由你决定
官方免责声明写得很直白：自定义连接器的访问范围由你的配置决定，WorkBuddy 不预设范围。 请审慎评估后再启用。
也就是说，官方连接器的权限边界是经过设计的，自定义连接器的边界是你自己划的。
断开连接器
- 点已连接的连接器卡片，在弹窗中点左侧的「解绑」。
- 系统提示已断开，连接器恢复为未连接状态。
QQ 邮箱这类还可以从服务方那边撤销：QQ 邮箱 App →「设置 - 账号 - 安全管理 - 应用授权」。
定期清一遍
不再使用的连接器建议及时撤销授权。凭据放着不用不会自己失效，但会一直是一把有效的钥匙。
权限与数据边界
官方列出的收集项：
| 收集项 | 类型 | 用途 |
|---|---|---|
| 第三方账号标识 | 必要 | 邮箱地址、账号 ID，用于在第三方服务中识别你 |
| 授权凭据 | 必要 | OAuth Access / Refresh Token，或你手填的 API 密钥 |
| 第三方业务数据 | 必要 | 仅在你的指令触发时按需读取（邮件、文档、知识库、会议、TAPD 数据等） |
| 用户写入数据 | 非必要 | 代发邮件、创建 / 编辑文档、创建会议等，需你明确指令确认 |
三条边界规则：
- 每个连接器独立授权——装了邮箱不等于装了文档
- 不主动定时抓取——只在你的指令触发时读
- 不超出你已有权限范围——你在乐享里看不到的文档，它也看不到
积分怎么算
连接器自身的读写不消耗积分。
消耗发生在 WorkBuddy 对外部数据进行理解、汇总的时候。
这个区分挺重要：「把我今天的邮件列出来」很便宜；「读完这 40 封邮件，按项目归类，告诉我哪些需要今天回」就贵了——贵的是后半句。
安全建议
它以你本人的身份行动
连接器调用所产生的对第三方服务的访问、读写、消息发送，均以你本人身份与授权范围执行。
所以：涉及对外发送、内容修改前，再确认一次目标对象与内容。 一封发错人的邮件是收不回来的。
- API 密钥与 Token 是钥匙。 妥善保管，避免在公共设备或共享环境填写。
- 定期检查连接器状态，确保服务正常运行。
- 第三方服务的可用性和内容真实性由其自身决定。 遇到接口异常或服务变更，先去看那家的服务状态与协议。
常见问题
Q：连接器和技能怎么选？
需要对接的是官方支持的服务（QQ 邮箱、腾讯文档、乐享、会议、TAPD、网盘）就用连接器——授权流程和权限边界是现成的。其它服务走自定义连接器或 MCP。
Q：连接器断开后，之前的任务记录还在吗？
在。断开只影响后续调用。
Q：项目里的连接器和我个人的连接器是一回事吗？
不是。项目里的连接器按授权方式分「公共授权」（管理员配一次、全员共用同一套票据）和「个人授权」（每位成员各自授权自己的账号，票据不共享）。协作任务中个人授权连接器全部禁用，只有公共授权连接器可用。 详见 项目与团队协作。
下一步
03 MCP 与插件——接入官方清单之外的任何服务。