dsh-plugin-subs：DeepSeek Harness 訂閱接入插件

前言¶

DeepSeek Harness (DSH) 採取“一切皆插件”的架構。開發者在使用消費級訂閱（如 Claude Pro、ChatGPT Plus 或 Grok）時，通常需要手動處理 API 密鑰或複雜的認證流程。dsh-plugin-subs 插件通過 OAuth 流程，直接將現有的消費者訂閱接入爲本地 LLM 提供商，省去了手動生成 API Key 的步驟。

插件介紹¶

dsh-plugin-subs 是一個由 randomix777 維護的插件，屬於模型推理類別，許可證爲 MIT。它主要解決的問題是：如何在不直接申請開發者 API Key 的情況下，利用現有的消費級訂閱服務在 DSH 中進行模型推理。

核心功能¶

OAuth 登錄：支持通過 OAuth 授權直接登錄訂閱提供商，無需手動配置 API Key。
模型解析：直接從訂閱中解析 Composer 可用的模型列表。
功能支持：支持流式輸出、工具調用（Tool Calling）和圖像輸入（視提供商支持情況而定）。
狀態監控：在 Subscriptions 設置板塊中展示使用狀態。
目錄管理：內置各提供商的模型目錄，且支持在配置中覆蓋。

安裝與啓用¶

安裝該插件無需編譯步驟，直接使用官方命令：

dsh plugin --profile web add dsh-plugin-subs

安裝後，插件將自動註冊到 DSH 的插件系統中。

典型用法¶

啓動 DSH：運行 dsh web，並在終端中打開打印出的 URL。
進入設置：在 Web 界面導航至 Settings → Subscriptions。
連接提供商：點擊目標服務（如 Claude、Codex、Grok 等）旁的 Connect 按鈕。
完成認證：
- 在瀏覽器標籤頁中完成 OAuth 授權流程。
- 在無頭（Headless）環境下，需手動粘貼回調 URL 或授權碼。
- 注意：Agnes AI 需要手動粘貼回調 URL（DSH 不支持 agnes:// 協議）。
選擇模型：在任何聊天界面，打開模型選擇器（/model），從已登錄的提供商列表中選擇模型。

適用場景與注意事項¶

適用場景¶

該插件適合希望直接利用現有消費級訂閱（如 ChatGPT Plus、Claude Pro、Grok 等）進行模型調用的 DSH 用戶，特別是希望減少 API Key 管理複雜度的場景。

注意事項¶

可見性：未登錄的提供商在模型選擇器中不會顯示卡片。
訂閱依賴：提供商的可用性取決於你的訂閱狀態。
圖像生成：需要 Codex 或 Grok 的活躍會話支持。
工具限制：x_search（搜索）工具需要 Grok 登錄及 API 可用的訂閱層級。
OpenRouter：其 API Key 是永久有效的（無刷新機制），更換 Key 需要登出後重新登錄。
中文提供商配置：
- iFlytek Spark 和 Baidu ERNIE 需要在各自平臺註冊 OAuth 應用，並配置環境變量（SPARK_CLIENT_ID、SPARK_CLIENT_SECRET 等）。
Qwen Code 流程：使用設備流（Device Flow）認證，需在驗證 URL 輸入用戶碼，該流程可取消且會過期。

短結尾¶

dsh-plugin-subs 實現了消費級訂閱到 LLM 提供商的無縫對接，簡化了配置流程。更多技術細節和源碼可參考 GitHub 倉庫。