dsh-opencode-go-key-broker
在终端中运行以下命令:
dsh plugin install Gdenich/dsh-opencode-go-key-broker
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install Gdenich/dsh-opencode-go-key-broker 安装本插件,也可从 https://github.com/Gdenich/dsh-opencode-go-key-broker 获取源码后按文档本地添加。
插件介绍
在 DSH 里把 OpenCode Go 配成模型路由时,通常只能绑定一个环境变量密钥。某个滚动、周或月窗口配额用尽后,请求会直接报 QUOTA,你只能停下手头的事去换密钥、改配置。这个插件把多把密钥当成一个池子,在每次真正发请求前通过凭证解析拿到当前应用的密钥,因此不必改路由、模型或适配器。
它用两条线保活:预防性按 refreshMs 轮询各密钥的 /v1/usage,若当前活跃密钥已「变红」(状态异常或用量达到 rolling/weekly/monthly 阈值),就切到下一个仍「绿色」的密钥,并可在 sticky 策略下一直用到它自己也变红;反应性则监听 agent 请求错误,遇到 QUOTA 或 INVALID_CREDENTIAL 时立刻换钥并让同一次对话里重试,无需等下一轮轮询。写入走本地凭证存储与跨进程锁,与 Models 页面手工改密钥互不覆盖,密钥值留在 Host,界面只展示名称、掩码与用量百分比。
Settings 里提供 OpenCode Go Keys 专页:查看活跃密钥与各窗口用量、手动激活或增删密钥,以及「决策日志」;默认 dryRun 只记录会怎么切,确认行为后再关闭。若所有候选都已变红、被限流或 usage 查询失败,会保持当前密钥并记录 no-alternative,另有每分钟最多三次切换的上限,避免全员耗尽时的死循环。
适合长期用 OpenCode Go、手里有多把 API 密钥、又希望配额在后台自动轮换、偶尔还要在 UI 里看一眼池子状态的人——尤其是已经把 dsh-opencode-go-usage 一类用量展示接进工作流的用户。
使用场景
- 多把 OpenCode Go 密钥轮流用,避免单窗口配额打满后整段对话中断
- 已在 DSH 配好 opencode-go 路由,希望 QUOTA 时自动换钥并重试同轮请求
- 想在设置页查看各密钥 rolling/weekly/monthly 用量并手动指定活跃密钥
适合人员
- 日常在 DSH 里调用 OpenCode Go 的开发者
- 持有多账号或多密钥、需要自动化配额切换的用户
- 已使用或计划配合 OpenCode Go 用量展示插件的团队