← 返回列表
未验证
🔑 dsh-go-rotator
尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。 · 最近上游提交 2026/8/14 · 已提供中文文档
一个用于 DSH 切换 opencode Go 订阅的插件
综合分
28.5
GitHub 分
28.5
用户评分
—
★ Stars
3
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add echo-xianyu/dsh-go-rotator该插件未发布到 npm，走 GitHub 源安装（pnpm 若拦截 prepare 脚本，按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑）
信任档位：已验证本站已于 0 天前真实安装成功
- 是什么
- dsh 原生插件 · other
- 装得上吗
- 本站已真实安装成功（非静态推断）
- 安全吗
- 本站尚未对该插件做风险分级（暂未覆盖，不等同于无风险）
- 还在维护吗
- 更新放缓：最近一次提交在 42 天前
档位由下列信号合成：本站实装验证（真实安装，当前最高到 L4）· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →
🟢实装验证通过· 2026/9/25
由本站实装验证器在真实 dsh 环境安装成功，非静态推断。
数据截至 2026/9/20（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
依赖的 DSH / Cordis 模块
@deepseek-ai/schemastery@deepseek-ai/dsh-client-runtime@deepseek-ai/dsh-client-ui-settings@deepseek-ai/dsh-client-ui-slots@deepseek-ai/dsh-client-locale@deepseek-ai/cordis@deepseek-ai/dsh-llm用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
由 DeepSeek 最新模型翻译生成🔑 dsh-go-rotator License Version DSH Platform OpenCode Go 订阅 key 轮换器 —— 为 DeepSeek Harness（dsh）提供多 key 负载均衡、自动轮换与配额管理。 ✨ 特性 - 按请求路由 —— provider 通过 apiKeyEnv 每请求解析活跃 key，多 key 自动分摊负载； - 自动轮换 —— 流以 RATE_LIMIT / QUOTA_EXCEEDED / AUTH / INVALID_CREDENTIAL 错误终止时冷却当前 key 并切换（env 即时生效，错误原样上抛，内置 llm-retry 用新 key 无感重试）； - 成本记账 —— 正常完成的流按 token 估算成本：滚动窗口（5h/周/月）入状态文件，长期账本（日/月/年）入统计文件； - 配额看门狗 —— 定时抓取各 key 的 dashboard 真实配额（workspaceId + authCookie），越过阈值自动禁用该 key； - Web 设置界面 —— dsh web 客户端设置页 + 独立 HTTP API（默认 http://localhost:7777），供外部工具读写同一状态； - 自包含 —— 全部数据落在插件安装目录的 data/ 下，配置永远不需要绝对路径。 📦 安装 1. 配置 provider 路由（$DSH_HOME/settings.yaml） llm-pi-ai: providers: opencode-go: displayName: OpenCode Go api: openai-completions baseURL: https://opencode.ai/zen/go/v1 apiKeyEnv: GO_ROTATOR_ACTIVE_KEY models: [ ...opencode-go 模型... ] 2. 安装插件（tarball / 本地目录均可） dsh plugin --profile add ./dsh-go-rotator-0.2.0.tgz 或开发期直接引用源码目录： dsh plugin --profile add file:/path/to/dsh-go-rotator 3.（可选）把默认模型路由到 opencode-go $DSH_HOME/cordis.patch.yml: - id: agent-default-model config: provider: opencode-go model: deepseek-v4-flash 4. 运行 —— 活跃 key 由插件启动时自动同步到 env，无需手动导出 dsh --profile "hello" 需要 dsh ≥ 0.1.0-rc.6。Release 资产（tgz / 源码 zip / 校验和）见页面右侧 Releases。 ⚙️ 配置 profile cordis.patch.yml 或 --patch 覆盖行 go-rotator： | 键 | 默认 | 说明 | |---|---|---| | stateFile | /data/opencode-go-rotator.json | 状态文件（keys、冷却、轮换日志、用量窗口；支持 ~/ 与相对路径） | | statsFile | 状态文件中的 statsFile（默认 /data/opencode-go-rotator-stats.json） | 长期账本 | | apiKeyEnv | GO_ROTATOR_ACTIVE_KEY | provider 每请求解析的 env 引用 | | cooldownMinutes | 60 | 出错 key 的冷却分钟数 | | disableThresholdPercent | 97 | 配额使用率阈值，越过即禁用该 key | | rotateOnCodes | RATE_LIMIT, QUOTA_EXCEEDED, AUTH, INVALID_CREDENTIAL | 触发轮换的 LlmError 码 | | rotateDebounceMs | 3000 | 并发失败时的轮换防抖 | | scrapeIntervalMs | 300000 | dashboard 配额抓取间隔；0 关闭 | | guiPort | 7777 | GUI/API 端口；0 关闭（被占用时自动 +1 回退） | 🔧 工作原理 | 环节 | 实现 | |---|---| | 路由 | llm-pi-ai: 段声明 opencode-go provider，apiKeyEnv 每请求经 credentials 解析活跃 key | | 轮换 | 包装 llm/stream waterfall：错误终止 → 冷却当前 key → 轮换 → llm-retry 用新 key 自动重试 | | 记账 | 滚动窗口（5h/周/月）入状态文件；长期账本（日/月/年）入统计文件；本地价格表按 token 估算 | | 配额 | 定时抓取 dashboard 真实配额，越过 disableThresholdPercent 自动禁用 | 数据位置（首次运行全新初始化，不含任何旧路径探测或迁移逻辑）： | 文件 | 默认位置 | |---|---| | 状态文件 | /data/opencode-go-rotator.json | | 长期账本 | /data/opencode-go-rotator-stats.json | 📝 注意事项 - 密钥只存于状态文件，插件不打印、不入日志；data/ 目录不随 npm 包发布（已在 .gitignore 中排除）。 - 状态文件写入为原子操作（tmp + rename），多进程并发安全。 - GUI 由 dsh web 客户端的设置页提供；独立 HTTP API 默认监听 http://localhost:7777，供外部工具读写同一状态。 🤖 AIGC 声明 本项目部分代码与文档由 AI 辅助生成，并经过人工审查与测试。项目按 MIT 许可证开源，仅供学习与参考；使用者请自行评估代码的安全性与合规性。 🔗 相关插件 - dsh-chat-archive —— 聊天记录管理面板 - dsh-better-chat-history —— 会话 I/O 优化 📄 许可证 MIT © 2026 dsh-go-rotator contributors