dsh-opencode-routing

DSH PLUGIN模型与账号接入

仓库 2869949486/dsh-opencode-routing · npm dsh-opencode-routing

模型与账号接入 L4 · 沙盒安装通过 安全审查:低风险 可信度:银 可安装插件
安装这个插件

为 DeepSeek Harness 提供 OpenCode 账户池,支持配额路由与自动故障转移,并在同一设置页展示按账户、按模型的用量看板。

一句话选型结论

按资料字段整理

dsh-opencode-routing 是模型与账号接入类的 DSH 可安装插件,验证等级 L4 · 沙盒安装通过,安全审查为低风险,列出 5 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类模型与账号接入 收录类型可安装插件 验证等级L4 · 沙盒安装通过 安全审查低风险
验证等级 L4 L4 · 沙盒安装通过
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-11-07 创建于 2026-11-03
README 24.8 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add dsh-opencode-routing
  1. 1
    确认版本与运行环境

    仓库没有标注兼容版本与 Node.js 要求,先确认你的 DSH 版本能装,再继续。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本未标注版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名dsh-opencode-routing可用 npm view 查看包信息

能做什么

5 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-opencode-routing:DeepSeek Harness 的 OpenCode 账户池与用量面板

  • 账户池自动 A→B 故障转移
  • 配额路由与单模型隔离
  • 按账户/模型用量看板
  • 账户增删排序与探测
  • 10 语言界面

适用场景

智能体编排

上游标签

deepseek-harnessdshdsh-pluginfailoveri18nopencodequotausage-dashboard

验证等级与安全审查

L4 · 沙盒安装通过
自动化流程结论,不是人工审核
验证等级L4 · 沙盒安装通过安装命令在隔离沙盒内真实执行成功,无依赖错误
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度银综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(2026-11-10): 同一套检查会在插件发新版后重跑,页面显示的是最新一次的逐项结果。

逐项检查结果

L1 · 已找到 ✓ 通过
  • L1.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L2 · 结构化 ✓ 通过
  • L2.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L3 · 安装规范 ✓ 通过
  • L3.1_INSTALL_COMMAND_PARSED 安装命令已解析 方式:安装规范解析
  • L3.2_DSH_VERSION_DECLARED DSH 版本已声明 方式:DSH 版本声明
L4 · 安装已测 ✓ 通过
  • L4.1_INSTALL_EXECUTED_CONFINED 受限沙盒内执行安装 方式:沙盒安装执行
  • L4.2_INSTALL_SUCCESS 沙盒安装成功 方式:沙盒安装执行
  • L4.3_ARTIFACT_CONFIRMED 安装产物已确认 方式:沙盒安装执行
L5 · 运行已测 ✕ 未通过
  • L5.1_INSTALL_PASSED_SANDBOXED 沙盒安装通过 方式:沙盒安装执行
  • L5.2_WEB_BOOT_READY Web 启动就绪 插件目录树加载失败
  • L5.3_HTTP_SERVED HTTP 服务响应

风险详情

  • 结论说明 静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。
  • 风险计数 严重 0 / 高 0

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L4:在沙盒里真实装过,依赖能装上,不是纸面声明。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在模型与账号接入场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-opencode-routing当前 L4 · 沙盒安装通过 低风险 0 未标注 有
archify L4 · 沙盒安装通过 低风险 8.0 万 未标注 有
DeepSeek-Reasonix L4 · 沙盒安装通过 低风险 3.6 万 未标注 有
nocobase L3 · 安装规范通过 低风险 2.5 万 0.1.1-rc.2 无
voyager L3 · 安装规范通过 低风险 2.1 万 未标注 无
learn-harness-engineering L4 · 沙盒安装通过 低风险 2.0 万 未标注 有

仓库档案

模型与账号接入
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方2869949486仓库 dsh-opencode-routing · 默认分支 main
分类模型与账号接入ai
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-11-03 · 2026-11-07最后推送 2026-11-14
本站收录2026-11-05首次进入本站目录的时间

README 全文

24.8 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-opencode-routing

English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Русский

一个 DeepSeek Harness(dsh)插件,把原先分开的两个插件合成一个:
OpenCode 账户池 + 额度路由 和 用量看板 现在装在同一个包里,设置里也只有一个页面
「OpenCode 账户与用量」。

  • 客户端:settings.section 槽位,60 秒自动刷新;顶部第一张卡就答「走哪条路由、现在是峰还是谷、下次探测什么时候」;账户池可增删改、模型表带能力标签、两张表都能按住左右拖动;界面支持 10 种语言(跟随浏览器语言)。
  • Host:两个只读/管理接口 —— GET /opencode-usage.json(用量,?refresh=1 强制刷新)与 GET|POST /opencode-quota-router.json(账户池与路由,动作见下)。

安装

npm i dsh-opencode-routing

包自带 cordis.patch.yml:里面同时声明 opencode-go / opencode-free 两个 provider 和一条 insert
(id: opencode-router)。usage: 与 router: 两个子对象分别对应看板与路由各自的配置项(两边都有 path,
所以必须分开写)。

- insert:
- id: opencode-router
name: 'dsh-opencode-routing'
config:
usageUrl: https://opencode.ai/inference/go/v1/usage
apiKeyRef: OPENCODE_API_KEY
usage:
path: /opencode-usage
plan: go
router:
path: /opencode-quota-router
routes:
- primary: { provider: opencode-go, model: deepseek-v4.1-flash }
fallback: { provider: deepseek-account, model: deepseek-flash }

顶层键对两半都生效(usageUrl、apiKeyRef、probeIntervalMs 之类),子对象里的键只覆盖自己那一半。

DSH 兼容性

  • dsh >= 0.2.0-rc.1:所有流式调用都通过公开的 llm/stream waterfall 路由。
  • dsh >= 0.2.2-rc.1:额外在每一步之前用 agent.model.select() 对齐 Session 记录的模型选择,让持久请求头和
    assistant 来源跟随实际选择的一侧。
  • 旧版会自动跳过对齐,不需要版本开关或额外配置。

账户池与轮替

账户顺序就是使用顺序。任何时候只有一个「当前账户」,它的密钥会被镜像到 provider 读取的那个凭据引用
(默认 OPENCODE_API_KEY),因此切换账户不需要改任何 provider 配置:resolveApiKey 是在
llm/stream 路由选定账户之后、每次流式请求时现取的。

  • A 用完自动用 B:出现 QUOTA / ACCOUNT_QUOTA / 429 且官方额度确认耗尽,或出现鉴权类错误
    (AUTH、INVALID_CREDENTIAL、MISSING_CREDENTIAL、ACCOUNT_SIGN_IN_REQUIRED、CLIENT_UPGRADE_REQUIRED)时,
    当前账户被标记为不可用(额度用尽到窗口重置,鉴权失败 30 分钟),路由切到下一个启用账户并在同一步重试,
    不会把整轮对话降级。
  • 单模型隔离:只有一个模型报耗尽、池里还有额度时,只隔离这个模型(默认 30 分钟),其它模型继续走套餐。
  • 整池耗尽:才把这条路整体回退到 fallback(默认 DeepSeek 账户),并每 30 分钟(或 rolling 窗口重置时刻)
    用零 token 的 GET /inference/go/v1/usage 探测,恢复后自动回到套餐。
  • 上游容量/过载:router.fallbackOnCapacity: true 时,额度没耗尽但上游返回容量/过载类 429
    (overloaded / at capacity / prefill_cap_refused / ttft_admission_refused)也会回退到官方订阅;
    进入回退后的第一次探测在 router.capacityFallbackDelayMs(60 秒)后就开始,因为容量类拒绝通常几秒到几分钟就恢复。
    设置页有「立刻切到官方订阅 / 切回 OpenCode」,也可直接
    POST /opencode-quota-router.json {"action":"fallback"} / {"action":"primary"}。
  • 半路限流不会丢步:重试发生在同一次 llm/stream 调用内部,所以只有「一个 chunk 都还没吐出来」的主侧尝试会被原地改道;
    一旦已经输出第一个字,这条流就归调用方所有,失败原样抛出(不会把写了一半的回答悄悄重来一遍)—— 但路由会跟着改,
    于是这一步的重试落到官方订阅上,而不是再撞同一堵墙。之后的每一步靠 agent.model.select() 对齐到当前路由侧。
  • 恢复要连续干净 10 分钟:回退期间每 router.recoveryProbeIntervalMs(60 秒)探测一次,只有连续
    router.recoverStableMs(10 分钟)都探测成功才把流量交回套餐。中间任何一次探测失败,窗口清零重来 —— 这就是
    「上游一抖就来回横跳」的解法。探测只能证明额度接口能通(限流中的上游照样能通),所以窗口还要求官方状态
    不再把这个模型标为降级(recovery.blocked = "published" 就是在说「卡在官方状态上」)。官方 feed 自己读不到时
    就只能靠探测,窗口照常推进。
  • 重置:设置页的「重置封禁标记」清空所有「额度用尽 / 鉴权失败」标记并立刻回到账户池,不动账户与密钥。

官方状态(status.opencode.ai)

OpenCode 把状态页上看到的那份判断也以 JSON 形式发出来了:GET https://status.opencode.ai/api/status,免鉴权,
官方自己大约每分钟刷新一次。里面有总体判断、按服务(Console、日志、推理接口、Go 套餐、按量付费、免费推理)的分行、
按模型的分行(带 原因 与实时速度),以及进行中与历史事件。插件在 Host 侧直接读它(缓存
router.statusRefreshMs,默认 60 秒),和本地探测并排放在同一张「上游状态」卡里 ——
左半是本地探测、右半是官方判断,共用卡头那一个刷新按钮。上一版是两张卡,功能重合,已经合并成一张:

  • 判断标签:正常 / 降级 / 中断 / 维护,悬浮说明写的是「对你意味着什么」—— 原因是 upstream 时直接写
    「上游供应商在降级,不是你的密钥或额度问题,建议切官方订阅继续干活」,因为这才是一个 Degraded 徽章可执行的含义。
  • 一个模型一行:routes 里的主模型只列一次,左边是本地探测看到的判断(429 归类、失败计数、HTTP 状态、隔离到几点),
    右边紧跟一枚「官方 …」标签写官方 feed 对同一个模型的判断,后面是官方测到的首字延迟与吞吐。以前本地一张
    「按模型」、官方一张「你正在用的模型」,同一个模型说两遍;现在合成一行,官方没列出的模型照样写「官方没列出这个模型」。
  • 只在异常时才解释:探测全绿、官方正常时,两张分区里那句「一切都好」的长句不渲染 —— 徽章已经说完了。
  • 进行中的事件:只有真有事才出现;没有事件就是留白,不再占一行「当前没有进行中的事件」。
  • 刷新官方状态:按需重读官方 feed(同时刷新本地探测);页面开着的时候也每 60 秒重读一次,所以徽章跟着上游走,
    而不是停在打开页面那一刻。
  • 打开状态页:悬浮解释不够用时直接跳 status.opencode.ai。
  • 什么时候出现「切到官方订阅」:只有整体中断,或者你正在用的模型本身不正常时才出现。Go 套餐整行标降级、
    而你用的模型正常时不会出现 —— 那是隔壁在抖,切过去只是白花官方额度。
  • 探测全绿也不算恢复:只要官方仍把这个模型标为降级,「连续干净 10 分钟」根本不会开始计时;悬浮提示会说明卡在
    哪一半(recovery.blocked 为 probe 或 published)。

这就是「我的请求在失败」和「OpenCode 说 Go 套餐因为上游供应商在降级」的区别:本地探测只知道失败了,官方 feed 知道
为什么,也只有后者能告诉你「切官方订阅到底有没有用」。

页面瘦身(2.10.0 → 2.12.1)

设置页第一屏只留「现在走哪条」「此刻是峰还是谷」「上游怎么样」「额度还剩多少」,其余折叠或去重。
拿真实数据量:940 宽下整页从约 2930px 压到约 1050px。

  • 添加账户收进折叠面板 —— 一个密钥只填一次,不该常年占着三分之一屏。
  • 比价表收进折叠面板:外面留那句大字结论(「走 OpenCode 便宜 89%」),要逐项看再展开峰谷、缓存命中等明细;
    结论外面不再套第二层卡片,一句话只画一个框。
  • 横幅和额度路由卡并成一张(2.12.0):路由、峰谷、三个路由按钮共用顶部那张卡;独立的「额度路由」卡整个删掉,
    它那条常驻脚注变成「重置封禁标记」的悬浮说明。
  • 上游状态卡会折叠(2.12.0):两边都正常时只占一行(两个状态标签 + 探测时间 + 刷新/打开状态页),
    任何一边不正常就自己展开,本机网络行、模型行、错误码表都在展开区里。
  • 模型卡改一张表(2.12.0):五列 —— 模型、本月、5 小时、本周、请求数;能力标签缩成小图标,说明放悬浮里。
    本月没用过的模型折进「其余 N 个模型(本月未使用)」,30 个计价模型只占两行。
  • 失败记录只有在当下不正常时才展开在外面;恢复正常后它不再挂在页面上当噪音。

页面顶部:哪条路由、峰还是谷

设置页第一张卡一次答三件事 —— 下一句话花谁的钱、这句话算不算峰价、路由器什么时候再看一眼上游:

  • 路由行:「当前路由」+ 两个值之一:「OpenCode 账户池」或「DeepSeek 官方订阅」,绿色是套餐、琥珀色是官方订阅;
    右端是下次探测的倒计时。完整那句说明(走哪个账户、或按官方计费且 OpenCode 稳定后自动切回)挂在这行的悬浮里。
  • 峰谷行:一个色点 + 17px 的「高峰期 / 低谷期」,后面是每秒真跳的 HH:MM:SS 数字倒计时和翻面那一刻的北京时间。
    它跟着当前路由走:走账户池读 OpenCode 的日历,走官方订阅读 DeepSeek 那套带节假日的日历。两套日历只在
    中国法定节假日那天不一致,也只有那天才会多出一行把两边都写出来。
  • 三个小按钮:立即探测 / 立刻切到官方订阅(或切回账户池)/ 重置封禁标记(清掉「额度用尽 / 鉴权失败」标记,
    不动账户也不动密钥)。说明都在悬浮里,卡片底下不再挂一条常驻脚注。
  • 切换原因不在这里:它写在下面那张上游状态卡里(「额度用尽,暂时走官方直连」这种),顶部重复一遍只会把自己撑高。
  • 独立的「额度路由」卡没了(2.12.0):三个按钮搬到上面,常驻脚注变成最后一个按钮的悬浮,
    而它原来的「当前账户 / 下次探测 / 状态」三个数值本来就在路由行上。

切换通知(主界面浮层)

自动切走或自动切回时,主界面左上角(logo 下方)会落一条通知,不需要停在设置页:

  • 实心背景 + 阴影,不透明、不和标题栏混在一起,也不会压住左上角的 DSH logo。
  • 带时间点:「22:31:05 切换」用的是你本机时钟,方便和日志对齐。
  • 点 ✕ 才消失:不自动淡出、不弹确认;最多同时堆 3 条,最早的自动让位。
  • 正文是原因,不是枚举值:例如「上游容量不足/过载,暂时走官方直连」。

数据来源和横幅一样是 GET /opencode-quota-router.json(20 秒一次):只认 mode 发生变化,
页面刚打开读到的那一次不算「切换」,所以刷新页面不会刷出假通知。

接管框架自带的「上游不可用」提示条(2.11.0)

DSH 自己还有一条重试提示(「1 个上游不可用 / opencode.ai: connect_timeout ×3 · 约 1s 后重试」)。它由框架渲染,
实心不实心、能不能关都不归插件管,位置还正好压在左上角 logo 上。插件不改框架,而是接管它的 DOM:

  • 自动把它挪出 logo(left: 112px)、改成完全不透明、限宽 560px;
  • 补一个 ✕ 按钮,点一下关掉,同一条文案 5 分钟内不再出现;
  • 在它下面补一行判词(来自本机网络自检),把「谁的问题」写清楚 —— 例如
    「判断:两个域名都连不上:这是你本机到外网的路(Clash / TUN / 公司网 / DNS)出了问题,不是 OpenCode 的锅。」

匹配是文本级的(上游不可用 / upstream … unavailable / connect_timeout / 后重试),并且只处理最内层命中节点、
只向上最多 4 层找 fixed/absolute/sticky 的小盒子,所以不会误伤页面其它文字。

2.11.1 补的两件事,都是「按下葫芦浮起瓢」式的真实故障:

  • 样式会被框架写回去:React 每次重试都会重新渲染自己那条 toast,把插件加的 opacity / left 覆盖掉。
    所以现在不是「改一次」,而是每次变更都重新断言(含 attributes 监听),关掉之后也不会再冒出来。
  • 文字被抽走、底色还在:框架有时把 toast 的文本删了却留下那条填充色的空条 —— 一条无法关闭的红条。
    现在:① 关掉时连同「没有其它文字的填充祖先」一起隐藏;② 一旦你手动关过至少一条,之后 4 秒一次的巡检会把
    顶部 220px 内、fixed/absolute、无文字、不含任何按钮的填充空条一并清掉(没关过就不扫,避免误伤页面其它空面板)。

输入框里的模型标签(2.11.2)

框架会在输入框底部给模型选择器盖一个提供方角标(「OpenCode Go」,带图标)。这个角标是会话配置,不是实际路由:
回退到官方订阅时它照样写着 OpenCode Go,于是屏幕上唯一「说现在走哪」的位置反而说错了。

插件用的是框架给的正规扩展点 —— conversation.input.model.label 这个会话级 single slot,替换掉输入框触发器与
菜单当前值的标签渲染,所以:

  • 角标不再出现,只留模型名(DeepSeek V4.1 Flash);
  • 回退期间在后面加一个小标签「官方回退」,悬浮写着「当前请求走 DeepSeek 官方订阅……切回 OpenCode 后这个标记会消失」;
  • 切回 OpenCode 后标签自动消失,不需要重启、也不需要手动刷新;
  • 鼠标悬浮在模型名上会写出当前实际走的提供方。

这么做没有 DOM 补丁,也不改框架代码:拿到会话模型与角标的就是这个 slot 的 owner props,插件只负责不把角标画出来。

上游状态卡片

顶部那张卡下面是上游状态卡:本地探测与官方状态并排(各占一列),在账户表和模型表之上。两边都正常时它收成一行,
任何一边不正常就自己展开(2.12.0)。一句话说:

  • 两个状态标签:左边本地探测(正常 / 降级 (Degraded) / 回退中 / 恢复观察 / 未知),右边官方判断(正常 / 降级 / 中断 /
    维护,写成「官方 降级」)。鼠标悬浮(以及下面每个模型的小标签)会用一句话说明这个状态是什么意思、该怎么办,例如
    「限流 —— 等 1–10 分钟、换池里其它账户,或切官方订阅继续干」。
  • 「刷新状态」按钮重读每个账户的用量并重新探测上游(POST {"action":"status"});整页只有这一个状态刷新按钮。
    打开页面本身只读快照、不探测。
  • 每个模型一行:归类后的错误码、本轮失败次数、HTTP 状态、是否被隔离;最近一次的原始报错原文保留在悬浮提示里。
  • 恢复倒计时:回退中会显示距离「连续干净 10 分钟」的进度条,「什么时候能切回套餐」有个具体数字;探测失败进度条归零。
  • 错误码与解决办法:可折叠的对照表,列出卡片会出现的全部错误码与对应处置 —— 限流、过载、额度、欠费、鉴权、
    未配置密钥、需重新授权、需升级客户端、模型不可用、请求被拒、上下文超长、超时、服务端错误、网络错误、内容被拦截,
    以及未归类的未知错误。
  • 本机网络一行(2.11.0):同时探测 opencode.ai 与 api.deepseek.com,给出一句话判词,并带「重新自检」按钮
    (POST {"action":"netcheck"},绕过 30 秒缓存)。四种判词的意思是:
判词 含义 该怎么办
本机能连通 两个域名都通 这时的限流/降级是上游自己的,跟你本机无关
本机网络/代理有问题 两个域名都连不上 断点在你这一侧(Clash / TUN / 公司网 / 代理),先修本地网络
本机 DNS 解析失败 两个域名都解析不出来 换 DNS(223.5.5.5 / 1.1.1.1)或重启 Clash 的 DNS
只有 OpenCode 连不上 官方 API 通、opencode.ai 不通 断点在 OpenCode 这一侧,切官方订阅是对的

探针用 HEAD,任何 HTTP 响应都算「可达」(包括 401):要判断的是路通不通,不是你有没有密钥。

判断故意做得「粘」一点:30 分钟窗口内出现两次失败就显示降级,即使随后一次重试已经成功 —— 因为「失败一次、重试又好了」
正是这张卡片要暴露的抖动。切回套餐(自动或手动)会清掉这些标记,重新开始计数。

用量看板

官方 /inference/go/v1/usage 只给一组四舍五入的 rolling / weekly / monthly 百分比,没有按模型明细;
而套餐是按模型各自计额度(5 小时 = 月额度 20%、周 = 50%、月 = 100%)。所以页面有两套数:

  • 官方百分比(每个账户一行):来自接口,是账户真实用量,别的客户端、别的机器用了也算进去。
  • 按模型金额(模型表):本机估算 —— 回扫 $DSH_HOME/sessions 近 40 天的会话日志,只统计 provider 以
    opencode 开头的 assistant/message,按公开单价(含 DeepSeek 峰谷 2×)折算。别的工具用掉的额度没有本地记录。

「查看用量」按钮按账户弹窗展示三个窗口的百分比、重置时间与探测结果(只探测该账户,不切换模型)。

「编辑密钥」直接用 GET /opencode-quota-router.json?key=<账户 id> 取回该账户的当前密钥并预填输入框
(本机端点;列表快照始终只给掩码)。模型名按厂商习惯大写(deepseek-v4.1-flash → DeepSeek V4.1 Flash),
能取到品牌图标的厂商显示 SVG 图标,取不到的保留字母徽标。「下次探测」是真实的定时器(默认 30 分钟一次),
页面每秒重绘一次,所以会像倒计时一样走;打开页面本身只读快照,不会触发探测。

「此刻用哪个更划算」按套餐杠杆算:Go 付 $10 拿到 $100 官方价额度(≈¥710),所以走 OpenCode 恒为官方价的
10%(便宜 90%)。真实数据里不会出现官方更便宜的情况。

表里每个模型拆成三行:缓存命中输入 / 缓存未命中输入 / 输出(按百万 token 折算),缓存命中那行高亮,
因为大多数请求落在这条线上。官方单价(人民币/百万 token,低谷价):
Flash 0.02 / 1 / 4,Pro 0.15 / 4.5 / 13.5;高峰期正好翻倍。

套餐价与额度可以覆盖:usage.planPriceUsd(默认 $10)与 usage.planAllowanceUsd(默认按 LIMITS 的
Flash 月额度 $100)。页面上的折扣是从这两个数推出来的 —— OpenCode 哪天改价或改额度,改配置即可,
不需要改代码。

模型表的「能力」列来自同一个模型目录接口(/inference/go/v1/models)的
modalities.input 与 capabilities,标出 文本 / 图像 / 视频 / 音频 / PDF、工具调用、推理,以及上下文长度;
价格为 0 的模型显示「无限」。

峰谷与节假日

官方 API 的空闲时段是北京周一至周五 09:00–12:00、14:00–18:00 之外(含午休、夜间、周末、法定节假日),
价格正好是峰价一半。OpenCode 只照 UTC 周一至周五 01–04、06–10 两个窗口算峰,不认中国法定节假日
(anomalyco/opencode#53071 维护者原话:"Go pricing follows our own schedule, not DeepSeek's holiday calendar.")。

插件里带 2026–2031 的中国法定节假日表,只有把 holidayAware: true 写进配置(usage.holidayAware)才会计入
官方侧折算;默认关闭,因为 OpenCode 侧照旧按峰计费。表在 usage.js 的 HOLIDAYS,isChinaHoliday()
可单独调用。

页面顶部那张卡的峰谷行就是按这两套日历算的:走账户池读 OpenCode 侧,走官方订阅读 DeepSeek 侧,倒计时是真的
HH:MM:SS(服务端 peakClock() 同时给出 opencode 与 official 两半,各带自己的 next),两边不一致时
(只有法定节假日)会多出一行把两边并列写清。

设置接口

GET /opencode-quota-router.json 返回 {mode, reason, active, accounts[], quarantine[], routes[], lastFailure},
账户里的密钥永远是掩码(hint)。POST 同一路径,body {action, ...}:

action 参数 作用
add label?, key 新建账户(密钥≥8 字符),写入凭据库并探测
update id, label? / enabled? / key? 改名、停用/启用、换密钥
remove id 删除账户并清掉它的密钥(至少留一个)
activate id 立刻切到该账户
move id, direction: up\|down 调整顺序
probe id? 探测全部账户(同时刷新状态);带 id 只探测这一个
status — 重新探测上游并刷新状态卡片(「刷新」按钮)
reset — 清空封禁标记,回到账户池
fallback — 立刻切到官方订阅
primary — 立刻切回 OpenCode 池

GET /opencode-usage.json 返回 {plan, configuredPlan, detectedPlan, holidayAware, peak, usage, accounts[], activeAccount, models[], totals};?refresh=1 先强制刷新官方快照再返回。

GET /opencode-quota-router.json 额外返回 cause、upstream 与 official:{state, code, mode, cause, since, checkedAt, windowMs, lastFailure, recovery, models[], recent[]},其中 state 是 healthy / degraded / fallback /
recovering / unknown,code 是 rate_limit / capacity / quota / payment / auth / missing_key /
sign_in / upgrade / not_found / bad_request / context / timeout / server / network / filter /
error / ok,recovery 是 {active, stableSince, stableForMs, requiredMs, remainingMs, attempts, lastProbeAt, probeIntervalMs}。

official 是官方状态卡的数据:{ok, error, errorAt, url, fetchedAt, ageMs, stale, status, since, updatedAt, services[], active[], models[]}。status 是官方总体判断(operational / degraded / outage /
maintenance / unknown);services[] 是 {id, status, reason, since}(id 为 inference / go /
payg / free,Console 与日志不展示);models[] 是每个 route 主模型的 {model, status, reason, service, ttftMs, tps};active[] 是仍在进行中的事件 {id, service, status, reason, startedAt, models[]}。读不到官方
feed 时 ok: false 并带 error,卡片显示错误,路由与本地探测不受影响。

多语言

界面文案在 client.js 的 DICT 里:zh(源)、zh-tw、en,以及 es / fr / de / pt / ja / ko / ru
(由 _merge_i18n.mjs 从翻译文件内联,缺键回退到 en,再回退到键名)。localeOf() 按浏览器语言前缀匹配,
中文区分简繁。

测试

node test.mjs

不需要任何模型额度:假 context、假凭据库、假 webServer,本地起一个 usage 端点按 API key 返回不同百分比,
覆盖组合插件挂载、账户收养、单模型隔离、A→B 切换与密钥镜像、按账户探测、整池耗尽回退、上游容量回退、
手动切换官方订阅、重置、设置动作校验、用量视图(能力标签、无限额度、峰谷换算)、单账户退化,
以及状态卡片(429 归类为限流、保留原始报错、失败计数)、官方状态半张卡(服务行、按模型行、feed 坏掉只损失新鲜度
不影响路由)与恢复窗口(一次探测不够、探测失败重来、官方仍标降级时窗口根本不开始、满窗口切回后下一个请求确实回到套餐),
还有「第一个字之后才限流」这一路(不原地重试,但这一步的重试落到官方订阅上)。

与旧包的关系

dsh-opencode-quota-router 与 dsh-opencode-usage-settings 是它的前身,功能已全部并入本包;
旧包在 npm 上标记为 deprecated,指向这里。它们原来的 GitHub 仓库已删除,本仓是唯一的源码位置。

License

MIT

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
dsh-opencode-routing 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add dsh-opencode-routing` 即可。对应的 npm 包名是 `dsh-opencode-routing`。

dsh-opencode-routing 的验证等级是什么意思?

L4 · 沙盒安装通过。安装命令在隔离沙盒内真实执行成功,无依赖错误

dsh-opencode-routing 安全吗?

低风险。静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。

dsh-opencode-routing 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-opencode-routing 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-opencode-routing 有哪些功能?

账户池自动 A→B 故障转移、配额路由与单模型隔离、按账户/模型用量看板、账户增删排序与探测、10 语言界面。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

模型与账号接入
按星标排序,可作替代方案

archify

archify

从仓库或系统描述生成经过校验的自包含交互式架构图、流程图、时序图、数据流图和生命周期图。

L4 · 沙盒安装通过 8.0 万 星

nocobase

nocobase

L3 · 安装规范通过 2.5 万 星

voyager

voyager

Enhancement suite for Gemini, AI Studio, Claude, ChatGPT & DeepSeek —

L3 · 安装规范通过 2.1 万 星

dsh-our-free-model

dsh-our-free-model

为 DeepSeek Harness 挂载免登录、免 API Key 的免费前沿模型通道,装完即用,并附用量看板与 OpenAI 兼容本地转

未标注验证等级 8,064 星

2869949486 的其它插件

3 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 2026-11-10。