dsh-ollama-usage 0.1.9 → 0.1.11

package/README.md

@@ -7,7 +7,7 @@
 [![npm version](https://img.shields.io/npm/v/dsh-ollama-usage?color=7c66e8&label=npm)](https://www.npmjs.com/package/dsh-ollama-usage)
 [![GitHub release](https://img.shields.io/github/v/release/SeverusZh/dsh-ollama-usage?color=b39df7&label=release)](https://github.com/SeverusZh/dsh-ollama-usage/releases)
 [![License](https://img.shields.io/badge/license-MIT-9ece6a)](LICENSE)
-[![dsh](https://img.shields.io/badge/DSH%200.1.5--rc.1%20%2F%20rc.2%20%2F%200.1.6--alpha.2%20%2F%200.1.7--rc.1%20%2F%20rc.2-7aa2f7)](https://github.com/deepseek-ai/dsh)
+[![dsh](https://img.shields.io/badge/DSH%200.1.5--rc.1%20%2F%20rc.2%20%2F%200.1.6--alpha.2%20%2F%200.1.7--rc.1%20%2F%20rc.2%20%2F%200.2.0--rc.1-7aa2f7)](https://github.com/deepseek-ai/dsh)
 
 可视化你的 **Ollama Cloud** 用量余量 —— 每 5 小时会话用量 + 周用量，
 侧边栏极简双横条常驻显示，插件详情页完整面板，Key 与快照持久化，自动刷新。
@@ -20,8 +20,8 @@ plugin's own detail page, persisted credentials & snapshots, auto-refresh.*
 
 ---
 
-> **兼容性 / Compatibility**：v0.1.8 支持 DSH **≥0.1.5-rc.1**，已在 **0.1.5-rc.1 / 0.1.5-rc.2 / 0.1.6-alpha.2 / 0.1.7-rc.1 / 0.1.7-rc.2** 实测（RPC envelope 探针全过；0.1.7-rc.2 上 `/ollama-usage/snapshot` 实测返回）；旧版 DSH（0.1.0-rc.5 ~ rc.8）请使用最后兼容的 npm 版本 **0.1.5**。
-> v0.1.8 targets DSH **≥0.1.5-rc.1**, verified on **0.1.5-rc.1 / 0.1.5-rc.2 / 0.1.6-alpha.2 / 0.1.7-rc.1 / 0.1.7-rc.2**; for older DSH releases use the last compatible npm version **0.1.5**.
+> **兼容性 / Compatibility**：v0.1.11 支持 DSH **≥0.1.5-rc.1**（`@deepseek-ai/dsh-*` peer 放宽为 `>=0.1.7-rc.1`），已在 **0.1.5-rc.1 / 0.1.5-rc.2 / 0.1.6-alpha.2 / 0.1.7-rc.1 / 0.1.7-rc.2 / 0.2.0-rc.1** 实测（RPC envelope 探针全过；0.1.7-rc.2 上 `/ollama-usage/snapshot` 实测返回；0.2.0-rc.1 上通过新的兼容性门禁并正常加载）；旧版 DSH（0.1.0-rc.5 ~ rc.8）请使用最后兼容的 npm 版本 **0.1.5**。
+> v0.1.11 targets DSH **≥0.1.5-rc.1**, verified on **0.1.5-rc.1 / 0.1.5-rc.2 / 0.1.6-alpha.2 / 0.1.7-rc.1 / 0.1.7-rc.2 / 0.2.0-rc.1**; for older DSH releases use the last compatible npm version **0.1.5**.
 
 ## ✨ 功能特性 Features
 
@@ -30,13 +30,20 @@ plugin's own detail page, persisted credentials & snapshots, auto-refresh.*
 | 🎯 **会话用量（每 5 小时）** | Ollama Cloud 的 5 小时会话配额，置顶展示「已用 X% · 剩余 Y%」 |
 | 📅 **周用量（Weekly）** | 本周配额进度，与会话用量并排展示 |
 | 🎨 **侧边栏双横条** | 极简透明风格：会话 5h **淡紫** + 周用量**深紫**，各带百分比数字，悬停显示详情，每 60 秒自动更新（窄栏自动隐藏） |
-| 🖥️ **插件详情页完整面板** | 渲染在「插件列表 → dsh-ollama-usage」页面的描述与组件行之间：会话/周用量进度条、周用量重置倒计时、模型请求数排行、最近 5 条会话用量历史 |
+| 🖥️ **插件详情页完整面板** | 渲染在「插件列表 → dsh-ollama-usage」页面的描述与组件行之间：会话/周用量进度条、会话与周重置倒计时、最近 5 条会话用量历史 |
 | 💾 **持久化** | API Key 与用量快照写入 `$DSH_HOME/storages/ollama-usage/usage.json`（权限 600，保留 24 条历史），跨对话 / 重启自动恢复 |
 | 🔄 **自动刷新** | Host 每 10 分钟自动查询（页面关闭也持续）；Key 失效（401）自动清除并提示 |
 | 🔑 **登录引导** | 未登录时一键打开 [ollama.com/settings](https://ollama.com/settings) 登录、到 [settings/keys](https://ollama.com/settings/keys) 创建 API Key；兼容旧版 CLI 的 `~/.ollama/auth.json` |
 
-数据来源为 Ollama 官方接口 `GET https://ollama.com/api/usage`，与
-[ollama.com/settings](https://ollama.com/settings) 页面一致。
+限额进度数据来源于 Ollama 官方接口 `GET https://ollama.com/api/balance`
+（`included.session` / `included.weekly` 的 `remaining_percent` 与 `resets_at`），
+与 [ollama.com/settings](https://ollama.com/settings) 页面一致。
+
+> **v0.1.11 修复**：Ollama 在 2026-10 把 `GET /api/usage` 改为只返回按小时/天的
+> 请求量分桶，不再包含 `limits.session` / `limits.weekly`，旧版本因此把两个百分比
+> 解析成 `null` —— 面板显示「暂无数据」、侧边栏双横条显示「—」。
+> 现在限额进度改由 `/api/balance` 提供（`已用 = 100 - remaining_percent`），
+> 重置倒计时也直接使用接口下发的真实 `resets_at`。
 
 ## 📦 安装 Install
 
@@ -59,7 +66,7 @@ dsh --profile web
 
 ## 🔒 数据与隐私 Privacy
 
-- 仅向 `https://ollama.com/api/usage` 发送带 Bearer 的查询请求；
+- 仅向 `https://ollama.com/api/balance` 发送带 Bearer 的查询请求；
 - Key 以明文保存在本机 `$DSH_HOME/storages/ollama-usage/usage.json`（权限 600，
   与 `~/.ollama/auth.json` 同等级信任），随时可清除。
 
@@ -69,7 +76,7 @@ dsh --profile web
 ┌──────────────────────────┐        ┌─────────────────────────────┐
 │  browser (client bundle) │  RPC   │  host (lib/index.js)        │
 │  lib/client.js           │◄──────►│  webServer /ollama-usage    │
-│  · sidebar dual bars     │ 信封协议 │  · fetch api/usage (Bearer)│
+│  · sidebar dual bars     │ 信封协议 │  · fetch api/balance(Bearer)│
 │  · settings panel        │        │  · $DSH_HOME 持久化(0600)   │
 │  · login guidance        │        │  · 10min auto-refresh       │
 └──────────────────────────┘        └─────────────────────────────┘
@@ -85,11 +92,15 @@ dsh --profile web
 ## 🧪 测试 Tests
 
 ```bash
-DSH_HOME=.tmp-dsh-home HOME=.tmp-home node test/bridge-smoke.mjs
+npm test   # bridge-smoke → balance-parse → rpc-envelope-alpha4
 ```
 
-17 项冒烟测试覆盖：路由注册、no-token / 401 分支、持久化读写与清理、
-snapshot / forget / auth-state、非法信封与请求方法校验。
+- `test/bridge-smoke.mjs`（17 项）：路由注册、no-token / 401 分支、持久化读写与
+  清理、snapshot / forget / auth-state、非法信封与请求方法校验。
+- `test/balance-parse.mjs`：`/api/balance` 解析回归（不联网，fetch 替身）。用真实
+  响应体驱动 `check`，断言 5h / 周百分比换算、`resets_at` 透传、持久化与历史追加，
+  以及无限额套餐 / 非 JSON / 401 / 403 / 网络异常各分支。
+- `test/rpc-envelope-alpha4.mjs`：逐端点通过 alpha.4 的 Connection RPC 信封校验器。
 
 ## 🛠️ 开发 / 发布 Develop & Publish
 

package/lib/client.js

@@ -3,7 +3,7 @@
  *
  * 提供三处界面:
  *  - plugins.bundle.config(以包名为键)「Ollama 用量」:完整面板(会话 5h / 周用量
- *    进度条、周用量重置倒计时、模型请求数、历史记录、API Key 配置、清除 Key)。
+ *    进度条、会话与周用量重置倒计时、历史记录、API Key 配置、清除 Key)。
  *    渲染在「插件列表 → dsh-ollama-usage」页面的描述与组件行之间 ——
  *    配置不再位于设置面板(settings.section 已退役);
  *  - sidebar.footer.action:极简双横条(会话 5h 淡紫 / 周用量深紫,透明背景);
@@ -175,11 +175,12 @@ window.__ModuleLoader__.load({
 
       function UsageBody(props) {
         const d = props.data
+        const sessionResetText = d.sessionResetAt ? fmtCountdown(d.sessionResetAt) : null
         const weeklyResetText = d.weeklyResetAt ? fmtCountdown(d.weeklyResetAt) : null
         const models = Array.isArray(d.models) ? d.models.slice(0, 5) : []
         const history = Array.isArray(props.history) ? props.history.slice(-5).reverse() : []
         return React.createElement('div', { className: 'olusa-block' },
-          React.createElement(BarRow, { label: '会话用量（每 5 小时）', percent: d.sessionPercent, em: true }),
+          React.createElement(BarRow, { label: '会话用量（每 5 小时）', percent: d.sessionPercent, em: true, resetText: sessionResetText ? '还有 ' + sessionResetText + ' 重置' : null }),
           React.createElement(BarRow, { label: '本周用量（Weekly）', percent: d.weeklyPercent, resetText: weeklyResetText ? '还有 ' + weeklyResetText + ' 重置' : null }),
           (models.length > 0
             ? React.createElement('div', { className: 'olusa-models' },
@@ -294,7 +295,7 @@ window.__ModuleLoader__.load({
             React.createElement('button', { className: 'olusa-btn', disabled: busy, onClick: () => doCheck('') }, busy ? '查询中…' : '刷新')
           ),
           body,
-          React.createElement('div', { className: 'olusa-ver' }, 'dsh-ollama-usage · v0.1.4')
+          React.createElement('div', { className: 'olusa-ver' }, 'dsh-ollama-usage · v0.1.11')
         )
       }
 

package/lib/index.js

@@ -4,7 +4,9 @@
  * 单一 Loader 行(见 cordis.patch.yml)挂载本模块,职责:
  *  1. 读取 Ollama 凭证:优先持久化的 API Key(settings 面板检测成功后写入),
  *     兼容旧版 CLI 的 ~/.ollama/auth.json;
- *  2. 请求 https://ollama.com/api/usage 获取用量(会话 5h 桶 + 周桶);
+ *  2. 请求 https://ollama.com/api/balance 获取余量:按会话(每 5 小时)与周
+ *     限额的「legacy plan」在 included.session / included.weekly 返回
+ *     { remaining_percent, resets_at },换算成已用进度与重置时间;
  *  3. 把 Key / 用量快照 / 历史记录持久化到
  *     $DSH_HOME/storages/ollama-usage/usage.json(权限 0600),跨对话/重启恢复;
  *  4. 每 10 分钟自动刷新一次(浏览器页面关闭也持续,Key 失效自动清除);
@@ -23,7 +25,7 @@ import { resolveDshHome } from '@deepseek-ai/dsh-home-paths'
 export const name = 'ollama-usage'
 
 const RPC_CHANNEL = '/ollama-usage'
-const USAGE_URL = 'https://ollama.com/api/usage'
+const BALANCE_URL = 'https://ollama.com/api/balance'
 const FETCH_TIMEOUT_MS = 20000
 const AUTO_REFRESH_MS = 10 * 60 * 1000
 const HISTORY_CAP = 24
@@ -78,28 +80,45 @@ function readLocalToken() {
  * 用量查询与解析
  * ------------------------------------------------------------------ */
 
-async function fetchUsage(token) {
-  const res = await fetch(USAGE_URL, {
+async function fetchBalance(token) {
+  const res = await fetch(BALANCE_URL, {
     headers: { Authorization: 'Bearer ' + token },
     signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
   })
   return { status: res.status, body: await res.text() }
 }
 
-/** API 返回的 usage 是 0~1 的小数(如 0.213 = 21.3%),统一转成百分比数字。 */
-function toPercent(v) {
+/**
+ * included.session|weekly.remaining_percent 是 0~100 的「剩余百分比」
+ * (75 = 还剩 75%);面板展示的是已用进度,因此换算成 100 - remaining。
+ */
+function usedPercent(remaining) {
   let n = null
-  if (typeof v === 'number' && Number.isFinite(v)) n = v
-  else if (typeof v === 'string' && v.trim() !== '') {
-    const c = Number(v)
+  if (typeof remaining === 'number' && Number.isFinite(remaining)) n = remaining
+  else if (typeof remaining === 'string' && remaining.trim() !== '') {
+    const c = Number(remaining)
     if (Number.isFinite(c)) n = c
   }
   if (n === null) return null
-  const pct = n <= 1 ? n * 100 : n
-  return Math.round(pct * 10) / 10
+  return Math.round(Math.min(100, Math.max(0, 100 - n)) * 10) / 10
+}
+
+function resetAt(limit) {
+  return typeof limit.resets_at === 'string' && limit.resets_at !== '' ? limit.resets_at : null
 }
 
-function parseUsage(body, status) {
+/**
+ * 解析 GET /api/balance(契约见 https://docs.ollama.com/api/balance)。
+ *
+ * 带会话(每 5 小时)/周限额的 legacy plan 返回
+ *   included.session|weekly = { remaining_percent, resets_at }
+ * 按美元计费的套餐只返回 included.balance_usd / allowance_usd / period,
+ * 没有 5h/周进度可展示 —— 此时两个百分比保持 null,面板显示“暂无数据”。
+ *
+ * /api/usage 自 2026-10 起只返回按小时/天的请求量分桶(不再有 limits /
+ * activity / models 字段),因此限额进度一律以 /api/balance 为唯一来源。
+ */
+function parseBalance(body) {
   let json = null
   try {
     json = JSON.parse(body)
@@ -109,57 +128,28 @@ function parseUsage(body, status) {
   if (!json || typeof json !== 'object' || Array.isArray(json)) {
     return { ok: false, message: '响应格式异常' }
   }
-  const limits = (json && json.limits) || {}
-  const activity = (json && json.activity) || {}
-  const sessionUsage = limits.session && typeof limits.session === 'object' ? toPercent(limits.session.usage) : null
-  const weeklyUsage = limits.weekly && typeof limits.weekly === 'object' ? toPercent(limits.weekly.usage) : null
-  // 模型请求数:真实响应放在 limits.weekly.models(有时 activity.models 也有),按优先级取
-  const weeklyModels = limits.weekly && Array.isArray(limits.weekly.models) ? limits.weekly.models : null
-  const sessionModels = limits.session && Array.isArray(limits.session.models) ? limits.session.models : null
-  const activityModels = Array.isArray(activity.models) ? activity.models : null
-  const rawModels =
-    (weeklyModels && weeklyModels.length ? weeklyModels : null) ||
-    (sessionModels && sessionModels.length ? sessionModels : null) ||
-    (activityModels || [])
-  const models = rawModels
-    .map((m) => ({ name: String((m && m.name) || ''), requestCount: Number((m && m.request_count)) || 0 }))
-    .filter((m) => m.name)
-    .sort((a, b) => b.requestCount - a.requestCount)
+  const included = json.included && typeof json.included === 'object' ? json.included : {}
+  const session = included.session && typeof included.session === 'object' ? included.session : null
+  const weekly = included.weekly && typeof included.weekly === 'object' ? included.weekly : null
   return {
     ok: true,
     usage: {
-      cost: typeof activity.cost === 'string' ? activity.cost : null,
-      periodType: activity.period && typeof activity.period.type === 'string' ? activity.period.type : null,
-      periodStart: activity.period && typeof activity.period.starting_at === 'string' ? activity.period.starting_at : null,
-      periodEnd: activity.period && typeof activity.period.ending_at === 'string' ? activity.period.ending_at : null,
-      sessionPercent: sessionUsage,
-      weeklyPercent: weeklyUsage,
-      models,
+      sessionPercent: session ? usedPercent(session.remaining_percent) : null,
+      weeklyPercent: weekly ? usedPercent(weekly.remaining_percent) : null,
+      sessionResetAt: session ? resetAt(session) : null,
+      weeklyResetAt: weekly ? resetAt(weekly) : null,
+      // 模型请求数仍留在快照结构里(客户端按非空才渲染),等官方
+      // “usage breakdowns by model”(docs 标注 coming soon)上线后再填充。
+      models: [],
     },
   }
 }
 
-/* ------------------------------------------------------------------ *
- * 周重置时间推算(API 不提供各限额重置时间,按配额语义推算)
- *  - weekly:下周一 00:00 UTC(last_4_weeks 周期锚点为周一)
- * ------------------------------------------------------------------ */
-
-function computeResetTimes(nowIso) {
-  const now = new Date(nowIso)
-  const daysUntilMonday = ((7 - now.getUTCDay()) % 7) + 1
-  const weeklyResetAt = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate() + daysUntilMonday)).toISOString()
-  return { weeklyResetAt }
-}
-
-function withResetTimes(usage, nowIso) {
-  return Object.assign({}, usage, computeResetTimes(nowIso))
-}
-
 /** 用 token 查询并把结果写入持久化文件;返回 RpcResult({ ok, value|error })。 */
 async function checkWithToken(token) {
   let res
   try {
-    res = await fetchUsage(token)
+    res = await fetchBalance(token)
   } catch (e) {
     return fail('network', String((e && e.message) || e))
   }
@@ -172,7 +162,7 @@ async function checkWithToken(token) {
   if (res.status >= 400) {
     return fail('http-error', res.body || ('HTTP ' + res.status))
   }
-  const parsed = parseUsage(res.body, res.status)
+  const parsed = parseBalance(res.body)
   if (!parsed.ok) {
     return fail('internal', parsed.message)
   }
@@ -182,7 +172,7 @@ async function checkWithToken(token) {
   const history = Array.isArray(prev && prev.history) ? prev.history.slice() : []
   history.push({ at: now, sessionPercent: parsed.usage.sessionPercent, weeklyPercent: parsed.usage.weeklyPercent })
   const trimmed = history.length > HISTORY_CAP ? history.slice(history.length - HISTORY_CAP) : history
-  const usage = withResetTimes(parsed.usage, now)
+  const usage = parsed.usage
   const persisted = writeFile({ token, updatedAt: now, usage, history: trimmed })
   return {
     ok: true,
@@ -231,7 +221,7 @@ async function dispatch(endpoint, payload) {
   if (endpoint === 'snapshot') {
     const rec = readFile()
     if (!rec || !rec.usage) return fail('no-data', '暂无持久化的用量数据')
-    const usage = withResetTimes(rec.usage, new Date().toISOString())
+    const usage = rec.usage
     // snapshot 数据读自磁盘文件(插件无内存缓存),必然已持久化;与 check 端点一致地报告 persisted
     return { ok: true, value: { tokenPersisted: !!rec.token, persisted: true, updatedAt: rec.updatedAt, history: (rec.history || []).slice(-5), usage } }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-ollama-usage",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "DeepSeek Harness 插件:可视化 Ollama Cloud 账号用量余量(每 5 小时会话用量 + 周用量),支持侧边栏双横条、插件详情页完整面板、API Key 与用量快照持久化、自动刷新与登录引导。Ollama Pro usage & remaining-quota visualization for DeepSeek Harness: 5-hour session + weekly quota bars in the sidebar footer, a full panel on the plugin's own detail page, persisted API key and usage snapshots, auto-refresh and login guidance.",
   "type": "module",
   "main": "lib/index.js",
@@ -31,7 +31,8 @@
         "0.1.5-rc.2": "compatible",
         "0.1.6-alpha.2": "compatible",
         "0.1.7-rc.1": "compatible",
-        "0.1.7-rc.2": "compatible"
+        "0.1.7-rc.2": "compatible",
+        "0.2.0-rc.1": "compatible"
       },
       "node": ">=20"
     }
@@ -69,7 +70,7 @@
     "LICENSE"
   ],
   "peerDependencies": {
-    "@deepseek-ai/dsh-home-paths": "^0.1.7-rc.1"
+    "@deepseek-ai/dsh-home-paths": ">=0.1.7-rc.1"
   },
   "repository": {
     "type": "git",
@@ -93,6 +94,6 @@
   ],
   "license": "MIT",
   "scripts": {
-    "test": "DSH_HOME=.tmp-dsh-home HOME=.tmp-home node test/bridge-smoke.mjs && DSH_HOME=.tmp-env-dsh-home HOME=.tmp-env-home node test/rpc-envelope-alpha4.mjs"
+    "test": "DSH_HOME=.tmp-dsh-home HOME=.tmp-home node test/bridge-smoke.mjs && DSH_HOME=.tmp-balance-dsh-home HOME=.tmp-balance-home node test/balance-parse.mjs && DSH_HOME=.tmp-env-dsh-home HOME=.tmp-env-home node test/rpc-envelope-alpha4.mjs"
   }
 }