跳转到正文

使用插件 ​

Universal Agent Plugins 为您选择的 AI 客户端安装标准包。包可以包含技能、MCP 服务器配置,或两者兼有。 您可以为用户账户安装,也可以将某个项目的依赖与用户环境分开管理。

获取 CLI ​

安装 Node.js 22 或更高版本后,可直接运行 npm 包装器:

bash
npx universal-agent-plugins search docs

经常使用时可全局安装:

bash
npm install -g universal-agent-plugins
agentplugins version

也可通过 Homebrew 安装:

bash
brew install 777genius/agentplugins/agentplugins

原生安装指南涵盖 macOS、Linux 和 Windows。 原生管理器不依赖 Node.js,但各插件可能需要运行时。本指南使用 agentplugins; npx universal-agent-plugins 可运行相同的安装器命令。

按步骤安装 ​

  1. 查找并检查包,了解来源和前提条件。
  2. 使用 --dry-run 预览目标客户端、安装范围和变更。
  3. 应用已检查的安装计划,并完成激活步骤。
  4. 使用 list、update、repair 和 remove 维护安装状态。
  5. 需要时从 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。

面向插件作者和集成者的公共文档。