Ollama 额度面板 okku000/dsh-ollama-quota

dsh-ollama-quota

DeepSeek Harness 插件，把 Ollama Cloud 额度余额显示为一个 Settings 分区（id ollama-quota，order -9，紧挨着内置的 Account 条目下方），并让你在同一页填写或替换 Ollama Cloud API key。

Ollama 把账户改成了额度模式：GET https://ollama.com/api/usage 不再返回旧的 limits.session / limits.weekly 窗口（改为返回 range/totals/buckets 报告），所以按旧结构写的读取器会报 "Could not parse the response · no limits object"。
剩余额度现在来自 GET https://ollama.com/api/balance，本插件读的就是它。

数据来源

| Endpoint | 作用 |
| GET https://ollama.com/api/balance | 主数据：included.balance_usd、included.allowance_usd、included.period、purchased.balance_usd |
| GET https://ollama.com/api/usage?range=24h\|7d\|30d | 参考数据：totals（费用、请求数、token）和每日 buckets |

两者都带 Authorization: Bearer <Ollama Cloud key>。用量报告失败绝不会掩盖正常的余额；它会在用量卡片里显示为一条内联提示。用量报告按自己更慢的间隔（usageRefreshMs）重新读取，因为它的窗口很宽，几乎不怎么变。

显示内容

| 行 | 来源 |
| 剩余赠送额度 | included.balance_usd / included.allowance_usd |
| 已用比例条 | allowance - balance 除以 allowance |
| 已购额度 | purchased.balance_usd |
| 额度周期 | included.period.from → included.period.until |
| 花费、请求数、输入/缓存/输出 token | usage.totals，窗口为 usageRange |
| 每日花费条 | usage.buckets[].usage_usd（最多 31 个 bucket） |
| 非高峰状态与倒计时 | 按浏览器时钟计算：高峰定价为工作日 12:00–18:00 UTC，其余时间都是非高峰 |
| key 来源 | 解析到了哪个凭据引用 |
| API key 编辑器 | 通过 DSH Remote 调用 remote.credentials.describe(refs) / set(ref, value) / unset(ref)（remote.credentials 是声明过的注入边） |

不显示按模型的请求数：该 endpoint 已不再上报。

侧边栏小组件

插件还注册了 sidebar.footer.action，也就是堆叠在内置 Settings 条目上方的列表槽位。
这个小组件始终可见，不只在 Settings 打开时显示，内容包括：

- 剩余额度和 30 天花费，
- 当前是否适用非高峰定价，以及当前本地时间，
- 到下一个边界的倒计时，精确到分钟（高峰时倒计时到非高峰开始，非高峰时倒计时到非高峰结束），
- 一条按浏览器本地时钟绘制的 24 小时条，高峰窗口也画在上面。JST 把 12:00–18:00 UTC 变成 21:00–03:00，所以这段区间会跨过本地午夜；刻度是本地小时，条下方的说明也是本地时间。

折叠后的 56px 侧栏保留额度，以及一个紧凑的 H:MM 倒计时。
Ollama 在工作日 UTC 12:00–18:00 之外、以及周末全天实行错峰定价，所以高峰窗口是唯一一个「结束时间就是高峰起点」的区间。

Settings 区块承载同样的状态，另有一张卡片展示完整规则文本、本地高峰窗口、当前本地时间，以及两个倒计时。

安装

dsh plugin --profile web add git+https://github.com/okku000/dsh-ollama-quota.git

如果对着本地检出开发，改成链接目录，这样编辑即时生效：

dsh plugin --profile web add link:/path/to/dsh-ollama-quota

Host 侧改动需要重启应用；Client 侧改动需要刷新页面。

配置

该行读取以下字段，全部可选（cordis.patch.yml）：

| 字段 | 默认值 | 含义 |
| keyEnvs | [OLLAMA_CLOUD_API_KEY, OLLAMA_API_KEY] | 按顺序尝试的凭据引用；编辑器写入的是第一个 |
| apiBase | https://ollama.com | API 源 |
| usageRange | 30d | 用量窗口，取 24h、7d、30d 之一 |
| refreshMs | 60000 | 余额刷新间隔，最小 5000 |
| usageRefreshMs | 300000 | 用量报告间隔，最小 60000；?force=1 或换新 key 会重新读取 |
| timeoutMs | 15000 | 单次请求超时 |

Host 侧提供 GET /ollama-quota/snapshot（加 ?force=1 先刷新）。快照携带金额、计数、时间戳、错误标签，以及凭据引用顺序——绝不包含 key。

验证

node scripts/verify.mjs # offline: fake Host context and fake browser runtime
node scripts/verify.mjs --live # also drives the real endpoints with the stored key

--live 从 $DSH_HOME/.credentials.yaml 读取 OLLAMA_CLOUD_API_KEY。

许可证

MIT —— 见 LICENSE。