从插件页面安装
点按插件页面上的添加:
你添加的内容位于 Enconvo 标签页顶部的已安装中:按名称列出你已连接的连接器以及你安装或制作的插件。点按已安装即可查看全部。Enconvo 自带的插件不会列在其中。PopBar 扩展有自己的 PopBar 标签页,其中是经 Enconvo 审核的目录;参见 PopBar 扩展。
从 GitHub 添加
粘贴插件所在的位置,然后按预览:owner/repo,或 GitHub 链接,包括指向某个文件夹的链接(/tree/<branch>/<folder>)- 仓库中的插件写作
owner/repo/folder,可加@branch或@tag固定版本 - 任意 https git 地址
npm:<package>,可加@version固定版本- 指向插件
.zip的 https 链接 - 你 Mac 上的一个文件夹
enconvo plugin install 命令,让你在终端中运行。
从聊天中安装
当你让 Enconvo 的智能体做你现有插件做不到的事时,它可以在你 Mac 上的插件市场中查找插件:包括你在 Enconvo 中添加的插件市场,以及 Codex 或 Claude Code 拥有而 Enconvo 尚未添加的插件市场,其中包括 Codex 自带的 OpenAI Curated 插件市场(参见在 Codex 或 Claude Code 中添加的插件市场)。它读取的是这些插件市场目录在你 Mac 上已有的副本,查找期间不会下载任何内容。它会排除你已安装的插件,以及与你从其他地方安装的插件同名的插件。 找到后,智能体会在聊天中显示一张卡片,在你点按安装之前不会安装任何内容:- 如果来自你在 Enconvo 中添加的插件市场,卡片会说明插件会在你的 Mac 上启动或连接到哪些 MCP 服务器、它的技能,以及它依赖的其他插件。
- 如果来自只有 Codex 或 Claude Code 才有的插件市场,卡片会说明安装时会把该插件市场添加到 Enconvo。在此之前 Enconvo 无法读取插件的内容,因此卡片无法列出它们。
来自 ChatGPT 的插件
ChatGPT 插件目录中的插件无法安装到 Enconvo。其中大多数是 ChatGPT 应用,只能在 ChatGPT 中运行;其余的则由 OpenAI 仅提供给 ChatGPT 和 Codex。如果你在 Mac 上登录了 Codex,智能体可以通过 Codex 保存的副本了解该目录。当你说出其中某个插件的名称或粘贴它的 chatgpt.com 链接时,智能体会告诉你为什么无法安装,并推荐功能相同的替代品:连接器、MCP 服务器、技能,或你某个插件市场中的同名插件。该目录中许多附带文件的插件,在 OpenAI Curated(Codex 自带的插件市场,即 OpenAI 的公开仓库openai/plugins)中也有同名插件。智能体会推荐该插件,安装它会把 OpenAI Curated 添加到 Enconvo。Enconvo 不会加载这些插件包含的 ChatGPT 应用,只会加载它们的技能和 MCP 服务器。
chatgpt.com 链接在从 GitHub 添加中同样无效,对话框也会给出同样的说明。
从命令行安装
plugin install 可以从 GitHub、git、npm、网上的 zip、文件夹或插件市场获取插件。需要 Enconvo 2.5.6 或更高版本正在运行。
plugin install 和 plugin marketplace 需要高于 0.1.174 的 @enconvo/api 版本。在依赖 @enconvo/api 的项目中,只需运行 npx enconvo …。marketplace import 还需要 Enconvo 2.5.7 或更高版本。--preview 可以查看将要安装什么以及来自哪里,而不实际安装。
如果来源是插件市场而不是插件,plugin install 会列出其中的插件。插件超过 200 个的插件市场只列出前 200 个,并说明还有多少个;plugin marketplace add 会列出全部。用 --plugin 选择一个,这也会添加该插件市场:
安装时会发生什么
- 设置:有必填设置(例如 API 密钥)的插件会先安装,然后要求你填写。
plugin install会列出这些设置;请在插件页面上填写。 - 从源代码安装 Enconvo 插件:当 GitHub 仓库或文件夹中是一个尚未构建的 Enconvo 插件时,
plugin install会先构建它。文件夹会在运行npm install后原地构建。 - 引导:如果插件指定了引导技能,Enconvo 会在首次安装后提议运行它。
- 登录:当插件的 MCP 服务器需要你登录时(例如 Notion 和 Figma 的服务器),插件页面会在安装后立即显示登录。Enconvo 会在浏览器中打开该服务器的登录页面,并在它连接成功后提示下一个服务器。
plugin install则会列出这些服务器。你跳过的登录会在设置 → MCP 服务器中等待处理。 - 钩子:插件的钩子在安装时处于关闭状态,因为它们会运行命令。
--preview会列出它们;用插件页面上的允许钩子开关允许它们。你允许过的钩子,在不改变它们的更新之后仍保持开启。 - 依赖:当来自插件市场的 Claude Code 插件需要其他插件时,Enconvo 会一并安装它们(参见插件市场)。
--preview会列出这些依赖,并说明哪些已安装、哪些将要安装、哪些无法安装。如果插件市场条目声明的依赖来自未被允许的插件市场,安装会停止;如果是插件自身的plugin.json声明的,则会略过该依赖,安装继续进行。它们的钩子保持关闭;卸载插件后它们仍会保留,直到你清理(参见卸载)。 - 使用:与 Codex 一样,在聊天中输入
@并选择插件,或点按插件页面上试着提问下的某个提示。无论哪种方式,聊天都会附加该插件。所有已安装的插件都在@菜单中,包括未指定类别的 Codex 或 Claude Code 插件。 - 同名:从同一来源再次安装会更新插件。如果已经从其他地方(例如商店)安装了同名插件,Enconvo 会保留它不动,并请你先将其卸载。
plugin install 仍可以通过构建的方式从 GitHub 安装 Enconvo 插件。其他情况请打开 Enconvo 后重试。
插件市场
插件市场是存放在仓库或文件夹中的插件目录。Enconvo 能读取两种格式:Codex 的.agents/plugins/marketplace.json 和 Claude Code 的 .claude-plugin/marketplace.json。
refresh 也可以写成 upgrade(Codex 的叫法)或 update(Claude Code 的叫法),--ref v2 等同于 acme/plugins@v2。
在插件页面上,打开添加 → 从 GitHub 添加…并粘贴插件市场的地址,或在你的插件市场下选择一个已添加的插件市场。
对于来自 GitHub 或 git 的插件市场,Enconvo 会保存一份副本;对于文件夹中的插件市场,则直接在原处读取。移除插件市场后,你从中安装的插件会保留。
在 Codex 或 Claude Code 中添加的插件市场
如果你在这台 Mac 上的 Codex 或 Claude Code 中添加过插件市场,或者 Codex 已获取其 OpenAI Curated 插件市场,marketplace list 会显示 Enconvo 尚未添加的那些,import 会添加它们,你无需再次输入地址:
~/.codex/config.toml、它的 OpenAI Curated 副本和个人的 ~/.agents/plugins/marketplace.json 中,以及 Claude Code 的已知插件市场列表中查找它们。它只读取这些文件,不会更改两个应用中的任何内容。OpenAI Curated 从 GitHub 上的 openai/plugins 添加。它会略过 Codex 自带的其他插件市场(其中是 Codex 自身工具的插件),以及通过 marketplace.json 文件网址添加的 Claude Code 插件市场(Enconvo 不添加这类插件市场)。如果两个应用中有同名的插件市场,它会提供 Codex 的那个。
OpenAI Curated 等 Codex 插件市场只列出每个插件的名称和来源。对于位于插件市场自身文件夹中的插件,Enconvo 会像 Codex 一样,显示插件清单中的标题、描述、类别和开发者;智能体除了按名称,也能按功能找到它。插件市场条目本身的内容优先。
OpenAI Curated 中的部分插件(例如 Gmail、Google Drive、Outlook 和 Teams)只有在用 ChatGPT 登录 Codex 时才能使用,因此 Codex 不会向使用 API 密钥登录的用户提供它们。Enconvo 也不会登录 ChatGPT,因此会将它们显示为需要 ChatGPT 登录,不会安装它们,智能体也不会推荐它们。对于这些服务,请改为添加服务商自己的 MCP 服务器或连接器。
插件市场中插件的来源
插件市场中的插件可以来自插件市场中的文件夹、另一个 GitHub 仓库、git 地址、git 仓库中的文件夹、npm,或网上的 zip(Claude Code 的archive 来源)。被 Codex 插件市场标记为 NOT_AVAILABLE 的插件无法安装。
写作 ./plugins/notes 的文件夹来源从插件市场的根目录读取。像 notes 这样的纯名称则从 metadata.pluginRoot 指定的文件夹读取(与 Claude Code 相同),并且需要该字段。
从 GitHub、npm 或网上下载最多可能需要三分钟;如果超时,Enconvo 会停止下载,并请你检查网络连接。
zip 无论是你粘贴的链接还是插件市场列出的,都只能从公开的 https 地址下载,且最多经过五次重定向。如果插件市场提供了 sha256,校验不匹配的下载会被拒绝。插件可以位于 zip 的根目录,也可以位于其中的某个文件夹内。
Claude Code 插件市场条目
Claude Code 插件市场条目与插件自身plugin.json 的配合方式,与 Claude Code 的读取方式相同:
- 条目可以在插件自身的基础上添加
commands、agents、skills、outputStyles和themes,其hooks会替换插件中相同事件的钩子。 - 如果条目设置了
"strict": false,同时又列出了上述任一项,而插件本身有plugin.json,则会因清单冲突而被拒绝。请把它们放在同一处。 - 如果插件没有
plugin.json,条目就是它的清单。 - 显示的是条目中的名称、描述、作者和其他列表信息;版本则取自插件本身。
- 会遵循插件市场的
renames。以旧名称安装的插件会以新名称继续更新,按旧名称安装也能找到它。被重命名为null的名称表示已从插件市场中移除,Enconvo 会说明这一点。如果插件自身的清单也改了名称,Enconvo 会请你卸载旧插件并安装新插件,因为 Enconvo 按清单为插件命名。 - 插件的
dependencies(位于其条目或plugin.json中)会随插件一起安装。每项依赖可以是一个名称("formatter")、名称加插件市场("formatter@acme-tools"),两者都可以再跟一个^范围("formatter@acme-tools@^2.1"),也可以是带 semver 范围的{ "name", "marketplace", "version" }。依赖默认来自插件自身所在的插件市场,除非它指定了其他插件市场;而其他插件市场必须列在你安装所用插件市场的allowCrossMarketplaceDependenciesOn中。带version范围的依赖会安装该范围内(以及其他已安装插件对它设定的范围内)最高的发布标签(<plugin>--v<version>),标签取自插件自身的仓库;对于插件市场内部的插件,则取自插件市场的仓库(位于 git 仓库中的插件市场文件夹也算)。如果没有这样的标签,插件市场内部的插件会按插件市场中的现状安装,而位于独立仓库中的插件会被拒绝。如果没有任何单一版本能同时满足各个范围,安装会被拒绝,更新也会保持在范围之内。已安装的依赖会保持原样,超出其version范围的依赖会收到警告。
分享前检查插件市场
在分享插件市场之前,请检查它以及其中的每个插件。规则与claude plugin validate 所用的一致,对于 .agents/plugins/marketplace.json,还会加上 Codex 的规则;参见校验代码。错误表示 Claude Code 无法添加该插件市场或安装该插件,即使它可能仍会列出:例如条目中某个字段的类型错误、renames 指向不存在的插件、它拒绝的 relevance 信号,或者插件市场名称看起来像 Anthropic 自己的名称(例如 claude-plugins-hub)。警告涵盖 Claude Code 会忽略的内容(例如拼错的字段),以及 Claude Desktop 会拒绝的名称。
更新
Enconvo 的插件更新检查也涵盖从 GitHub、git、npm、文件夹和插件市场安装的插件,并将它们的更新与商店插件的更新一起列出。它会读取仓库的最新提交而无需下载、向 npm 查询最新版本、留意已安装的文件夹是否有变化;对于插件市场用sha256 固定的 zip,则留意该固定值是否变化。更新会从同一来源重新安装插件。
要检查单个插件,请打开其页面,在 ⋯ 菜单中选择检查更新。如果有新版本,在出现的消息中点按更新。
也可以像 Claude Code 中的 claude plugin update 一样,在终端中更新:
卸载
可以在插件页面上通过插件的菜单或其页面卸载插件(会先请你确认),也可以在终端中卸载:claude plugin prune 相同。你自己安装的插件永远不会被清理;你自己再次安装某个依赖后,它就算作你自己安装的。在终端中,Enconvo 会列出将要移除的内容并先询问你;添加 -y 可跳过询问,--prune 在无法询问时需要它。插件页面上的卸载暂时不会清理依赖。
发布你自己的插件
要在 Enconvo 商店上架插件,请参见插件商店指南。要发送任何人都能安装的链接,请点按插件页面上的 分享…;参见分享插件。如果不通过 Enconvo 分享,可将其推送到 GitHub 或插件市场,其他人就可以用 从 GitHub 添加… 或上述命令安装。标记发布版本
plugin tag 会用名为 <plugin>--v<version> 的 git 标签标记你要发布的提交,与 claude plugin tag 相同。当其他插件的依赖要求某个版本范围时,Claude Code 和 Enconvo 会在这些标签中选择;任何人也都可以用 Enconvo 安装该发布版本,例如 acme/plugins/notes@notes--v1.2.0。
1.2.0)。打标签前,plugin tag 会像 plugin validate 一样检查插件;如果插件市场条目中的版本不同、插件文件夹中有未提交的文件,或标签已存在,它就会停止。发布新版本时请提升版本号;--force 则会移动已有的标签。它对 Codex、Claude Code、可移植和 Enconvo 插件一视同仁,因此安装包中的每个清单都必须写明相同的版本。-m 设置标签信息(%s 代表版本),--remote 设置 --push 推送到的远程仓库。与 plugin install 一样,它需要高于 0.1.174 的 @enconvo/api 版本。