用途:把开发中的 Codex 插件接入 Codex 文档化的本地插件安装面,适用于本地 Codex 插件开发工作流。不发布插件、不管理官方插件目录,也不对 Codex 已安装插件缓存内部作未文档化的控制。
主要能力:支持 install、update、uninstall、verify、repair、enable、disable、promote 动作;范围可选 personal(默认)或 repo;安装模式默认 copy,也可 symlink;可先用 check-only 规划再 apply。personal 目标为 ~/.codex/plugins/<plugin-name> 与 ~/.agents/plugins/marketplace.json,repo 目标为 $REPO_ROOT/plugins/<plugin-name> 与 $REPO_ROOT/.agents/plugins/marketplace.json。personal 安装默认在 ~/.codex/config.toml 写入 enabled = true。
用法:核心脚本为 scripts/install_plugin_to_socket.py,配合 uv run python 调用。例如个人安装:uv run python skills/install-plugin-to-socket/scripts/install_plugin_to_socket.py --source-plugin-root plugins/agent-plugin-skills --action install --run-mode apply;仓库范围安装加 --scope repo --repo-root /path/to/target-repo;校验用 --action verify --run-mode check-only --print-md。修改操作要求源为包含 .codex-plugin/plugin.json 的插件根。
限制:不管理项目级 .codex/config.toml 覆盖;暂存目标为原地替换语义,备份与存在即失败变体尚未提供;仓库范围可见性仅限拥有 .agents/plugins/marketplace.json 的仓库;应用后需重启 Codex 验证;不用于发布插件,也不涉及 Claude 插件接线。