前言¶
在 DeepSeek Harness（DSH）裏管理多個自定義模型 API 時，常見做法是按供應商各配一套密鑰，或在同一路由下手工切換憑據。供應商一多、同一端點下又有多把密鑰時，設置頁和會話裏的模型菜單容易變平、難找，也不便區分「同一模型 ID、不同密鑰」該用哪一份配置。
下面介紹社區插件 dsh-model-groups（維護者 betsunninda9-lgtm，分類：模型推理）。它在 DSH 0.2.2-rc.1 網頁端提供「供應商 → 密鑰配置 → 模型」的分層選擇與多密鑰配置，並包含經校驗的宿主兼容補丁，不改變你已有的供應商、密鑰與會話數據本身。
這是什麼¶
dsh-model-groups 是面向 DSH 網頁界面的模型選擇器插件：同一供應商共用 Provider ID、API 地址和協議；各份「密鑰配置」分別設置名稱、密鑰與模型列表。選擇模型時按你手動點選的那份配置使用對應密鑰，不自動輪換密鑰，也不自動切到其他配置。
- 倉庫：GitHub — betsunninda9-lgtm/dsh-model-groups
- 目錄頁：SkillHub 插件頁
- 許可證：MIT（含改編自 DeepSeek Harness 的代碼，保留原版權聲明）
- 當前 npm 正式版：0.3.4（
engines.dsh要求 0.2.2-rc.1；Node.js ≥ 22）
在 dsh-go 場景下，能力體現在對應網頁上，不替換 App 內原生模型菜單。
核心功能¶
資料中可覈對的能力如下。
- 分層瀏覽與選擇：按「供應商 → 密鑰配置 → 模型」展開；支持原地摺疊、側邊面板、名稱搜索、全部展開與收起；會記住各級摺疊狀態，搜索時臨時展開匹配項。
- 多密鑰與相同模型 ID：不同密鑰配置可使用相同模型 ID；會話裏選中某配置下的模型時，使用那份配置的密鑰。
- 手動選配置：不自動輪換密鑰，不自動合併供應商或遷移舊會話選擇；已有單密鑰配置與舊會話選擇會保留。
- 宿主補丁：加載時檢查並備份原文件，自動應用五項補丁；版本或文件內容不受支持時停止應用、不強制覆蓋；不修改現有供應商、密鑰或會話配置。
- 設置側多密鑰：在 設置 → 模型 中可爲自定義 API 開啓 多密鑰配置（依賴補丁生效後的網頁界面）。
關閉多密鑰會保留已保存的配置與憑據；刪除配置不會同時刪除憑據。有未保存的密鑰輸入時，需先保存或清空才能確認關閉。
安裝與啓用¶
插件在目標設備的 DSH 環境中安裝。web 爲 dsh-go 本機常用 profile，其他環境請換成實際 profile。安裝包見 npm 與 GitHub v0.3.4 發佈頁。
在 DSH 環境中執行（命令來自倉庫 README）：
dsh plugin --profile web add dsh-model-groups@0.3.4 --registry=https://registry.npmjs.org/
經過上面的步驟後：
- 等待插件加載並出現「補丁已自動安裝」類提示。
- 保存草稿，重啓原 DSH 引擎並刷新網頁（無需先停引擎，也無需在外部終端手工打補丁）。
- 若本次啓動纔剛應用補丁，可能需再重啓一次以載入新模塊；補丁已在磁盤就緒時，後續加載不會重複寫入。
插件以當前 DSH 進程權限運行；安裝前應自行查看源碼與 MIT 許可證，並確認 DSH 安裝目錄可寫、目標程序文件版本與哈希在支持範圍內。
沒有出現 多密鑰配置 開關時，先確認已在自動補丁後重啓引擎並刷新網頁。仍異常時，可在已安裝插件目錄執行（將 /opt/dsh 換成實際 DSH 根目錄）：
node scripts/doctor.mjs --dsh-root /opt/dsh --json
五項相關文件應爲 patched。該命令只讀檢查程序文件，不讀取密鑰。
典型用法¶
- 打開 設置 → 模型，新增或編輯自定義模型 API。
- 填寫供應商公共的 Provider ID、API 地址和協議。
- 開啓 多密鑰配置，爲每份配置填寫名稱、密鑰和模型列表，點擊「應用」。
- 在會話模型菜單中展開供應商和配置，選擇需要的模型。
菜單結構示意（來自 README）：
示例供應商 A
配置 A
示例模型
配置 B
示例模型
示例供應商 B
示例模型
開啓多密鑰後，在模型菜單裏手動選新配置即可；插件不會自動把已有供應商合併或改寫舊會話裏的選擇。
適用場景與注意¶
適合：同一供應商下有多把 API 密鑰、希望按「配置名」區分用量或環境；需要在網頁模型菜單裏快速摺疊/搜索大量供應商與模型；已固定使用 DSH 0.2.2-rc.1 網頁端（或兼容該插件聲明的宿主版本）。
注意：
- DSH 大版本升級前請覈對插件兼容範圍；不支持的新文件會被拒絕，需等待適配，不能強制套用舊補丁。
- 卸載插件 不會 自動還原宿主補丁或刪除憑據。完整還原前需將會話切回普通單密鑰模型，關閉多密鑰並清理原版不支持的
multiKey、keyEntries等字段（保留仍要用的憑據），再在保留的插件包目錄執行還原腳本（詳見 README「卸載與還原」）。 - 窄屏側邊面板會按可用寬度調整；三級並列時較長名稱可能被截斷。
- 社區目錄（如 SkillHub）與 DeepSeek / 幻方無官方從屬關係；DSH 生態強調「一切皆插件」，本文事實以 GitHub README 與 npm 包元數據爲準。
更新時使用對應發佈版本的安裝命令 reinstall，再按加載日誌重啓引擎並刷新網頁；兼容補丁未變化時不會重複應用。
結尾¶
dsh-model-groups 把網頁端的模型選擇做成可摺疊的三級結構，並把多密鑰留在「手動選配置」的粒度上，適合多供應商、多密鑰並行維護的場景。安裝與行爲以官方 README 爲準。
