概览
@rycbartbad/dsh-key-manager
Multiple API keys per provider for DeepSeek Harness: keep a pool of keys with notes, switch the active key right from Settings → API 密钥, and every switch really takes effect on the next model call.
README / ZH
插件文档
dsh-key-manager
为 DeepSeek Harness 提供「每个提供商多个 API 密钥」管理。
在 设置 → 模型 中配置过的每个提供商，都可以在这里维护一个密钥池：给每个密钥加备注、随时切换当前使用的密钥——切换是真正生效的，下一次模型调用就会用到新密钥。
功能
- 按提供商的密钥池 —— 只列出模型页中已配置 key 引用的可配置提供商。
- 备注 —— 每个密钥可加注释（如「个人」「团队」「计费A」）；正在使用的密钥也能改名。
- 切换真正生效 —— 激活密钥会写入 harness 凭据通道。当原生引用被进程环境或
.env文件遮蔽时，插件会接管：把值存入插件管理的引用，并把该提供商的apiKeyEnv指向新引用——模型页会显示当前生效的引用名。 - 当前使用置顶 —— 正在生效的密钥总是排在第一位，带绿色徽章；不在密钥池中的当前密钥以「live」行展示。
- 默认选中当前提供商 —— 打开页面自动选中当前模型所用的提供商。
- 持久化、无硬编码路径 —— 注册表文件存放在 harness 数据目录旁（运行时由设置文档路径推导）。
存储说明：密钥值以明文存放在 harness 数据目录下（
~/.dsh/dsh-key-manager.json），与 harness 自身对.credentials.yaml的保护级别一致。若电脑与他人共用，请锁好该目录。
安装
dsh plugin --profile web add dsh-key-manager
重启 dsh web，然后打开 设置 → API 密钥。
结构
| 部分 | 位置 |
|---|---|
设置区块 api-key-manager |
lib/client.js（web 模块） |
同源 JSON API /plugins/dsh-key-manager/* |
lib/index.js |
| 密钥池注册表 | ~/.dsh/dsh-key-manager.json（运行时推导） |
| 激活密钥写入 | harness credentials 服务（原生引用，或被遮蔽时接管引用） |
提供商 apiKeyEnv 指向 |
harness settings 服务（llm-* 命名空间） |
许可证
MIT