前言¶
在 DeepSeek Harness（DSH）里接入多家模型提供商时，常见做法是各环境只配一把 API 密钥。密钥轮换、备用密钥和用量核对往往要改配置文件或环境变量，和 DSH 的 Web 设置、插件化运维路径也不一致。社区插件 dsh-key-managment 按提供商维护密钥池，支持在界面里手动切换当前生效密钥，并附带可达性探测与部分服务商的套餐余量展示。下面介绍它的定位、能力、安装步骤和日常使用方式。
这是什么¶
dsh-key-managment 是面向 DeepSeek Harness 的分提供商 API 密钥池插件，维护者为 AhYi8，在 SkillHub 插件目录 中归类为 admin-security。插件描述为：Per-provider API key pool with manual switching for DSH providers——即为每个 DSH 提供商配置多把密钥，并由使用者手动选择哪一把当前生效。
当前 package.json 中版本为 1.0.3，许可证为 MIT。DSH 侧通过 Cordis 补丁（cordis.patch.yml）接入，Web 客户端会注入设置与会话相关 UI 模块，在浏览器端提供配置入口。
核心功能¶
以下能力均来自项目 README 与仓库结构说明，安装前仍以你本地核对为准。
密钥池与手动切换¶
按提供商录入多把 API 密钥，在设置页选择当前使用的密钥即可切换，无需为每次轮换改动全局配置。
后台可达性探测¶
可按可配置间隔对密钥做可达性探测；插件启动时会先执行一轮探测。探测间隔与开关均在 Web 设置页调整。
用量展示¶
内置多家服务商的套餐余量适配器，README 中列出的包括：DeepSeek 余额、Kimi Coding、MiniMax、智谱 / Z.ai、OpenRouter、Command Code、OpenCode Go、Magpie 等。具体展示以各适配器实现与对应 API 为准。
Web 设置界面与密钥脱敏¶
在 DSH 浏览器端提供配置与切换入口。界面与日志中对密钥做自动脱敏展示，降低误泄露风险。
安装与启用¶
插件面向 Web profile。官方 README 给出的安装方式为：
dsh plugin --profile web add dsh-key-managment
也可以在 DSH 设置 → 插件 / 插件市场中搜索 dsh-key-managment 安装。SkillHub 为社区维护的插件目录站点，与 DeepSeek / 幻方无官方从属关系；安装行为发生在你的 DSH 实例上，而非「官方应用商店」一键分发。
典型用法¶
安装完成后，按下面顺序即可完成基础配置。
- 打开插件设置，为各模型提供商添加一条或多条 API 密钥。
- 为每个提供商选择当前生效的密钥。
- 根据需要开启后台探测，并设置探测间隔。
- 在用量相关区域查看已适配服务商的套餐余量（若该提供商已有适配器）。
README 未给出更细的字段名截图；字段与开关以你安装版本下的设置页为准。
适用场景与注意¶
适合在 DSH Web 环境下集中管理多提供商、多密钥，并需要 occasional 手动切密钥或查看余量的开发者与运维。手动切换意味着不会自动按探测结果 failover 到另一把密钥，轮换策略仍由你在界面中决定。
安全方面需要明确：DSH 插件以当前 DSH 进程的权限运行，密钥会保存在插件配置所涉的存储路径中。安装前应阅读 GitHub 仓库 源码与 MIT 许可证，确认符合你的合规与审计要求。不要在不受信环境复制生产密钥做试验。
若你自行参与开发，仓库提供 pnpm install 与 node --test core.test.mjs 等测试入口；日常使用一般只需通过 DSH 插件市场或上述 CLI 安装即可。
结尾¶
dsh-key-managment 把「按提供商的多密钥池 + 手动切换 + 探测与余量」收进 DSH 插件，与「一切皆插件」的 DSH 理念一致。进一步了解可从目录页 SkillHub：AhYi8/dsh-key-managment 进入，源码与安装说明见 GitHub：AhYi8/dsh-key-managment。
