前言¶
DeepSeek Harness (DSH) 是一個插件化的智能體開發框架。在實際開發中，開發者經常需要爲同一模型提供商配置多個 API Key（例如區分個人賬號與企業賬號），或者在不同 Key 之間切換以平衡負載。DSH 原生支持憑證管理，但在多 Key 場景下，手動切換或覆蓋環境變量往往不夠直觀，且容易導致配置未生效。
dsh-key-manager 插件旨在解決這一痛點。它允許你在 Settings → API 密鑰 頁面維護一個 Key 池，爲每個 Key 添加備註，並確保切換操作在下次模型調用時真正生效。
核心功能¶
該插件提供以下核心能力：
- 按提供商 Key 池化：只列出在“模型”設置頁中實際配置了 Key 引用的提供商。
- 備註與重命名：可以爲每個 Key 添加備註（如“個人”、“團隊”），甚至對當前正在使用的 Key 進行重命名。
- 真正生效的切換：激活一個 Key 時，插件會通過 Harness 的憑證機制寫入該值。如果原生環境變量或
.env文件覆蓋了默認引用，插件會接管並指向其管理的引用，確保下次調用使用新 Key。 - 當前使用鎖定：正在使用的 Key 會始終顯示在列表頂部，並帶有綠色徽章；未加入池管理的 Key 會顯示爲“live”行。
- 智能默認選擇：頁面加載時，會自動預選當前選中模型背後的提供商。
- 持久化與無硬編碼：註冊表文件保存在 Harness 數據目錄中，不依賴硬編碼路徑。
安裝與啓用¶
安裝該插件需要使用 DSH 的 Web 配置模式。
dsh plugin --profile web add dsh-key-manager
安裝完成後，重啓 dsh web 服務，然後打開 Settings → API 密鑰，即可看到 Key 管理界面。
典型用法¶
- 在 Settings → 模型 中配置好模型提供商（例如 OpenAI）。
- 進入 Settings → API 密鑰。
- 輸入第一個 API Key，添加備註（如“personal”），點擊激活。
- 繼續添加第二個 Key，添加備註（如“team”），點擊激活。
- 下次模型調用時，系統將使用剛剛激活的 Key。頁面會顯示當前生效的引用來源。
注意事項¶
- 存儲安全：Key 值以明文形式保存在 Harness 數據目錄下（
~/.dsh/dsh-key-manager.），安全級別與 Harness 自身的.credentials.yaml一致。如果是在共享機器上運行，請務必鎖定該目錄的權限。 - 生態說明：DSH 插件目錄與 DeepSeek 或幻方官方無從屬關係，本插件由社區開發者維護。
- 許可證：遵循 MIT 許可證。
總結¶
dsh-key-manager 是一個針對 DeepSeek Harness 多賬號管理場景的實用工具。它通過池化管理和強制生效機制，簡化了 Key 切換流程，適合需要精細化管理 API 資源的開發者。更多細節與源碼，可參考其 GitHub 倉庫。
