插件市场与团队分发

市场是 JSON 插件目录，可先容纳一个测试插件，再扩展成团队清单。它与 ChatGPT/Codex 的公开插件目录是不同的分发入口。

本地市场

仓库市场位于 $REPO_ROOT/.agents/plugins/marketplace.json，个人市场位于 ~/.agents/plugins/marketplace.json。下面的目录项指向仓库根下的 plugins/my-plugin：

{
  "name": "local-repo",
  "plugins": [{
    "name": "my-plugin",
    "source": { "source": "local", "path": "./plugins/my-plugin" },
    "policy": { "installation": "AVAILABLE", "authentication": "ON_INSTALL" },
    "category": "Productivity"
  }]
}

source.path 相对市场根解析，不相对 .agents/plugins/ 目录解析；以 ./ 开始并保持在根内。每个目录项都应包含 installation、authentication 与 category。市场显示名称可用顶层 interface.displayName。

添加 Git 或本地来源

codex plugin marketplace add owner/repo --ref main
codex plugin marketplace add ./local-marketplace-root
codex plugin marketplace list
codex plugin marketplace upgrade marketplace-name
codex plugin marketplace remove marketplace-name

把示例名称换成真实市场。来源可为 GitHub shorthand、HTTP(S)/SSH Git URL 或本地根目录；--ref 固定 Git 引用，--sparse 可重复但仅用于 Git 来源。list 也显示隐式发现的本地默认市场和已配置快照。

目录项还可用 url、git-subdir 指定 Git 包来源，或 npm 来源。npm 分发需要 npm CLI，认证来自其配置，下载不运行生命周期脚本。registry 必须为无嵌入凭据、查询或 fragment 的 HTTPS URL。

安装缓存与启停

桌面安装到 ~/.codex/plugins/cache/$MARKETPLACE_NAME/$PLUGIN_NAME/$VERSION/；本地插件版本目录为 local，实际加载缓存副本。修改开发目录后，更新目录项所指文件并重启桌面应用以加载本地更新。

项目可用以下配置启停本地市场插件：

[plugins."my-plugin@local-repo"]
enabled = true

false 表示停用，不代表卸载；刷新市场时仍可能安装或更新相关文件。项目配置只在项目受信任时加载。此设置不改变通过 Admin > Plugins 导入的工作区安装策略。

工作区发布边界

发布到工作区不等于发布到公开目录。官方本地插件发布流程要求工作区管理员，选择 Personal 中的插件后 Publish，并指定可访问角色。外部连接仍要单独认证；仅能看到插件不代表可以访问连接服务的数据。