CodeBuddy 连接器

一、概述

从实现形态来看，连接器分为 MCP + CLI（标准化协议） 和 Skill + CLI（内置脚本） 两种形式，二者在数据收集和权限边界上遵循一致原则。

当前已支持 QQ 邮箱、腾讯文档、腾讯乐享、腾讯会议、TAPD、腾讯网盘等连接器，同时支持自定义连接器。新增连接器后，相关隐私协议条款将同步更新。

二、连接器能做什么

通过连接器，WorkBuddy 可以在任务中调用外部服务的能力，完成数据查询、服务调用、文件管理和消息通知等操作。

四、添加连接器

1. 在左侧边栏单击专家·技能·连接器，选中连接器页签，即可进入连接器管理页面。

2. 找到需要使用的连接器，单击卡片右上方的 。

3. 按页面提示完成登录、授权或其他配置。

4. 完成授权后，即可在 WorkBuddy 中使用该连接器。

注意：非连接器可能存在安全隐患，请优先使用推荐连接器。

五、使用连接器

连接器支持多种使用方式，你可以提前完成授权，也可以在创建或执行任务时按需添加。

·方式一：从连接器页面发起对话：在连接器管理页面中，找到已授权使用的连接器，单击卡片右上方的去试试，即可直接开始使用。

·方式二：创建任务时启用：新建任务时，单击输入框左下角的  > 连接器，在弹窗中开启需要使用的连接器。尚未完成授权的连接器，需要先完成授权后才能使用。

·方式三：执行任务时按需连接：任务执行过程中，如果需要使用尚未连接的连接器，输入框上方会自动显示连接引导卡片。单击卡片并按提示完成授权后，WorkBuddy 将自动继续执行当前任务，无需重新发起对话。

六、连接器授权失效后重新连接

已连接的连接器，授权可能会过期或失效。任务执行过程中遇到这种情况时，输入框上方会显示“连接器需要重新连接”卡片，提示“此连接器的授权已失效，请重新连接以继续当前任务”：

1. 单击卡片中的重新连接，按该连接器已有的授权方式完成登录、扫码或授权；

2. 授权成功后卡片会显示已连接，WorkBuddy 会自动重试刚才失败的那一步，无需重新发起对话；

3. 如果不想重新连接，单击卡片右上角的关闭按钮即可。此时不会重试刚才失败的步骤，该任务需要完成重新连接后才能继续使用这个连接器；

4. 重新连接失败时，卡片会提示“连接失败，请重试。”，可再次单击重新连接。

注意：说明：

注意：只有连接器明确返回授权失效时才会出现这张卡片。网络超时、服务异常或没有权限等情况，不会提示重新连接。同一步骤重新连接后只会自动重试一次，仍失败时会直接告知结果。

你也可以主动让 WorkBuddy 重新连接某个连接器，例如在对话中说“重新连接企业微信”。

七、停止使用连接器

如需停止使用已添加的连接器，可单击输入框左下角的  > 连接器，在弹窗中取消对应连接器的启用状态。

八、解绑连接器

如需断开已连接的连接器，操作步骤如下：

1. 在左侧边栏单击专家·技能·连接器，选中连接器页签，进入连接器管理页面。选中已连接且需要解绑的连接器，在弹窗中单击解绑。

2. 解绑完成后，系统会提示该连接器已解绑，并恢复为未连接状态。具体提示信息以页面实际显示为准。

九、通过对话管理连接器

除了在页面中手动操作，你也可以直接在对话中用自然语言管理已安装的连接器：

·安装连接器：直接在对话中说明要安装的连接器名称（如“帮我安装 QQ 邮箱连接器”），WorkBuddy 会引导你完成安装。安装后，如需授权，按照提示完成授权即可使用。

·查看已安装的连接器：询问“我安装了哪些连接器”，WorkBuddy 会列出已安装的连接器及其当前状态（是否已授权、是否启用）。其中“已授权但当前关闭”的连接器也会列出——它们平时不参与任务，容易被遗忘。

·卸载连接器：明确要求卸载时（如“帮我把 QQ 邮箱连接器卸载”），WorkBuddy 会弹出确认窗口，列出即将移除的连接器与数量，确认后完成卸载。内置连接器不支持卸载。

十、使用示例

不同连接器的连接和授权方式可能有所不同，以下以 QQ 邮箱和腾讯乐享为例，介绍常见的连接流程，其他连接器以实际页面提示为准。

十一、连接 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. 确认授权，发起连接后进入授权确认页面，通过乐享知识库 MCP，WorkBuddy 将能够：

·按你拥有的权限访问知识库

·搜索、查询知识库中的内容

·协助创建与管理知识库中的内容

确认无误后单击立即前往授权。

3. 登录乐享知识库，系统会跳转到腾讯乐享登录页面，支持微信登录、手机号登录和企业微信登录三种方式。

4. 授权成功，页面显示乐享知识库的账号信息，并且展示 WorkBuddy 将要从乐享知识库获取的权限，确认无误后单击继续。

5. 连接完成，回到 WorkBuddy，腾讯乐享卡片名称旁会出现绿色圆点，右侧显示去对话按钮，表示连接已就绪。

十三、自定义连接器

如需接入其他外部服务，可单击连接器管理页面右上角的自定义连接器按钮，按照引导配置自定义的 MCP 连接器。

注意：说明：

注意：自定义连接器的配置方式与 MCP 配置类似，详细说明可参考 MCP。

十五、信息收集与使用

十六、权限边界

·每个连接器独立授权

·不主动定时抓取数据

·不超出你已有权限范围

十七、安全提示

·连接器需要相应服务的访问权限，请确保授权信息正确。

·授权后可随时通过开关禁用或断开连接器。

·如需撤销 QQ 邮箱授权，可前往 QQ 邮箱 App 设置 > 账号 > 安全管理 > 应用授权中操作。

·建议定期检查连接器状态，确保服务正常运行。

十八、积分消耗提醒

连接器自身的读写不消耗积分；WorkBuddy 对外部数据进行理解、汇总时会消耗积分。

十九、第三方共享

本质即与第三方服务交互；凭据由 WorkBuddy 维护以便代你调用。

20、免责声明

自定义连接器的访问范围由你的配置决定，WorkBuddy 不预设范围，请审慎评估后再启用。

21、使用建议

·连接器调用所产生的对第三方服务的访问、读写、消息发送，均以你本人身份与授权范围执行，建议在涉及对外发送、内容修改前再次确认目标对象与内容。

·第三方服务的可用性、内容真实性由其自身决定，遇到接口异常或服务变更，请优先查看该第三方的服务状态与协议。

·API 密钥与 Token 是访问你第三方账号的钥匙，请妥善保管，避免在公共设备或共享环境填写；不再使用的连接器建议及时撤销授权。