Codex实现Windows部署路径配置的实现

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

核心路径配置

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

C:Users<你的用户名>.agentspluginsmarketplace.json

例如，用户名为 dusha 时，完整路径为 C:Usersdusha.agentspluginsmarketplace.json 。

marketplace.json文件内容示例

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

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

关键配置说明：

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

重要注意事项与路径修正

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

1. 插件源码到底放在哪儿，往往是个很容易踩坑的细节：有些时候，marketplace.json 里写明的路径，和 Codex++ 真正去查找插件的路径并不是一回事。比如参考资料里就提到过，插件原先放在 .agentsplugins 目录下，但 marketplace 实际期待的却是 ~/plugins/（也就是 C:Users<用户名>plugins）这个位置。要是碰上插件加载失败，多半就得重点排查这一点：

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

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

   python C:Users<你的用户名>.codexskills.systemplugin-creatorscriptsupdate_plugin_cachebuster.py C:Users<你的用户名>pluginshyperframes
   

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

3. 插件安装这一步并不复杂。完成缓存的配置与更新后，直接在命令行里执行安装命令，同时带上前面定义好的本地市场名称（my-local-plugins）：
   bash codex plugin add hyperframes --marketplace my-local-plugins
   命令跑完之后，插件会安装到 ~.codexpluginscachemy-local-pluginshyperframes 这个目录下。