HQY

一个CodexApp的增强工具

hqy 发表于2026-07-29 14:41:45 浏览196 评论0

Codex++

Codex++ 图标 https://github.com/Cayre1021/CodexPlusPlus

Codex++ 是一个面向 Codex App 的外部增强启动器。它不修改 Codex App 原始安装文件，而是通过外部 launcher 启动 Codex，并使用 Chromium DevTools Protocol 向渲染进程注入增强脚本。

功能

当前功能：

在会话列表悬停显示“删除”按钮
删除前确认，支持撤销
优先尝试服务端删除；不可用时删除本地 Codex SQLite 会话记录
在顶部菜单栏加入 Codex++ 菜单
支持开关：

插件选项解锁
特殊插件强制安装
会话删除

支持 Windows 快捷方式安装/卸载
支持 macOS 生成 /Applications/Codex++.app

痛点

API Key 登录模式下，Codex 原生插件入口会提示需要登录 ChatGPT，导致插件功能无法正常使用：

同时，Codex 原生会话列表只有归档入口，没有真正的删除按钮：

解决效果

Codex++ 启动后会解锁插件入口，并在会话列表悬停时显示删除按钮：

顶部菜单栏会出现 Codex++，点击后可以打开配置界面：

讨论交流

欢迎扫码加入 Codex++ 交流群，反馈问题、交流使用体验或提出新功能建议：

友情链接

LINUX DO

工作方式

Codex++ 使用外部启动方式运行 Codex：

启动 Codex App，并附加：

--remote-debugging-port=9229
--remote-allow-origins=http://127.0.0.1:9229

启动本地 helper 服务，用于删除/撤销会话。
通过 CDP 注入 renderer-inject.js。
渲染端通过 CDP bridge 与本地 helper 通信，避免被 Codex 页面 CSP 拦截。

这种方式不会修改 Codex 的 app.asar，也不需要往 Codex 安装目录写 DLL。

环境要求

Python 3.11+
Windows 或 macOS
已安装 Codex App

安装依赖：

python -m pip install -e .

如需运行测试：

python -m pip install -e .[test] python -m pytest -q

Windows 使用

图形菜单安装/卸载

双击项目根目录的：

setup.bat

然后按菜单选择：

[1] Install Codex++ [2] Uninstall Codex++ [3] Exit

命令行安装

在项目目录执行：

python -m codex_session_delete setup

安装后会在桌面生成：

Codex++.lnk

双击该快捷方式启动 Codex++。

命令行卸载

可以在系统“设置 → 应用 → 已安装的应用”里卸载 Codex++。

也可以在项目目录执行：

python -m codex_session_delete remove

如需同时删除 Codex++ 自己的日志和备份数据：

python -m codex_session_delete remove --remove-data

macOS 使用

安装

python -m codex_session_delete setup

默认会自动查找 /Applications/Codex.app、/Applications/OpenAI Codex.app 或用户 Applications 目录下的 Codex 应用，并生成：

/Applications/Codex++.app

卸载

python -m codex_session_delete remove

直接启动

不安装快捷方式时，也可以直接运行：

python -m codex_session_delete launch

常用参数：

python -m codex_session_delete launch \   --app-dir "/Applications/OpenAI Codex.app" \   --debug-port 9229 \   --helper-port 57321

Windows 也可以手动指定 Codex 安装目录：

python -m codex_session_delete launch \   --app-dir "C:/Program Files/WindowsApps/OpenAI.Codex_xxx/app" \   --debug-port 9229 \   --helper-port 57321

数据与备份

Codex++ 默认读取 Codex 本地数据库：

~/.codex/state_5.sqlite

删除前会把相关记录备份到：

~/.codex-session-delete/backups

隐藏启动失败日志位于：

~/.codex-session-delete/launcher.log

Windows 自动接管（可选）

默认情况下 Codex++ 只在你从 Codex++ 快捷方式启动时生效。如果你从开始菜单、任务栏或系统原生入口直接启动 Codex，那一次不会有注入，Codex++ 菜单和插件解锁都不会出现。

Windows 可以注册一个常驻 watcher 解决这个问题。它会每 3 秒探测一次本机 CDP 端口，发现 Codex 在跑但 CDP 没起来，就把这一批 Codex 进程杀掉、通过 launcher 重拉一次带注入的版本。这样不管你从哪里打开 Codex，都会被自动接管。

注意代价：

每次 Codex 通过原生路径启动，都会先打开一瞬间，再被 kill，再被 launcher 带 CDP 重开。视觉上是 1 ~ 2 秒的“打开→关闭→重开”闪烁。
watcher 以 pythonw.exe 常驻运行，登录时自动启动（通过 HKCU\...\Run 和 Startup 文件夹双路径注册，后者防止某些注册表清理工具干扰）。

安装

python -m codex_session_delete watch-install

安装完成后 watcher 会立即启动，无需重启。

卸载

python -m codex_session_delete watch-remove

remove / 系统卸载 Codex++ 时会自动连带执行 watch-remove，不需要手动处理。

临时开关

保留自启项、但让 watcher 不再自动接管：

python -m codex_session_delete watch-disable python -m codex_session_delete watch-enable

日志

%USERPROFILE%\.codex-session-delete\watcher.log

示例：

[...] watcher started (interval=3.0s) [...] Codex running without CDP (pids=[...]); attempting takeover [...] takeover: killing 4 codex pid(s): [...] [...] takeover: CDP is up on 9229 (launcher pid=...)

常见问题

双击 Codex++ 没反应

先查看日志：

%USERPROFILE%\.codex-session-delete\launcher.log

常见原因：

Codex App 没有安装或路径变化
9229 端口被占用
Python 环境不可用

Codex++ 菜单没出现

确认是从 Codex++ 快捷方式启动，而不是直接启动原版 Codex。

也可以检查 Codex 是否带了 CDP 参数：

--remote-debugging-port=9229

Windows 系统卸载失败

请先更新到当前版本后重新安装一次：

python -m codex_session_delete setup

新版会写入稳定的系统卸载项，并使用绝对 Python 路径执行卸载。

开发

运行测试：

python -m pytest -q

项目结构：

codex_session_delete/   cli.py                 CLI 入口   launcher.py            启动 Codex 并注入脚本   cdp.py                 CDP 通信与 bridge   helper_server.py       本地 helper 服务   storage_adapter.py     本地 SQLite 删除/撤销   windows_installer.py   Windows 快捷方式与卸载项   macos_installer.py     macOS app bundle 安装   watcher.py             Windows 常驻 watcher（可选，原生启动接管）   inject/renderer-inject.js tests/                   自动化测试