在原版 Codex 里用 DeepSeek。
把 DeepSeek Flash 加入 Codex 的模型菜单。保留 GPT、原登录与原生工具，同一个聊天里自由切换；密钥、上下文和自动更新都可在设置窗口管理。
DS 版 0.7.2 · 更新分支 main
更新会提前下载并校验。点击一次“开始更新”后，准备完成并等待任务空闲再安装；等待可取消，超过一小时保留更新包。旧版服务首次升级若无法报告任务状态，请正常退出 Codex，随后自动继续。进度按当前阶段的实际字节或完成项显示，新服务启动失败会恢复上一版；完成后可点击“启动 Codex”。
| 版本 | 接入范围 | 更新通道 |
|---|---|---|
| DS 版 | 原生 GPT + DeepSeek Flash | main |
| 扩展版 | 原生 GPT + 已有云端接口 / 本地服务；DeepSeek 可选 | codex/existing-proxy-models |
首次升级时，若旧设置窗口仍开着，请先保存并关闭它；新版小窗会随后接入，保留正在编辑的内容。
两个版本分别发布、分别更新。扩展版不要求配置 DeepSeek，也不管理外部服务的订阅登录。
- 官方应用保持原样：不改 ASAR、不复制 Windows 应用、不重新签名 Mac 应用。Windows 使用原 Store 包身份，应用自身的更新由官方处理。
- 同聊天切换：模型菜单使用原生目录。聊天 ID、工作目录、权限和历史保留；等当前回复结束再切换。
- 旧压缩历史恢复：切换到外部模型时，由所选模型生成可读交接摘要；摘要被截断会拆分失败的输入继续恢复，完整后才缓存。额度、限流、鉴权、内容过滤等失败分别提示，不再统一显示为摘要 502。
- 原登录和工具：GPT 沿用官方认证；其他模型只使用各自服务的凭据。原生工具继续由 Codex 发现、授权和执行。
- 上下文按模型最大值：规格与选择共用一份目录；用户主动调小的窗口、隐藏型号继续保留。本地服务加载窗口可单独保留。
- 原生功能与压缩：保留原生身份和下一步指令预判的调用链路。GPT 的等待时限、压缩和重试由 Codex 控制；外部模型用自己的接口生成可读摘要。跨模型隔离专有思考签名，保留可读对话、工具结果和各自的上下文窗口。
- 自动维护：官方应用更新后验证兼容性；适配层代码、模型列表和规格分别检查。无变化时安静运行，失败保留当前可用版本。模型列表或规格单独变化时静默准备，准备完成后临时监听 Codex 退出事件，退出后触发安装；快速重开会安全延后；新补丁版本仍显示更新进度。
适配器按 Responses / Chat Completions / Anthropic Messages 协议和显式能力工作，不按厂商名称决定路由。Claude 可使用原生 Messages 接口，其他模型按服务实际提供的协议选择。Messages 使用独立凭据，保留同模型思考签名，切换模型时只共享可读内容；最大输出由服务规格或用户明确声明提供。服务没有提供的规格可以手动声明，不给未知型号套用任意小窗口。
运行时是一个仅监听本机回环地址的 Python 标准库进程，负责请求转发与必要的格式转换。没有额外聊天界面、数据库、模型运行引擎或订阅登录系统。模型推理由原有服务完成，工具由 Codex 执行。
适配器由系统按用户启动；更新监测由 launchd / Windows 任务计划程序定时执行，检查后退出。Windows 使用无控制台 Python。发布包仅含源码和文档；旧应用修改逻辑保留用于历史版本的恢复和回归，新安装路径不执行它。
需要 Python 3.11+ 和已安装的官方 macOS / Windows Codex。无需另装 Node.js；较早的 Python 使用 Codex 自带运行时处理原生请求压缩。外部模型服务需自行准备。
指令预判由官方客户端在回复结束、输入框为空等条件下触发，还受功能开关、模型支持、服务端抽样和请求时限影响。补丁保留原生预判链路；预判请求成功与输入框实际展示分别验证。
git clone --branch main https://github.com/limyum-creator/codex-deepseek-patch.git
cd codex-deepseek-patch
python3 patch.py setup-keyDeepSeek 使用独立 API Key；GPT 继续使用已有官方登录。
macOS 示例，使用新的空输出目录：
python3 patch.py build --app /Applications/ChatGPT.app \
--with-deepseek --output /absolute/path/build --verify# 正常退出 Codex 后：
python3 patch.py install /absolute/path/build
python3 monitor.py enable --app /Applications/ChatGPT.app --baseline /absolute/path/build--connections 和 --proxy-config 可组合；至少选择一个外部来源，也可单独 --with-deepseek。Windows 使用 python 和 Windows 路径；--app 可省略，自动发现官方安装。
--verify 使用隔离的原生 CLI 和本机模拟接口，在后台验证路由、工具、思考档位、窗口、同聊天切换及压缩。不会打开测试桌面窗口，不调用付费模型。验证通过后才允许安装。
从旧补丁迁移时指定 --baseline /path/to/old-build。Mac 的 --app 指向旧构建保留的、通过官方签名验证的 original.app，--install-target 指向原安装位置。首次迁移恢复官方应用，后续更新只替换适配代码和受管配置。Windows 沿用已注册的官方 Store 应用。
已有聊天继续通过原生接口保留 ID、内容、归档、模型和思考档位。旧 GPT 专有压缩块改为按当前聊天身份与压缩块核对本机可读记录，由当前选择的模型生成并缓存摘要，使用该模型自己的凭据，无需 GPT 额度。分叉对话只继承分叉点之前的记录，原文件保持不变。
已有摘要缓存继续复用；长历史按当前模型的有效窗口分块，小窗口也不会直接塞入过大的旧摘要。若可读记录缺失、损坏或格式无法验证，会提示恢复原记录或补充任务摘要，不会悄悄丢弃历史。摘要生成会使用所选服务的额度。
安装并开启监测后，从 Mac 的“应用程序”用户目录或 Windows 开始菜单打开“Codex 模型设置”。也可运行：
python3 patch.py settings入口是一个可拖动、可隐藏的小鲸鱼。点击后展开紧凑的水滴菜单，分类为“模型、连接、更新、工具、诊断、偏好”；悬浮显示简短说明，点击后水滴柔和展开为白色设置卡片，关闭时反向收回。
拖近屏幕边缘会显示淡蓝色落点，松手后收成一颗朝向边缘的小水滴。无待更新时为白色，有更新时为淡红色。鼠标移开再靠近时鲸鱼探出，离开后快速潜回；拖离边缘后保持普通悬浮。设置卡片打开时保持展开，填写内容不会被自动收走。选择“减少动效”可直接切换状态。
- 模型：显示与隐藏、最大/服务/实际窗口、上下文和压缩阈值、恢复默认。
- 连接：检测现成接口、勾选型号、管理凭证引用；扩展版可单独启停 DeepSeek。
- 更新：检查与重试补丁更新、单独同步模型、进度、开始更新及完成后启动 Codex。
- 工具：图片工具、模型能力比较、旧历史恢复进度与取消。
- 诊断：版本和运行状态、连接检查、复制脱敏报告。
- 偏好：外观、动效、气泡音效与呼出快捷键；缓存清理、安装恢复和撤销补丁统一放在“更新 → 维护与恢复”。
小窗按需启动，右键鲸鱼打开偏好设置。隐藏后可用 ⌃⌥D / Ctrl+Alt+D 呼出，也可再次点击 App 或开始菜单入口，已有小窗会直接唤醒；“退出小窗”会结束界面进程并释放快捷键。界面使用 AppKit / WPF，无网页服务器或额外 UI 运行时。保存采用冲突检查，保留已有连接、手动隐藏和主动调小的窗口。本版本提供首次设置卡片，可检测连接、选择型号、准备验证后安装；准备过程显示实际阶段、完成项和耗时，支持取消。公开版本仍按上面的命令安装，图形引导包完成发布验证后另行提供。
此功能从 DS 0.7.2／扩展版 0.8.2-proxy.1 开始提供。请先通过对应通道更新补丁，旧版 0.7.1／0.8.1-proxy.1 不包含这项发送入口兼容。
- 正常使用时：照常点击原来的 Codex 图标，无需每次从补丁设置启动。
- GPT 的 5 小时或每周额度耗尽，切到 DeepSeek 后发送按钮仍不可用时：保存当前工作并正常完全退出 Codex，再从鲸鱼「偏好 → 启动 Codex」打开，选择 DeepSeek 后发送消息。安装更新后，也可使用更新完成页的「启动 Codex」。
- 生效范围：兼容持续到本次 Codex 进程退出。期间切换对话、切换模型或隐藏窗口，不需要重复操作。
- 下次启动时：如果 GPT 额度仍未恢复，请继续从上述入口启动；完全退出后直接点击原版图标，会回到原生的发送入口判断。额度恢复后，可继续用原图标启动。
此兼容按所选模型处理发送入口：使用独立接口的已接入模型可继续发送，GPT 保留自身额度限制。Mac 和 Windows 的 DS／扩展版共用这一规则；官方应用文件和签名保持原样。
发现补丁新版本时，鲸鱼左侧出现小水滴提示，“更新”按钮变为淡红色。后台提醒不打开设置卡片；点击气泡或更新按钮后，在同一个小窗中查看目标版本、真实进度和操作。可以关闭卡片或隐藏小窗，后台任务继续。
点击“开始更新”后，准备和兼容性校验通过才正常关闭 Codex；安装时提示暂勿启动。完成后更新按钮恢复正常，页面提供“启动 Codex”，由用户决定何时打开。失败可在“维护与恢复”重试。官方 Codex 客户端仍由官方更新机制维护。
有实际工作数量的阶段显示计数，无法预估时使用活动进度条。相同版本不会反复呼出小窗；旧版首次升级在新版组件下载后开始使用整合后的界面。DS 与扩展版继续独立更新。
python3 monitor.py status
python3 monitor.py run-once --sync-now
python3 monitor.py model-options --model MODEL_ID --context-window 32768
python3 monitor.py model-options --model MODEL_ID --hide
python3 monitor.py model-options --model MODEL_ID --reset-context监测默认启用代码更新与模型同步，可在启用时分别用 --no-code-updates / --no-model-sync 关闭。正在使用 Codex 时等待退出后安装。更新包优先一次下载完整源码，再逐文件校验；旧客户端下载方式仍兼容。检查版本通道、不可变提交、文件摘要及隔离测试，DS 与扩展不会交叉覆盖。用户主动检查会排队，不被正在运行的检查丢弃。过期清理只处理本版本拥有、未被安装或恢复链引用的缓存，保留最近回退版本。
python3 patch.py status /absolute/path/build
python3 monitor.py disable
python3 patch.py recover /absolute/path/build # 恢复中断的安装
python3 patch.py restore /absolute/path/build # 撤销本适配层，恢复先前配置恢复命令保留官方应用；旧补丁迁移前已有的外部提供方配置仍按原记录恢复。Mac 不重置钥匙串或系统隐私权限；首次从旧本地签名切回官方身份时，系统可能要求确认相应权限。日常更新不再重新签名。
python3 patch.py setup-images --proxy-config /absolute/path/config.yaml复用已有 CPA 的图片接口，将其注册为可选 MCP 工具。图片模型、账号权限和额度由外部服务提供。聊天模型具备工具能力即可请求调用；不会把“能聊天”自动当成“具备生图权限”。
非官方项目。请勿提交官方程序、生成的模型目录、个人日志、账号配置或凭据。问题反馈请附系统、Codex 版本、适配层版本、接口类型和脱敏错误。真实模型实测与模拟协议覆盖分别记录在验证文档。
Dot 使用官方客户端自己的云端长连接。若反复重连，先检查系统 DNS 与代理／VPN 的分流；系统代理能访问网页，不代表原生长连接一定走相同路径。适配层不会自动改全局 DNS、关闭 VPN 或修改官方应用。可用设置窗口导出脱敏诊断；反馈时附连接错误和系统版本。
- 安装和日常管理：根目录
patch.py、monitor.py，原命令保持可用。 - 实现代码：
src/；内部测试和维护脚本位于src/tests/、src/scripts/。 - 技术说明：
docs/；参与开发见 CONTRIBUTING.md。
自动更新包保留旧版所需的文件路径，由整理后的源码生成。目录调整不增加常驻服务，也不影响两个版本的独立更新。