在 Windows 系统上部署 Codex++ 时，marketplace.json 文件的正确配置路径取决于您希望如何管理本地插件市场。核心路径通常位于用户的 .agents 目录下。

核心路径配置

根据参考资料，marketplace.json 的标准存放路径为：

C:\Users\<你的用户名>\.agents\plugins\marketplace.json

例如，用户名为 dusha 时，完整路径为 C:\Users\dusha\.agents\plugins\marketplace.json 。

marketplace.json 文件内容示例

该文件用于定义本地插件市场。一个典型的配置示例如下：

{
  "name": "my-local-plugins",
  "interface": {
    "displayName": "My Local Plugins"
  },
  "plugins": [
    {
      "name": "hyperframes",
      "source": {
        "source": "local",
        "path": "./plugins/hyperframes"
      },
      "policy": {
        "installation": "AVAILABLE",
        "authentication": "ON_INSTALL"
      },
      "category": "Design"
    }
  ]
}

关键配置说明：

• "name": 市场名称，在后续使用 codex plugin add 命令时需要指定。
• plugins[].source.path: 此路径是相对于 marketplace.json 文件所在目录的相对路径。示例中的 "./plugins/hyperframes" 意味着插件源码应放置在 C:\Users\<用户名>\.agents\plugins\hyperframes\ 目录下 。

重要注意事项与路径修正

在实际操作中，可能会遇到路径不匹配的问题，需要进行修正：

1. 插件源码的实际存放位置：有时，marketplace.json 中定义的路径可能与 Codex++ 实际查找插件的路径不一致。例如，参考资料中提到，插件原本放在 .agents\plugins\ 下，但 marketplace 期望它放在 ~/plugins/（即 C:\Users\<用户名>\plugins\）下 。如果遇到插件加载失败，您可能需要：

   • 将插件文件夹（如 hyperframes）从 C:\Users\<用户名>\.agents\plugins\ 复制到 C:\Users\<用户名>\plugins\。
   • 或者，相应修改 marketplace.json 中的 "path" 值，使其指向正确的绝对或相对路径。

2. 更新插件缓存：在修改 marketplace.json 或移动插件文件后，需要触发 Codex++ 重新加载插件缓存。可以使用 plugin-creator 技能自带的脚本：

   python C:\Users\<你的用户名>\.codex\skills\.system\plugin-creator\scripts\update_plugin_cachebuster.py C:\Users\<你的用户名>\plugins\hyperframes
   

   执行后，脚本会更新插件版本号的时间戳后缀，强制刷新缓存 。

3. 安装插件：配置并更新缓存后，通过命令行安装插件，并指定您定义的本地市场名称（my-local-plugins）：
   bash codex plugin add hyperframes --marketplace my-local-plugins
   插件将被安装到 ~\.codex\plugins\cache\my-local-plugins\hyperframes\ 目录下 。

参考来源

• Codex Codex++ windows环境部署
• VS2022插件安装原理与离线部署实战指南