Codex Mode Guard 使用说明

Codex Mode Guard 是配合 Codex++ 使用的 Windows 托盘工具。它监测 Codex 的认证模式，在切换到 ChatGPT 官方登录时准备 SSRDOG 和本机代理；切换到 API key / 中转时只更新状态，不主动清理现有代理。

#一、准备工作

使用前请确认：

1. 已安装 Codex，并至少成功登录过一次。

2. 已安装 SSRDOG。默认路径为 F:\ssrdog\SSRDOG.exe。

3. SSRDOG 使用本机 HTTP 代理端口 9567，默认地址为 http://127.0.0.1:9567。

4. Codex++ 位于 F:\Codex++，并包含 codex-plus-plus-manager.exe 或 codex-plus-plus.exe。

如果软件安装在其他位置，可以在主界面修改 SSRDOG 路径和代理地址。Codex++ 管理器的安装路径也会优先从 Windows 注册表自动读取。

#二、启动工具

双击 CodexModeGuard.exe 启动。工具启动后会进入系统托盘，并进行一次认证和运行状态检测。

如果使用后台启动参数：

CodexModeGuard.exe --background

工具会启动后直接隐藏主窗口，但仍会继续监听认证文件变化。关闭主窗口不会退出程序，只会隐藏到托盘。

#三、主界面说明

#状态区域

• 认证模式：显示当前认证类型。

• ChatGPT 官方登录：使用 ChatGPT 官方认证。

• API key / 中转：使用 API key 或中转配置。

• 认证类型未知：未找到 auth.json，或文件内容暂时无法解析。

• SSRDOG：显示 SSRDOG 是否正在运行。

• 代理端口：显示代理地址是否可以连接。

• 顶部状态徽章：显示检测中、准备中、官方就绪、处理中转或需要处理等状态。

#操作按钮

• 准备官方网络：手动启动 SSRDOG，等待代理端口可用，写入代理环境并验证官方 Codex 接口。网络较慢时可能需要等待几十秒。

• 重新检测：重新读取认证状态并刷新运行状态。认证模式没有变化时不会重复准备网络。

• 重启 Codex：关闭并重新打开官方 Codex。此操作会中断正在运行的任务，只在确认任务可以中断时使用。

• 打开 Codex++（管理器）：优先启动或聚焦 Codex++ 管理器，而不是直接创建新的 Codex++ 实例。打开会话历史时建议使用此入口，以避免历史列表暂时为空。

#四、推荐使用流程

#从中转切换到官方登录

1. 在 Codex++ 中完成 ChatGPT 官方登录。

2. 等待 Codex Mode Guard 自动检测到认证模式变化。

3. 如果“监听认证切换”已开启，工具会自动准备 SSRDOG 和代理。

4. 看到“官方就绪”后，重启 Codex，使新的代理环境被 Codex 进程读取。

5. 需要查看会话历史时，从工具中点击“打开 Codex++（管理器）”。

首次切换到官方模式时，建议手动点击一次“重启 Codex”，确认官方网络已加载后再继续工作。

#从官方切换到中转

1. 在 Codex++ 中切换到 API key 或中转配置。

2. 等待认证模式显示为“API key / 中转”。

3. 工具不会关闭 SSRDOG，也不会自动清理代理设置或修改 Codex provider。

4. 如果中转程序要求新的环境变量，按中转服务商的说明重新启动对应应用。

#五、自动选项

• 监听认证切换：监听 %USERPROFILE%\.codex\auth.json。关闭后不会自动响应认证变化，但仍可以手动检测和准备网络。

• 官方模式自动重启 Codex：认证从其他模式切换到官方模式时自动重启 Codex。重启会中断当前任务，建议只有在不运行重要任务时开启。

• 开机启动：将 Codex Mode Guard 写入当前 Windows 用户的启动项，并使用后台模式启动。

设置修改后会自动保存到程序目录的 settings.json。保存过程使用临时文件替换，不会把 token 或 API key 写入配置。

#六、系统托盘

右键托盘图标可以使用：

• 打开：显示主窗口。

• 准备官方网络：执行官方网络准备流程。

• 重新检测：重新读取认证状态。

• 退出：完全退出工具并停止认证监听。

双击托盘图标也可以显示主窗口。点击主窗口右上角的关闭按钮只会隐藏窗口，不会退出后台监听。

#七、故障排查

#显示“未找到 SSRDOG”

在 SSRDOG 输入框中填写实际的 SSRDOG.exe 路径，或点击“浏览”选择文件。确认当前 Windows 用户有权限启动该程序。

#显示“代理端口不可用”

1. 确认 SSRDOG 已启动。

2. 确认代理地址为本机地址，例如 http://127.0.0.1:9567。

3. 确认端口没有被其他程序占用。

4. 在 SSRDOG 中确认对应的 HTTP 代理监听已开启。

5. 点击“准备官方网络”重新等待端口。

#官方网络准备成功，但 Codex 仍无法连接

官方网络准备会设置当前用户的环境变量和 Windows 代理。已经运行的 Codex 进程不会自动读取新的进程环境，因此需要点击“重启 Codex”。

#Codex++ 会话历史为空

不要从外部直接重复启动 codex-plus-plus.exe。先关闭重复的 Codex++ 窗口，再通过 Codex Mode Guard 的“打开 Codex++（管理器）”入口启动或聚焦管理器，由管理器打开会话历史。

#主界面响应较慢

网络准备和代理验证可能受 SSRDOG、网络或系统代理响应速度影响。认证文件只发生内容刷新但模式未变化时，工具不会重复执行完整网络准备。仍然卡住时可先关闭“监听认证切换”，完成手动网络准备后再重新开启。

#八、配置文件

配置文件位置：

程序目录\settings.json

字段说明：

字段说明SsrdogPathSSRDOG 可执行文件路径ProxyUrl本机 HTTP 代理地址WatchEnabled是否监听认证切换AutoRestartCodex官方模式变化时是否自动重启 CodexStartWithWindows是否随 Windows 启动不建议在 Codex Mode Guard 运行时手动编辑配置文件。修改后重新打开工具即可加载。

#九、隐私与权限

• 工具只读取 auth.json 中用于判断模式的字段名称和结构，不读取、复制、保存或显示 token/API key 内容。

• 工具会修改当前 Windows 用户的代理环境变量和 Internet Settings，这是为了让 Codex 读取本机代理。

• 工具不会删除会话历史，不会清理 Codex 数据库，也不会修改中转 provider 配置。

• “重启 Codex”和“官方模式自动重启 Codex”会终止 Codex 进程；正在执行的任务可能因此中断。