概述
连接器是 WorkBuddy 与外部服务之间的桥梁，将外部能力引入 AI 工作流，实现数据互通与能力扩展。技术形态分为：
MCP + CLI（标准化协议）
Skill + CLI（内置脚本）
二者在数据收集和权限边界上遵循一致原则。
通过配置连接器，你可以：
对接外部服务：让 WorkBuddy 直接访问和操作第三方服务
扩展数据源：从外部系统获取数据，丰富 AI 工作流
安全授权：通过 OAuth 或 API Key 方式安全连接外部服务
双向同步：支持数据查询与操作执行（如发送邮件、创建文档）
当前已支持多种连接器，并支持自定义连接器；新增连接器将同步更新隐私协议相关条款。
如何使用连接器
1. 进入连接器：单击对话框左侧的 + 按钮，单击连接器。
2. 选择并添加连接器：单击卡片右侧按钮，添加连接器。
3. 完成授权：按照引导完成扫码或登录授权。
在消息框中支持快捷管理连接器：
注意：
非官方连接器可能存在安全隐患，请优先使用官方推荐连接器。
断开连接器
如需断开已连接的连接器，操作步骤如下：
1. 单击开关：在已连接的连接器卡片上，单击右侧的按钮。
2. 确认断开：弹窗询问确定要解绑连接器 iWiki 吗？单击解绑确认操作。
3. 解绑完成：系统提示连接器 iWiki 已解绑，连接器恢复为未连接状态。
应用场景
场景 | 说明 | 示例 |
数据查询 | 从外部数据源获取信息 | 查询数据库、检索文档 |
服务调用 | 调用第三方 API 完成操作 | 发送邮件、创建日程 |
文件管理 | 访问云端存储与文件系统 | 读取网盘文件、上传附件 |
消息通知 | 与即时通讯工具集成 | 发送企业微信/飞书消息 |
配置示例
示例一：连接 QQ 邮箱
QQ 邮箱连接器支持收发、搜索和整理 QQ 邮件，用自然语言读取邮件内容、汇总邮件线程、管理文件夹。
1. 单击添加
在连接器管理页面找到 QQ 邮箱 卡片，单击右侧的 + 按钮发起连接。
2. 扫码授权
系统会跳转到 QQ 邮箱授权页面，显示二维码。使用 QQ 邮箱 App（7.1.5 / 鸿蒙0.2.9及更新版本）扫码进行授权。
3. 确认权限
在手机端确认 WorkBuddy 申请的访问权限，包括：
账号信息：获取邮箱账号基础信息
读取邮件：读取收件箱内近一个月的邮件
发送邮件：代为发送邮件
删除邮件（可选）：已删除邮件会移入「已删除」文件夹
确认无误后单击 同意授权。
4. 授权成功
手机端显示 授权成功，可在设置 > 账号 > 安全管理 > 登录设备和授权码 > 应用授权中管理授权应用。
5. 连接完成
回到 WorkBuddy，QQ 邮箱卡片名称旁会出现绿色圆点，并提示连接器 QQ 邮箱已连接，右侧显示启用/禁用开关。
示例二：连接腾讯乐享
腾讯乐享连接器支持搜索、创建和管理乐享知识库中的文档，支持导入 Markdown、按标签整理内容、追踪团队文档的更新动态。
1. 单击添加
在连接器管理页面找到腾讯乐享卡片，单击右侧的 + 按钮发起连接。
2. 登录乐享知识库
系统会跳转到腾讯乐享登录页面，支持微信登录、手机号登录和企业微信登录三种方式。
3. 确认授权
登录后进入授权确认页面，显示当前账号信息。通过乐享知识库 MCP，WorkBuddy 将能够：
按你拥有的权限访问知识库
搜索、查询知识库中的内容
协助创建与管理知识库中的内容
确认无误后单击继续。
4. 授权成功
页面显示 Authentication Successful，表示已成功完成认证，可关闭当前窗口返回 WorkBuddy。
5. 连接完成
回到 WorkBuddy，腾讯乐享卡片名称旁会出现绿色圆点，右侧显示启用/禁用开关，表示连接已就绪。
自定义连接器
如需接入其他外部服务，可单击连接器管理页面右上角的自定义连接器按钮，按照引导配置自定义的 MCP 连接器。
说明：
自定义连接器的配置方式与 MCP 配置类似。
注意事项与重点提示
信息收集与使用
收集项 | 类型 | 用途 |
第三方账号标识 | 必要 | 邮箱地址、账号 ID 等，用于在第三方服务中识别您的身份 |
授权凭据 | 必要 | OAuth Access/Refresh Token，或您手动填写的 API 密钥 |
第三方业务数据 | 必要 | 仅在您的指令触发时按需读取（邮件、文档、知识库、会议、TAPD 项目数据等） |
用户写入数据 | 非必要 | 代发邮件、创建/编辑文档、创建会议等，需您明确指令确认 |
权限边界
每个连接器独立授权
不主动定时抓取
不超出您已有权限范围
安全提示
连接器需要相应服务的访问权限，请确保授权信息正确。
授权后可随时通过开关禁用或断开连接器。
如需撤销 QQ 邮箱授权，可前往 QQ 邮箱 App 设置 > 账号 > 安全管理 > 应用授权中操作。
建议定期检查连接器状态，确保服务正常运行。
积分消耗提醒
连接器自身的读写不消耗积分；WorkBuddy 对外部数据进行理解、汇总时会消耗积分。
第三方共享
本质即与第三方服务交互；凭据由 WorkBuddy 维护以便代您调用。
免责声明
自定义连接器的访问范围由您的配置决定，WorkBuddy 不预设范围，请审慎评估后再启用。
使用建议
连接器调用所产生的对第三方服务的访问、读写、消息发送，均以您本人身份与授权范围执行，建议在涉及对外发送、内容修改前再次确认目标对象与内容。
第三方服务的可用性、内容真实性由其自身决定，遇到接口异常或服务变更，请优先查看该第三方的服务状态与协议。
API 密钥与 Token 是访问您第三方账号的钥匙，请妥善保管，避免在公共设备或共享环境填写；不再使用的连接器建议及时撤销授权。
声明
如有不一致之处，以前述协议原文为准。
