前言¶
在 DSH 里接 DeepSeek、OpenAI 等能力时，API Key 往往要反复填写，或散落在环境变量、临时配置文件里。把明文写进脚本或 shell 历史，也不利于轮换和清理。下面介绍社区插件 深鲸 Key 保险箱（npm 包名 @deepwhale-cn/dsh-key-vault，仓库 feely0208/dsh-key-vault）：在本机集中保存你自己带来的 Key，界面与命令行只展示掩码，文件权限为 0600，且不上传至远端。
这是什么¶
深鲸 Key 保险箱是 DeepSeek Harness 的 admin-security 类插件，由维护者 feely0208 发布。定位一句话：本机管理多个 API Key，只显示掩码、0600 权限、不上传任何地方。官方说明中强调：不提供、不代持、不代理任何凭据；费用与额度由你在对应平台自行承担。
当前 package 版本为 0.1.1，许可证 MIT；面向 web profile 注入客户端，并依赖 @deepwhale-cn/dsh-guard-core。运行环境要求：Node.js ≥ 18，DSH 版本 >=0.1.0-rc.6 且 <0.3.0。
核心功能¶
- Web 面板：侧栏入口「深鲸 Key 保险箱」，填写 provider 与 key 后保存；之后列表里仅见掩码。可设置默认项、删除条目。
- CLI
dsh-key-vault：在无图形界面或自动化场景下增删改查、设默认；列表输出同样为掩码。 - 本机存储：数据写入
~/.deepwhale/key-vault.json，权限 0600；删除即从本机移除。 - 模块导出：除主入口外，提供
./client导出，供其他插件或技能在 DSH 内按约定读取（具体集成方式以仓库源码为准）。
安装与启用¶
安装命令来自仓库 README，使用 web profile：
dsh plugin --profile web add @deepwhale-cn/dsh-key-vault
安装完成后，在 DSH Web 侧栏找到「深鲸 Key 保险箱」即可使用面板；CLI 随插件安装，命令名为 dsh-key-vault。
典型用法¶
面板¶
侧栏「深鲸 Key 保险箱」→ 填写 provider 与 key → 保存（之后只显示掩码）；按需设默认或删除。
命令行¶
下列示例均来自官方 README，可按 provider 名称替换：
写入或更新一条 Key，并加标签：
dsh-key-vault --set deepseek --key sk-xxxx --label 个人
从标准输入读 Key，避免出现在 shell 历史中：
dsh-key-vault --set openai --key -
只查看掩码列表：
dsh-key-vault --list
指定默认 provider、删除某条：
dsh-key-vault --default deepseek
dsh-key-vault --remove openai
存储位置固定为 ~/.deepwhale/key-vault.json（0600）；--remove 即从本机删除对应条目。
适用场景与注意¶
适合谁：需要在 DSH Web 里统一管理多家 LLM / API 凭据、又不想把明文散落在聊天或脚本里的开发者；也适合习惯用 CLI 做密钥轮换、设默认 provider 的场景。
使用前请知悉：
- 插件以当前 DSH 进程的用户权限读写本机文件；安装前建议查看 GitHub 仓库 源码与 MIT 许可证，确认行为符合你的安全策略。
- 保险箱只解决「本机存放与掩码展示」，不替代各云平台的 IAM、审计与配额管理。
- DSH 生态主张「一切皆插件」；社区目录页 skillhub.cn 上的条目 为独立站点信息，与 DeepSeek / 幻方无官方从属关系。
结尾¶
深鲸 Key 保险箱把「自带 Key、本机保存、掩码展示、0600、不上传」写进一条清晰路径：Web 面板与 dsh-key-vault CLI 并用即可。更多说明见 目录页 与 GitHub README。
