dsh-opencode-usage-dashboard

usagetested: passnpmMIT

OpenCode usage dashboard: a sidebar panel for quota and usage in DeepSeek Harness, with Go subscription windows, Console spend, trends, forecasts and model breakdown, multiple accounts, service-account filtering and English/Chinese UI.

下载量 / Downloads

1,087

依赖体积 / node_modules

3.18 MB

测试时间 / Tested

2026-11-06

DSH 版本 / Version

0.2.2-rc.1

Install

dsh plugin --profile web add dsh-opencode-usage-dashboard

Sandbox test results

Stage	Result
1 install	✓
2 list	✓
3 mount	✓
4 boot	—

Four stages run in an isolated sandbox: install (network on) → list → mount → boot (last three with no network).

README

</div>

<h1 align="center">OpenCode 用量面板</h1>

在 DeepSeek Harness 侧栏，随时看清 OpenCode 的额度、花费和趋势。

<a href="#安装">安装</a> ·

<a href="#界面">界面</a> ·

<a href="#账户形态">账户形态</a> ·

<a href="https://github.com/zhxmt-xm/dsh-opencode-usage-dashboard/blob/main/docs/README.md">开发与原理</a>

[!NOTE]

这是 DeepSeek Harness 的第三方插件，数据来自 OpenCode 官方。

侧栏卡片（浅色主题，示意数据）：用量 · 额度 · 预测 · 趋势 · 模型

</div>

为什么用它

OpenCode 的额度、花费和用量分散在几个接口里：Go 订阅的滚动 / 周 / 月窗口，Console 的花费与 token。这个插件把它们收进一张侧栏卡片，不用打开网页控制台，也不用自己算。

Go 和按量账户都能用：有 Go 订阅时显示额度窗口；只有 Console 用量时保留花费、趋势和模型。
知道今天花了多少：今日花费、请求数、tokens，以及本周 / 本月汇总。
看见趋势：7 天 / 24 小时，花费 / tokens / 请求数随时切换。
提前知道会不会用完：有月度额度时，按当前计费周期的花费速度外推，标出 50% / 100% 的预计日期。
知道钱花在哪个模型：按花费排序的模型条形图。
多账户不打架：同一组织的 Key 合并成一张卡，不同组织分开；可切换账户，花费可按服务账号筛选。
高度可配置：分块显示/隐藏与排序、色条、四档阈值、趋势指标、刷新间隔都能改。
不打扰：跟随 DSH 主题、中英双语、无外部 CDN，偏好只存在本机。

界面

下面按侧栏卡片的五个分块、设置页的三个面板分别说明。截图使用固定样例数据（acme / org_acme 等账户名与组织 id 均为虚构），实际数字随账户变化。

侧栏卡片

卡片放在侧栏设置按钮上方；侧栏收起时退化为一个百分比/金额小方块，展开后按偏好顺序显示分块，默认只开「用量」和「额度重置时间」，其余在设置里随时打开。每个分块标题右侧有个箭头，点一下就把这一块收成一行（只留标题和它的关键数据，例如用量显示当日花费、额度显示本月已用、趋势显示最近一根、模型显示第一名），再点展开。卡片右上角还有收起按钮，收起后只剩一行「OpenCode + 本月剩余（没有月度额度时显示总花费）」，再点一下展开。卡片顶部有一条拖拽热区（悬停露出一小条横线），上下拖动直接调卡片限高，拖到内容放满、不再需要滚动时会自动关掉限高。卡片顶部是账户入口：点账户名可切换组织和服务账号，右侧是刷新、设置与收起按钮。

用量

今日花费、请求数、tokens；
Tokens 列默认显示紧凑值，悬停或键盘聚焦可看精确到个位的数字；
有月度额度时，顶部油表显示本月剩余百分比；
下方并排汇总今日、本周、本月，不用来回切页面。

额度

滚动 5 小时、本周、本月三个窗口；
进度条按四档分级变色，右侧显示已用百分比；
每行带重置倒计时；没有 Go 订阅时整块隐藏。

预测

按当前计费周期的花费速度做线性外推；
绿色为实测、橙色为预测，标出 50% / 100% 的预计日期；
没有月度额度或有效数据不足两个点时整块隐藏。

趋势

7 天 / 24 小时切换；
花费 / tokens / 请求数切换；
没有数据时保留分块，显示空态文案。

模型

按花费排序，条形长度按最高花费归一化；
最多显示四行；
没有按模型计费记录时整块隐藏。

分块收起

每个分块标题右侧有一个箭头，点一下收成一行，再点一下展开；
收起时标题右侧显示这一块的关键数据：
用量 → 当日 · $0.55
额度重置时间 → 本月 · 23% 已用
月度预测 → 11/27 · 163%（重置日期 + 按当前速度的预测值）
趋势 → 11/01 · $0.55（24 小时时是 18:00 · $0.12）
模型 → 只放第一名的模型名
卡片窄的时候这些文字会自动省略成 …，标题和箭头位置不动；
最后一个分块的提示气泡朝上弹，不会被卡片底边裁掉。

设置页

设置 → OpenCode 套餐。Key 仍在 DSH 的 provider 设置里管理，这一页只读。

账户

账户按组织分组，同一组织的 Key 合成一张卡；
当前账户打绿色「当前」，其余可「切换」；组织下的服务账号可以单独筛选花费；
「刷新数据」立即重读，刷新间隔可选 30 秒 / 1 分钟 / 5 分钟 / 15 分钟；
Key 只读，改 Key 去 DSH 设置 → Providers（llm-pi-ai）。

显示

卡片样式：开关控制是否显示左侧色条，旁边选色条颜色；
卡片限高：默认关闭；打开后分块区最高到设定像素，超出在卡片内滚动（卡片头和账户菜单不会被裁）。上限永远等于「内容自然高度 - 1px」，跟着内容实时变化，输入框只做范围保护；也可以直接拖卡片顶部的把手上下调，拖到顶（已经没有东西可滚）时会自动关掉限高一次；
进度条分级：四档的名称、区间、颜色都可以改，区间首尾相接；
「恢复默认」回到 0–50 绿、50–75 黄、75–90 橙、90–100 红。

卡片展示

一行一个分块：左边是该块的开关，右边就是它在侧栏里的真实渲染；
「在侧栏显示」控制整块；「收起」让这一块在侧栏里只留一行标题（收起时标题右侧显示它的关键数据，见上面的「分块收起」）；用量块另有「本周」「本月」控制表格行，以及「简化版本」——只保留今日，油表缩到左侧、花费 / 请求数 / Tokens 各占一行，块高度从约 230px 降到约 75px；简化版打开时「本周 / 本月」置灰（选择保留）；
悬停行标题时右侧浮出拖拽点，按住标题上下拖即可调整顺序；
趋势的 7 天 / 24 小时、花费 / tokens / 请求数切换直接在右侧预览里点；24 小时轴会按卡片实际宽度自动抽稀标签；
「简化版本」后面的 ? 是这一项的说明，面板标题旁的 ? 是操作提示。

这里没有单独的「趋势图」设置面板：趋势的显示范围与指标就在卡片展示的预览里切换。

账户形态

卡片的五个分块由接口数据决定，不是配置开关，也不看 provider 名：

形态 · 你会看到

只有 Go 订阅 · 五个分块齐全

只有 Console 按量

…(truncated)

Rendered from the README published on npm. Formatted only, not edited.

Versions

Published on npm:：6，最后更新 2026-11-01

Links

GitHub · Homepage · npm