Jindom/dsh-bitwarden ↗★ 0

@dsh-external/dsh-bitwarden

Bitwarden/Vaultwarden credentials in every DSH session: vault tools + proactive prompt guidance + a settings card for the master password. 适合需要在DSH会话中安全调用和管理Bitwarden密码库凭据的用户。

パッケージ
@dsh-external/dsh-bitwarden
互換性
未検証
Harness ピア範囲
>=0.0.1-rc <2
バージョン
0.1.0
ライセンス
MIT
最終更新
2026/09/16

インストール

$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 密钥登录即可(主密码仍要填,用于解密保险库)。