dsh-oauth

DSH OAuth Bridge

DSH OAuth Bridge 是一个 DeepSeek Harness 插件，通过浏览器 OAuth 将 ChatGPT Codex 与 Gemini Code Assist 订阅接入 DSH，无需手动配置对应模型的 API Key。

登录成功后，插件会根据认证状态动态挂载对应 provider；退出登录或凭据失效后，对应 provider 会自动撤销。

Features

• ChatGPT Codex OAuth：使用 ChatGPT 订阅访问 Codex 模型。
• Gemini Code Assist OAuth：通过 Google OAuth 接入 Gemini Code Assist。
• DSH Web UI 登录：在 DSH 设置页中完成登录、状态查看与退出登录。
• 动态 Provider Route：仅在对应账号已认证时向 DSH 暴露 provider。
• Gemini 动态模型目录：通过 Code Assist retrieveUserQuota 获取可用模型，并缓存最近一次成功结果。
• 安全凭据存储：OAuth 凭据保存到 $DSH_HOME/oauth-bridge.json，文件权限为 0600。
• 本地 OAuth Control Server：默认仅监听 127.0.0.1:1456，并限制非 loopback Origin。

Providers

Provider	Route	Subscription / Account	Authentication
Codex	openai-codex	ChatGPT subscription	ChatGPT OAuth
Gemini	gemini-cli-oauth	Gemini Code Assist	Google OAuth

只有登录成功的 provider 才会出现在 DSH 中。

Install

项目已发布到 npm：

npx @deepseek-ai/dsh plugin --profile web add @kelvinwww/dsh-oauth

安装完成后重新启动 dsh web，使插件加载到 Web profile。

Use

1. 启动 DSH Web：

   dsh web
   

2. 打开浏览器中的 DSH 页面。

3. 进入设置页中的 OAuth Providers / OAuth 登录。

4. 根据需要选择：

   • Login with ChatGPT：连接 ChatGPT Codex。
   • Login with Google：连接 Gemini Code Assist。

5. OAuth 成功后，对应 provider 会自动注册到 DSH。

6. 退出登录后，插件会撤销对应 provider route。

Configuration

插件支持以下配置：

Option	Description	Default
dshHome	自定义 DSH Home 路径	DSH 默认目录
controlPort	本地 OAuth control server 端口	1456
codexRedirectPort	Codex OAuth redirect 端口	插件默认值

Gemini OAuth credentials

使用 Gemini 前，需要提供 Google installed-app OAuth client：

export GEMINI_CLIENT_ID="..."
export GEMINI_CLIENT_SECRET="..."

对于非 FREE tier，还需要指定 Google Cloud Project：

export GOOGLE_CLOUD_PROJECT="your-project-id"

也可以使用：

export GOOGLE_CLOUD_PROJECT_ID="your-project-id"

Authentication behavior

Codex

Codex 登录状态会同步到 DSH 的 openai-codex provider route。

插件只会移除由自身创建并持有 ownership 标记的 Codex route，不会覆盖或删除用户自行配置的同名 route。

Gemini

Gemini 使用独立的 gemini-cli-oauth Adapter。

登录成功后注册 Adapter；登出或确认 OAuth 凭据失效时撤销 Adapter。

Gemini 模型目录来自 Code Assist retrieveUserQuota，结果缓存 5 分钟。如果远端暂时失败或返回空目录，会优先复用最近一次成功获取的模型列表。

明确的 HTTP 401 或 OAuth invalid_grant 会被视为凭据已失效，此时插件会清理凭据并撤销对应 provider；临时网络或刷新错误不会立即清除登录状态。

Security

OAuth token 与 Codex route ownership 元数据保存在：

$DSH_HOME/oauth-bridge.json

存储文件权限为：

0600

OAuth control server 默认监听：

127.0.0.1:1456

Control API 仅允许 loopback 来源，包括：

• localhost
• 127.0.0.1
• ::1

Limitations

当前版本：

• 仅支持单账号。
• Gemini OAuth callback 使用操作系统动态分配的端口。
• 暂不支持 reasoning effort。
• 暂不提供订阅额度展示。
• 暂不支持代理配置。
• 暂不支持 Web Search。
• 暂不支持图像生成。
• 暂不调用 token revoke endpoint。

Develop

Requirements

Node.js：

^22.19.0 || >=24.11.0

Install dependencies

npm install

Build

npm run build

Type check

npm run check

Test

npm test

Build browser bundle only

npm run bundle

Watch browser bundle

npm run watch:client

Project Layout

src/
├── index.ts            # 插件入口、本地 control server、生命周期管理
├── routes.ts           # Codex / Gemini provider route 动态注册
├── codex.ts            # ChatGPT Codex OAuth 与服务逻辑
├── gemini.ts           # Gemini Code Assist OAuth、Adapter 与模型目录
├── storage.ts          # OAuth 凭据与 route ownership 持久化
├── client.tsx          # DSH Web 设置页 OAuth UI
└── client-locales.ts   # OAuth UI 中英文文案

Package

npm package：

@kelvinwww/dsh-oauth

插件入口同时导出 Gemini Adapter、Codex/Gemini service factory 与 storage API，便于测试和二次集成。