# 技能、插件与 MCP

> 安装 GitHub 上的 Skill 和插件，使用推荐的 Remotion、HyperFrames、ComfyUI、RunningHub 插件，添加自定义 MCP 连接，并把常用方法保存为技能。

- 原文: https://beav.pro/docs/agent/skills-and-plugins

核对日期：2026-10-07。适用于 Beav 桌面端 2.8.13。

## 先分清四个概念

| 名称        | 是什么                          |
| --------- | ---------------------------- |
| 技能（Skill） | 给 AI 的可复用工作方法和参考资料，按需读取      |
| 工具        | AI 读取状态或执行动作的能力，有具体参数和权限边界   |
| 插件        | 可安装的能力包，可以包含 Skill 和 MCP 服务器 |
| MCP 连接    | 连接外部工具服务的配置，可以由插件提供，也可以单独添加  |

插件已安装、连接已配置、账号已授权、工具在当前任务可用，是四个不同的状态。遇到“装好了但不能用”，先检查对应的设置和连接状态，不需要重装所有组件。

## 技能市场与安装 Skill

在“工具&技能 → 技能市场”中搜索、查看和安装技能。点击市场左上角的“管理”进入“已安装技能”，输入 GitHub 仓库的 `owner/repo` 或网址，点击“安装”，Beav 会查找仓库中的 `SKILL.md`，连同参考文件和模板一起安装。已有同名但内容不同的技能时会提示冲突，不会覆盖。卸载和启停也在“已安装技能”中管理。

安装 Skill 不会自动安装它依赖的 Node、Python 或浏览器等运行环境，需要按该 Skill 的说明准备。

![已安装技能页面：顶部是 GitHub Skill 仓库输入框和安装按钮，下方列出四个已安装技能及其来源标签、开关和删除按钮，最后是折叠的内置技能分组](https://beav.pro/screenshots/skills-installed-zh-2026-10-07.webp)

*已安装技能：输入 GitHub 仓库安装 Skill，并管理启停和卸载。*

## 把方法保存为技能

在对话中可以让 AI 把已经确认好的方法整理成可复用的 Skill。跨空间使用时保存为用户级技能，只在当前空间使用时保存到工作区。只有看到安装成功的回执才算保存；同名内容不同的更新会先核对版本，避免覆盖。

## 插件

在“工具&技能 → 插件 → 我的插件”查看已安装的插件，可以启停或卸载。

![插件页面：推荐插件区列出 ComfyUI Local、Comfy Cloud、RunningHub · Pixelle、Remotion 和 HyperFrames；我的插件区显示已安装的 Remotion 和 ComfyUI Local 及其 MCP 连接状态；其他 MCP 连接区显示 Beav Browser Control 和一个自定义连接](https://beav.pro/screenshots/plugins-recommended-zh-2026-10-07.webp)

*插件页集中展示推荐插件、我的插件和其他 MCP 连接。*

* **推荐插件**：可以直接安装 Remotion、HyperFrames、ComfyUI Local、Comfy Cloud 和 RunningHub · Pixelle。Remotion 插件让 AI 制作代码动画，HyperFrames 提供 HTML 视频制作技能；它们使用固定的官方版本，安装前会校验文件。
* **从 GitHub 安装**：点击“安装插件”，输入带插件清单的 GitHub 仓库，例如 `remotion-dev/codex-plugin`。
* **导入 Codex 插件**：读取本机 Codex 插件缓存，选择后复制到 Beav 管理的插件目录。

插件里的 Skill 由插件整体管理，请在“我的插件”中卸载，不要用普通 Skill 的删除按钮。插件安装成功不等于渲染环境已就绪，例如 Remotion 动画仍需要本机能运行对应工程。

### ComfyUI 与 RunningHub

ComfyUI Local 和 Comfy Cloud 是 Comfy 官方 MCP，RunningHub · Pixelle 是第三方 MCP。点击列表项可以先查看用途和准备条件，再点“安装插件”确认启动命令或连接地址。Comfy Cloud 可以在安装弹窗中填写 `COMFY_API_KEY`，作为密钥安全保存。RunningHub · Pixelle 需要你先运行 Pixelle 并完成它自己的模型与 RunningHub API Key 配置。

安装后，插件的 MCP 连接默认关闭，需要到“我的插件”对应条目启用并测试。

## 自定义 MCP 连接

在插件页的“其他 MCP 连接”中：

* **添加自定义连接**：选择 STDIO 启动命令，或填写 HTTP / SSE 地址，保存后用“测试”确认能连接。STDIO 需要的 Node、Python、npm、uv 等必须已经安装。
* **导入本机配置**：在“设置 → MCP 服务器”点击“导入”，读取 Codex、Cursor 和 Claude 的 MCP 配置，按 ID 保留已有项，只加入新的服务器。
* HTTP 认证使用安全环境变量填写 Bearer Token 或 Header。目前不支持 MCP 的 OAuth 登录。

内置的浏览器连接显示为“Beav Browser Control”。

启用插件后，AI 会在需要时搜索并加载其中的工具；运行中安装、启用或关闭插件，会在下一次模型请求时生效。

## 浏览器插件诊断

浏览器插件连接异常时，在“设置 → 通用”底部的“浏览器插件诊断”点击“开始诊断”，检查本机注册、连接程序握手和插件连接。点击“反馈诊断结果”会自动附上脱敏的检查结论和日志，不需要手动查找日志文件。更多排查见[浏览器插件排错](https://beav.pro/docs/browser-extension/troubleshooting)。
