前言¶
在 DeepSeek Harness(DSH)裏跑智能體或對話,通常要爲每個廠商單獨申請 API Key,再寫進配置。若你已經在 Kimi Code、Grok(X Premium)、Google Antigravity、智譜 GLM 等平臺付費訂閱,同一能力往往還有一套 OAuth 登錄後的 Web/API 額度,和開放平臺 Key 是兩條線。
下面介紹社區插件 dsh-plugin-subscription-oauth(倉庫 EricFL1998/dsh-subscription-oauth)。它在 DSH 內走各服務商自帶的 OAuth / 設備碼登錄,把訂閱賬號註冊爲 ctx.llm 路由,並在 Settings → Subscriptions 裏展示套餐餘量;請求直連廠商端點,令牌保存在本機。維護者爲 EricFL1998,npm 包名與插件 ID 爲 dsh-plugin-subscription-oauth,許可證 MIT。
這是什麼¶
一句話:把你已經付費的 AI 訂閱賬號,變成 DSH 會話裏的 LLM Provider,一次登錄、按模型選用,並支持跨 Provider 的 auto 回退鏈。
與「自己找 Key、填環境變量」相比,插件側重點是:登錄流程由插件發起,模型列表從各 Provider 端點讀取並緩存,Settings 裏可隱藏、排序模型,Composer 芯片顯示實時配額。
支持的 Provider¶
資料中列出的接入方式如下(模型 ID 以各賬號端點返回的列表爲準,非插件硬編碼):
| Provider | 能力概要 | 登錄方式 |
|---|---|---|
| Kimi Code | 如 kimi-for-coding、k3(1M)、k3-256k |
OAuth 設備流(展示碼、瀏覽器確認) |
| Grok (X Premium) | 賬號模型列表(如 grok-4.7),含 lightspeed 快速變體 |
瀏覽器 OAuth(自動跳轉) |
| Google Antigravity | Claude Sonnet/Opus、Gemini Flash、GPT-OSS 及 reasoning 檔位 | Google 賬號 OAuth |
| GLM (BigModel) | 編碼宿主列出的模型(如 glm-5.3、glm-5.3-flash) |
ZCode 瀏覽器登錄(輪詢) |
| Volcengine Ark | 套餐內編碼模型 | 火山引擎 SSO |
| Xiaomi MiMo | MiMo 模型列表,應用內兩模型集作 fallback | 小米賬號(二維碼 / 密碼) |
| WorkBuddy(國內版) | Hy、GLM、Kimi、DeepSeek、MiniMax 等 | 瀏覽器 OAuth(騰訊) |
所有已啓用 Provider 的模型也會進入 auto 路由:在模型選擇器裏選 auto 時,Harness 按你啓用的順序依次嘗試,直到有模型成功響應。
核心功能¶
OAuth 登錄與本地憑據¶
每個 Provider 只需登錄一次,無需查找、粘貼或輪換 API Key。插件執行廠商自帶的 OAuth / device flow,令牌寫入本機(README 示例路徑:~/.dsh/plugins/kimi-oauth/auth.json,權限 0600,原子寫入)。插件僅與各 Provider 主機及 OAuth 端點通信,README 說明無遙測、無第三方中繼。
套餐用量與模型選擇器¶
Settings 卡片與 Composer 芯片展示各賬號剩餘配額(如 Kimi 的 5 小時 / 周窗口與 credit、Grok 周 credit、Antigravity 的 Gemini / Claude 桶、GLM / Ark / MiMo / WorkBuddy 等 credit),含進度條與重置時間。
各 Provider 模型進入會話模型選擇器,帶上下文窗口與 reasoning 檔位;可在 Settings 裏按 Provider 隱藏、拖拽排序,也可手動添加當前構建未內置的 model id。模型目錄來自 Provider 端點,登錄或 Settings 的 refresh models 會重新拉取;瀏覽選擇器本身不額外發請求。
Fast / lightspeed 變體¶
對支持快速變體的模型(例如 Grok 4.7 對應 grok-4.7-build-fast),模型選擇器旁有閃電按鈕可切換;在 UI 上表現爲 reasoning 檔位,基礎模型仍可單獨選擇。
多賬號與 Auto 回退¶
同一 Provider 可登錄多個賬號;某一賬號額度用盡時,插件會使用下一個賬號。Auto fallback:在選用 auto 時,若首選模型被拒絕(重命名、限流、配額用盡等),會跳到下一個已啓用模型;流式響應已開始後不再繼續回退。
安裝與啓用¶
插件面向 web profile(package.json 中 dsh.client.platform 爲 web)。官方安裝命令如下:
dsh plugin --profile web add dsh-plugin-subscription-oauth
安裝後重啓 DeepSeek Harness,打開 Settings → Subscriptions(訂閱)。
指定版本或從 GitHub 安裝(README 原文):
dsh plugin --profile web add dsh-plugin-subscription-oauth@0.10.2
dsh plugin --profile web add github:EricFL1998/dsh-subscription-oauth
運行環境要求 Node.js >= 20(來自 package.json 的 engines)。
典型用法¶
- 打開 Settings → Subscriptions。每個 Provider 一張卡片;已登錄的排在前面,
auto位於前列。 - 在某 Provider 上點 Connect。瀏覽器或設備碼啓動該廠商登錄,在瀏覽器側完成;卡片會自動更新。
- 在 Composer 的模型選擇器裏選用該 Provider 的模型或
auto;芯片顯示當前 Provider 的實時用量。 - 展開卡片可管理賬號(默認賬號、登出、刷新 token)、開關模型可見性、拖拽排序、添加 model id,並查看憑據文件路徑與端點信息。
提示(README):若要在同一 Provider 換賬號,先 Sign out 再 Connect;瀏覽器裏當前登錄的賬號即 OAuth 使用的賬號。
在 DSH 中註冊的內容¶
| 表面 | 內容 |
|---|---|
ctx.llm |
kimi、grok、antigravity、glm、ark、mimo、workbuddy 與 auto 路由(模型、reasoning、流式) |
| Settings | Subscriptions 分區,每 Provider 一卡 |
| Model picker | 各 Provider 模型 + 跨全部 Provider 的 auto |
| Composer chip | 當前 Provider 的實時套餐用量 |
隱藏某個 Provider¶
不卸載插件、但不想讓某 Provider 模型出現在選擇器時,可在 profile 的 cordis.patch.yml 裏縮短 providers 列表:
# $DSH_HOME/profiles/<profile>/cordis.patch.yml
plugins:
dsh-plugin-subscription-oauth:
providers: [kimi, grok, antigravity, glm, ark, mimo, workbuddy]
去掉不需要的項即可;默認包含上述全部已實現路由。
適用場景與注意¶
適合誰:已在 Kimi Code、X Premium Grok、Antigravity、智譜 GLM、火山 Ark、小米 MiMo、WorkBuddy 等渠道有訂閱,希望在 DSH 裏統一選模型、看配額,且不想維護多套 API Key 的開發者。
權限與安全:插件以當前 DSH 進程的用戶權限運行,憑據落在本機 ~/.dsh 目錄;安裝前建議在 GitHub 倉庫 查看源碼與 MIT 許可證,確認符合你的合規要求。訂閱賬號僅本機使用,README 說明不在機器間共享。
生態說明:DSH 採用「一切皆插件」的擴展方式;SkillHub 目錄頁 爲社區站點,與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-plugin-subscription-oauth 把常見訂閱產品的 OAuth 登錄、模型列表與配額展示接到 DSH 的 ctx.llm 與 Settings UI 上,並輔以多賬號池化與 auto 有序回退。若你的主力模型來自上述訂閱而非開放平臺 Key,可按 README 安裝後在 Settings → Subscriptions 完成連接。
- 目錄頁:https://www.skillhub.cn/plugins/EricFL1998/dsh-subscription-oauth
- GitHub:https://github.com/EricFL1998/dsh-subscription-oauth