使用插件
Universal Agent Plugins 为您选择的 AI 客户端安装标准包。包可以包含技能、MCP 服务器配置,或两者兼有。 您可以为用户账户安装,也可以将某个项目的依赖与用户环境分开管理。
获取 CLI
安装 Node.js 22 或更高版本后,可直接运行 npm 包装器:
npx universal-agent-plugins search docs经常使用时可全局安装:
npm install -g universal-agent-plugins
agentplugins version也可通过 Homebrew 安装:
brew install 777genius/agentplugins/agentplugins原生安装指南涵盖 macOS、Linux 和 Windows。 原生管理器不依赖 Node.js,但各插件可能需要运行时。本指南使用 agentplugins; npx universal-agent-plugins 可运行相同的安装器命令。
按步骤安装
- 查找并检查包,了解来源和前提条件。
- 使用
--dry-run预览目标客户端、安装范围和变更。 - 应用已检查的安装计划,并完成激活步骤。
- 使用 list、update、repair 和 remove 维护安装状态。
- 需要时从
uap.toml和uap.lock恢复共享依赖集合。
CLI是当前原生安装器,新增本地管理 API 和用户范围及符合条件的项目范围的 Pi 原生扩展。请参阅本地管理和Pi 兼容性。各分发渠道的版本可能不同,请先用 agentplugins version 确认;要获取已验证版本,可使用原生安装器。
显式项目范围从 0.1.93 起可用。多数命令默认使用用户范围。自 0.1.94 起,未指定来源参数或显式范围的 install 仅在当前目录存在普通 uap.toml 文件时选择项目,不搜索父目录。显式范围优先。针对项目的维护命令应明确指定 --scope project。已有锁文件会在安装或修复前严格验证;只有缺少锁文件时才允许首次解析并创建。各客户端的项目组件和激活要求不同。
分别查看每个目标的结果
安装后仍可能需要重新加载、工作区信任、手动激活或 OAuth。Prepared 表示仍有客户端步骤未完成。 请按目标查看结果,不要将整次操作完成等同于运行成功。兼容性参考说明版本化原生观察的证据范围。
如果您要编写包
从构建插件开始。交付物是包含根目录 plugin.json 及其组件的文件夹; 安装者不需要运行源码创作工具。
| 命令 | 用途 |
|---|---|
agentplugins validate ./my-plugin | 为安装读取并验证本地包。 |
agentplugins doctor | 诊断安装器管理的状态。 |
agentplugins author validate ./my-plugin | 在启用创作功能的源码构建中检查符合性和就绪情况。 |
agentplugins author doctor ./my-plugin | 在该源码构建中检查项目和工具链证据。 |
当前 npm 和原生安装器版本不包含 agentplugins author。