前言¶

在 DeepSeek Harness（DSH）裏跑智能體，模型提供方往往是繞不過去的一環。很多人手裏已經有 ChatGPT Plus/Pro、Claude Pro/Max 或 X Premium 訂閱，卻還要單獨申請各家 API Key，按量計費、額度管理、密鑰輪換，一套流程走下來並不輕鬆。更麻煩的是，不同平臺模型命名、計費方式和調用協議各不相同，想在同一個 Harness 會話裏靈活切換，配置成本偏高。

社區插件 dsh-plugin-subscriptions（維護者 V1ki）走另一條路：把現有訂閱賬號通過 OAuth 登錄接入 DSH，在 Web 界面完成授權後，即可在模型選擇器裏直接選用對應訂閱下的模型，無需再填 API Key。該插件在 SkillHub 插件庫 分類爲「模型推理」，GitHub 約 251 stars（目錄頁數據，2026-08-25 覈實），MIT 許可證。

需要說明的是：SkillHub 等社區目錄由愛好者維護，與 DeepSeek / 幻方並無官方從屬關係；DSH 本身秉持「一切皆插件」的理念，這類插件屬於社區生態能力擴展。

這是什麼¶

dsh-plugin-subscriptions 是一個 DSH 的 LLM Provider 插件。它把 ChatGPT（Codex）、Claude、Grok（X Premium），以及 GitHub Copilot 訂閱，橋接爲 DSH 可調用的模型後端。

核心思路很直接：

• OAuth 網頁登錄：Codex、Grok 在 DSH Web 界面「設置 → 訂閱」裏點連接，瀏覽器完成授權；Claude 若本機已有 Claude Code 會話憑據（macOS Keychain 或 ~/.claude/.credentials.json），可自動導入，否則同樣走瀏覽器 OAuth。
• Token 本地存儲：憑據保存在 ~/.dsh/plugins/subscriptions/auth.json（文件權限 0600），過期自動刷新。
• 即時模型目錄：已登錄的 Provider 會出現在會話模型選擇器（/model）中，模型列表從各平臺接口即時拉取（Claude 爲插件內置靜態目錄並隨版本更新）。

一句話概括：有訂閱就能用，登錄一次，在 DSH 裏像選普通模型一樣切換各家能力。

核心功能與亮點¶

支持的 Provider¶

只有已登錄的 Provider 纔會出現在模型選擇器；支持視覺的模型會聲明 text + image 輸入模態，圖片內容自動轉換爲各平臺協議格式。

界面與推理能力¶

• 訂閱用量展示：Codex、Claude、Grok 卡片可查看各限額窗口的已用比例、進度條與重置時間（Copilot 暫無用量接口）。
• 推理等級（Effort）：對聲明瞭 reasoning levels 的模型（如 Codex、Grok 4.6/4.5、Copilot 推理模型），模型菜單內可直接選擇推理檔位。
• Codex 速度切換：支持 fast tier 的 Codex 模型可在輸入框旁切換 Standard / Fast（service_tier: priority），也可用 /fast 斜槓命令。
• HTTP(S) 代理：在「設置 → 訂閱 → 代理」中配置，訂閱相關請求（含 OAuth 換票、模型流式調用、工具調用）可走代理；OAuth 授權頁本身仍走瀏覽器系統代理。

附贈工具（隨 Provider 啓用）¶

• x_search（Grok）：調用 xAI 託管的 X 搜索，返回答案與引用。
• image_generate（ChatGPT 或 Grok）：分別經 Codex 後端或 xAI 圖像接口生圖，結果內聯顯示在對話中，文件保存在 ~/.dsh/plugins/subscriptions/images/。
• video_generate（Grok）：異步生成短視頻，內聯播放，保存在 ~/.dsh/plugins/subscriptions/videos/。

安裝與啓用¶

本機需已安裝 dsh CLI。推薦從 npm 安裝預構建產物（無需構建授權）：

dsh plugin --profile web add dsh-plugin-subscriptions

也可從 GitHub 安裝源碼：

dsh plugin --profile web add github:V1ki/dsh-plugin-subscriptions

首次通過 Git 安裝時，pnpm 可能要求允許構建腳本。按提示在 profile 的 pnpm-workspace.yaml 中加入：

allowBuilds:
  dsh-plugin-subscriptions: true

然後重新執行 add。僅對信任的包授予該權限——安裝階段會執行包內代碼。

本地檢出開發安裝：

git clone https://github.com/V1ki/dsh-plugin-subscriptions.git
cd dsh-plugin-subscriptions && pnpm install && pnpm build
dsh plugin --profile web add ./dsh-plugin-subscriptions

安裝完成後重啓 dsh web 以加載插件。

更新 npm 版：

dsh plugin --profile web update --latest dsh-plugin-subscriptions

GitHub 版重新執行 add github:V1ki/dsh-plugin-subscriptions 即可。

典型用法¶

1. 登錄訂閱賬號¶

dsh web

在瀏覽器打開打印的地址，進入 設置 → 訂閱，對目標 Provider 點擊「連接」並完成 OAuth。無圖形界面的 headless 環境可展開手動兜底，粘貼回調 URL 或授權碼。

2. 在會話中切換模型¶

在任意會話輸入 /model，在 ChatGPT (Codex)、Claude (Subscription)、Grok (Subscription) 或 Copilot 分組下選擇模型即可開始對話。

未登錄時，該 Provider 不會出現在選擇器中；若強行請求會返回 MISSING_CREDENTIAL 並提示前往設置頁，不影響其他功能。

3. 按需裁剪 Provider（可選）¶

在插件配置中可指定啓用的 Provider 子集，例如只開 Codex 與 Claude：

- id: llm-subscriptions
  name: dsh-plugin-subscriptions
  config:
    providers: [codex, claude]
    streamIdleTimeoutMs: 300000

也可通過 models 字段覆蓋或補充模型目錄（詳見倉庫 README）。

4. Headless 場景（進階）¶

若不在 profile 中安裝插件，可先在 Web 界面完成登錄（token 文件共享），再使用 overlay 方式掛載本地構建產物運行 headless 任務——具體見倉庫 overlay.example.yml 說明。

適用場景與注意事項¶

適合誰用：

• 已有 ChatGPT / Claude / Grok / Copilot 訂閱，希望在 DSH 智能體工作流中直接複用，而不想維護多套 API Key。
• 需要在同一 Harness 會話裏按任務切換不同廠商模型（例如 Codex 寫代碼、Claude 做長文推理、Grok 搜 X）。
• 希望利用插件附帶的生圖、生視頻、X 搜索等工具能力。

使用前請注意：

1. 服務條款與合規：插件通過 OAuth 使用訂閱賬號訪問各平臺接口，請遵守 ChatGPT、Anthropic、xAI、GitHub 等平臺的服務條款；勿用於違反訂閱協議的場景。
2. 插件權限：DSH 插件以當前 dsh 進程權限運行，可讀寫本機文件、發起網絡請求。安裝前建議閱讀 GitHub 源碼 與 MIT 許可證，確認來源可信。
3. 憑據安全：Token 存於 ~/.dsh/plugins/subscriptions/，代理密碼存於同目錄 proxy.json，注意本機賬戶與文件權限安全。
4. 平臺差異：各 Provider 的模型列表、限額、推理檔位隨訂閱計劃與上游接口變化；Copilot 登錄爲設備碼流程，與瀏覽器 OAuth 略有不同。
5. 社區目錄非官方商店：插件信息以 SkillHub 目錄頁 與 GitHub 倉庫爲準，版本與星標會隨社區同步更新。

小結¶

dsh-plugin-subscriptions 把「已有訂閱」和「DSH 智能體」之間的縫隙填上了：OAuth 登錄、免 API Key、多 Provider 統一接入，還附帶搜索與生圖/生視頻工具。若你正在 SkillHub 或 GitHub 上挑選模型推理類插件，值得一試。

• 目錄頁：https://www.skillhub.cn/plugins/V1ki/dsh-plugin-subscriptions
• GitHub：https://github.com/V1ki/dsh-plugin-subscriptions