# CodexPlusPlus
**Repository Path**: ArtfulCoder/CodexPlusPlus
## Basic Information
- **Project Name**: CodexPlusPlus
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-12
- **Last Updated**: 2026-05-12
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# Codex++
Codex++ 是一个面向 Codex App 的外部增强启动器。它不修改 Codex App 原始安装文件，而是通过外部 launcher 启动 Codex，并使用 Chromium DevTools Protocol 向渲染进程注入增强脚本。
## 目录
- [功能](#功能)
- [痛点](#痛点)
- [解决效果](#解决效果)
- [讨论交流](#讨论交流)
- [友情链接](#友情链接)
- [工作方式](#工作方式)
- [环境要求](#环境要求)
- [Windows 使用](#windows-使用)
- [图形菜单安装/卸载](#图形菜单安装卸载)
- [命令行安装](#命令行安装)
- [命令行卸载](#命令行卸载)
- [自动更新](#自动更新)
- [macOS 使用](#macos-使用)
- [安装](#安装)
- [卸载](#卸载)
- [直接启动](#直接启动)
- [数据与备份](#数据与备份)
- [常见问题](#常见问题)
## 功能
当前功能：
- 在会话列表悬停显示“删除”按钮
- 删除前确认，支持撤销
- 优先尝试服务端删除；不可用时删除本地 Codex SQLite 会话记录
- 在顶部菜单栏加入 `Codex++` 菜单
- 支持开关：
- 插件选项解锁
- 特殊插件强制安装
- 会话删除
- 支持 Windows 快捷方式安装/卸载
- 支持 macOS 生成 `/Applications/Codex++.app`
- 支持基于 GitHub Release 检查和更新 Codex++
## 痛点
API Key 登录模式下，Codex 原生插件入口会提示需要登录 ChatGPT，导致插件功能无法正常使用：
同时，Codex 原生会话列表只有归档入口，没有真正的删除按钮：
## 解决效果
Codex++ 启动后会解锁插件入口，并在会话列表悬停时显示删除按钮：
顶部菜单栏会出现 `Codex++`，点击后可以打开配置界面：
## 讨论交流
欢迎扫码加入 Codex++ 交流群，反馈问题、交流使用体验或提出新功能建议：
## 友情链接
- [LINUX DO](https://linux.do)
## 工作方式
Codex++ 使用外部启动方式运行 Codex：
1. 启动 Codex App，并附加：
- `--remote-debugging-port=9229`
- `--remote-allow-origins=http://127.0.0.1:9229`
2. 启动本地 helper 服务，保留健康检查和运行生命周期。
3. 通过 CDP 注入 `renderer-inject.js`。
4. 渲染端通过 CDP bridge 调用本地删除服务；默认不开放 HTTP 删除/撤销入口，避免本机其他页面误触发删除类操作。
5. 启动 Codex 时会继承现有 `HTTP_PROXY` / `HTTPS_PROXY` / `ALL_PROXY`；如果这些环境变量未设置，会自动探测常见本地代理端口（如 `127.0.0.1:7897`），帮助 Codex 加载需要访问 GitHub 的技能资源。
这种方式不会修改 Codex 的 `app.asar`，也不需要往 Codex 安装目录写 DLL。
## 环境要求
- Python 3.11+
- Windows 或 macOS
- 已安装 Codex App
安装依赖：
```bash
python -m pip install -e .
```
如需运行测试：
```bash
python -m pip install -e .[test]
python -m pytest -q
```
## Windows 使用
### 图形菜单安装/卸载
双击项目根目录的：
```text
setup.bat
```
然后按菜单选择：
```text
[1] Install Codex++
[2] Uninstall Codex++
[3] Update Codex++
[4] Exit
```
### 命令行安装
在项目目录执行：
```bash
python -m codex_session_delete setup
```
安装后会在桌面生成：
```text
Codex++.lnk
```
双击该快捷方式启动 Codex++。
### 命令行卸载
可以在系统“设置 → 应用 → 已安装的应用”里卸载 `Codex++`。
也可以在项目目录执行：
```bash
python -m codex_session_delete remove
```
如需同时删除 Codex++ 自己的日志和备份数据：
```bash
python -m codex_session_delete remove --remove-data
```
## 自动更新
Codex++ 会在启动时检查 GitHub Release。如果发现比本地版本更新的 Release，会在控制台提示版本号、Release 地址和更新命令；检查失败不会影响 Codex++ 启动。
手动检查更新：
```bash
python -m codex_session_delete check-update
```
从最新 GitHub Release 更新：
```bash
python -m codex_session_delete update
```
更新流程：
1. 请求 `https://api.github.com/repos/BigPizzaV3/CodexPlusPlus/releases/latest`。
2. 比较最新 Release tag 与本地版本。
3. 优先下载 Release 中的 `.whl` asset。
4. 执行 `python -m pip install --upgrade `。
5. 自动重新执行 `python -m codex_session_delete setup`，刷新快捷方式、Windows 卸载项或 macOS app bundle。
发布新版本时，请在 GitHub Release 里附加 wheel 文件，例如：
```bash
python -m build
```
然后把 `dist/codex_session_delete--py3-none-any.whl` 上传到对应 Release。
## macOS 使用
### 安装
```bash
python -m codex_session_delete setup
```
默认会自动查找 `/Applications/Codex.app`、`/Applications/OpenAI Codex.app` 或用户 Applications 目录下的 Codex 应用，并生成：
```text
/Applications/Codex++.app
```
### 卸载
```bash
python -m codex_session_delete remove
```
## 直接启动
不安装快捷方式时，也可以直接运行：
```bash
python -m codex_session_delete launch
```
常用参数：
```bash
python -m codex_session_delete launch \
--app-dir "/Applications/OpenAI Codex.app" \
--debug-port 9229 \
--helper-port 57321
```
Windows 也可以手动指定 Codex 安装目录：
```bash
python -m codex_session_delete launch \
--app-dir "C:/Program Files/WindowsApps/OpenAI.Codex_xxx/app" \
--debug-port 9229 \
--helper-port 57321
```
## 数据与备份
Codex++ 默认读取 Codex 本地数据库：
```text
~/.codex/state_5.sqlite
```
删除前会把相关记录备份到：
```text
~/.codex-session-delete/backups
```
隐藏启动失败日志位于：
```text
~/.codex-session-delete/launcher.log
```
## Windows 自动接管（可选）
默认情况下 Codex++ 只在你**从 `Codex++` 快捷方式启动时**生效。如果你从开始菜单、任务栏或系统原生入口直接启动 Codex，那一次不会有注入，`Codex++` 菜单和插件解锁都不会出现。
Windows 可以注册一个常驻 watcher 解决这个问题。它会每 3 秒探测一次本机 CDP 端口，发现 Codex 在跑但 CDP 没起来，会先短暂等待并二次确认，确认仍没有 CDP 后再把这一批 Codex 进程杀掉、通过 launcher 重拉一次带注入的版本。这样不管你从哪里打开 Codex，都会被自动接管。
注意代价：
- 每次 Codex 通过原生路径启动，仍可能先打开一瞬间，再被 kill，再被 launcher 带 CDP 重开；watcher 会通过等待、二次确认和失败 backoff 尽量减少频繁闪烁。
- watcher 以 `pythonw.exe` 常驻运行，登录时自动启动（通过 `HKCU\...\Run` 和 Startup 文件夹双路径注册，后者防止某些注册表清理工具干扰）。
### 安装
```bash
python -m codex_session_delete watch-install
```
安装完成后 watcher 会立即启动，无需重启。
### 卸载
```bash
python -m codex_session_delete watch-remove
```
`remove` / 系统卸载 Codex++ 时会自动连带执行 `watch-remove`，不需要手动处理。
### 临时开关
保留自启项、但让 watcher 不再自动接管：
```bash
python -m codex_session_delete watch-disable
python -m codex_session_delete watch-enable
```
### 日志
```text
%USERPROFILE%\.codex-session-delete\watcher.log
```
示例：
```text
[...] 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++ 没反应
先查看日志：
```text
%USERPROFILE%\.codex-session-delete\launcher.log
```
常见原因：
- Codex App 没有安装或路径变化
- 9229 端口被占用
- Python 环境不可用
### 技能推荐加载失败
如果技能页提示 `git fetch failed`、`unable to access 'https://github.com/openai/skills.git/'` 或无法连接 GitHub，通常是本机网络不能直连 GitHub。Codex++ 启动时会优先继承现有代理环境变量；如果未设置，会自动探测常见本地代理端口。也可以手动指定：
```powershell
$env:HTTP_PROXY="http://127.0.0.1:7897"
$env:HTTPS_PROXY="http://127.0.0.1:7897"
python -m codex_session_delete launch
```
### Codex++ 菜单没出现
确认是从 `Codex++` 快捷方式启动，而不是直接启动原版 Codex。
也可以检查 Codex 是否带了 CDP 参数：
```text
--remote-debugging-port=9229
```
### Windows 系统卸载失败
请先更新到当前版本后重新安装一次：
```bash
python -m codex_session_delete setup
```
新版会写入稳定的系统卸载项，并使用绝对 Python 路径执行卸载。
## 开发
运行测试：
```bash
python -m pytest -q
```
项目结构：
```text
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/ 自动化测试
docs/ai/ 项目级 AI 协作状态和 skills 配置中枢
```
## 说明
Codex++ 是外部增强工具，不修改 Codex App 原始文件。Codex App 更新后，如果页面结构变化，可能需要更新注入脚本。