前言¶
在 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