用途:为 Codex 桌面应用注入自定义功能、修复界面问题、管理扩展,无需重新构建应用。原理是给本地 Codex 安装打补丁以加载运行时,该运行时可发现并执行小型 ESM 模块(tweak),并具备 Electron 渲染进程的完整访问权限。
安装:macOS/Linux 可用 Homebrew 执行 brew install b-nnett/codex-plusplus/codexplusplus 再运行 codexplusplus install;或用源码引导脚本 install.sh;Windows 用 PowerShell 脚本 install.ps1;也可用 Bun:bun install -g github:b-nnett/codex-plusplus 后 codexplusplus install。安装器会备份 Codex.app、给 app.asar 打补丁、重签名(macOS)、安装随更新自动修复的监视器,并从 GitHub Releases 安装默认 tweaks。支持 --no-default-tweaks 与 --local 标志。
常用命令:status、doctor、repair、update、update-codex、create-tweak、validate-tweak、safe-mode(及 --off)、dev、uninstall。
创建 tweak:目录包含 manifest.json 与 index.js,manifest 需 id、name、version、githubRepo、minRuntime 等字段;tweak 导出 start(api) 与 stop(),可使用 api.log、api.config、api.settings 注册设置面板,并通过 DOM 操作或 MutationObserver 注入界面、监听聊天事件、绑定快捷键或注入 CSS。
分发与更新:把 tweak 文件放 GitHub 仓库,以 semver 标签发布 Release 并附上 .zip;用户将文件夹放入 tweaks 目录并在设置中启用。Codex++ 每日检查更新但由用户手动更新。
限制与安全:tweak 以完整 Electron 渲染进程权限运行,只应安装可信来源的代码并事先审查;安装涉及对应用打补丁与重签名,可能受 Gatekeeper 影响;Windows 需从开始菜单/桌面启动 Codex++,而非商店版快捷方式。部分平台与收费信息暂未提供。