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

---

# 安装、启用和检查插件

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

## 可以安装什么

插件把 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)。

## 打开插件管理

点击左侧导航的**插件**，在同一页面切换**插件、技能、MCP**。安装或修改前，先用作用范围选择器选中具体项目或**个人 · 所有项目**。个人插件可以跨项目使用，除非在项目中停用；选中项目不代表所有继承能力都会消失。

Claude Code 市场整合在**插件**标签页中。在 **Claude Code 插件**区域点击**浏览 marketplace**。该区域沿用现有 Claude 环境，独立于上方的项目范围选择器；仍需核对已安装条目的**作用域**，不能默认仅本项目可用。

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

## 安装 Frontend Design

1. 在**插件市场**点击\*\*搜索插件…\*\*图标，搜索 `frontend-design`。
2. 确认来源为 `claude-plugins-official`、作者为 Anthropic。完整标识是 `frontend-design@claude-plugins-official`。
3. 点击**安装**，再点击**返回插件**，确认它出现在 **Claude Code 插件**区域。
4. 打开详情，核对**来源、作用域、Skills**，未启用时打开开关。
5. 在小型前端项目中新建会话，让运行时加载插件。

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

## 官方市场没有出现时

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

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

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

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

## 实际调用一次

在新会话发送：

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

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

## 启用、查看和卸载

在统一插件中心打开插件，核对来源、版本、所含能力和当前作用范围，再按范围启用或停用。**从此范围移除**会移除该范围的选择，磁盘中的版本仍可能供其他项目和正在运行的任务使用。用新一轮任务验证变化；已有运行保留已加载的上下文。

出现可用更新时，先查看变化，再选择对当前范围执行更新。检查更新不会自动安装；更新保留原来的启用或关闭状态，正在运行的任务继续使用原版本。

本教程示例使用的 **Claude Code 插件**区域仍使用启停开关，以及需要确认的**卸载**操作。该区域没有独立的插件更新按钮，更新需在对应 Claude CLI 环境完成，再重新加载并核对版本。Claude Code 插件与中心内其他插件的范围和更新控制不同。

## 常见问题

| 现象             | 下一步                            |
| -------------- | ------------------------------ |
| 没有市场或搜索为空      | 在同一 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)区分内置工具与安装的能力。