> 内容来源：Onevium 官方文档
> 文章: 安装、启用和检查插件
> 原文: https://onevium.com/zh/docs/plugins
> 语言：简体中文
> 更新于: 2026-09-09
> 适用版本: 1.1.22
> 功能状态: 已发布

---

# 安装、启用和检查插件

检查插件来源与内容，完成安装和启用，并验证一项实际能力。

## 可以安装什么

插件把 Skill、Agent、Hook 或 MCP 组成一个包。本教程使用 Anthropic 官方市场 `claude-plugins-official` 中的 **Frontend Design**，它提供前端设计 Skill，与 Onevium 内置 Widget 是不同能力。参见[官方插件说明](https://github.com/anthropics/claude-plugins-official/blob/main/plugins/frontend-design/README.md)。

## 打开插件管理

点击工作区右侧图标栏的**插件**（包裹图标），再点**浏览插件**。右侧栏隐藏时，默认可用 macOS 的 **Option+Command+B** 或 Windows/Linux 的 **Alt+Ctrl+B** 显示。

列表来自当前 Claude 环境已经下载的市场目录。看得到官方市场，不等于其中每个插件都已安装。使用插件中的 Skill 前，还需有可用模型连接。

## 安装 Frontend Design

1. 在“浏览插件”搜索 `frontend-design`。
2. 确认来源为 `claude-plugins-official`、作者为 Anthropic。完整标识是 `frontend-design@claude-plugins-official`。
3. 点击**安装**，等待它出现在“已安装”列表。
4. 打开详情，核对**来源、作用域、Skills**，未启用时打开开关。
5. 在小型前端项目中新建会话，让运行时加载插件。

| 详情项                   | 用来确认什么                |
| --------------------- | --------------------- |
| 来源                    | 区分不同市场里的同名插件          |
| 作用域                   | 当前安装覆盖什么范围，不默认只有本项目可用 |
| Skills / Agents / MCP | 插件实际包含哪些能力            |
| 启用开关                  | 是否让已安装插件参与后续工作        |

## 官方市场没有出现时

市场地址与下载好的目录是两件事。1.1.22 的**添加市场**只保存地址，不能仅凭点击成功就认为目录已下载。

如果使用的 Claude Code CLI 与 Onevium 属于**同一系统用户和配置目录**，可在该 CLI 环境注册或刷新官方目录：

```bash
claude plugin marketplace add anthropics/claude-plugins-official
claude plugin marketplace update claude-plugins-official
```

市场尚未注册时才运行第一条。重新打开“浏览插件”，实际找到条目后继续安装。这是终端命令，不表示上游所有斜杠命令都能在 Onevium 对话里直接执行。注册和刷新见[官方市场指南](https://code.claude.com/docs/en/discover-plugins)。

## 实际调用一次

在新会话发送：

```text
使用 frontend-design@claude-plugins-official 提供的 frontend-design Skill。
创建 demo-settings.html，做一个紧凑的通知设置面板。
包含标签、保存按钮和空状态，使用虚构数据。
只写这个演示文件，并说明如何预览。
```

核对 Skill 被实际调用或读取、来源正确，并打开生成文件。这个插件通过 Skill 工作，不要求一定出现单独的斜杠命令。决定整合前，把演示文件与正式应用分开。

## 启用、查看和卸载

点击已安装插件可以查看它提供的能力。关闭开关可停用，再用新会话检查；需要移除时点击**卸载**，再确认一次。

1.1.22 面板提供安装、启停和卸载，没有独立更新按钮。更新应在同一 Claude CLI 环境使用对应操作，重新加载运行时后核对版本和能力。

## 常见问题

| 现象             | 下一步                            |
| -------------- | ------------------------------ |
| 没有市场或搜索为空      | 在同一 Claude 环境注册并下载官方目录，再重开浏览列表 |
| 安装报错           | 阅读界面错误，核对网络和完整 `名称@市场` 标识      |
| 已安装但没用到        | 检查开关和 Skills 列表，然后新建会话         |
| 插件包含 MCP，但工具失败 | 打开相应服务器，检查地址、凭据和连接条件           |

## 下一步

学习 [Skills](https://onevium.com/zh/docs/skills)、连接 [MCP](https://onevium.com/zh/docs/mcp-servers)，或用[操作技巧](https://onevium.com/zh/docs/workflows/tips)区分内置工具与安装的能力。