AI工具WorkBuddy篇：7_ 插件完全指南

体系	定位	说明
技能 Skill	工具能力包	封装一组可执行脚本和工作流，赋予 AI 具体动作能力：读写文件、生成文档、操控浏览器、查询数据等
连接器 Connector	外部服务桥梁	将 WorkBuddy 与外部服务（邮箱、文档、会议、项目管理等）对接，实现数据互通与服务调用
MCP 服务器	通用协议扩展	基于模型上下文协议，接入任意第三方工具和数据源，是最灵活的自定义扩展方式

三者对比一览

维度	技能 Skill	连接器 Connector	MCP 服务器
定位	工具能力包	外部服务桥梁	通用协议扩展
技术形态	脚本 + 工作流	MCP + CLI / Skill + CLI	MCP 协议服务
安装方式	技能市场一键安装 / 上传 / AI 创建	扫码授权连接	编辑 mcp.json 配置文件
使用门槛	⭐ 最低，一键安装即用	⭐⭐ 需要授权账号	⭐⭐⭐ 需要一定技术基础
典型场景	生成 PPT、处理 Excel、浏览器自动化	读取邮件、操作腾讯文档、查 TAPD	接入企微机器人、自定义 API
能否自定义	✅ 可 AI 创建技能	✅ 支持自定义连接器	✅ 完全自定义

简单理解

技能 = 给 AI 发一把"瑞士军刀"，让它会做各种操作

连接器 = 给 AI 一把"钥匙"，让它能打开外部服务的门

MCP = 给 AI 一个"USB 接口"，什么外部设备都能插

2. 技能（Skill）详解

技能是 WorkBuddy 最核心、最常用的扩展方式。每个技能封装了一组可执行的脚本与工作流，让 AI 在你的授权下完成具体动作。

2.1 技能是什么？

技能（Skill）为 WorkBuddy 增加「特定工具能力」。比如：

📦 xlsx 技能：让 AI 能读写、编辑 Excel 表格

📑 pptx 技能：让 AI 能从零生成专业 PPT

🌐 agent-browser 技能：让 AI 能自动操控浏览器，打开网页、截图、填表

📊 westock-data 技能：让 AI 能查询实时股票行情和财报数据

2.2 技能页面概览

在 WorkBuddy 左侧导航栏点击**「技能 / 插件」**图标，进入技能管理页面，分为两个区域：

区域	说明
技能市场	官方推荐技能列表，可按需一键安装
已安装	已安装的本地技能，可直接在对话中调用

2.3 安装技能的四种方式

点击技能页面的**「添加技能」**按钮，你会看到以下选项：

方式一：技能市场一键安装（最推荐新手）

步骤 1： 打开技能管理页面

在左侧导航栏点击「插件 / 技能」图标

步骤 2： 浏览技能市场

在「技能市场」标签页中浏览推荐的技能列表，也可以用搜索框输入关键词快速定位

步骤 3： 点击安装

找到需要的技能，点击「安装」按钮。安装完成后按钮变为「管理」，说明安装成功

步骤 4： 直接使用

安装后即可在对话中直接使用。例如安装了 pptx 技能后，直接说"帮我生成一个关于XX主题的PPT"

方式二：查找技能（按需求搜索）

步骤 1： 选择「查找技能」

点击「添加技能」→ 选择「查找技能」

步骤 2： 输入任务描述

用自然语言描述你的需求，如"我需要处理PDF文件"或"我想要查询股票数据"

步骤 3： WorkBuddy 自动匹配

AI 会根据你的描述，自动查找相关的技能并推荐给你

步骤 4： 确认安装

查看推荐技能的功能说明，确认后点击安装

方式三：上传技能包（导入本地技能）

步骤 1： 选择「上传技能」

点击「添加技能」→ 选择「上传技能」

步骤 2： 拖拽或选择文件

将本地技能包文件拖拽到上传区域，或点击「选择文件」选中技能包

步骤 3： 自动配置

导入后系统会自动完成配置，无需额外操作

方式四：AI 创建技能（自定义技能）

步骤 1： 选择「创建技能」

点击「添加技能」→ 选择「创建技能」

步骤 2： 输入任务描述

描述你希望技能完成什么任务，如"帮我每天自动整理下载文件夹"

步骤 3： AI 自动生成

WorkBuddy 会根据描述自动创建相关技能，生成对应的脚本和工作流

步骤 4： 测试和优化

创建后可以在对话中测试技能效果，按需调整

💡 提示：在对话框中输入 /skills 或直接描述你的需求（如"我需要处理 Word 文档"），WorkBuddy 也会自动帮你查找和安装相关技能。

2.4 管理已安装的技能

操作	方法	说明
启用/关闭	在「已安装」列表中切换开关	关闭后该技能不会被调用，无需卸载。建议只启用当前需要的技能
搜索	在搜索框输入关键词	技能较多时快速定位目标
卸载	点击「卸载技能」	从本机完全移除，支持批量卸载
查看详情	点击技能卡片	查看技能功能说明、权限要求和脚本内容

✅ 最佳实践：只启用当前任务需要的技能。这样既能减少无关干扰、降低误调用概率，也能节省积分消耗。

3. 内置技能完整清单

以下是 WorkBuddy 当前支持的技能完整列表，按功能分类整理。

📄 文档处理类

技能名称	标签	功能说明
xlsx	官方推荐	Excel/CSV/TSV 表格处理全能技能。支持打开、读取、编辑、创建电子表格，添加公式、格式化、生成图表、清洗数据。适用于任何以表格文件为主要输入输出的场景
docx	官方推荐	Word 文档处理技能。支持创建、读取、编辑 .docx 文件，格式化文本、插入表格图片、设置样式。适合生成工作报告、技术文档、会议纪要等
pptx	官方推荐	PowerPoint 演示文稿生成技能。从需求描述自动生成完整的 PPT，包括布局、配色、内容编排。支持创建幻灯片、设计模板、生成图表
pdf	官方推荐	PDF 文件处理技能。支持读取/提取文本和表格、合并/拆分 PDF、加密解密、OCR 识别、表单填写、格式转换等
pdfkit-py	进阶	纯 Python PDF 工具包，包含 50+ 命令覆盖读取、编辑、转换、合并、拆分、表单、加密、OCR、红外等高级操作
minimax-docx	进阶	专业 DOCX 文档生成技能，基于 OpenXML SDK (.NET)，支持从零创建、修改已有文档、格式转换三条管线

📲 腾讯文档集成类

技能名称	功能说明
tencent-docs-routing	腾讯文档路由技能。处理 .docx/.doc、.xlsx/.xls、.ppt/.pptx 文档及在线腾讯文档的智能路由分发
tencent-local-office-edit	通过本地 editor_sdk 实时读写本机磁盘上的 Office 文档，编辑所见即所得。支持 .docx/.doc/.xlsx/.xls/.pptx/.ppt 本地文件的打开、编辑与保存

🌐 浏览器自动化类

技能名称	标签	功能说明
agent-browser	官方推荐	浏览器自动化技能。支持打开网页、截图、提取页面内容、点击元素、填写表单、数据抓取。适合需要与网页交互的任务
playwright-cli	进阶	基于 Playwright 的浏览器自动化技能，支持网页导航、交互、截图和数据提取，适合 Web 测试和表单填写

💰 金融数据类

技能名称	标签	功能说明
wb-finance-skill	金融总入口	金融/投资/股票/基金/ETF/板块/指数/宏观/外汇/大宗商品/财报/估值/持仓/交易/量化/因子/回测/选股/期权/衍生品——金融场景的总入口，优先级最高
westock-data	-	金融市场结构化数据查询权威入口。支持 A股/港股/美股/日韩股、ETF、指数、板块、期货、外汇、可转债的行情、财报、研报、新闻、公告、龙虎榜等数据
westock-tool	-	选股/选基工具。按条件、策略、标签、事件、排行从全市场批量筛选股票或 ETF。支持自定义条件筛选和预置策略
neodata-financial-search	自然语言查询	NeoData 金融搜索——用自然语言查询股票（A股/港股/美股）、基金、指数、板块、宏观经济、外汇、大宗商品等金融数据

🎨 多模态内容生成类

技能名称	功能说明
3D模型与视频特效	AI 生成 3D 模型（文生3D / 图生3D）及基于模板的图片视频特效（拥抱、变身、万物归尘等动效模板）
ImageGen（内置工具）	文本生成图片 / 图片到图片转换。直接通过自然语言描述生成图像，或基于已有图片进行 AI 变换
VideoGen（内置工具）	文本生成视频 / 图片生成视频。支持从文字描述或输入图片生成短视频（1-3分钟），结果保存为 MP4

☁️ 云端部署类

技能名称	功能说明
cloudstudio-deploy	将本地静态网站部署到 CloudStudio 沙箱工作区。创建工作区、上传文件、启动静态文件服务器，返回访问 URL

🛠️ 技能管理与发现类

技能名称	标签	功能说明
find-skills	发现技能	帮助用户发现和安装技能。当你问"怎么做X"或"有没有能做X的技能"时，自动搜索推荐市场并安装
marketplace-skill-installer	-	从推荐市场（BuiltinMarket）搜索并安装技能。一句话即可完成搜索和安装
skill-creator	-	创建新技能的向导。当用户想创建或更新技能时，提供详细的创建指南和最佳实践
expert-manager	专家管理	专家包全生命周期管理：从开源仓库/本地项目创建专家包、修改已有专家、合规检查、批量更新、质量审查

⚖️ 法律与专利检索类

技能名称	功能说明
pkulaw	北大法宝·法律智能检索。检索法律法规、案例、司法文件等
yuandian-mcp	华宇元典法律数据检索
patsnap-search	智慧芽专利与文献融合检索

💡 提示：以上是当前已安装/可用的技能列表。WorkBuddy 的技能市场会持续更新，不断添加新的技能。你可以在技能管理页面查看最新可用技能，也可以通过 find-skills 技能搜索。

4. 连接器（Connector）详解

连接器是 WorkBuddy 与外部服务之间的桥梁，让你用自然语言直接访问和操作第三方服务。

4.1 连接器是什么？

连接器用于将 WorkBuddy 与外部服务对接，实现数据互通与能力扩展。通过配置连接器，你可以让 WorkBuddy：

📊 数据查询：从外部数据源获取信息（查询数据库、检索文档）

🔧 服务调用：调用第三方 API 完成操作（发邮件、创建日程）

📁 文件管理：访问云端存储与文件系统（读取网盘文件、上传附件）

💬 消息通知：与即时通讯工具集成（发送企微/飞书消息）

4.2 可用连接器完整清单

WorkBuddy 当前支持 50+ 个连接器，涵盖办公协作、邮件通信、项目管理、金融数据、法律专利等多个领域：

办公协作类

连接器	功能说明
腾讯文档	读写、创建、编辑在线文档
腾讯文档企业版	企业版腾讯文档操作
金山文档 (KDocs)	WPS 金山文档读写
飞书	飞书消息、文档、日历
钉钉	钉钉消息和工作台

企业通讯类

连接器	功能说明
企业微信	企微消息发送、通讯录管理
QQ邮箱	收发、搜索、整理邮件
网易邮箱	网易邮箱收发邮件
微盛企微管家SCRM	企微客户管理

项目管理类

连接器	功能说明
TAPD	腾讯敏捷项目管理，需求/缺陷/迭代
轻流 (QingFlow)	无代码流程管理
Notion	Notion 文档和数据库
销售易CRM	客户关系管理

知识库类

连接器	功能说明
腾讯乐享	企业知识库搜索与管理
IMA知识库	ima 知识库检索
知识星球	知识星球内容查看
iWiki	内部 Wiki 知识检索

会议类

连接器	功能说明
腾讯会议	创建/管理会议、查看日程
腾讯问卷	创建和管理问卷调查
腾讯企点客服	客服工单管理

云存储类

连接器	功能说明
百度网盘	读取/管理网盘文件
微云	腾讯微云文件管理
腾讯云 CloudBase	云开发服务管理

金融数据类

连接器	功能说明
腾讯自选股	股票行情和自选股管理
通达信	通达信行情数据
恒生聚源	专业金融数据服务
腾讯营销投放	广告投放数据管理

企业信息类

连接器	功能说明
企查查	企业工商信息查询
天眼查	企业信息查询
启信宝	企业信用查询

开发工具类

连接器	功能说明
GitHub	仓库管理、PR、Issue
CNB	代码托管平台
智研构建部署	CI/CD 构建部署

地图与设计类

连接器	功能说明
腾讯地图	地图服务、位置搜索
MasterGo 莫高设计	设计稿管理和查看
EdgeOne Makers	边缘计算和页面部署

其他类

连接器	功能说明
小鹅通	知识付费平台管理
携程问道	差旅服务查询
中兴新云AI智报	智能财务报表

4.3 如何安装和配置连接器

基本安装流程

步骤 1： 进入连接器管理页面

在左侧导航栏点击「连接器」图标（插头形状）

步骤 2： 找到需要的连接器

在连接器列表中浏览或搜索，找到你需要的服务

步骤 3： 点击右侧 + 按钮发起连接

系统会跳转到对应服务的授权页面

步骤 4： 扫码或登录授权

根据提示用微信/QQ/企业微信扫码，或直接登录对应服务进行授权

步骤 5： 确认权限范围

仔细查看申请的权限（如读取邮件、发送消息等），确认后点击同意

步骤 6： 查看连接状态

回到 WorkBuddy，连接器卡片旁出现绿色圆点 = 连接成功；红色 = 配置异常

示例：连接 QQ 邮箱

在连接器管理页面找到「QQ 邮箱」卡片，点击右侧 + 按钮

系统跳转到 QQ 邮箱授权页面，显示二维码

使用 QQ 邮箱 App（版本 ≥ 7.1.5 / 鸿蒙 ≥ 0.2.9）扫码

在手机端确认权限：
- ✅ 账号信息：获取邮箱账号基础信息
- ✅ 读取邮件：读取收件箱内近一个月的邮件
- ✅ 发送邮件：代为发送邮件
- ⬜ 删除邮件（可选）：已删除邮件移入「已删除」文件夹

确认无误后点击「同意授权」

回到 WorkBuddy，QQ 邮箱卡片旁出现绿点 = 连接成功

使用示例：在对话框输入"读取我 QQ 邮箱最近 3 天的未读邮件，分类整理成需要回复的和可直接归档的"

4.4 在对话中快捷管理连接器

除了在连接器管理页面操作，你也可以直接在消息输入框中快捷管理连接器。当你在对话中提到需要使用某个外部服务时，WorkBuddy 会提示你连接对应的连接器。

4.5 自定义连接器

如果内置连接器不满足需求，WorkBuddy 支持自定义连接器（基于 MCP 协议）。具体配置方法见下一节 MCP 部分。

5. MCP 服务器详解

MCP（Model Context Protocol，模型上下文协议）是 WorkBuddy 最灵活的扩展方式，可以理解为 AI 的"USB 接口"——什么外部工具和数据源都能接入。

5.1 什么是 MCP？

就像电脑通过 USB 连接外设一样，MCP 让 AI 连接各种外部工具和数据源。WorkBuddy 已将 MCP 配置集成到界面中，无需编码、无需手动改配置文件，可视化操作即可完成接入。

能力	说明
上下文共享	向模型提供文件内容、数据库记录、业务信息等上下文
工具调用	将文件读写、接口调用、消息发送等能力暴露给模型
可组合工作流	多个工具和服务通过 MCP 串联，组成自动化流程
数据控制	支持本地或受控方式运行，兼顾灵活性与安全性

5.2 配置级别

WorkBuddy 支持两种 MCP 配置级别：

级别	说明	适用场景
用户级	配置一次，所有项目复用	频繁跨项目使用的能力（如企微机器人通知）
项目级	仅当前项目生效，互不影响	仅特定项目需要的专属服务

如何选择？ 跨项目常用 → 用户级；仅特定项目 → 项目级；不确定 → 先用户级。

5.3 配置步骤（以企微机器人为例）

步骤 1： 获取 WebHook URL

在企业微信群中：添加群机器人 → 获取 WebHook URL

步骤 2： 打开 MCP 配置入口

进入侧边栏「插件」→ 点击右上角「MCP 服务器」→「配置 MCP」

步骤 3： 填写 mcp.json 配置

将配置粘贴到编辑器中，替换 your-webhook-url 为实际地址后保存

步骤 4： 查看连接状态

🟢 绿色 = 连接成功，🔴 红色 = 配置异常

步骤 5： 用自然语言调用

在对话框输入"请通过企业微信机器人通知：正式产品已发布"

配置文件示例

{
  "mcpServers": {
    "wecom": {
      "command": "uvx",
      "args": ["wecom-bot-mcp-server"],
      "env": {
        "WECOM_WEBHOOK_URL": "your-webhook-url"
      }
    }
  }
}

5.4 MCP 市场

WorkBuddy 提供现成的 MCP 资源入口，可访问腾讯云 MCP 市场获取更多开放生态能力。地址：https://cloud.tencent.com/developer/mcp

5.5 添加第三方 MCP

步骤 1： 打开 MCP 服务管理页面

侧边栏「插件」→ 右上角「MCP 服务器」

步骤 2： 点击「配置 MCP」

在编辑器中添加新的 MCP 服务器配置

步骤 3： 保存并授权

保存配置后，在自定义连接器列表中找到新添加的 MCP，点击「启用」完成授权

步骤 4： 验证是否生效

在对话框输入"列出 xxx-mcp 下的所有工具"，如果返回工具列表说明配置成功

HTTP 模式 MCP 配置示例

部分 MCP 服务器支持 HTTP 传输模式，配置更简单：

{
  "mcpServers": {
    "your-mcp": {
      "url": "https://your-mcp-server.com/mcp?secret-key=你的密钥",
      "transport": "http",
      "disabled": false
    }
  }
}

6. 专家中心

除了技能、连接器和 MCP，WorkBuddy 还有一个强大的功能——专家中心，提供 100+ 领域专家智能体。

6.1 什么是专家？

专家是针对特定领域预设好的 AI 智能体，拥有该领域的专业知识和工作方式。与技能不同，专家更像是一个"专业顾问"，而技能是"工具"。

6.2 如何使用专家

步骤 1： 进入专家中心

在左侧边栏点击「专家」选项

步骤 2： 浏览专家分类

按类别浏览专家，如技术开发、金融投资、法律合规、设计创意等

步骤 3： 选择专家并对话

点击你需要的专家，开始对话。专家会以专业视角帮你分析和解决问题

6.3 管理专家包

通过 expert-manager 技能，你可以管理专家包的全生命周期：

🔄 从开源仓库/本地项目创建专家包

✏️ 修改已有专家

✅ 合规检查

📦 批量更新

🔍 质量审查

7. 安全注意事项与最佳实践

⚠️ 重要安全提醒：非官方技能可能存在安全风险！包括：恶意提示词注入、越权访问、后门程序等。请始终优先使用官方推荐技能。

7.1 信息收集与使用

技能/连接器/MCP 可能涉及的信息（视具体扩展而定）：

🔐 账户身份信息、联系方式

📝 用户输入内容、使用行为日志

🔑 第三方平台凭证

💾 本地文件读写权限

🖥️ 屏幕与输入控制权限

7.2 安全建议

建议	说明
优先官方技能	优先使用官方推荐技能，安装第三方前仔细查看权限申请、来源说明与脚本内容
谨慎授权	不授权系统盘和隐私文件夹，仅授权工作相关目录
先小范围验证	涉及文件删除、批量写入、系统配置变更或资金操作时，先小范围验证再放大使用
仅启用所需技能	只启用当前任务需要的技能，减少干扰和误调用
关注积分消耗	复杂任务和复杂技能的积分消耗通常较高
注意第三方共享	部分技能会将输入内容发往第三方（如订外卖、查股票、发消息等）
仅从官网下载	仅通过官网 codebuddy.cn/work 下载 WorkBuddy

7.3 程序化安装（进阶）

如果你需要程序化或批量安装技能，可以通过配置文件实现：

插件市场目录：

$HOME\.workbuddy\plugins\marketplaces\codebuddy-plugins-official
$HOME\.workbuddy\plugins\marketplaces\cb_teams_marketplace

启用配置文件（$HOME\.workbuddy\settings.json）：

{
  "enabledPlugins": {
    "pptx@codebuddy-plugins-official": true,
    "pdf@codebuddy-plugins-official": true,
    "docx@codebuddy-plugins-official": true,
    "xlsx@codebuddy-plugins-official": true,
    "agent-browser@codebuddy-plugins-official": true
  }
}

设置值为 true 即启用对应插件，false 则关闭。