前言¶
DeepSeek Harness (DSH) 的插件化架构允许开发者将外部能力集成到工作流中。对于需要复用 ChatGPT Codex 订阅（Plus / Pro / Business / Edu）的开发者，直接在 DSH 中调用需要解决认证与上下文管理的问题。该插件通过 OAuth 流程接入 ChatGPT 订阅，并将上下文压缩逻辑替换为 Codex 原生机制，解决了多轮对话的上下文溢出与压缩效率问题。
这是什么¶
这是一个为 DeepSeek Harness (DSH) 提供的插件，由 thaning0 维护。它将 ChatGPT Codex 订阅暴露为 DSH 的 codex-oauth 模型提供方，同时集成了原生压缩和图片输入能力。
核心功能¶
- 订阅模型接入：将 OpenAI Codex 的 provider 注册为
codex-oauth，暴露gpt-5.3-codex-spark等模型。 - OAuth 设备码登录：使用
auth.openai.com进行设备码登录，无需本地回调服务器。 - 凭据安全：Refresh / Access Token 仅存储在 DSH 凭据库
$DSH_HOME/.credentials.yaml（权限 0600），不进配置文件、不进会话日志，也不进插件仓库。 - 登录与订阅用量：支持登录、登出，并在设置页及对话中通过命令查看剩余用量百分比。
- 多轮对话：完整保留 provider 原生回放元数据，支持跨轮次多轮请求。
- 瞬时错误恢复：将 WebSocket、DNS、限流及服务不可用等错误归入 DSH 的
TRANSPORT、RATE_LIMIT或SERVER退避重试。 - 多模态图片输入：支持对声明 image capability 的模型进行图片输入。
- 原生压缩：提供手动
/compact命令以及 80% 压力触发的自动压缩，使用 opaque native checkpoint。
安装¶
安装必须使用 file: 前缀，否则依赖加载会失败。
dsh plugin --profile web add file:/path/to/dsh-llm-codex-auth-native-compact-image
安装后需重启 DSH Web 使新 bundle 生效。安装前请确认已安装 pnpm（dsh plugin 转发依赖）或使用提供的脚本进行跨平台安装。
典型用法¶
- 登录：重启 dsh 后打开设置页，侧栏选择「Codex 订阅 (ChatGPT)」并登录。登录后可在设置页查看 5 小时与 7 天窗口的剩余用量百分比。
- 创建会话：新建会话时选择
Codex Nativeagent preset，并在 Models 设置页选择codex-oauth下的模型。 - 手动压缩：在对话中输入
/compact进行手动压缩。 - 状态查询：在对话中输入
/codex-status查看登录状态，输入/codex-usage查看剩余用量，输入/codex-logout登出。
适用场景与注意¶
- 兼容性：原版 OAuth 插件与本插件不得同时加载，否则会重复注册同一 provider。
- 安全与合规：本插件使用未公开的 ChatGPT 后端接口（
chatgpt.com/backend-api），违反 OpenAI 服务条款的风险真实存在，可能导致账号受限。请自行评估后使用。 - 插件维护：仓库内不包含任何秘密，推送到 GitHub 前请确认
.gitignore生效，永远不要提交$DSH_HOME/.credentials.yaml。 - 限制：自动 native compaction 只处理
codex-oauth；其他 provider 不会回退到compaction-basic。
结语¶
该插件为 DSH 用户提供了直接调用 Codex 订阅的途径，并优化了上下文压缩流程。对于需要处理大量上下文或需要多模态能力的开发者，这是一个可行的接入方案。
