DSH Plugins Marketplace

DSH Plugins

Plugins

/

Development & Infrastructure

/

dsh-opencode-go-pool

R

dsh-opencode-go-pool

Manifest valid★ 2

DSH Plugin: Merge Multiple OpenCode Go Subscriptions into a Single Model Provider (Automatic Account Selection, Session Stickiness, Account Switching on Quota Exhaustion, 30 Models, Usage Dashboard)

UI (client)hasBundlePatch

dsh-opencode-go-pool

npm version license node

把 N 个 OpenCode Go 订阅合并成 一个 DSH 模型提供商,自动选号、会话粘滞、额度耗尽自动换号,并在输入框工具行显示各账号的用量曲线。

~/.dsh/
├── plugin-src/dsh-opencode-go-pool/     # 插件源码(本目录)
├── opencode-go-pool/
│   ├── config.json                      # 账号/模型/公式参数(改完 1 秒生效)
│   └── state.json                       # 会话钉号、冷却、用量采样、本地记账
└── profiles/desktop/
    ├── package.json                     # dependencies + dsh.profile.bundles 各加一项
    └── node_modules/dsh-opencode-go-pool -> junction 到 plugin-src

模型(OpenCode Go 全量 30 个)

模型选择的入口就是 DSH 自己的模型菜单:插件通过 listModels() 把 config.json 里的每个模型 注册成同一个 provider(opencode-go)下的可选项,气泡/面板里不再有模型下拉框,只做只读展示。

config.json 里现在包含 OpenCode Go 目前提供的全部 30 个模型(取自 GET https://opencode.ai/zen/go/v1/models 的权威元数据,含 limit.context / limit.output / capabilities.reasoning / modalities.input):

模型 ID名称上下文输出上限图片输入
deepseek-v4.1-flashDeepSeek V4.1 Flash 10171,000,000384,000✅
deepseek-v4-proDeepSeek V4 Pro1,000,000384,000—
glm-5.3 / glm-5.3-flash / glm-5.2GLM-5.3 / 5.3-Flash / 5.21,000,000131,0725.3-Flash ✅
gpt-6-luna / gpt-5.6-lunaGPT-6 Luna / GPT-5.6 Luna1,050,000128,000✅
claude-haiku-5-5Claude Haiku 5.51,000,000128,000✅
gemini-4-argonGemini 4 Argon1,048,57665,536✅
kimi-k3.1-pro / kimi-k3 / kimi-k2.7-codeKimi K3.1 Pro / K3 / K2.7 Code262,144–1,048,576131,072–262,144✅
grok-4.7Grok 4.7500,000500,000✅
minimax-m3 / minimax-m3.1-flashMiniMax M3 / M3.1 Flash1,000,000131,072 / 512,000✅
qwen3.8-max / qwen3.8-flash / qwen3.7-plusQwen3.8 Max / 3.8 Flash / 3.7 Plus1,000,00065,536–131,072✅
hy4 / hy4-preview / hy3Hy4 / Hy4 preview / Hy3256,000–1,048,57664,000–128,000Hy4 ✅
mimo-v2.6-flash / mimo-v2.6-proMiMo-V2.6-Flash / Pro1,048,576131,072✅
longcat-2.0 / longcat-2.5-freeLongCat-2.0 / 2.5 Free1,000,000131,072 / 262,144—
step-5-previewStep 5 Preview1,000,00065,536✅
muse-spark-1.3-contributor / muse-spark-1.2-contributorMuse Spark 1.3 / 1.2 Contributor1,048,576131,072✅
beam-free / iceman-contributor-freeBeam Free / Iceman Contributor Free1,048,576 / 262,144131,072—

要点:

  • 协议只有一条:全部模型都走 OpenAI 兼容的 POST {baseUrl}/chat/completions。 官方 docs 的 Endpoints 表里每个模型标的是"原生" API(OpenAI Responses / Anthropic Messages / Google v1beta),但同一段说明还写着 "every text model also works through the other APIs, which Console translates"——Console 会替我们翻译,所以选号层不需要按模型切协议。
  • 推理档位统一为 {off:none, low:low, high:high, max:max},实测 5 个不同家族 (GLM / Kimi / Qwen / GPT / Claude / Grok / MiniMax / Gemini / Hy / Step)都接受这三档。
  • 地区限制:muse-spark-* 与 beam-free 在中国大陆会返回 403 RegionError: This model is not available in your country; 这是上游限制,不是插件问题(模型仍列在菜单里,方便你换地区/工作区隐私设置后直接用)。 这类错误现在会被识别成模型级错误:只报错一次,不换号、不冷却账号。
  • 隐私限制:iceman-contributor-free 这类"会训练请求数据"的模型,如果工作区没打开 Settings › Privacy › Allow paid endpoints that train on request data,会返回 400 trains on request data;同样按模型级错误处理(不冷却账号),按提示去 Console 打开即可。
  • 新增/删模型只改 config.json 的 models 数组,1 秒内生效;插件重载配置后会调用 registration.replace() 重新发布路由,宿主随之发出 llm/adapters-updated, 前端的模型目录会自动重拉(旧版不会发这个事件,所以改完要刷新页面才看得到)。
  • 模型菜单是页面加载时从宿主拉的一份目录:如果改完 config.json 菜单没变, 先刷新页面(Ctrl+R);仍然只有旧模型时,彻底重启 DSH(宿主在启动时按 registerAdapter 建路由)。

选号规则

score = (100 - 月用量%) / max(距套餐重置的天数 - reserveDays, 0)
  • 越闲、越接近重置的账号分数越高 → 先把快过期的额度烧掉;
  • 落在重置前 reserveDays(默认 3.5)天以内 → 分母为 0,按正无穷处理(最优先,用光为止);
  • 月用量已满(≥100%)、处于冷却、或者 status 标记不可用 → 不参与竞争;
  • 没有「立即可用」的号时,兜底优先在没打满的号里挑(哪怕它在冷却),发出去由上游给出真实错误; 只要还有没打满的号,就不会把请求发给已打满的号;
  • 全部账号都打满时才按「最早重置」选,不在这里主动拒绝;也不引入任何等待。

会话策略:每个会话第一次请求时选号并钉住(保留 KV 缓存/上下文一致),此后同一会一直用它;该号额度耗尽或被限流/鉴权失败时才解钉换号,并把同一会话重新钉到新号。

用量从哪来

GET https://opencode.ai/zen/go/v1/usage
Authorization: Bearer <Go 的 API key>
→ {"usage":{"rolling":{...},"weekly":{...},"monthly":{"percent":83,"resetsAt":"2026-11-16T07:56:38Z"}}}

用 API key 直读,不需要 cookie。插件每 60 秒(usageRefreshMs)刷新全部账号,采样写进 state.json 供曲线使用。

界面

输入框工具行右侧有一枚胶囊(conversation.input.right):显示 全池月用量(所有启用账号的平均值,各号套餐上限相同时即整池用掉的百分比)。 鼠标悬停能看到「全池平均 + 每个号明细」;点开是面板:

  • 每个账号一行:月用量条、5h/周用量、距重置天数、评分、采样曲线、本地累计美元/次数、prompt cache 命中率;
  • 本会话钉住的号有高亮与「本会话」标记;打满/冷却会变灰并注明;
  • 「刷新」按钮立刻打一次上游用量;底部写明公式。
  • 面板通过 react-dom 的 portal 挂到 document.body(插件槽位的祖先可能带 transform/filter, 那样 position: fixed 会相对祖先定位、坐标再算也会整体偏出窗口);渲染后再量一次真实矩形做兜底校正, 上下方向自适应、maxHeight = min(屏高 62%, 该侧可用空间)、宽度夹在窗口内(左右各留 8px), 窗口 resize 会重新定位。每次打开还会把面板/视口几何写进 diag.json,方便核对是否越界。

安装

git clone https://github.com/Ritanlisa/dsh-opencode-go-pool ~/.dsh/plugin-src/dsh-opencode-go-pool
cd ~/.dsh/plugin-src/dsh-opencode-go-pool
node scripts/install-into-desktop.mjs    # 写 link: 依赖 + 建 junction
mkdir -p ~/.dsh/opencode-go-pool
cp config.example.json ~/.dsh/opencode-go-pool/config.json   # 首次装:改账号

scripts/install-into-desktop.mjs 默认装进 ~/.dsh/profiles/desktop,可用 DSH_PROFILE_DIR 指向别的 profile;脚本从自身位置推导插件源码目录,clone 到哪都能跑。

然后重启 DSH Desktop(客户端 bundle 在启动时合成,热重载只覆盖宿主半边)。

密钥不放仓库:config.json 里只写 apiKeyEnv(环境变量名或 ~/.dsh/.credentials.yaml 的键), 真实 key 由宿主凭据服务 / 环境变量 / 凭据文件解析。config.json、state.json、*.ndjson 已在 .gitignore 里。

从 npm 装(可选)

cd ~/.dsh/profiles/desktop
pnpm add dsh-opencode-go-pool        # 或 npm i dsh-opencode-go-pool

然后把 "dsh-opencode-go-pool" 加进该 profile package.json 的 dsh.profile.bundles 数组 (和 scripts/install-into-desktop.mjs 做的事一样,只是依赖写成版本号而不是 link:),重启 DSH。

加账号

  1. 在 ~/.dsh/.credentials.yaml 的 refs: 下加一行 OPENCODE_GO_4_API_KEY: oc_sk_xxx;
  2. 在 ~/.dsh/opencode-go-pool/config.json 的 accounts 里加 {"id":"go-4","label":"Go 4","apiKeyEnv":"OPENCODE_GO_4_API_KEY"};
  3. 保存即可(配置有 watcher,1 秒内重载;账号数量不限)。

也可以完全不写 accounts:启动时自动扫描 refs: 里所有 OPENCODE_GO* 键生成账号。

在面板里直接增删(推荐)

点胶囊打开面板:

  • 顶部四宫格:账号数 / 当前可用(未停用、未打满、未冷却)/ 全池月用量 / 本会话账号。
  • 每个账号一张卡:色点 + 名称 + 徽章(本会话 / 冷却中 / 月额度已满 / 已停用),右侧是本月用量百分比; 下面三条迷你进度条分别是 5 小时 / 本周 / 本月 窗口,再下面是距重置、评分、缓存命中率、本地累计花费与请求数,最右是采样曲线。
  • 卡片底部四个动作:
    • 切到该号:把本会话手动钉到这个账号(冷却中会顺带解除冷却);已在用则显示「已在本会话」。
    • 解除冷却:清掉冷却,让它立刻重新参与选号(账号旁出现「冷却中」时才显示)。
    • 停用 / 启用:保留历史采样,只是不参与选号。
    • 删除:点一次变「确认删除?」,再点一次才真删。
  • 右上角 同步模型:从官方 GET /zen/go/v1/models 拉最新目录,已有模型保序更新、新模型追加到末尾 (官方已下架的旧条目保留,不擅自删),结果会显示「新增 N 个 / 更新 N 个」。
  • 最后一个启用中的账号不允许删除;失败原因显示在面板顶部。

底层路由:

路由body作用
POST /plugins/dsh-opencode-go-pool/accounts{"action":"add|toggle|remove", …}增删改账号(加号时先把 key 写进凭证库)
POST /plugins/dsh-opencode-go-pool/switch{"session":"…","accountId":"go-3"}手动把会话钉到该号
POST /plugins/dsh-opencode-go-pool/clear-cooldown{"accountId":"go-3"}清掉该号的冷却
POST /plugins/dsh-opencode-go-pool/models-refresh{}拉官方模型目录并入 config.json

手改 config.json 也一样有效(watcher 1 秒重载)。

失败分流

上游处理
401 / 403该号冷却 30 分钟,换下一个
402 / 429先拉一次用量确认:月额度满 → 冷却到 resetsAt;否则冷却 3 分钟
5xx冷却 3 分钟,换下一个
400 且响应含 quota/limit/额度按额度不足处理
连接失败(fetch failed)网络层问题,与账号无关:该号只冷却 15 秒,并在 30s 预算内最多重试 4 轮

换号只在还没吐字时发生;流开始后失败直接上抛,避免重复输出。

限流不是死路:一轮里所有账号都失败、且错误属于「限流 / 上游 5xx / 连接抖动」时,插件会退避 (config.json 的 retryBackoffMs,默认 2500ms)后清空排除集再来一轮,总预算 15s。 原来的写法是「三个号各 429 一次 → 直接抛错」,用户只看到一句「本轮出错了」; 现在一次 429 会先重试,真失败才报错。

所有失败都会落到 ~/.dsh/opencode-go-pool/errors.ndjson(最近 100 条,含 HTTP 状态与网关原文; 连接类失败还会带 cause,把 undici 藏在 error.cause 里的真实原因展开), 排查时先看这个文件,不用再猜:

{"at":"…","kind":"http","sessionId":"session-…","accountId":"go-3","status":429,"code":"RATE_LIMIT","snippet":"{\"type\":\"error\",…}","message":"账号 Go 3 被限流(HTTP 429)…"}
{"at":"…","kind":"transport","sessionId":"session-…","accountId":"go-2","cause":"TypeError fetch failed <- Error code=ECONNRESET syscall=read","message":"账号 Go 2 连接失败(网络层,与额度无关):…"}
{"at":"…","kind":"give-up","sessionId":"session-…","code":"RATE_LIMIT","message":"账号 Go 1 被限流(HTTP 429)…"}

请求身份(UA / 会话头 / prompt cache)

OpenCode Go 对客户端有三条要求(docs/console/go → Where can I use it): 发典型 coding agent 流量、用自己的 user agent 自报身份、每个会话在 x-opencode-session 里带稳定 id (供其路由与 prompt cache 分桶)。三条都落在 lib/identity.mjs 一个地方:

要求本插件发的值
自己的 UAopencode-go-pool/<版本> (+https://github.com/deepseek-ai/deepseek-harness),版本取自 package.json,不手抄
会话路由 / 缓存分桶x-opencode-session: <DSH 会话 id>(没有 sessionId 时用落盘的稳定兜底 id,跨重启不变)
让 OpenCode 认出 DSHx-deepseek-harness-session-id: <同一个 id>(DSH 官方适配器发的就是这个原生头)
coding agent 流量形态accept: text/event-stream、stream: true、stream_options.include_usage、工具与推理档位原样透传

两个会话头同值一起发:缺 x-opencode-session → 网关直接 400 MissingSessionID; 只发原生头 → 请求能过,但基本不进缓存桶(实测单会话连打 10 次,命中 0 次;两个头一起发时同样的打法命中 9/10)。 实测(2026-11-06,同一段 3459 token 前缀连打两次同一个会话):

status=200  x-opencode-session + x-deepseek-harness-session-id
第一次  cached=0     prompt=3459  allowance=0.00062838
第二次  cached=3456  prompt=3459  allowance=0.00001874   ← 命中 99.9%,账单降到 1/33

换一个会话 id 命中即归零,说明缓存确实按会话分桶——所以 DSH 传入的 sessionId 必须逐轮稳定地发出去。 用量查询(GET /usage)复用同一个 UA,但不带会话头(那不是推理流量)。

面板里每个账号行的「缓存 xx%」就是本插件自己请求的命中率 (cacheRead / (未命中输入 + cacheRead),数据来自响应 usage.prompt_tokens_details.cached_tokens)。

测试

node --test test/unit.test.mjs   # 公式/选号/序列化/SSE 翻译/出站身份头
node test/apply.mjs              # 宿主装配 + 路由 + 客户端 bundle 契约
node test/e2e.mjs                # 真实请求跑通整条链路(会花一点额度)

图片支持(多模态)

DeepSeek V4.1 Flash 原生收图,插件按 OpenAI 兼容的 image_url 发 data URL:

  1. ImageBlock.attachment 是 ImageAttachmentRef(attachmentId/mediaType/bytes/宽高,无字节);
  2. 适配器调官方附件服务 ctx.attachments.readImageRequest(ref, target, signal) 取「请求版本」 (按长边 ≤2048、编码 ≤2MB 派生,带磁盘缓存),再 base64 成 data:<mediaType>;base64,…;
  3. 同一张图按 attachmentId+目标尺寸 缓存 24 条,多轮带历史图不会重复编码;
  4. 取不到字节时降级成一行 [图片未随请求发送:名称],请求照发,不会整轮失败。

实测(2026-11-04):16×16 红方块 → 模型回答「红色」,allowance ≈ 0.0000186(同规模纯文字约 0.0000089,图片确实更贵)。 config.json 里模型的 input 可写 ["text"] 关掉图片、或 ["text","image"] 打开。

请求体体积(网关硬上限 64 MiB)

历史图片每轮都会重新带进请求体,一张 2 MiB 的图 base64 后约 2.7 MiB,几十张截图会顶到网关 413 Request bodies must be at most 64 MiB。DSH 的压缩按 token 算,图片几乎不计 token, 所以图片堆积不会触发压缩。插件现在自己做三层保护:

  1. 图片总预算 20 MiB:从最新往最旧分配,超出的旧图降级成 [图片已省略:为控制请求体大小,历史图片不再随请求发送](文本与最近的图保留);
  2. 整包 60 MiB 上限:组装完实测字节数,超了就去掉全部图片重建一次;
  3. 上游仍返回 413:自动去图重发一次;重发还超才报 「请求体超过网关 64 MiB 上限…请先压缩会话」,并且不冷却账号(跟账号无关)。

所以正常情况下不会再看到 413;真看到时说明纯文本历史就超过 60 MiB,压缩会话即可。

已知限制

  • provider.id 改名需要重启(路由按启动时的 id 注册)。
  • 上游没有公开「套餐总额度」数值,面板显示的是百分比(来自 /usage)与实际累计美元(来自响应里的 usage.opencode.allowance)。

测试

node --test test/unit.test.mjs   # 单测:评分、选号、序列化、SSE、身份头、413 体积保护
node test/apply.mjs              # 装配冒烟:假 ctx 走一遍 apply(),校验路由与客户端 bundle 契约
node test/e2e.mjs                # 真机冒烟(需要真实 key;可跳过)

License

MIT © 2026 Ritanlisa

Comments

Loading…

From the same category

awesome-dsh-plugin

by awesome-dsh-plugin

A curated list of plugins for DeepSeek Harness (dsh) · DeepSeek Harness 插件精选列表

Development & Infrastructure

★ 25k

CC0-1.0

Python

Nov 17, 2026

Index only — not installable

by woniuniuniu

DeepSeek Harness 自媒体工作台插件:一句话记灵感,一键生成脚本、封面、配图和分镜

Workflow & AutomationTools & CapabilitiesDevelopment & InfrastructureManifest valid

★ 1.5k

↓ 8.2k/wk

MIT

JavaScript

Nov 15, 2026

dsh plugin --profile web add dsh-media-desk

by 0xsline

DeepSeek Harness (DSH) ecosystem: curated plugins, tools, and infrastructure from dsh-external/hub and the public dsh-plugin topic.

Development & Infrastructure

★ 1.4k

CC0-1.0

Python

Nov 6, 2026

Index only — not installable

by keli-wen

Hire Google's Antigravity CLI (agy) as a fast Gemini staffer for Claude Code, OpenAI Codex, and DeepSeek Harness.

Development & InfrastructureManifest valid

★ 888

MIT

JavaScript

Nov 16, 2026

dsh plugin --profile agent add agy-staff

by Roland0511

MarkText (muya) WYSIWYG Markdown editor for the DeepSeek Harness right sidebar

Tools & CapabilitiesUI & ExperienceDevelopment & InfrastructureManifest valid

★ 762

↓ 2.8k/wk

MIT

JavaScript

Nov 7, 2026

dsh plugin --profile web add dsh-marktext

by SAOS-3624

Scene-aware storyboard for DeepSeek Harness: 9-16 numbered cells with timestamps + transcript + an audio envelope, packed into ONE image (384 tokens). Two tools: video_storyboard and video_zoom.

Tools & CapabilitiesVision & MultimodalDevelopment & InfrastructureManifest valid

★ 568

↓ 17k/wk

MIT

JavaScript

Nov 16, 2026

dsh plugin --profile web add dsh-video-storyboard