DeepSeek Harness (DSH) 是構建 AI 智能體的常用框架。在開發過程中,尋找可用的免費模型接口並逐一配置提供方,通常需要瀏覽多個網站並手動編輯配置文件。下面介紹一個社區插件,它能在 DSH 的 Web UI 右側直接提供免費模型榜單,並支持一鍵配置。
插件定位¶
這是由 yu-wenchao 維護的 DeepSeek Harness 社區插件,名爲 dsh-free-models-hub。它的核心價值在於:
* 在 DSH 界面右側提供一個分頁的免費模型榜單抽屜面板。
* 支持一鍵配置或批量配置自定義提供方,用戶只需在設置中粘貼 API Key。
* 提供本地多 Key 輪換代理功能,自動處理 Key 失效切換。
安裝與啓用¶
安裝過程通過 DSH 的官方插件管理命令完成。
- 打開終端或命令行,執行以下命令安裝插件(推薦使用 npm 源):
dsh plugin --profile web add dsh-free-models-hub
- 執行安裝命令後,重啓 DSH 應用程序,插件即可生效。
核心功能¶
- 右側邊緣抽屜面板:DSH 啓動後,窗口右側邊緣會出現一個 🎁 圓形按鈕,點擊即可展開面板。
- 一鍵配置 / 批量配置:在面板中點擊模型行,可展開 API 地址、模型名稱等信息。點擊「一鍵配置到 DSH」可將該提供方寫入
設置 → 模型;也可以點擊「配置本頁全部」批量寫入。 - 多 Key 輪換代理:點擊「🔄 多 Key 輪換」,將多條免費 API Key 每行一個粘貼保存。本地代理(默認端口
8787)會自動輪詢這些 Key,當前一個 Key 失效時自動切換到下一條。 - 安全特性:插件全程不接觸用戶 Key,Key 僅通過 DSH 官方的憑據通道傳遞。插件不直接改寫
settings.yaml文件,避免損壞配置。
使用步驟¶
安裝並重啓 DSH 後,按以下步驟操作即可使用:
- 打開面板:點擊 DSH 窗口右側邊緣的 🎁 按鈕展開「免費模型榜」抽屜面板。
- 申請與配置:點擊列表中的模型行展開詳情。如果需要,點擊「🔑 申請免費密鑰key」跳轉至第三方平臺註冊獲取 Key。點擊「⚡ 一鍵配置到 DSH」將提供方寫入設置。
- 填寫 Key:進入 DSH 的「設置 → 模型」,找到
freehub-*開頭的提供方,將申請到的 API Key 粘貼到對應框中並保存。 - 開始對話:在聊天頁的頂部模型選擇器中,切換到該提供方下的模型即可進行對話。
- 配置輪換(可選):若有多條 Key,點擊模型行中的「🔄 多 Key 輪換」進行配置,插件將自動在本地代理中輪詢使用。
注意事項¶
- 數據源:榜單數據由作者運營的後端提供,不包含在倉庫分發文件中。
- 依賴要求:運行該插件需要環境安裝 Node.js >= 18。
- 文件安全:插件不會覆蓋或修改
settings.yaml,現有配置不會因安裝該插件而損壞。 - 許可協議:使用該插件需遵守 MIT 許可協議。
總結¶
這個插件通過將免費模型榜單集成到 DSH 的側邊欄,簡化了從發現模型到配置 Provider 的流程。開發者無需手動維護配置文件,只需在界面中點擊操作,即可快速接入免費模型服務。