公共文档
Agent Plugins
为您使用的 AI 智能体安装技能和 MCP 工具,或构建自己的可移植插件包。
选择您的路径
使用插件
检查来源、预览变更,然后为用户账户或单个项目安装插件。
构建插件
使用 plugin.json、技能和 MCP 配置编写标准包,并了解源码构建中的创作工具。
集成 UAP
Hooks、代理检测、Go 安装器与 TypeScript 管理。
UAP 的更多功能
- 为多个代理安装插件,添加独立 Skills,使用签名目录、Git/SSH 或归档来源。 安装.
- 通过
uap.toml/uap.lock隔离用户和项目;更新、修复和诊断状态。 管理. - 构建可移植的 Skills/MCP 包,并集成 Go 与 TypeScript SDK。 SDK · 构建.
安装第一个插件
安装 Node.js 22 或更高版本后,运行:
npx universal-agent-plugins add context7CLI 会询问要使用哪些兼容客户端。检查计划,并完成结果中列出的激活或登录步骤。 若想直接使用原生可执行文件,请阅读适用于 macOS、Linux 和 Windows 的 原生安装指南。原生管理器本身不需要 Node.js;插件可能有自己的运行时要求。
当前可用功能
CLI是当前原生安装器版本。新增本地管理 API,并在用户范围和符合条件的项目范围支持 Pi 扩展、Skills 及 stdio/Streamable HTTP MCP。签名目录中的 Pi 目标仍需独立的发布策略授权。请参阅本地管理和Pi 兼容性。
它保留显式项目范围和锁定恢复。多数命令默认使用用户范围。自 0.1.94 起,未指定来源参数的 install 仅在当前目录存在普通 uap.toml 文件时自动选择项目;显式范围优先。add 和维护命令需明确指定 --scope project。请参阅安装和维护。
各分发渠道的版本可能不同。先用 agentplugins version 确认版本;要获取当前稳定发布版,可使用原生安装器。自动项目选择要求 0.1.94 或更高;显式项目范围从 0.1.93 起可用。
当前安装器不包含 agentplugins author。构建指南同时说明手动编写标准包的方法和当前源码中实现的创作命令。 旧版创作工具的发布证据仍对应其原始版本,不能用于说明当前安装器下载包含哪些命令。
如何理解结果
包验证、文件安装、客户端发现、MCP 工具执行和服务认证是不同的检查。 安装文件成功后,客户端仍可能需要信任确认、重新加载或新建会话。 原生测试只覆盖记录中的客户端版本和平台,不能证明所有插件在所有智能体中都可用。