在 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"
}
]
}
关键配置说明：
- "name": 本地插件市场名称，后续执行 codex plugin add 命令时需要明确指定该名称。
- plugins[].source.path: 该路径是相对于 marketplace.json 所在目录的相对路径。示例中的 "./plugins/hyperframes" 表示插件源码应放置在 C:Users<用户名>.agentspluginshyperframes 目录下 。
重要注意事项与路径修正
在实际部署 Codex++ 插件时，常见问题之一就是路径不一致，因此需要根据实际情况进行修正：
插件源码的实际存放位置，是 Windows 部署过程中非常容易出错的细节。有时 marketplace.json 中填写的路径，与 Codex++ 实际查找插件的目录并不完全一致。比如参考资料中提到，插件最初放在 .agentsplugins 目录下，但 marketplace 真正期望读取的却可能是 ~/plugins/（也就是 C:Users<用户名>plugins）这个位置。如果遇到插件无法加载或安装失败，建议优先检查这里：
- 将插件文件夹（如 hyperframes）从 C:Users<用户名>.agentsplugins 复制到 C:Users<用户名>plugins。
- 或者，直接修改 marketplace.json 中的 "path" 配置，使其指向正确的绝对路径或相对路径。
更新插件缓存：在修改 marketplace.json 配置文件或移动插件目录之后，需要让 Codex++ 重新加载插件缓存。可以使用 plugin-creator 技能附带的脚本：
python C:Users<你的用户名>.codexskills.systemplugin-creatorscriptsupdate_plugin_cachebuster.py C:Users<你的用户名>pluginshyperframes
执行完成后，脚本会更新插件版本号中的时间戳后缀，从而强制刷新缓存 。
插件安装步骤并不复杂。完成缓存更新和路径配置后，直接在命令行中执行安装命令，并带上前面定义好的本地市场名称（my-local-plugins）：
bash codex plugin add hyperframes --marketplace my-local-plugins
命令执行完成后，插件会被安装到 ~.codexpluginscachemy-local-pluginshyperframes 目录下。
