DeepSeek Harness 插件介紹：godd6366/dsh-sub2api

前言¶

DeepSeek Harness (DSH) 通過插件系統擴展功能。sub2api 是一個將訂閱額度轉化爲 OpenAI 兼容端口的網關，每個 API Key 綁定一個組，組決定平臺（OpenAI/Claude/Grok）和可用模型。

本文介紹的 godd6366/dsh-sub2api 插件將 sub2api 網關接入 DSH，使其作爲模型提供商。它將 OpenAI、Claude 和 Grok 的路由統一在單一基礎 URL 後，並提供模型發現、用量查詢和設置頁面。

核心功能¶

多路由支持：支持 sub2api-openai、sub2api-claude、sub2api-grok 三個提供者路由，共享單一基礎 URL。
流式對話：支持 SSE 流式輸出、工具調用、推理增量和 Token 用量統計。
模型發現：通過 GET {baseURL}/v1/models 一鍵獲取模型列表，與網關分組完全匹配。
推理強度調整：支持調整 reasoning effort（如 none/low/medium/high/xhigh/max），配置項從 models.dev 獲取。
用量查詢：通過 GET {baseURL}/v1/usage 查看配額、餘額和訂閱窗口。
圖片生成：支持選擇生成模型，保存至工作區並返回內聯附件。
標準化配置：配置存儲在 llm-sub2api: 區段，密鑰通過憑證服務或環境變量管理。
提供商圖標：內置 LobeHub 的 SVG 圖標。

安裝¶

此插件依賴 DeepSeek Harness 0.1.2-rc.1 或更高版本。安裝命令如下：

dsh plugin --profile web add @godd6366/dsh-sub2api

安裝後，路由由 dsh-llm-pi-ai 服務，插件負責將設置轉換爲 llm-pi-ai: 配置文件。注意：dsh-client-runtime 不再是必需依賴。

配置與使用¶

基礎配置¶

在 DeepSeek Harness 中進入 Settings → Sub2API 模型，或直接編輯 $DSH_HOME/settings.yaml：

llm-sub2api:
  baseURL: http://localhost:8080
  providers:
    openai:
      apiKeyEnv: SUB2API_OPENAI_API_KEY
      models:
        - id: gpt-5.6-sol
    claude:
      apiKeyEnv: SUB2API_CLAUDE_API_KEY
    grok:
      apiKeyEnv: SUB2API_GROK_API_KEY

密鑰管理¶

將 API Key 存儲在憑證服務（Web 界面 Models 頁面寫入）或環境變量中（例如 SUB2API_OPENAI_API_KEY）。
路由激活條件：當平臺配置了 Key 且至少有一個模型時，路由激活；清除 Key 或空模型列表將註銷路由。

高級設置：端點覆蓋¶

若網關未原生支持某協議，可在配置中強制指定 api 字段（無設置頁控制）：

llm-sub2api:
  providers:
    openai:
      apiKeyEnv: SUB2API_OPENAI_API_KEY
      api: openai-responses  # 可選: openai-completions / openai-responses / anthropic-messages
      models:
        - id: gpt-5.6-sol

常用操作¶

獲取模型：點擊設置頁面的“獲取模型”按鈕，自動執行 GET {baseURL}/v1/models。
查看用量：點擊“查看用量”按鈕，執行 GET {baseURL}/v1/usage。
圖片生成：使用 generate_image 工具，保存圖片到工作區。

注意事項¶

版本要求：必須使用 DSH 0.1.2-rc.1 或更高版本。
後端依賴：路由由 dsh-llm-pi-ai 服務，插件僅在啓動時進行防禦性檢查（確保 assistant.usage 存在）。
輸入模態：若模型未聲明 image 輸入模態，DSH 將拒絕發送圖片。

總結¶

godd6366/dsh-sub2api 是連接 sub2api 網關與 DeepSeek Harness 的橋樑。它通過標準化配置，將多提供商的路由統一管理，適合需要在 DSH 中整合多個訂閱源的開發者。

源碼：https://github.com/GodD6366/dsh-sub2api
目錄：https://www.skillhub.cn/plugins/GodD6366/dsh-sub2api