dsh-sensenova-freeapi：非官方 SenseNova 插件介紹

前言¶

DeepSeek Harness (DSH) 採用「一切皆插件」的架構。在接入第三方模型（如 SenseNova）時，渠道限流（429）是常態。多數插件在遇到連續限流時會陷入「全池短路」的死鎖，導致服務不可用。

dsh-sensenova-freeapi 是一個非官方的 DSH LLM 提供商插件。它註冊了 sensenova 路由，對接 SenseNova 的 OpenAI 兼容 API。該插件通過多賬戶 API-Key 輪換、運行態/阻塞態雙列表狀態機等機制，將渠道限流轉化爲穩定的運行狀態，避免因單 Key 失效導致服務中斷。

核心功能¶

多賬戶輪換：支持 1 個默認賬戶 + 多個額外賬戶。通過環回輪換和配額類 429 粘性換 Key，分散單 Key 的限流壓力。
狀態機管理：內置運行態 / 阻塞態雙列表。連續限流時 Key 進入阻塞態並退避；401 錯誤永久禁用 Key；429 錯誤不冷卻、不禁用。
安全性：Key 原文存儲在 DSH 憑據服務中，絕不落盤、絕不出境。錯誤日誌中僅記錄 Key 的哈希指紋。
監控與診斷：提供錯誤記錄表（異步寫入）、當前模型及參數面板、Key 狀態管理（相位、strikes、blockedSince 等）。

安裝與啓用¶

在終端中執行以下命令之一：

# 1. 本地路徑安裝（推薦用於驗證）
dsh plugin --profile <name> add /path/to/dsh-sensenova-freeapi

# 2. GitHub 倉庫安裝
dsh plugin --profile <name> add github:modesthub/dsh-sensenova-freeapi

# 3. npm 發佈後安裝
dsh plugin --profile <name> add dsh-sensenova-freeapi

安裝完成後，DSH 會自動註冊 sensenova 路由。

配置與使用¶

1. 準備工作¶

註冊 SenseNova 賬號並申請 API Key。
配置默認憑據環境變量：
- SENSENOVA_API_KEY
- https://token.sensenova.cn/v1（base URL）

2. 配置多賬戶¶

進入 DSH 的 Models 頁，在配置面板中設置 accounts[]。該插件支持雙賬戶輪換，建議按賬戶交替排列 Key（例如 A1, B1, A2, B2），以降低單賬戶觸頂概率。

3. 推薦模型¶

deepseek-v4-flash：日常、代碼、Agent 處理的首選。
sensenova-6.8-flash-lite：讀圖/視覺任務的首選，搭配 dsh-sensenova-vision-aid 插件使用。
注意：不建議使用 deepseek-flash（V4.1 版本）。

適用場景與注意事項¶

適用場景：需要穩定調用 SenseNova 模型的開發者，或希望處理高頻 429 錯誤以保持服務連續性的場景。
非官方聲明：本插件由社區維護，與 DeepSeek / 幻方無官方從屬關係。
功能裁剪：登錄流程、用量面板、套餐窗口、命令行工具等功能已被裁剪。
Key 管理：Key 僅存儲在 DSH 憑據服務中，不寫入本地文件。
限流認知：SenseNova 的 429 限流是常態，不代表賬號異常。遇到 429 時，插件會自動進行 Key 輪換或進入阻塞等待狀態。

總結¶

dsh-sensenova-freeapi 解決了第三方模型接入中常見的限流與死鎖問題。通過精細化的 Key 狀態管理和自動輪換機制，它能讓 DSH 在高併發限流環境下保持穩定運行。

更多詳情可參考：GitHub | 插件目錄