前言¶
DeepSeek Harness (DSH) 是一个插件化的智能体开发框架。在实际开发中，开发者经常需要为同一模型提供商配置多个 API Key（例如区分个人账号与企业账号），或者在不同 Key 之间切换以平衡负载。DSH 原生支持凭证管理，但在多 Key 场景下，手动切换或覆盖环境变量往往不够直观，且容易导致配置未生效。
dsh-key-manager 插件旨在解决这一痛点。它允许你在 Settings → API 密钥 页面维护一个 Key 池，为每个 Key 添加备注，并确保切换操作在下次模型调用时真正生效。
核心功能¶
该插件提供以下核心能力：
- 按提供商 Key 池化：只列出在“模型”设置页中实际配置了 Key 引用的提供商。
- 备注与重命名：可以为每个 Key 添加备注（如“个人”、“团队”），甚至对当前正在使用的 Key 进行重命名。
- 真正生效的切换：激活一个 Key 时，插件会通过 Harness 的凭证机制写入该值。如果原生环境变量或
.env文件覆盖了默认引用，插件会接管并指向其管理的引用，确保下次调用使用新 Key。 - 当前使用锁定：正在使用的 Key 会始终显示在列表顶部，并带有绿色徽章；未加入池管理的 Key 会显示为“live”行。
- 智能默认选择：页面加载时，会自动预选当前选中模型背后的提供商。
- 持久化与无硬编码：注册表文件保存在 Harness 数据目录中，不依赖硬编码路径。
安装与启用¶
安装该插件需要使用 DSH 的 Web 配置模式。
dsh plugin --profile web add dsh-key-manager
安装完成后，重启 dsh web 服务，然后打开 Settings → API 密钥，即可看到 Key 管理界面。
典型用法¶
- 在 Settings → 模型 中配置好模型提供商（例如 OpenAI）。
- 进入 Settings → API 密钥。
- 输入第一个 API Key，添加备注（如“personal”），点击激活。
- 继续添加第二个 Key，添加备注（如“team”），点击激活。
- 下次模型调用时，系统将使用刚刚激活的 Key。页面会显示当前生效的引用来源。
注意事项¶
- 存储安全：Key 值以明文形式保存在 Harness 数据目录下（
~/.dsh/dsh-key-manager.），安全级别与 Harness 自身的.credentials.yaml一致。如果是在共享机器上运行，请务必锁定该目录的权限。 - 生态说明：DSH 插件目录与 DeepSeek 或幻方官方无从属关系，本插件由社区开发者维护。
- 许可证：遵循 MIT 许可证。
总结¶
dsh-key-manager 是一个针对 DeepSeek Harness 多账号管理场景的实用工具。它通过池化管理和强制生效机制，简化了 Key 切换流程，适合需要精细化管理 API 资源的开发者。更多细节与源码，可参考其 GitHub 仓库。
