@mzzsfy/dsh-usage-panel 0.6.0 → 0.7.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mzzsfy/dsh-usage-panel",
   "description": "多平台 LLM 账号余额与额度面板:支持 DeepSeek/OpenRouter/Kimi/智谱/MiniMax/NewApi 及自定义端点,自动定期查询,趋势图与历史快照,用量/余额阈值与窗口重置多通道通知",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "type": "module",
   "main": "src/index.js",
   "exports": {

package/src/client.js

@@ -181,9 +181,9 @@ window.__ModuleLoader__.load({
       })()
     }
 
-    // 导航图标声明:交给 dsh-settings-nav-icons 统一渲染(本插件分区 → plan);
-    // 该插件未就绪时入队,由其启动时排空
-    const NAV_ICON = { '账号余额': 'plan' }
+    // 导航图标声明:交给 dsh-settings-nav-icons 统一渲染;双键 = 分区 label + 市场
+    // 短名(发现页收录显示形态);该插件未就绪时入队,由其启动时排空
+    const NAV_ICON = { '账号余额': 'wallet', 'dsh-usage-panel': 'wallet' }
     if (window.__navicIcons !== undefined) window.__navicIcons.register(NAV_ICON)
     else if (Array.isArray(window.__navicIconQueue)) window.__navicIconQueue.push(NAV_ICON)
     else window.__navicIconQueue = [NAV_ICON]

package/src/index.js

@@ -731,6 +731,9 @@ export function apply(ctx) {
   let pollArmed = false
   ctx.inject(['timer'], (timerCtx) => {
     if (typeof timerCtx.interval !== 'function') return
+    // 配置预载:启动即读盘,消除懒加载空窗——否则宿主重启后直到首个面板请求前,
+    // tick 回调因 config 为 null 空转,自动查询静默停摆,通知全部缺席
+    void ensureConfig()
     const dispose = timerCtx.interval(() => {
       if (pollInFlight) return
       const current = config

package/test/poller.test.mjs

@@ -13,6 +13,10 @@ import {
   isDue,
   runLimited,
 } from '../src/poller.mjs'
+import { evaluateAccount, createNotifyState } from '../src/notify.mjs'
+
+// 宿主 tick 周期(index.js TICK_SEC=30s)的测试替身:语义=tick 远小于轮询间隔
+const TICK_SEC = 30
 
 test('场景: 失败退避指数增长并封顶', () => {
   const backoff = createBackoff({ baseSec: 600 })
@@ -120,3 +124,50 @@ test('场景: 受限并发执行——空列表与并发大于任务数', async
   await runLimited([1, 2], 8, async (item) => processed.push(item))
   assert.deepEqual(processed, [1, 2])
 })
+
+// 端到端时钟推演:自动轮询 tick 驱动(无任何手动刷新)下,读数新越阈值即产出通知。
+// Given tick 周期远小于轮询间隔,阈值 91%,上游 utilization 按轮次爬升。
+// When 宿主 tick 循环按 isDue 判定到点轮次并执行查询 + 沿触发评估。
+// Then 通知在越线轮次由自动路径产出,armed 解除后不重发。
+test('场景: 自动轮询 tick 驱动下阈值穿越产出通知(无手动刷新)', () => {
+  let nowSec = 0
+  const utilizationByRound = [40, 55, 70, 93, 95, 60]
+  let round = 0
+  const account = { id: 'acct-sim', name: '模拟账号', last: null, notifyState: createNotifyState() }
+  const backoff = createBackoff({ baseSec: POLL_INTERVAL_SEC })
+  const events = []
+  for (; round < utilizationByRound.length && nowSec <= POLL_INTERVAL_SEC * utilizationByRound.length + TICK_SEC; nowSec += TICK_SEC) {
+    const due = !backoff.isBlocked(nowSec) && isDue({
+      lastQuerySec: lastQuerySecOf(account.last),
+      nowSec,
+      intervalSec: POLL_INTERVAL_SEC,
+    })
+    if (!due) continue
+    // runQuery 成功路径:落读数记 queriedAt(成功失败均记),退避恢复
+    const queriedAt = nowSec * 1000
+    account.last = {
+      ok: true,
+      reading: {
+        kind: 'quota',
+        windows: [{ label: '5小时', utilization: utilizationByRound[round++], remaining: null, limit: null, resetsAt: '2026-01-01T00:00:00Z' }],
+      },
+      error: null,
+      queriedAt,
+    }
+    backoff.onSuccess()
+    // evaluateAndDispatch 评估段:通知开,阈值 91%
+    const outcome = evaluateAccount({
+      account,
+      rule: { quotaThresholdPct: 91, balanceThreshold: null, resetNotice: true },
+      state: account.notifyState,
+      seq: events.length,
+      ts: queriedAt,
+    })
+    account.notifyState = outcome.state
+    events.push(...outcome.events)
+  }
+  assert.equal(round, utilizationByRound.length, '每轮到点均被 tick 驱动查询')
+  assert.equal(events.length, 1, '自动路径恰好产出一次阈值通知')
+  assert.equal(events[0].detail.value, 93, '通知发生在越线轮次')
+  assert.equal(account.notifyState.windows['5小时'].armed, false, '越线后武装解除')
+})

package/test/route.test.mjs

@@ -90,6 +90,18 @@ test('settings:timer 服务激活时 pollArmed 为 true', async () => {
   assert.equal(res.payload.pollArmed, true)
 })
 
+// 启动即预载配置:tick 驱动自动查询的先决条件——懒加载形态下宿主重启后
+// 到首个面板请求之间 config 为 null,tick 空转,自动查询静默停摆
+test('settings:timer 激活即预载配置(tick 不因 config 空窗停摆)', async () => {
+  const { ctx, routes } = makeCtx({ timerAvailable: true })
+  apply(ctx)
+  // ensureConfig 异步读盘;await 一拍微任务让它完成
+  await new Promise((resolve) => setImmediate(resolve))
+  const res = await call(routes, '/api/usage-panel/accounts', makeReq('GET'))
+  assert.equal(res.status, 200)
+  assert.ok(Array.isArray(res.payload.accounts), '配置已载入内存,轮询具备调度对象')
+})
+
 test('settings:timer 服务缺失时 pollArmed 为 false(降级可见)', async () => {
   const { ctx, routes } = makeCtx({ timerAvailable: false })
   apply(ctx)