前言¶
在 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 各自保留相應名稱與商標。倉庫地址：
