SuperAPI AI 工具集

pluginstaller

编程与开发

查看项目

更新于 10-16 05:00

技能介绍

用途:当用户给出一个 Codex 插件的 GitHub 仓库并希望它在 Codex 中可用时使用。需遵循当前 Codex 插件文档,不要自创其他安装流程。

输入:GitHub 仓库 URL 或 owner/repo;安装范围(repo 或 personal)。若仓库包含多个插件根目录,需询问安装哪个插件文件夹。

工作流:用户未指定 repo 级还是 personal 级时先停下询问。拉取仓库,通过查找 .codex-plugin/plugin.json 定位插件根目录,并校验其规范结构:name、version、description 应存在;skills、apps、mcpServers 等打包路径应相对于插件根目录并以 ./ 开头;.codex-plugin/ 内只应放 plugin.json。若任务是搭建新的本地插件或把已有本地插件加入 marketplace,优先使用内置 @plugin-creator 技能;手动路径用于接入用户已提供的仓库。

将整个插件目录(而非仅 SKILL.md)复制到 marketplace 可见位置。默认使用文档标准位置:repo 为 $CWD/plugins/<plugin-name> 与 $CWD/.agents/plugins/marketplace.json;personal 为 ~/.codex/plugins/<plugin-name> 与 ~/.agents/plugins/marketplace.json。保留插件根目录下的完整包,包括同级 skills/、.app.json、.mcp.json、assets/ 等,不要把这些文件移到 .codex-plugin/ 下。

创建或更新 marketplace 文件,包含顶层 marketplace name、可选 interface.displayName、插件条目 name、source.source = "local"、相对 marketplace 根的 source.path(repo 为 ./plugins/<plugin-name>,personal 为 ./.codex/plugins/<plugin-name>)、policy.installation、policy.authentication、category。默认 policy.installation = "AVAILABLE",policy.authentication = "ON_INSTALL",category 取 interface.category,否则用 Productivity。合并进已有 marketplace 文件而非替换。重启 Codex 并在 /plugins 中验证插件出现。

运行时行为:marketplace 条目指向源插件目录;Codex 将插件安装到 ~/.codex/plugins/cache/<marketplace>/<plugin>/<version>/;本地插件的缓存版本为 local;启用或禁用状态存于 ~/.codex/config.toml。

规则:优先使用 repo marketplace 与 personal marketplace 术语;不要把复制到 plugins/ 当作完整安装,marketplace 条目才使插件可被发现;不要扁平化或重命名插件包;保持插件名在文件夹、清单和 marketplace 条目中一致;路径保持相对且按文档要求以 ./ 开头;文档中的 repo 与 personal 插件目录是默认值而非绝对要求,只要 source.path 有效且位于 marketplace 根内;若仓库已带 marketplace 文件,以其为 marketplace 顺序与元数据的准绳,只增改所需插件条目;若清单缺少必需基础项或使用无效的根相对路径,先修复结构再声称安装完成。

范围指南:插件应随某个仓库存在或通过该仓库 marketplace 共享时用 repo;插件应在用户自己的 Codex 设置中跨项目可用时用 personal。