dsh-openai-codex-auth

简体中文 | English

为 DeepSeek Harness 增加 openai-codex 模型提供方，通过符合资格的 ChatGPT 订阅登录，无需配置 OpenAI Platform API Key。

一个 LLM provider 路由应当只由一个插件负责。同时启用两个 openai-codex 实现会造成 adapter 注册冲突。

DSH 0.2.0-rc.2 的内置 llm-pi-ai.providers.openai-codex 路由也受此限制： 使用本插件时不要同时配置该内置路由。共存尚不支持，同时启用会导致插件无法激活。

功能

• 使用 OpenAI Codex OAuth 设备码流程登录 ChatGPT；
• 在 DSH 模型选择器中提供 Codex 模型及对应推理等级；
• 在本地保存凭据并自动刷新令牌；
• 在设置页显示登录状态、滚动用量周期、重置时间和 Credits。
• 显示重置卡数量和到期时间，支持选卡并确认后兑换；
• 无需重启即可切换跟随 DSH 宿主或 Windows 手动系统代理。

要求

• DSH 0.2.0-rc.2 Web 或 Windows 桌面版（已测试的宿主版本）； 同时支持 DSH 0.2.1-rc.2 和宿主提供的 pi-ai 1.1.0。
• CLI 安装需要 Node.js >=22.19.0；桌面版自带运行时，无需另装；
• 具有 Codex 使用资格并已启用设备码登录的 ChatGPT 订阅。

模型来自宿主的 pi-ai 目录。DSH 0.2.0-rc.2 自带的 pi-ai 0.87.1 已包含 GPT-6 Sol 和 GPT-6 Luna，实际访问权限仍取决于账号；插件不会替换宿主目录或安装另一套 provider 运行时。

安装或更新

CLI / Web

dsh plugin --profile web add dsh-openai-codex-auth

安装或更新后重启 DSH。

Windows 桌面版

在桌面版插件管理器中输入 [email protected] 安装。 管理器会安装到当前桌面版 profile 并启用 bundle，无需另外安装全局 Node.js、pnpm 或 CLI。 如果更新后提示需要重启，请重启桌面版再检查新界面。

桌面版 0.2.0-rc.2 内置独立的 DSH 运行时，使用 desktop profile。 安装到 web 不会自动安装到桌面版。插件仍使用 dsh.client.platform: web， 因为桌面版复用 Web 插件界面。

以下 CLI 方式仅适用于桌面版 0.2.0-rc.2；0.2.1-rc.2 的 desktop profile 由桌面应用专属管理，请使用应用内插件管理器。 先打开一次桌面版以初始化 profile，再完全退出（包括托盘进程）， 然后在 PowerShell 中调用桌面版自带 CLI：

$desktopDsh = "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd"
& $desktopDsh plugin --profile desktop add [email protected]

自定义安装位置需调整路径，不要用 npm 全局安装的 dsh 代替该命令。 重启桌面版后打开“设置 → OpenAI Codex”。卸载时同样先完全退出桌面版， 再用该 CLI 执行 plugin --profile desktop remove dsh-openai-codex-auth。

插件 0.6.3 支持 DSH 0.2.0-rc.2 和 0.2.1-rc.2；仍使用 DSH 0.1.7-rc.2 的用户 请安装插件 0.4.2。不要绕过兼容性检查。

已验证隔离安装、桌面内置运行时及 Web 设置页/状态接口； 原生 Electron 窗口交互、真实 OAuth 和模型请求不在自动验证范围内。

从源码安装

以下命令针对 CLI / Web。桌面版请先完全退出，再使用自带 CLI 执行 plugin --profile desktop add .。

npm install
dsh plugin --profile web add .

这个包本身就是 DSH bundle，不需要再执行安装脚本。

使用

1. 打开“设置 → OpenAI Codex”，选择“使用 ChatGPT 登录”；
2. 打开验证页面，输入显示的设备码并完成授权；
3. 在模型选择器的“OpenAI Codex”下选择模型。

DSH agent 也可以调用 codex_login、codex_status 和 codex_logout。

重置卡

用量下方展示可用重置卡数量和每张可用 Codex 重置卡的到期时间（本地时区），最近到期的排在前面。 每行的“使用重置额度”按钮指定该张卡，确认弹窗也会显示所选卡的到期时间。 接口未提供有效期或详情读取失败时会明确提示，不会误显示为零张。 点击“使用重置额度”后需在弹窗再次确认，才会发送可能消耗所选重置卡的请求。 具体重置哪些符合条件的额度由服务端决定；所选卡失效时不会自动改用另一张。 结果不确定时只能重试同一次请求，请勿在其他窗口另行发起重置。 此功能依赖非公开接口，其兼容性不保证；兑换仅做模拟测试，未消耗真实重置卡验证。

网络代理

在 设置 → OpenAI Codex → 网络代理 中选择模式，新请求立即生效，无需重启 （底层配置字段为本插件的 proxyMode）：

• host（默认）：跟随 DSH 宿主。启动前配置 HTTPS_PROXY / HTTP_PROXY / ALL_PROXY 和 NO_PROXY，或写入 $DSH_HOME/.env。
• system：读取运行 DSH 的 Windows 用户的手动 HTTP/HTTPS 系统代理及绕过列表。 登录、令牌刷新、用量和模型请求均使用此模式；模型对话使用 SSE，不使用 WebSocket。 OAuth 在独立 Worker 内运行，不修改宿主的环境变量或全局连接管理器。

系统代理模式不支持 PAC、自动发现、SOCKS-only 或带用户名密码的代理地址；没有可用的 手动 HTTPS 代理时请求会报错，不会自动回退直连。系统绕过列表匹配的地址按系统策略直连。 此设置不控制外部浏览器中的授权页面。进行中的请求保留原连接直到结束；修改 Windows 代理后点击“重新读取系统代理”即可，切换失败保留原模式。修改宿主的环境变量仍需重启 DSH。

例如在 PowerShell 中（请替换为你的代理地址）：

$env:HTTPS_PROXY = "http://127.0.0.1:7897"
dsh web

卸载

以下命令针对 CLI / Web。桌面版请通过插件管理器或上文自带 CLI 卸载； 卸载 Web profile 中的插件不会移除桌面版中的副本。

先在“设置 → OpenAI Codex”中退出登录，然后运行：

dsh plugin --profile web remove dsh-openai-codex-auth

最后重启 DSH。

安全

• OAuth token 以 PI_OAUTH_OPENAI_CODEX 项保存在本地 $DSH_HOME/.credentials.yaml，不会发送到设置页面；
• 用量数据只保留聚合百分比、重置时间、Credits，以及重置卡数量、到期时间和选卡所需的卡片标识，不包含用户身份信息；
• 请勿提交或分享 .credentials.yaml、auth.json 或环境变量文件。

安全问题请按 SECURITY.md 私下报告。

开发

npm run check
npm test
npm pack --dry-run

提交改动前请阅读 CONTRIBUTING.md。

License

MIT