前言¶
在 DeepSeek Harness 的插件化使用方式里,不少能力可以以插件形式接入。对使用 openai-codex provider 的场景来说,除了模型请求本身,还常需要处理浏览器 OAuth、本地回调、凭据保存和访问令牌刷新。dyuan311/dsh-openai-codex-oauth 解决的是这一类登录与凭据管理问题:它把 ChatGPT 订阅 OAuth 登录接到 DeepSeek Harness 的 Web 界面中。
这是什么¶
dsh-openai-codex-oauth 是一个面向 DeepSeek Harness 的社区插件,定位是 openai-codex provider 的 ChatGPT subscription OAuth。
该插件使用 @earendil-works/pi-ai 提供的 OAuth 实现,并使用 @deepseek-ai/dsh-llm-pi-ai 模型适配器。
核心功能¶
1、交互式登录:支持 /codex-login,可启动 OAuth 授权。
2、凭据持久化:OAuth credential 存到 OPENAI_CODEX_OAUTH_CREDENTIAL,access token 存到 OPENAI_CODEX_ACCESS_TOKEN。
3、token refresh:提供访问令牌刷新相关能力。
4、登录状态查询:/codex-status 显示 credential state、source 和 access-token expiry。
5、退出登录:/codex-logout 清除存储的 OAuth credential 和 access token。
6、登录方式:支持浏览器 OAuth,使用 OAuth 2.0 Authorization Code with PKCE;也支持 device-code login。
安装与启用¶
先确认运行环境满足要求:
- DeepSeek Harness
0.1.0-rc.6 - Node.js
22.19.0or newer - pnpm
- 一个具有 Codex subscription access 的 OpenAI 账户
- 浏览器登录期间,本地 TCP 端口
1455可用
插件以当前 dsh 进程权限运行,安装前建议先检查源码、依赖与许可证。该项目使用 MIT License;上游项目也按 MIT License 分发,相关版权声明和许可文本在 THIRD_PARTY_NOTICES.md。
已有本地 tgz 文件时,在对应目录执行:
dsh plugin --profile web add ./dsh-openai-codex-oauth-0.1.1.tgz
安装后进入 DeepSeek Harness 的 Web 界面,即可使用下面的登录命令。
典型用法¶
先打开 Harness Web 界面,发送:
/codex-login
按提示选择浏览器登录。也可以使用显式方式:
/codex-login browser
/codex-login device
授权完成后,从模型选择器中选择一个 openai-codex 模型。
检查状态:
/codex-status
退出登录:
/codex-logout
适用场景与注意¶
适合已经在 DeepSeek Harness 中使用 openai-codex provider,并希望通过 Web 界面完成 ChatGPT 订阅 OAuth 登录的使用者。它不替代模型调用本身,而是补充登录、凭据状态和退出清理。
使用 OAuth 时需要注意访问与刷新令牌对应的是相关 OpenAI 账户。请保持 Harness 凭据文件私有,并将账户控制在单一用户手中。同时,应在账户的 usage allowance 内使用;OpenAI 服务条款和具体套餐规则决定订阅访问权限。
Codex 后端和请求格式可能变化;未来 OpenAI 或 pi-ai 的更新可能需要兼容性调整。
链接¶
这是独立社区集成,OpenAI、DeepSeek 和 Pi 各自保留相应名称与商标。仓库地址: