前言¶
DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。對於希望接入 SenseNova API 的開發者，通常需要手動處理路由註冊、模型列表獲取以及多賬號的限流問題。alaxrpg/dsh-sensenova-provider 插件提供了一個官方 DSH 路由之外的解決方案，它註冊了 sensenova 路由，集成了實時模型目錄、OpenAI 兼容的流式接口，並實現了多賬號 API Key 的自動輪轉與 Web 界面管理。
核心功能¶
- 路由註冊：在 DSH 中註冊
sensenova提供者路由（顯示名稱：SenseNova）。 - 實時模型目錄：通過
GET {apiBase}/v1/models獲取 SenseNova 的可用模型列表。 - OpenAI 兼容流式輸出：支持標準的
POST {apiBase}/v1/chat/completions(SSE) 請求。 - 多賬號自動輪轉：在單一共享 Base URL 下管理多個 API Key，自動處理限流：
429 Too Many Requests：進入冷卻期（尊重Retry-After，默認 60s）。401 Unauthorized：禁用該 Key，直到憑證更新。- Key 耗盡：報錯
RATE_LIMIT或INVALID_CREDENTIAL。 - Web 設置頁面：提供模型頁卡片與獨立設置區域。
環境要求¶
- DSH host 版本：
>= 0.1.2-alpha.3(Alpha 線)。 - Node.js 版本：
>= 22。
安裝與啓用¶
使用官方 CLI 安裝插件：
dsh plugin --profile <name> add dsh-sensenova-provider
也可以從本地路徑安裝：
dsh plugin --profile <name> add ./dsh-sensenova-provider
配置說明¶
安裝後，插件會在設置中增加 llm-sensenova 區域。默認配置如下：
- API Base：https://token.sensenova.cn/v1。
- 默認憑證環境變量：SENSENOVA_API_KEY。
配置字段詳情：
| 字段 | 類型 | 默認值 | 說明 |
|---|---|---|---|
apiBase |
string | https://token.sensenova.cn/v1 |
所有賬號共享的基礎 URL。 |
apiKeyEnv |
credential-ref | SENSENOVA_API_KEY |
默認賬號憑證引用。 |
accounts[] |
array | [] |
額外賬號列表，格式爲 { id, label, apiKeyEnv }。 |
activeAccount |
string | "" |
指定首選賬號 ID（空字符串表示自動選擇第一個可用賬號）。 |
API Key 通過 DSH 憑證服務存儲，不會直接發送給模型。
使用方式¶
- 在 DSH 的 Models 頁面選擇 SenseNova 提供者。
- 填入配置的 Base URL 和 API Key。
- 插件將自動加載模型列表並支持流式對話。
注意事項¶
- 非官方插件：此插件由社區開發者維護，非 DeepSeek 官方出品。
- 運行時依賴：運行時導入接口是
@deepseek-ai/dsh-llm的穩定子集。 - ToolCallId：符號定義在本地
src/brand.ts中，不與核心庫直接依賴。
總結¶
該插件通過將 SenseNova 的接入流程標準化，解決了多賬號管理中的限流痛點，適合需要在 DSH 中穩定使用 SenseNova 服務的開發者。
