@dsh-external/dsh-bitwarden
Bitwarden与Vaultwarden凭据库集成插件 适合需要在DSH会话中安全调用和管理Bitwarden密码库凭据的用户。
安裝
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Jindom/dsh-bitwarden說明文件
閱讀完整 README ↗配置
三种方式,优先级从高到低:用户设置(GUI/settings.yaml)→ 插件组合配置 → 环境变量 → 默认值。
1. DSH 设置界面(推荐)
设置 → 插件 → 插件配置 → Bitwarden / Vaultwarden 凭据库:插件自带前端卡片, 填完点"保存"立即生效(无需重启)。主密码与 API 密钥是只写字段——保存后不会再回传浏览器, 输入框留空表示不修改。
卡片由插件的浏览器半边(
lib/client.js)提供;若刚注入/重载后没看到卡片, 刷新一次页面(F5)即可,之后随启动图自动加载。
字段:
| 字段 | 说明 |
|---|---|
serverUrl | 服务器地址,默认 https://bitwarden.jindom.cc;也可填 http://192.168.88.101 |
email | 登录邮箱。必须与账号一致——它是 KDF 的盐值 |
masterPassword | 主密码(secret)。用于派生主密钥、解密保险库,只存在本机 settings.yaml |
apiKeyClientId | 可选。Bitwarden 网页端 → 账户设置 → 安全 → 密钥 的 client_id(user.)。填了就走 API 密钥登录,可绕过两步验证 |
apiKeyClientSecret | 可选。上面的 client_secret(secret) |
cacheMinutes | 解锁后的内存缓存时长,默认 30 分钟;到期后自动重新同步 |
配置文件位置:$DSH_HOME/settings.yaml(本机为 /dsh-home/settings.yaml)。
2. 环境变量
DSH_BITWARDEN_SERVER、DSH_BITWARDEN_EMAIL、DSH_BITWARDEN_MASTER_PASSWORD、
DSH_BITWARDEN_CLIENT_ID、DSH_BITWARDEN_CLIENT_SECRET(也接受去掉 DSH_ 前缀的写法)。
3. 组合配置
在 profile 的 cordis 配置里给插件传入同名字段即可(作为 settings 的 base 层)。
开了两步验证(2FA)的账号:密码授权会被服务器拒绝。此时填
apiKeyClientId/apiKeyClientSecret走 API 密钥登录即可(主密码仍要填,用于解密保险库)。
3. 组合配置
在 profile 的 cordis 配置里给插件传入同名字段即可(作为 settings 的 base 层)。
开了两步验证(2FA)的账号:密码授权会被服务器拒绝。此时填
apiKeyClientId/apiKeyClientSecret走 API 密钥登录即可(主密码仍要填,用于解密保险库)。