用途：codex-plusplus 是 Codex 桌面应用（Electron）的补丁注入系统。它修补 app.asar、注入加载器桩，并从用户目录运行可热重载的运行时。补丁是带 manifest 与 start/stop 生命周期的小型 ESM 模块，无需重新构建应用。
安装：macOS 可用 brew install b-nnett/codex-plusplus/codexplusplus 后执行 codexplusplus install；也可 bun install -g github:b-nnett/codex-plusplus；macOS/Linux 源码引导用 curl -fsSL https://raw.githubusercontent.com/b-nnett/codex-plusplus/main/install.sh | bash；Windows 用 irm https://raw.githubusercontent.com/b-nnett/codex-plusplus/main/install.ps1 | iex。安装器会定位应用、备份原始文件、修补 app.asar、重算 asar 头 SHA-256 写入 Info.plist、调整 Electron Framework 中的校验开关、在 macOS 重新 ad-hoc 签名并安装自动修复的启动代理。
主要能力与用法：提供 install、status、doctor、repair、update、update-codex、uninstall 等命令，以及 tweaks list、tweaks open 管理补丁。补丁目录含 manifest.json（必填 id、name、version、githubRepo、author、description、minRuntime）与 index.ts/js/mjs，导出含 start 与 stop 的默认对象。API 提供日志、设置面板注册、storage 持久化、dom.waitFor 监听元素、onStop 清理回调。配置可用 autoRepair、autoUpdateRuntime 与各补丁启用状态。带 githubRepo 的补丁每日检查 GitHub Releases，仅提示更新不自动下载。
适用场景与限制：适合为 Codex 桌面端注入 UI 改进、快捷键与自定义功能。补丁在渲染进程运行，权限与应用自身渲染代码相同；Codex++ 不自动更新补丁代码。macOS 首次启动可能需 xattr -cr /Applications/Codex.app；Codex 更新后由启动代理修复，必要时用 codexplusplus repair。更多细节见 docs/WRITING-TWEAKS.md 与 SECURITY.md。