跳转到正文

使用插件 / 构建插件 ​

为您使用的客户端安装包,或创建包含操作说明和工具配置的可移植 Agent Plugins 1.0 包。

使用插件 ​

安装 Node.js 22 或更高版本后,运行:

bash
npx universal-agent-plugins add context7

CLI 会询问所选兼容客户端,并报告剩余激活步骤。也可先检查和预览:

bash
npx universal-agent-plugins info context7
npx universal-agent-plugins add context7 --target codex,cursor --dry-run

原生安装指南提供 macOS、Linux 和 Windows 可执行文件。 原生管理器不需要 Node.js,但插件可能需要自己的运行时。

CLI保留显式项目范围和 0.1.94 引入的自动安装选择,并新增本地管理 API和Pi 扩展、Skills 和 MCP。预览将包添加到项目:

对于符合条件的已审核目录条目,如果目标客户端支持所有必需组件,已发布的 CLI 可使用签名 Directory 短名称和显式项目范围(例如 agentplugins add context7 --target codex --scope project --dry-run)。如需固定可复现的来源,也可以使用完整提交 SHA 的 Git 来源及兼容客户端。将 OWNER/REPOSITORY、FULL_COMMIT_SHA 和 PACKAGE_PATH 替换为真实值;如果包位于仓库根目录,请省略 //PACKAGE_PATH。

语法模板:github:OWNER/REPOSITORY@FULL_COMMIT_SHA//PACKAGE_PATH。下面的命令使用一个真实的 GitLab 历史提交,并不代表该版本目前仍通过目录审核。实际安装时请从目录复制当前已审核的固定来源。

bash
npx universal-agent-plugins add github:777genius/universal-agent-plugins@2ddbb99dd190c1792b79904f9875e6322bccd243//plugins/gitlab --target codex --scope project \
  --project-root /path/to/project --dry-run

选择已存在的项目目录。add 和维护命令默认使用用户范围,应明确指定项目范围。 未指定来源参数的 install 则在当前目录存在普通 uap.toml 时自动选择项目,不向上查找;显式范围优先,已有锁文件会被严格检查。

各分发渠道的版本可能不同。使用 0.1.94 的自动项目选择前,先运行 agentplugins version 或 npx universal-agent-plugins version。若所选渠道仍较旧,可使用原生安装器, 或使用 0.1.93 已支持的完整 SHA 固定 Git 来源项目命令;签名 Directory 短名称的项目安装需使用当前稳定版 CLI。

检查计划后再去掉 --dry-run。写入包文件不等于客户端已发现、授予信任、完成认证或成功调用 MCP。

完整安装流程 · 客户端兼容性与测试边界

恢复已保存的依赖集合 ​

先检查所选用户环境的记录:

bash
npx universal-agent-plugins deps status

对于已保存的 uap.toml / uap.lock,在交换文件夹导出:

bash
npx universal-agent-plugins deps export

将该文件夹复制到另一台机器,安装目标客户端,再在该目录运行:

bash
npx universal-agent-plugins deps import
npx universal-agent-plugins install --locked --scope user

只转移经过验证的清单和锁文件;配置目录、设置、凭证、收据和插件数据需要单独处理。 安装仍需确切来源或已验证缓存。项目应提交这两个文件,并以显式 install --locked --scope project 恢复。 维护与恢复说明恢复和转移细节。

构建插件 ​

标准包从根目录 plugin.json 开始,可包含 skills/<name>/SKILL.md、mcp.json 或两者。 可以手动编写文件,再使用已发布安装器验证:

bash
npx universal-agent-plugins validate ./my-plugin
npx universal-agent-plugins add ./my-plugin --target codex --dry-run

这些例子假设 ./my-plugin 已经是完整包。构建指南提供手动技能包示例和源码骨架工具的步骤。

创作工具可用性: 当前 npm 和原生安装器不包含 agentplugins author。 当前源码实现了骨架、静态检查、显式 MCP 运行检查、开发周期、依赖 bootstrap 和 JSON 维护。 这些命令需先从源码构建。旧版创作发布证据仍只对应其原始版本,不能说明当前下载可用功能。

静态验证不证明运行、OAuth 或激活。MCP 传输支持也因客户端而异;例如 Codex 不支持声明为 SSE 的 MCP。 请在 README 中保留前提条件和待完成检查。

Agent Plugins 1.0 规范

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