sudipnext/dsh-chatgpt-codex

dsh-chatgpt-codex

CI
License: MIT
DeepSeek Harness plugin

在 DeepSeek Harness 中使用你的 ChatGPT 账户和 Codex 模型。这个独立的 DSH 插件同时支持 localhost 浏览器回调和无头设备代码认证，自动刷新 OAuth 令牌，并将 Codex Responses 流式传输到原生 DSH 消息/工具协议中。

无需 OpenAI API 密钥。无 pi-ai 运行时依赖。

[!IMPORTANT]
DeepSeek Harness 目前尚未为其主模型路由提供 ChatGPT/Codex OAuth。它有一个 Codex 子代理启动器，可以复用官方 Codex 应用的登录，但那是一条独立的一次性委托路径。本插件填补了主模型的空白，并面向当前的 DSH next API（0.1.0-rc.6 或更新版本）。

功能特性

- 带 PKCE、严格 state 校验和 localhost 回调的 ChatGPT 浏览器 OAuth
- 适用于 SSH、容器和无头机器的 ChatGPT 设备代码 OAuth
- 自动刷新访问令牌，带进程内和跨进程轮换锁
- 在 $DSH_HOME 下仅限所有者访问的原子凭据存储
- 原生 openai-codex DSH 模型提供程序——无需 pi-ai 适配器
- 用于 Codex Responses 传输的官方 OpenAI JavaScript SDK
- 流式文本、推理摘要、函数调用、图像、用量和结束原因
- 加密的推理项重放，以实现正确的多轮 Codex 会话
- 当前 GPT-5.6 Luna、Terra 和 Sol 发现条目，以及 GPT-5.5/5.4 模型

两分钟安装

该仓库提交了其构建产物，因此 GitHub 安装不会运行依赖 prepare 脚本。

1. 使用 ChatGPT 登录

浏览器回调（在桌面端推荐）：

pnpm dlx github:sudipnext/dsh-chatgpt-codex#v0.1.0 login

设备代码（通过 SSH 或在容器中推荐）：

pnpm dlx github:sudipnext/dsh-chatgpt-codex#v0.1.0 login --device

默认凭据文件为 $DSH_HOME/chatgpt-codex/auth.json，当未设置 DSH_HOME 时为 ~/.dsh/chatgpt-codex/auth.json。

2. 添加 DSH 捆绑包

dsh plugin --profile codex add github:sudipnext/dsh-chatgpt-codex#v0.1.0

3. 运行 DeepSeek Harness

dsh --profile codex

该捆绑包注册 openai-codex 并选择 gpt-5.6-luna 作为该配置文件的默认模型。后续的配置文件补丁可以选择另一个模型。

认证命令

浏览器回调，不自动打开浏览器
dsh-chatgpt-codex login --no-open

设备授权；代码在 15 分钟后过期
dsh-chatgpt-codex login --device

安全的状态输出，绝不打印令牌
dsh-chatgpt-codex status
dsh-chatgpt-codex status --json

立即轮换访问令牌
dsh-chatgpt-codex 刷新

移除本地凭据
dsh-chatgpt-codex logout

对于仅使用 GitHub 的安装，请在这些命令前加上 pnpm dlx github:sudipnext/dsh-chatgpt-codex#v0.1.0。

配置

在配置文件的 $DSH_HOME/profiles//cordis.patch.yml 中覆盖插件行：

- id: llm-chatgpt-codex
config:
defaultReasoningEffort: high
textVerbosity: low
requestTimeoutMs: 300000

- id: agent-default-model
config:
provider: openai-codex
model: gpt-5.6-terra

可用的插件设置：

| 设置 | 默认值 | 用途 |
| --- | --- | --- |
| authFile | $DSH_HOME/chatgpt-codex/auth.json | OAuth 凭据文档 |
| issuer | https://auth.openai.com | OAuth 颁发者，主要用于兼容的部署/测试 |
| baseURL | https://chatgpt.com/backend-api/codex | Codex Responses 基础 URL |
| originator | dsh-chatgpt-codex | 向上游发送的真实产品标识 |
| models | 当前捆绑的目录 | 供参考的 DSH 模型选择器条目 |
| defaultReasoningEffort | high | low、medium、high、xhigh 或 max |
| textVerbosity | low | low、medium 或 high |
| requestTimeoutMs | 300000 | 提供方请求超时 |

模型目录仅供参考。实际模型可用性取决于已登录的 ChatGPT 套餐、工作区策略、地区以及 OpenAI 当前的发布情况。

为什么不使用 pi-ai

DeepSeek Harness 的通用 llm-pi-ai 适配器有意不暴露仅支持 OAuth 的提供方，因为它没有凭据存储或登录生命周期。本项目直接负责缺失的生命周期：

1. CLI 执行 ChatGPT PKCE 或设备代码认证。
2. AuthManager 存储并轮换 OAuth 令牌集。
3. CodexAdapter 将原生 DSH 历史/工具转换为无状态的 Responses 输入。
4. 官方 openai SDK 承载 HTTPS/SSE 传输。
5. 流转换器发出 DSH 块，并存储下一轮所需的加密重放项。

有关确切的组件和信任边界，请参阅架构。

安全

- OAuth 状态是加密随机的，并以恒定时间进行比较。
- PKCE 使用 S256，并为每次登录使用全新的验证器。
- 回调服务器仅监听 127.0.0.1，并在收到一个结果后关闭。
- 在 POSIX 上，凭据以 0600 模式原子写入；父存储使用 0700。
- 状态、错误、测试或日志绝不会打印令牌。
- 此插件使用自己的凭据文件，而不是复制 ~/.codex/auth.json，从而避免与官方 Codex 客户端发生刷新令牌轮换竞争。

在报告漏洞之前，请阅读 SECURITY.md。logout 会移除本地凭据，但不会远程撤销 OpenAI 会话。

兼容性与状态
这是一个独立的社区插件，并非 OpenAI 或 DeepSeek 的官方项目。Codex 的私有 ChatGPT 后端和预发布版 DSH API 都可能发生变化。该仓库通过无密钥 OAuth、wire、replay 和存储测试来固定行为；发布说明会描述任何所需的迁移。

使用 ChatGPT/Codex 仍需遵守你的 OpenAI 账户条款和工作区政策。ChatGPT 订阅并不保证能使用目录中的每一个模型。

开发

pnpm install
pnpm run check

测试套件使用本地 HTTP 服务器和合成 JWT；它不需要也不会读取真实的 ChatGPT 凭据。

许可证

MIT © 2026 sudipnext