前言¶
在 DeepSeek Harness（DSH）裏接入多家模型提供商時，常見做法是各環境只配一把 API 密鑰。密鑰輪換、備用密鑰和用量覈對往往要改配置文件或環境變量，和 DSH 的 Web 設置、插件化運維路徑也不一致。社區插件 dsh-key-managment 按提供商維護密鑰池，支持在界面裏手動切換當前生效密鑰，並附帶可達性探測與部分服務商的套餐餘量展示。下面介紹它的定位、能力、安裝步驟和日常使用方式。
這是什麼¶
dsh-key-managment 是面向 DeepSeek Harness 的分提供商 API 密鑰池插件，維護者爲 AhYi8，在 SkillHub 插件目錄 中歸類爲 admin-security。插件描述爲：Per-provider API key pool with manual switching for DSH providers——即爲每個 DSH 提供商配置多把密鑰，並由使用者手動選擇哪一把當前生效。
當前 package.json 中版本爲 1.0.3，許可證爲 MIT。DSH 側通過 Cordis 補丁（cordis.patch.yml）接入，Web 客戶端會注入設置與會話相關 UI 模塊，在瀏覽器端提供配置入口。
核心功能¶
以下能力均來自項目 README 與倉庫結構說明，安裝前仍以你本地核對爲準。
密鑰池與手動切換¶
按提供商錄入多把 API 密鑰，在設置頁選擇當前使用的密鑰即可切換，無需爲每次輪換改動全局配置。
後臺可達性探測¶
可按可配置間隔對密鑰做可達性探測；插件啓動時會先執行一輪探測。探測間隔與開關均在 Web 設置頁調整。
用量展示¶
內置多家服務商的套餐餘量適配器，README 中列出的包括：DeepSeek 餘額、Kimi Coding、MiniMax、智譜 / Z.ai、OpenRouter、Command Code、OpenCode Go、Magpie 等。具體展示以各適配器實現與對應 API 爲準。
Web 設置界面與密鑰脫敏¶
在 DSH 瀏覽器端提供配置與切換入口。界面與日誌中對密鑰做自動脫敏展示，降低誤泄露風險。
安裝與啓用¶
插件面向 Web profile。官方 README 給出的安裝方式爲：
dsh plugin --profile web add dsh-key-managment
也可以在 DSH 設置 → 插件 / 插件市場中搜索 dsh-key-managment 安裝。SkillHub 爲社區維護的插件目錄站點，與 DeepSeek / 幻方無官方從屬關係；安裝行爲發生在你的 DSH 實例上，而非「官方應用商店」一鍵分發。
典型用法¶
安裝完成後，按下面順序即可完成基礎配置。
- 打開插件設置，爲各模型提供商添加一條或多條 API 密鑰。
- 爲每個提供商選擇當前生效的密鑰。
- 根據需要開啓後臺探測，並設置探測間隔。
- 在用量相關區域查看已適配服務商的套餐餘量（若該提供商已有適配器）。
README 未給出更細的字段名截圖；字段與開關以你安裝版本下的設置頁爲準。
適用場景與注意¶
適合在 DSH Web 環境下集中管理多提供商、多密鑰，並需要 occasional 手動切密鑰或查看餘量的開發者與運維。手動切換意味着不會自動按探測結果 failover 到另一把密鑰，輪換策略仍由你在界面中決定。
安全方面需要明確：DSH 插件以當前 DSH 進程的權限運行，密鑰會保存在插件配置所涉的存儲路徑中。安裝前應閱讀 GitHub 倉庫 源碼與 MIT 許可證，確認符合你的合規與審計要求。不要在不受信環境複製生產密鑰做試驗。
若你自行參與開發，倉庫提供 pnpm install 與 node --test core.test.mjs 等測試入口；日常使用一般只需通過 DSH 插件市場或上述 CLI 安裝即可。
結尾¶
dsh-key-managment 把「按提供商的多密鑰池 + 手動切換 + 探測與餘量」收進 DSH 插件，與「一切皆插件」的 DSH 理念一致。進一步瞭解可從目錄頁 SkillHub：AhYi8/dsh-key-managment 進入，源碼與安裝說明見 GitHub：AhYi8/dsh-key-managment。
