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": "AVAILABLE",        "authentication": "ON_INSTALL"      },      "category": "Design"    }  ]}

关键配置说明：

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

重要注意事项与路径修正

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

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

   1. 将插件文件夹（如 hyperframes）从 C:Users<用户名>.agentsplugins 复制到 C:Users<用户名>plugins。
   2. 或者，相应修改 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 目录下 。