dsh-go-quota
Manifest validOpenCode Go multi-account quota cards for DeepSeek Harness
dsh-go-quota
OpenCode Go 多账号额度卡片与 Key 切换插件,运行在 DeepSeek Harness(DSH)桌面版的 Web UI 里。
每个 OpenCode Go 订阅 Key 一张额度卡:实时查看 5h / 周 / 月三档用量,点卡片切换当前 Key;支持星标置顶、单/双列布局、拖动悬浮窗、展开收起动画,并与 DSH 左下角的 Go 额度面板联动。
本项目与 OpenCode、DeepSeek 官方无隶属关系。额度查询使用 OpenCode Go 的接口,接口可能随时变化。
功能
- 每个 Key 一张卡:5h / 本周 / 本月进度条、百分比、重置倒计时;≥70% 变黄,≥90% 变红。
- 当前账号细长横条:账号名 + 5h / 周 / 月三档 + 星标,不占用一张大卡。
- 点击切换:把该账号的 Key 写入 DSH 凭据库的
OPENCODE_GO_API_KEY,并刷新dsh-cost-meter;卡片显示「切换中…」。 - 添加 / 删除:Key 只以掩码(前 4 + 后 4)下发浏览器;当前账号不显示删除按钮。
- 星标置顶:灰色实心五角星,点击变金色并在切换列表置顶;再点取消。
- 布局:标题栏布局图标切换单列 ↔ 双列,宽度弹簧过渡 + 卡片错峰入场;首次点击前按账号数自适应。
- 拖动 / 收起:收起胶囊或标题栏拖动;位置、布局、星标、收起状态存 cookie + localStorage,跨重启保留。
- 动效:展开/收起弹簧、卡片错峰、胶囊 pop;支持
prefers-reduced-motion。 - 安全区:顶部保留 84px,避免压到窗口标题栏/拖拽区;面板在 Electron 拖拽区可点击。
界面
- 标题栏:
Go 账号 · N 个账号+ 布局图标 + 刷新 + 收起。 - 使用中横条:
● 账号名 ★ 使用中 5h x% · 周 y% · 月 z%。 - 卡片组:每个账号一张,当前账号不在卡片组里。
- 底部:
+ 添加账号/ 更新时间。
欢迎 PR 提供脱敏截图;请勿提交真实 Key 或账号数据。
安装
前置
- DSH 桌面版,带 Web UI(本插件使用 DSH 的 Web 客户端插件 API;不同 DSH 版本可能有差异)。
- 一个 OpenCode Go 订阅 Key(
oc_...)。 - 首次使用需要让 DSH 能访问
https://opencode.ai/zen/go/v1/usage。
本地 Bundle 安装
-
克隆或下载本仓库到本地目录:
git clone https://github.com/EyuNO1/dsh-go-quota -
在 DSH 里把它作为本地 bundle 安装:
-
打开 DSH 的插件管理页,选择「安装本地 Bundle / Install local bundle」,选中该目录;或
-
让 DSH 的 agent 执行:
plugin_manager install_bundle target=<仓库绝对路径>
-
-
重启 / 刷新 DSH。右上角出现「Go 账号」浮层。
-
首次启动会把凭据库里已有的
OPENCODE_GO_API_KEY导入为「默认账号」;没有则在浮层点「+ 添加账号」。
本包是 DSH 本地 bundle(包名
@local/dsh-go-quota),不是 npm 包;@local/前缀是本地安装约定。
开发模式
修改 client.js 后刷新 DSH 页面即可(部分环境支持热加载);修改 index.js / cordis.patch.yml 后需要重载插件或重启 DSH。
node --check index.js
node --check client.js
使用
- 切换:点卡片正文(不是星标/删除)切换当前 Key;当前账号会变成顶部横条,原当前账号回到卡片组。
- 星标:点账号名右侧灰星,标记为重要并置顶;再点金星取消。
- 布局:点标题栏布局图标,在单列/双列之间切换;选择会记住。
- 拖动:收起后拖胶囊,或展开后拖标题栏;位置自动限制在屏幕内。
- 刷新:点标题栏刷新图标,强制重查所有账号额度。
数据与安全
- Key 保存在 DSH 凭据库的
OPENCODE_GO_API_KEY中;账号列表保存在$DSH_HOME/plugin-data/dsh-go-quota/accounts.json(权限 0600)。 - 浏览器只拿到掩码(前 4 + 后 4),拿不到完整 Key。
- Key 只作为
https://opencode.ai/zen/go/v1/usage的 Bearer 和 DSH 凭据值使用;无遥测、不上传第三方。 - 插件 HTTP 路由与 DSH 同源、仅本机,不额外监听端口。
- 位置/布局/星标/收起状态存 host 级 cookie + localStorage,不包含 Key。
- 请勿在 issue / PR 中粘贴
accounts.json、完整 Key 或带个人数据的截图。安全报告见 SECURITY.md。
工作原理
DSH Web UI
shell.overlay ── 「Go 账号」浮层 (client.js)
│ fetch(同源)
▼
Host plugin (index.js)
GET /go-quota/state
POST /go-quota/accounts {name, key}
POST /go-quota/accounts/remove {id}
POST /go-quota/activate {id}
POST /go-quota/refresh
│ accounts.json + DSH credentials + costMeter
▼
https://opencode.ai/zen/go/v1/usage
- 激活:写
OPENCODE_GO_API_KEY,读回校验;成功后才确认切换,失败会报错。 - 首次导入:从 DSH 凭据库读取已有 Key,不覆盖、不丢 Key。
- 额度:并发查询所有账号,约 20 秒缓存;
?force=1绕过。
兼容性 / 已知限制
- OpenCode Go 的 usage 接口不是公开稳定 API;请求需要浏览器 UA,可能触发 Cloudflare 限制。
- DSH 的 Web 客户端插件 API 仍在演进;本插件按 2026-11 的 desktop 版本验证。
- 面板顶部保留 84px 安全区,因此不能拖到窗口最顶;这是为了避免压到标题栏/拖拽区后无法点击。
- 位置/布局/星标是 host 级 cookie:用
localhost和127.0.0.1打开会被视为两份。 - 手动选过布局后不再自动跟随账号数;清除
dsh_goq_layoutcookie 可恢复自动。 - 星标是浏览器本地 UI 偏好,不写入
accounts.json。 - 两列布局下最后一张奇数卡片右侧会留一个空位。
开发 / 贡献
- 纯 ESM,无构建步骤;源码即发布。
node --check index.js、node --check client.js必须通过。- UI 颜色全部使用
--dsw-alias-*token;避免硬编码主题色。 - PR 请附:改了什么、如何验证、是否影响切换/凭据/额度链路。
- 不要提交 Key、
accounts.json、个人截图或$DSH_HOME下的数据。
License
MIT © 2026 dsh-go-quota contributors
English
dsh-go-quota is a local-first DeepSeek Harness (DSH) Web UI plugin that shows one quota card per OpenCode Go subscription key: 5-hour, weekly and monthly usage, a compact active-account bar, click-to-switch of the active OPENCODE_GO_API_KEY, star-to-pin ordering, one/two-column layout, draggable placement, and open/close animations. It integrates with dsh-cost-meter.
Install: clone this repo, install the folder as a local DSH bundle (Plugins UI or plugin_manager install_bundle target=<path>), restart DSH, then add your oc_... keys. The first launch imports an existing OPENCODE_GO_API_KEY as the default account.
Keys stay in the DSH credential store; only masked values reach the browser; no telemetry. The OpenCode Go usage endpoint is unofficial and may change. MIT licensed. Not affiliated with OpenCode or DeepSeek.
Comments
Loading…
Similar plugins
by lccc233
OpenCode Go plan quota rings for the DeepSeek Harness web GUI
★ 0
MIT
JavaScript
Oct 2, 2026
dsh plugin --profile web add dsh-opencode-go-usageby qknc-bot
DSH plugin: OpenCode Go quota ring + expandable card (5h/weekly/monthly usage) for DeepSeek Harness Web
★ 0
MIT
JavaScript
Aug 16, 2026
dsh plugin --profile web add dsh-opencode-go-usageby haipisao
deepseek web端的一个小插件,显示opencode go套餐剩余额度的
★ 0
MIT
JavaScript
Aug 17, 2026
dsh plugin --profile web add dsh-plugin-opencode-go-quotaby whitelonng
DeepSeek Harness plugin: multi-key pool with automatic quota failover and a usage dashboard for the OpenCode Go plan
★ 3
MIT
JavaScript
Aug 28, 2026
dsh plugin --profile web add dsh-opencode-go-poolby 6pofx
OpenCode GO 套餐用量监控插件:账户三窗口额度 + DSH 按模型 Token/金额统计,为 DeepSeek Harness Web GUI 而生
★ 3
↓ 164/wk
MIT
JavaScript
Oct 17, 2026
dsh plugin --profile web add dsh-go-usageby CJYLZS
auto sync opencode-go models in dsh
★ 3
JavaScript
Sep 4, 2026
dsh plugin --profile web add dsh-opencode-go-autosync