前言¶
DSH 的擴展方式強調插件化，第三方模型登錄這類能力可以做成獨立插件接入。dsh-oauth-api 面向的是這類場景：在 DeepSeek Harness 的 Web 管理界面裏發起第三方 OAuth 登錄，保存 token，並讓對應 provider 的模型出現在官方模型選擇器中。
下面介紹它支持哪些 provider，以及如何在本地完成安裝、登錄和驗證。
這是什麼¶
dsh-oauth-api 是一個 out-of-tree DeepSeek Harness plugin，用於第三方 OAuth login。
它被明確描述爲 community plugin，不是官方 DeepSeek 產品，也不是上游 PR。倉庫路徑爲 hahaha-taotao/dsh-oauth-api，package.json 中的 name 爲 dsh-oauth。資料中未給出獨立作者字段，本文按倉庫路徑引用。許可證爲 MIT。
核心功能¶
安裝後，插件會在 Web 界面中增加一個 Settings -> OAuth 登錄 視圖，每個 provider 顯示一張卡片。
它支持以下四組 provider：
| 設置卡片 | 模型選擇器分組 | 登錄方式 | 推理接口 |
|---|---|---|---|
| Grok / xAI | xai-oauth |
Device code，認證端點 auth.x.ai |
https://api.x.ai/v1/responses |
| Codex / ChatGPT | codex-oauth |
Device code，認證端點 auth.openai.com/codex |
https://chatgpt.com/backend-api/codex |
| Claude Code | claude-oauth |
PKCE，打開授權 URL 後粘貼 code#state |
https://api.anthropic.com/v1/messages |
| Kimi Code | kimi-oauth |
Device code，認證端點 auth.kimi.com |
https://api.kimi.com/coding/v1 |
token 會保存在插件自己的 store 中：
$DSH_HOME/oauth/xai.json
$DSH_HOME/oauth/codex.json
$DSH_HOME/oauth/claude.json
$DSH_HOME/oauth/kimi.json
默認 $DSH_HOME 是 ~/.dsh。
插件還會暴露兩個 Cordis 行：
dsh-oauth-host
dsh-oauth-client
安裝與啓用¶
先克隆倉庫，安裝依賴並構建本地包，然後把當前目錄作爲插件加入 web profile：
git clone https://github.com/hahaha-taotao/dsh-oauth-api.git
cd dsh-oauth-api
pnpm install
pnpm build
dsh plugin --profile web add .
啓用後，可以檢查當前 web profile 的配置，確認插件是否被識別：
dsh --profile web --dump-config
在輸出中確認能看到下面兩行：
dsh-oauth-host
dsh-oauth-client
典型用法¶
1、啓動 Web UI：
dsh web
2、打開 Settings -> OAuth 登錄，在目標 provider 卡片上點擊 登錄。
3、完成瀏覽器側登錄步驟：
- Grok / xAI、Codex / ChatGPT、Kimi Code：完成 device code 流程。
- Claude Code：打開授權 URL，然後粘貼
code#state。
4、在官方模型選擇器中選擇對應分組：
xai-oauth
codex-oauth
claude-oauth
kimi-oauth
登錄成功不會自動改變當前默認模型。需要手動在官方模型選擇器裏選擇對應的 provider 分組。
如果使用 Grok，並且推理時提示 scope 缺失，可以重新登錄一次。Grok token 需要 api:access scope。
適用場景與注意¶
適合以下場景：
- 在 DSH 的
webprofile 中統一發起第三方 OAuth 登錄。 - 把 Grok / xAI、Codex / ChatGPT、Claude Code、Kimi Code 的 token 保存在插件本地 store 中。
- 通過官方模型選擇器切換到對應的
*-oauth分組。
使用注意：
- 這是社區插件，不是官方 DeepSeek 產品，也不是上游 PR。
- 社區插件目錄是獨立站點，不等同於官方應用商店。
- 插件會以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
- token 只保存在這個插件的 store 中，默認路徑位於
~/.dsh/oauth/。 - 登錄成功不等於切換默認模型，需要在模型選擇器中選擇對應 provider 分組。
相關鏈接¶
- GitHub 倉庫：
https://github.com/hahaha-taotao/dsh-oauth-api - 插件目錄線索頁（未驗證）：
https://www.skillhub.cn/plugins/hahaha-taotao/dsh-oauth-api
