zhangxiubo/dsh-llm-chatgpt-oauth

dsh-llm-chatgpt-oauth

通过 pi-ai 的 openai-codex OAuth 路由，将 ChatGPT Plus/Pro 订阅用作 DeepSeek Harness 模型提供方——无需 OpenAI API 密钥。

本包注册通过 ChatGPT OAuth 暴露的 OpenAI Codex 模型目录。它不会将公共 api.openai.com 路由转变为订阅访问，也不会抓取浏览器会话。

这是一个独立的社区项目，并非 OpenAI、DeepSeek 或 pi-ai 的官方包。OpenAI、ChatGPT 和 Codex 是各自所有者的商标。

它提供什么

- DeepSeek Harness 提供方路由：openai-codex
- 通过 chatgpt.com/backend-api 进行 ChatGPT OAuth 身份验证
- 无需 OPENAI_API_KEY
- pi-ai 当前的 Codex 模型目录（例如 gpt-5.4、gpt-5.5，以及兼容的 gpt-5.6-* 模型）
- 通过 PiAiAdapter 复用现有的 Harness 消息转换、工具调用、推理级别、重放元数据、附件和流式转换
- 自动刷新 OAuth 访问令牌
- 私有、原子的凭据持久化
- 可选从现有 Codex CLI 登录进行引导
- 专用的设备代码登录命令
- 在 DSH 的模型设置页面中显示一个活动的 OpenAI Codex (ChatGPT) 提供方行
- 由设置支持的运行选项实时更新；自定义标头在设置传输中被脱敏

模型可用性和使用限制由 ChatGPT 账户控制，并且可能独立于本连接器发生变化。

要求

- Node.js >=22.19.0
- PATH 中有 pnpm（由 dsh plugin add 使用）
- DeepSeek Harness 与 @deepseek-ai/dsh-llm-pi-ai@0.1.0-rc.7 兼容
- @earendil-works/pi-ai@0.82.1
- 一个可访问 OpenAI Codex 模型的 ChatGPT 账户

该连接器有意扩展了一个按约定为私有的 PiAiAdapter.current() 构造接缝，以便注入 pi-ai 的 OAuth 凭据存储。因此，它的 Harness 和 pi-ai 对等版本被精确锁定；只有在完整测试套件和可选的实时测试针对新版本通过后，才升级这些锁定版本。

安装与接入（一条命令）

对于不可变安装，请使用 GitHub 发行说明中显示的发行提交 SHA：

dsh plugin --profile web add 'github:zhangxiubo/dsh-llm-chatgpt-oauth#'

版本标签是更易读的替代方案：

dsh plugin --profile web add 'github:zhangxiubo/dsh-llm-chatgpt-oauth#v0.1.0'

该连接器是一个 DSH bundle，因此上述任一命令都会安装 Git 依赖，并将其声明的 dsh.bundle.patch 追加到配置文件的 bundle 栈中——无需手动编辑 cordis.patch.yml。之后重启 dsh web。
该仓库直接提供可运行的 JavaScript，无需安装时构建、prepare 脚本或 pnpm allowBuilds 条目。这遵循 Harness 的官方 GitHub 插件安装指南，包括其建议固定提交 SHA。若要改为测试最新的开发分支，请省略修订版本：

dsh plugin --profile web add github:zhangxiubo/dsh-llm-chatgpt-oauth

该包被标记为 private，并包含一个会失败的 prepublishOnly 守卫，以防止意外发布到 npm registry；GitHub releases 是受支持的发布渠道。

手动回退方案

如果你自行管理 profile，请将包安装到 profile 的 Cordis loader 解析 Node 包的位置，然后向 ${DSH_HOME:-$HOME/.dsh}/profiles/web/cordis.patch.yml 添加一行：

- insert:
- id: llm-chatgpt-oauth
name: dsh-llm-chatgpt-oauth

重要的要求是 import('dsh-llm-chatgpt-oauth') 能从 profile 组合中解析。

身份验证

专用 OAuth 登录（推荐）

安装包后：

dsh-llm-chatgpt-auth login

该命令会打印一个 OpenAI 设备代码 URL 和代码，等待授权，并保存专用的连接器凭据。它绝不会打印令牌。

其他命令：

dsh-llm-chatgpt-auth status
dsh-llm-chatgpt-auth logout

凭据存储在：

${DSH_HOME:-~/.dsh}/llm-chatgpt-oauth/oauth.json

从 Codex CLI 引导

默认情况下，当不存在专用凭据时，连接器会读取：

${CODEX_HOME:-~/.codex}/auth.json

这使得现有的 codex login 可立即使用。刷新后的连接器凭据会写入连接器自己的文件，绝不会覆盖 Codex CLI 文件。

如需独立的令牌生命周期，请使用专用登录命令，并在 ${DSH_HOME:-~/.dsh}/settings.yaml 中禁用引导：

llm-chatgpt-oauth:
bootstrapFromCodexCli: false

选择提供方

安装后重启后，Models 设置页面会将 OpenAI Codex (ChatGPT) 列为活动提供方。在编辑器模型选择器中选择一个具体模型，或在 ${DSH_HOME:-~/.dsh}/settings.yaml 中为新 agent 设置默认值：

agent-default-model:
provider: openai-codex
model: gpt-5.4
reasoningEffort: high

当前的 DSH Models 编辑器仅为其内置的 DeepSeek 和 pi-ai 设置命名空间提供精选表单。因此，这个第三方 OAuth 行仅用于提供方可见性/状态；请使用登录 CLI 进行 OAuth，并使用下面的 llm-chatgpt-oauth: 设置部分配置高级连接器选项。

可选插件配置

在 ${DSH_HOME:-~/.dsh}/settings.yaml 中设置连接器选项；有效的更改会实时生效，并刷新适配器元数据和 Models 提供方目录：

llm-chatgpt-oauth:
displayName: OpenAI Codex (ChatGPT)
streamIdleTimeoutMs: 300000
bootstrapFromCodexCli: true
可选显式路径：
codexAuthFile: /path/to/codex/auth.json
credentialFile: /path/to/dsh/oauth.json
可选的提供方请求头（在设置传输中会被标记为密钥并脱敏）：
headers:
X-Custom-Header: value

可以通过在配置文件的 cordis.patch.yml 中定位 llm-chatgpt-oauth，将相同的字段设置为组合基础；设置中的值会覆盖该基础。OAuth 访问令牌和刷新令牌永远不会进入这两个文件。自定义请求头会经过验证，在设置传输响应中会被脱敏，并且不能覆盖 authorization、cookie、proxy-authorization 或 HTTP 传输请求头。

要在不卸载软件包的情况下禁用该路由：

- id: llm-chatgpt-oauth
disabled: true

架构

1. 该插件注册一个 Harness 路由 openai-codex，以及一个由 llm-chatgpt-oauth 设置命名空间寻址的可配置提供方目录条目。
2. CodexOAuthAdapter 继承 PiAiAdapter，并使用 OAuth 凭据存储构建 pi-ai 的 Models 集合。
3. 设置变更会替换配置文件快照以及切换凭据存储委托，而不会替换当前活动的适配器注册。
4. 提供方来自 pi-ai 的 openaiCodexProvider()，并使用 https://chatgpt.com/backend-api。
5. pi-ai 解析并刷新 OAuth 凭据，然后将其访问令牌提供给其 Codex Responses 传输层。
6. 继承的 PiAiAdapter 将 Harness 消息转换为 pi-ai 上下文，并将流式 pi-ai 事件转换回 Harness 数据块。

该连接器不会将访问令牌或刷新令牌放入 DSH 设置、模型配置、日志或 Git 仓库中。

开发

npm install
npm run verify

普通测试套件永远不会联系 OpenAI，也不需要凭据。

仅在已认证的机器上运行可选的实时测试：

RUN_LIVE_CODEX=1 npm run test:live

使用以下命令选择另一个模型：

RUN_LIVE_CODEX=1 CODEX_MODEL=gpt-5.5 npm run test:live

在创建 GitHub 发布之前检查软件包载荷：

npm pack --dry-run

GitHub 发布

本项目直接从 GitHub 分发，而不是从 npm 注册表分发。package.json 被有意标记为 private，并带有一个注册表发布拒绝钩子；当 pnpm 安装该 Git 依赖时，其软件包名称仍用于标识 Cordis 模块。

规范的仓库链接在 package.json 中声明。发布维护者应遵循 RELEASING.md，发布带注释的版本标签，并在 GitHub 发布说明中包含其不可变的提交 SHA。

安全性与限制

- 切勿提交 ~/.codex/auth.json 或连接器的 oauth.json。
- 建议使用专用的设备代码登录，而不是导入现有的 Codex CLI 授权。
- 凭据存储在同一进程内串行化刷新；目前不支持多个连接器进程针对同一凭据文件运行。
- 提供商/模型访问和订阅计费由 OpenAI 控制。
- 本项目依赖 pi-ai 的 OpenAI Codex OAuth 提供商以及当前的 Harness PiAiAdapter 实现；上游变更可能需要更新。

有关报告指南，请参阅 SECURITY.md。

许可证

MIT