前言¶
在 DeepSeek Harness (DSH) 的使用場景中,API Token、服務器登錄和網站賬號等敏感信息的管理是一個痛點。如果這些信息分散存儲,不僅維護成本高,還存在安全隱患。下面介紹 dsh-vault 插件,它爲 DSH 提供了集中管理憑據的能力,支持將機密字段與配置分離存儲。
是什麼¶
dsh-vault 是一個 DeepSeek Harness 的持久化憑據保險庫插件,由用戶 njjpro 維護。它通過設置面板集中管理 API Token、服務器登錄和網站賬號等憑據,並將機密數據安全地存儲在 DSH 憑據庫中,供模型直接調用。
核心功能¶
- 集中管理:在設置面板集中管理所有憑據(API Token、服務器登錄、網站賬號等),支持 5 種內置憑據類別。
- 分離存儲:機密字段與配置分離存儲。Token 等敏感信息存入憑據庫,IP 等非機密字段存入 settings。
- 工具調用:提供
vault_status和vault_get兩個工具,供模型在任務中直接調用,獲取憑據值。 - 界面安全:機密字段在界面不回顯,只顯示已配置或未配置狀態。
安裝與啓用¶
執行以下命令安裝插件:
dsh plugin add https://github.com/njjpro/dsh-vault
安裝完成後需重啓 DSH,設置中會出現「憑據」板塊。
使用方法¶
- 添加憑據:進入設置 → 憑據 → 點擊「+ 添加憑據」,選擇類型並填寫字段(改動在輸入框失焦時保存)。
- 模型調用:模型會自動調用
vault_status查看憑據配置狀態,或調用vault_get獲取特定憑據值(如id=github field=token)。
數據存儲與安全¶
- 存儲位置:
- 條目結構和非機密字段存放在
~/.dsh/settings.yaml的dsh-vault命名空間下。 - 機密字段存入 DSH 憑據庫
~/.dsh/.credentials.yaml。
- 條目結構和非機密字段存放在
- 安全機制:
- 機密字段僅在寫入時經過界面,之後界面不回顯。
vault_get的返回值只出現在當次工具調用裏,不會在界面渲染層顯示具體值。- 卸載插件不會刪除憑據庫中的密鑰;如需清除,可在條目裏點擊「清除已存密鑰」。
依賴要求¶
插件依賴 @deepseek-ai/cordis ^4.0.1。
總結¶
dsh-vault 解決了 DSH 環境下憑據管理分散和安全回顯的問題。通過集中配置和工具化調用,它讓模型能夠安全地訪問外部資源。更多細節可查看插件目錄或源碼:catalog_url github_url