dsh-all-usage 1.0.4 → 1.0.5

package/lib/index.js

@@ -1,630 +1,650 @@
-// dsh-all-usage 插件 Host 半（永久版）
-// 数据聚合 + 账户余额 + 工作区别名持久化，通过 webServer 路由向客户端提供数据。
-import { randomBytes, timingSafeEqual } from 'node:crypto'
-
-const name = 'dsh-all-usage'
-const inject = ['sessionQuery', 'workspaceRegistry', 'timer']
-
-// webServer route handlers do not inherit the connection API fence; keep this plugin
-// local and require a browser-originated capability for state-changing reads/writes.
-function requestHeader(req, name) {
-  const headers = req && req.headers
-  if (headers === null || headers === undefined || typeof headers !== 'object') return undefined
-  const value = headers[name.toLowerCase()]
-  if (Array.isArray(value)) return typeof value[0] === 'string' ? value[0] : undefined
-  return typeof value === 'string' ? value : undefined
-}
-
-function isLoopbackHostname(hostname) {
-  if (hostname === 'localhost' || hostname === '[::1]') return true
-  const parts = hostname.split('.')
-  return parts.length === 4 && parts[0] === '127' && parts.every((part) => /^\d{1,3}$/.test(part) && Number(part) <= 255)
-}
-
-function isTrustedLocalApiRequest(req, requireOrigin) {
-  const host = requestHeader(req, 'host')
-  if (host === undefined) return false
-  let hostUrl
-  try {
-    hostUrl = new URL('http://' + host)
-  } catch (err) {
-    return false
-  }
-  if (!isLoopbackHostname(hostUrl.hostname)) return false
-  if (requestHeader(req, 'sec-fetch-site') === 'cross-site') return false
-  const origin = requestHeader(req, 'origin')
-  if (origin === undefined) return requireOrigin !== true
-  try {
-    const originUrl = new URL(origin)
-    return originUrl.protocol === 'http:' && originUrl.host === hostUrl.host
-  } catch (err) {
-    return false
-  }
-}
-
-function hasWriteToken(req, expected) {
-  const actual = requestHeader(req, 'x-all-usage-request-token')
-  if (typeof actual !== 'string' || typeof expected !== 'string') return false
-  const actualBytes = Buffer.from(actual)
-  const expectedBytes = Buffer.from(expected)
-  return actualBytes.length === expectedBytes.length && timingSafeEqual(actualBytes, expectedBytes)
-}
-
-function sendJson(res, code, value) {
-  res.statusCode = code
-  res.setHeader('content-type', 'application/json; charset=utf-8')
-  res.setHeader('cache-control', 'no-store')
-  res.end(JSON.stringify(value))
-}
-
-function readBody(req, maxBytes) {
-  return new Promise((resolve) => {
-    const chunks = []
-    let size = 0
-    req.on('data', (chunk) => {
-      size += chunk.length
-      if (size <= maxBytes) chunks.push(chunk)
-    })
-    req.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')))
-    req.on('error', () => resolve(''))
-  })
-}
-
-function apply(ctx) {
-  const credentials = ctx.get('credentials')
-  const settings = ctx.get('settings')
-  const storage = ctx.get('storage')
-  const webServer = ctx.get('webServer')
-
-  // ---------- owned aggregation state ----------
-  const wsMeta = new Map()
-  const pathIndex = new Map()
-  const memberOf = new Map()
-  const byDay = new Map()
-  const byDayUtc = new Map()
-  const perWorkspace = new Map()
-  const perModel = new Map()
-  // One canonical usage contribution per session turn/step. This makes retries and
-  // replacement messages update a logical model call instead of double-counting it.
-  const usageByStep = new Map()
-  const sessionModel = new Map()
-  const totals = { turns: 0, input: 0, output: 0, cacheRead: 0, cacheWrite: 0, reasoning: 0 }
-  const sessionCount = new Set()
-  const sessionSeq = new Map()
-  const chains = new Map()
-  const scan = { started: false, done: false, scanned: 0, total: 0, failed: 0 }
-  const aliases = {}
-  let kvUnit = null
-  let aliasWriteChain = Promise.resolve()
-  let balanceCache = { fetchedAt: 0, payload: null }
-  const requestToken = randomBytes(32).toString('base64url')
-
-  const DAY_MS = 86400000
-  const WEEKS = 53
-
-  function dayKey(ms) {
-    const d = new Date(ms)
-    return d.getFullYear() + '-' + String(d.getMonth() + 1).padStart(2, '0') + '-' + String(d.getDate()).padStart(2, '0')
-  }
-  function dayKeyUtc(ms) {
-    const d = new Date(ms)
-    return d.getUTCFullYear() + '-' + String(d.getUTCMonth() + 1).padStart(2, '0') + '-' + String(d.getUTCDate()).padStart(2, '0')
-  }
-  function cutoffKey() {
-    return dayKey(Date.now() - WEEKS * 7 * DAY_MS)
-  }
-  function cutoffKeyUtc() {
-    return dayKeyUtc(Date.now() - WEEKS * 7 * DAY_MS)
-  }
-  function num(v) {
-    return typeof v === 'number' && Number.isFinite(v) ? v : 0
-  }
-  function ensureDay(dayMap, date) {
-    let day = dayMap.get(date)
-    if (day === undefined) {
-      day = { turns: 0, tokens: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, reasoning: 0 }, perWs: new Map(), byWs: new Map(), byModel: new Map() }
-      dayMap.set(date, day)
-    }
-    return day
-  }
-  function ensureWs(wsId) {
-    let ws = perWorkspace.get(wsId)
-    if (ws === undefined) {
-      ws = { turns: 0, input: 0, output: 0, cacheRead: 0, cacheWrite: 0, reasoning: 0 }
-      perWorkspace.set(wsId, ws)
-    }
-    return ws
-  }
-  function ensureDayWs(day, wsId) {
-    let w = day.byWs.get(wsId)
-    if (w === undefined) {
-      w = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, reasoning: 0 }
-      day.byWs.set(wsId, w)
-    }
-    return w
-  }
-  function ensureModel(model) {
-    let item = perModel.get(model)
-    if (item === undefined) {
-      item = { calls: 0, input: 0, output: 0, cacheRead: 0, cacheWrite: 0, reasoning: 0 }
-      perModel.set(model, item)
-    }
-    return item
-  }
-  function ensureDayModel(day, model) {
-    let item = day.byModel.get(model)
-    if (item === undefined) {
-      item = { calls: 0, input: 0, output: 0, cacheRead: 0, cacheWrite: 0, reasoning: 0 }
-      day.byModel.set(model, item)
-    }
-    return item
-  }
-  function usageValues(usage) {
-    return {
-      input: num(usage && usage.inputTokens),
-      output: num(usage && usage.outputTokens),
-      cacheRead: num(usage && usage.cacheReadTokens),
-      cacheWrite: num(usage && usage.cacheWriteTokens),
-      reasoning: num(usage && usage.reasoningTokens),
-    }
-  }
-  function adjustValues(target, values, direction) {
-    target.input += values.input * direction
-    target.output += values.output * direction
-    target.cacheRead += values.cacheRead * direction
-    target.cacheWrite += values.cacheWrite * direction
-    target.reasoning += values.reasoning * direction
-  }
-  function noValues(target) {
-    return target.input === 0 && target.output === 0 && target.cacheRead === 0 && target.cacheWrite === 0 && target.reasoning === 0
-  }
-  function adjustDay(dayMap, date, wsId, values, modelId, direction) {
-    const day = ensureDay(dayMap, date)
-    adjustValues(day.tokens, values, direction)
-    const dayWs = ensureDayWs(day, wsId)
-    adjustValues(dayWs, values, direction)
-    if (noValues(dayWs)) day.byWs.delete(wsId)
-    const dayModel = ensureDayModel(day, modelId)
-    dayModel.calls += direction
-    adjustValues(dayModel, values, direction)
-    if (dayModel.calls === 0 && noValues(dayModel)) day.byModel.delete(modelId)
-  }
-  function adjustUsage(wsId, time, values, modelId, direction) {
-    const modelTotals = ensureModel(modelId)
-    modelTotals.calls += direction
-    adjustValues(modelTotals, values, direction)
-    if (modelTotals.calls === 0 && noValues(modelTotals)) perModel.delete(modelId)
-    adjustValues(totals, values, direction)
-    const ws = ensureWs(wsId)
-    adjustValues(ws, values, direction)
-    const date = dayKey(time)
-    if (date >= cutoffKey()) adjustDay(byDay, date, wsId, values, modelId, direction)
-    const utcDate = dayKeyUtc(time)
-    if (utcDate >= cutoffKeyUtc()) adjustDay(byDayUtc, utcDate, wsId, values, modelId, direction)
-  }
-  function usageStepKey(sid, data, seq) {
-    const turn = data && typeof data.turn === 'number' ? data.turn : null
-    const step = data && typeof data.step === 'number' ? data.step : null
-    if (turn !== null && step !== null) return sid + ':step:' + turn + ':' + step
-    return sid + ':event:' + (typeof seq === 'number' ? seq : String(Date.now()))
-  }
-  function addUsage(wsId, time, usage, model, sid, data, seq) {
-    const values = usageValues(usage)
-    const modelId = typeof model === 'string' && model !== '' ? model : '未知模型（历史记录缺少路由）'
-    const eventSeq = typeof seq === 'number' ? seq : -1
-    const key = usageStepKey(sid, data, seq)
-    const previous = usageByStep.get(key)
-    // A late replay of an older raw event cannot replace the canonical later step.
-    if (previous !== undefined && eventSeq >= 0 && previous.seq > eventSeq) return
-    if (previous !== undefined) adjustUsage(previous.wsId, previous.time, previous.values, previous.modelId, -1)
-    const next = { seq: eventSeq, wsId, time, values, modelId }
-    usageByStep.set(key, next)
-    adjustUsage(wsId, time, values, modelId, 1)
-  }
-  function addDayTurn(dayMap, date, wsId) {
-    const day = ensureDay(dayMap, date)
-    day.turns += 1
-    day.perWs.set(wsId, (day.perWs.get(wsId) || 0) + 1)
-  }
-  function addTurn(wsId, time) {
-    ensureWs(wsId).turns += 1
-    totals.turns += 1
-    const date = dayKey(time)
-    if (date >= cutoffKey()) addDayTurn(byDay, date, wsId)
-    const utcDate = dayKeyUtc(time)
-    if (utcDate >= cutoffKeyUtc()) addDayTurn(byDayUtc, utcDate, wsId)
-  }
-  function routeLabel(route) {
-    if (route && typeof route.model === 'string' && route.model !== '') return (typeof route.provider === 'string' && route.provider !== '' ? route.provider + ' / ' : '') + route.model
-    return undefined
-  }
-  function modelFromRoute(data) {
-    return routeLabel(data) || routeLabel(data && data.header && data.header.config)
-  }
-  function modelFromMessage(data, fallback) {
-    return routeLabel(data && data.message && data.message.source) || fallback
-  }
-  function foldEvent(wsId, time, type, data, sid, seq) {
-    if (type === 'request/context' || type === 'request/header') {
-      const model = modelFromRoute(data)
-      if (model !== undefined) sessionModel.set(sid, model)
-    } else if (type === 'turn/end') addTurn(wsId, time)
-    else if (type === 'assistant/message' && data && data.usage) addUsage(wsId, time, data.usage, modelFromMessage(data, sessionModel.get(sid)), sid, data, seq)
-  }
-  function foldEvents(wsId, events, fromSeq, sid) {
-    for (const ev of events) {
-      if (fromSeq !== undefined) {
-        const s = typeof ev.seq === 'number' ? ev.seq : -1
-        if (s <= fromSeq) continue
-      }
-      if (ev.type === 'turn/end' || ev.type === 'assistant/message' || ev.type === 'request/context' || ev.type === 'request/header') foldEvent(wsId, ev.time, ev.type, ev.data, sid, ev.seq)
-    }
-  }
-  function lastSeqOf(events) {
-    let last = 0
-    for (const ev of events) {
-      const s = typeof ev.seq === 'number' ? ev.seq : -1
-      if (s > last) last = s
-    }
-    return last
-  }
-  function enqueue(sid, task) {
-    const prev = chains.get(sid) || Promise.resolve()
-    const next = prev.then(() => task(), () => task())
-    chains.set(sid, next)
-    return next
-  }
-  function wsForLiveSession(session, sid) {
-    let wsId = memberOf.get(sid)
-    if (wsId !== undefined) return wsId
-    const header = session && session.header
-    const cwd = header && typeof header.cwd === 'string' ? header.cwd : ''
-    if (cwd === '') return undefined
-    wsId = pathIndex.get(cwd)
-    if (wsId !== undefined) memberOf.set(sid, wsId)
-    return wsId
-  }
-  async function processLiveEvent(sid, wsId, event) {
-    const seq = typeof event.seq === 'number' ? event.seq : -1
-    const last = sessionSeq.get(sid)
-    if (last === undefined) {
-      try {
-        const snap = await ctx.sessionQuery.readSession(sid)
-        if (snap && Array.isArray(snap.events)) {
-          foldEvents(wsId, snap.events, undefined, sid)
-          sessionSeq.set(sid, lastSeqOf(snap.events))
-          sessionCount.add(sid)
-        }
-      } catch (err) { /* retry on the next event */ }
-      return
-    }
-    if (seq <= last) return
-    if (seq > last + 1) {
-      try {
-        const snap = await ctx.sessionQuery.readSession(sid)
-        if (snap && Array.isArray(snap.events)) {
-          foldEvents(wsId, snap.events, last, sid)
-          sessionSeq.set(sid, lastSeqOf(snap.events))
-        }
-      } catch (err) { /* keep last; retry later */ }
-      return
-    }
-    foldEvent(wsId, event.time, event.type, event.data, sid, event.seq)
-    sessionSeq.set(sid, seq)
-    sessionCount.add(sid)
-  }
-
-  // ---------- baseline scan over durable logs ----------
-  async function runBaseline() {
-    if (scan.started) return
-    scan.started = true
-    try {
-      const workspaces = ctx.workspaceRegistry.list()
-      for (const w of workspaces) {
-        const id = w && w.id
-        const path = w && typeof w.path === 'string' ? w.path : ''
-        const title = w && typeof w.title === 'string' ? w.title : ''
-        if (id === undefined) continue
-        wsMeta.set(id, { id, title, path })
-        if (path !== '') pathIndex.set(path, id)
-        if (w && Array.isArray(w.sessionIds)) {
-          for (const sid of w.sessionIds) memberOf.set(sid, id)
-        }
-      }
-    } catch (err) {
-      console.error('[all-usage] workspace list failed:', err)
-    }
-    let records = []
-    try {
-      records = await ctx.sessionQuery.listSessions()
-    } catch (err) {
-      console.error('[all-usage] session list failed:', err)
-    }
-    scan.total = Array.isArray(records) ? records.length : 0
-    for (const record of records) {
-      if (record === undefined || record === null || record.header === undefined) {
-        scan.scanned += 1
-        continue
-      }
-      const sid = record.header.id
-      const cwd = typeof record.header.cwd === 'string' ? record.header.cwd : ''
-      const wsId = cwd === '' ? undefined : pathIndex.get(cwd)
-      if (sid === undefined || wsId === undefined) {
-        scan.scanned += 1
-        continue
-      }
-      await enqueue(sid, async () => {
-        try {
-          if (sessionSeq.has(sid)) return
-          const snap = await ctx.sessionQuery.readSession(sid)
-          if (snap && Array.isArray(snap.events)) {
-            foldEvents(wsId, snap.events, undefined, sid)
-            sessionSeq.set(sid, lastSeqOf(snap.events))
-            sessionCount.add(sid)
-          }
-        } catch (err) {
-          sessionSeq.set(sid, -1)
-          scan.failed += 1
-        } finally {
-          scan.scanned += 1
-        }
-      })
-      await ctx.timeout(0)
-    }
-    scan.done = true
-  }
-
-  // ---------- live feed ----------
-  ctx.on('session/event', (session, event) => {
-    if (event === undefined || event === null) return
-    const type = event.type
-    if (type !== 'turn/end' && type !== 'assistant/message' && type !== 'request/context' && type !== 'request/header') return
-    const sid = session && session.id
-    if (typeof sid !== 'string') return
-    const wsId = wsForLiveSession(session, sid)
-    if (wsId === undefined) return
-    enqueue(sid, () => processLiveEvent(sid, wsId, event))
-  })
-
-  // ---------- workspace aliases (durable, schema-free KV unit) ----------
-  async function loadAliases() {
-    if (storage === undefined) return
-    try {
-      const backend = storage.backend.get('json')
-      if (backend === undefined || backend === null || backend.kv === undefined) return
-      const unit = await backend.kv.open({ name: 'all-usage-aliases', version: 0, tables: [], hasGlobal: true })
-      kvUnit = unit
-      const snap = await unit.loadAll()
-      const g = snap && snap.global
-      if (g !== null && g !== undefined && typeof g === 'object') {
-        for (const key of Object.keys(g)) {
-          const value = g[key]
-          if (typeof value === 'string' && value.trim() !== '') aliases[key] = value
-        }
-      }
-    } catch (err) {
-      console.error('[all-usage] alias storage unavailable:', err)
-    }
-  }
-  function persistAliases() {
-    const snapshotAliases = {}
-    for (const key of Object.keys(aliases)) snapshotAliases[key] = aliases[key]
-    aliasWriteChain = aliasWriteChain.then(() => {
-      if (kvUnit === null || kvUnit === undefined) return undefined
-      return kvUnit.setGlobal(snapshotAliases).catch((err) => {
-        console.error('[all-usage] alias persist failed:', err)
-      })
-    })
-  }
-  function setAlias(wsId, raw) {
-    const alias = typeof raw === 'string' ? raw.trim().slice(0, 80) : ''
-    if (!wsMeta.has(wsId)) return { ok: false, message: 'unknown-workspace', aliases: Object.assign({}, aliases) }
-    if (alias === '') delete aliases[wsId]
-    else aliases[wsId] = alias
-    persistAliases()
-    return { ok: true, aliases: Object.assign({}, aliases) }
-  }
-  ctx.effect(() => () => {
-    const unit = kvUnit
-    kvUnit = null
-    if (unit !== null && unit !== undefined) void unit.close().catch(() => {})
-  })
-
-  // ---------- snapshot for the client ----------
-  function serializeDays(dayMap, cutoff) {
-    const result = []
-    for (const pair of dayMap) {
-      const date = pair[0]
-      const day = pair[1]
-      if (date < cutoff) continue
-      result.push({
-        date,
-        turns: day.turns,
-        tokens: { input: day.tokens.input, output: day.tokens.output, cacheRead: day.tokens.cacheRead, cacheWrite: day.tokens.cacheWrite, reasoning: day.tokens.reasoning },
-        perWorkspace: Array.from(day.perWs, (p) => ({ workspaceId: p[0], turns: p[1] })),
-        byWorkspace: Array.from(day.byWs, (p) => ({ workspaceId: p[0], input: p[1].input, output: p[1].output, cacheRead: p[1].cacheRead, cacheWrite: p[1].cacheWrite, reasoning: p[1].reasoning })),
-        byModel: Array.from(day.byModel, (p) => ({ model: p[0], calls: p[1].calls, input: p[1].input, output: p[1].output, cacheRead: p[1].cacheRead, cacheWrite: p[1].cacheWrite, reasoning: p[1].reasoning })),
-      })
-    }
-    result.sort((a, b) => (a.date < b.date ? -1 : a.date > b.date ? 1 : 0))
-    return result
-  }
-  function snapshot() {
-    return {
-      scan: { started: scan.started, done: scan.done, scanned: scan.scanned, total: scan.total, failed: scan.failed },
-      generatedAt: Date.now(),
-      requestToken,
-      workspaces: Array.from(wsMeta.values(), (w) => ({ id: w.id, title: w.title, path: w.path })),
-      aliases: Object.assign({}, aliases),
-      tokenSemantics: {
-        processedTotal: 'input + output + cacheRead + cacheWrite + reasoning',
-        cacheRead: 'reused context tokens; not newly generated output',
-        cacheWrite: 'tokens written into a provider cache',
-      },
-      totals: { turns: totals.turns, sessions: sessionCount.size, input: totals.input, output: totals.output, cacheRead: totals.cacheRead, cacheWrite: totals.cacheWrite, reasoning: totals.reasoning },
-      perWorkspace: Array.from(perWorkspace, (p) => ({ workspaceId: p[0], turns: p[1].turns, input: p[1].input, output: p[1].output, cacheRead: p[1].cacheRead, cacheWrite: p[1].cacheWrite, reasoning: p[1].reasoning })),
-      perModel: Array.from(perModel, (p) => ({ model: p[0], calls: p[1].calls, input: p[1].input, output: p[1].output, cacheRead: p[1].cacheRead, cacheWrite: p[1].cacheWrite, reasoning: p[1].reasoning })),
-      byDay: serializeDays(byDay, cutoffKey()),
-      byDayUtc: serializeDays(byDayUtc, cutoffKeyUtc()),
-    }
-  }
-
-  // ---------- account balance (DeepSeek open platform) ----------
-  async function requestBalance(url, key) {
-    let controller = null
-    let timer = null
-    try {
-      if (typeof AbortController === 'function') {
-        controller = new AbortController()
-        timer = setTimeout(() => controller.abort(), 30000)
-      }
-      const response = await fetch(url, {
-        method: 'GET',
-        headers: { accept: 'application/json', authorization: 'Bearer ' + key },
-        ...(controller === null ? {} : { signal: controller.signal }),
-      })
-      return { ok: response.ok, status: response.status, text: await response.text() }
-    } catch (err) {
-      return { ok: false, status: 0, text: '', error: 'network request failed' }
-    } finally {
-      if (timer !== null) clearTimeout(timer)
-    }
-  }
-  function moneyOf(v) {
-    if (typeof v === 'number' && Number.isFinite(v)) return v
-    if (typeof v === 'string' && v.trim() !== '') {
-      const n = parseFloat(v)
-      if (Number.isFinite(n)) return n
-    }
-    return null
-  }
-  function parseBalance(text) {
-    let obj = null
-    try {
-      obj = JSON.parse(String(text).replace(/^\uFEFF/, ''))
-    } catch (err) {
-      return null
-    }
-    if (obj === null || typeof obj !== 'object') return null
-    if (obj.is_available === false) return { unavailable: true, currencies: [] }
-    const infos = (Array.isArray(obj.balance_infos) && obj.balance_infos) || (Array.isArray(obj.balance) && obj.balance) || null
-    if (!infos) return null
-    const out = []
-    for (const info of infos) {
-      if (info === null || typeof info !== 'object') continue
-      if (typeof info.currency !== 'string') continue
-      out.push({
-        currency: info.currency,
-        total: moneyOf(info.total_balance !== undefined ? info.total_balance : info.balance),
-        granted: moneyOf(info.granted_balance),
-        toppedUp: moneyOf(info.topped_up_balance),
-      })
-    }
-    return { unavailable: false, currencies: out }
-  }
-  async function fetchBalance(force) {
-    const now = Date.now()
-    if (force !== true && balanceCache.payload !== null && now - balanceCache.fetchedAt < 300000) return balanceCache.payload
-    let ref = 'DEEPSEEK_API_KEY'
-    if (settings !== undefined) {
-      try {
-        const section = settings.get('llm-deepseek')
-        if (section !== null && typeof section === 'object' && typeof section.apiKeyEnv === 'string' && section.apiKeyEnv.length > 0) ref = section.apiKeyEnv
-      } catch (err) { /* default ref */ }
-    }
-    let key
-    if (credentials !== undefined) {
-      try {
-        const hit = await credentials.resolve(ref)
-        if (hit !== null && hit !== undefined && typeof hit.value === 'string' && hit.value.length > 0) key = hit.value
-      } catch (err) { /* unconfigured */ }
-    }
-    if (key === undefined) {
-      const payload = { status: 'missing-key' }
-      balanceCache = { fetchedAt: now, payload }
-      return payload
-    }
-    if (typeof fetch !== 'function') {
-      const payload = { status: 'error', message: '当前 DSH 运行时不支持余额查询' }
-      balanceCache = { fetchedAt: now, payload }
-      return payload
-    }
-    const result = await requestBalance('https://api.deepseek.com/user/balance', key)
-    const body = (result.text || '').trim()
-    if (result.ok && body.length > 0) {
-      const parsed = parseBalance(body)
-      if (parsed !== null && parsed.unavailable) {
-        const payload = { status: 'unavailable', message: 'DeepSeek 接口返回余额不可用（is_available=false）' }
-        balanceCache = { fetchedAt: now, payload }
-        return payload
-      }
-      if (parsed !== null && parsed.currencies.length > 0) {
-        const payload = { status: 'ok', currencies: parsed.currencies, fetchedAt: now }
-        balanceCache = { fetchedAt: now, payload }
-        return payload
-      }
-    }
-    const detail = body.length > 0 ? body.slice(0, 300) : (result.status > 0 ? 'HTTP ' + result.status : result.error || 'network request failed')
-    const payload = { status: 'error', message: '余额查询失败', detail }
-    balanceCache = { fetchedAt: now, payload }
-    return payload
-  }
-
-  // ---------- HTTP data routes for the client half ----------
-  if (webServer !== undefined) {
-    const rejectRequest = (res) => sendJson(res, 403, { ok: false, message: 'forbidden' })
-    ctx.effect(() => webServer.register({
-      kind: 'exact',
-      path: '/api/all-usage',
-      handler: (req, res) => {
-        if (req.method !== 'GET') { res.statusCode = 405; res.end(); return }
-        if (!isTrustedLocalApiRequest(req, false)) { rejectRequest(res); return }
-        if (!scan.started) void runBaseline()
-        sendJson(res, 200, snapshot())
-      },
-    }))
-    ctx.effect(() => webServer.register({
-      kind: 'exact',
-      path: '/api/all-usage/balance',
-      handler: async (req, res) => {
-        if (req.method !== 'GET') { res.statusCode = 405; res.end(); return }
-        // Browsers may omit Origin on same-origin GET; the process token remains required.
-        if (!isTrustedLocalApiRequest(req, false) || !hasWriteToken(req, requestToken)) { rejectRequest(res); return }
-        let force = false
-        try {
-          const url = new URL(req.url ?? '/', 'http://x')
-          force = url.searchParams.get('force') === '1'
-        } catch (err) { /* default */ }
-        sendJson(res, 200, await fetchBalance(force))
-      },
-    }))
-    ctx.effect(() => webServer.register({
-      kind: 'exact',
-      path: '/api/all-usage/alias',
-      handler: async (req, res) => {
-        if (req.method !== 'POST') {
-          res.statusCode = 405
-          res.end()
-          return
-        }
-        if (!isTrustedLocalApiRequest(req, true) || !hasWriteToken(req, requestToken)) { rejectRequest(res); return }
-        const body = await readBody(req, 16 * 1024)
-        let args = null
-        try {
-          args = JSON.parse(body)
-        } catch (err) { /* invalid json */ }
-        const result = args !== null && args !== undefined && typeof args.workspaceId === 'string'
-          ? setAlias(args.workspaceId, args.alias)
-          : { ok: false, message: 'bad-request', aliases: Object.assign({}, aliases) }
-        sendJson(res, 200, result)
-      },
-    }))
-  }
-
-  // ---------- start the historical backfill immediately ----------
-  void runBaseline()
-  void loadAliases()
-}
-
-export { name, inject, apply }
-export default { name, inject, apply }
+// dsh-all-usage 插件 Host 半（永久版）
+// 数据聚合 + 账户余额 + 工作区别名持久化，通过 webServer 路由向客户端提供数据。
+import { randomBytes, timingSafeEqual } from 'node:crypto'
+
+const name = 'dsh-all-usage'
+const inject = ['sessionQuery', 'workspaceRegistry', 'timer']
+
+// webServer route handlers do not inherit the connection API fence; keep this plugin
+// local and require a browser-originated capability for state-changing reads/writes.
+function requestHeader(req, name) {
+  const headers = req && req.headers
+  if (headers === null || headers === undefined || typeof headers !== 'object') return undefined
+  const value = headers[name.toLowerCase()]
+  if (Array.isArray(value)) return typeof value[0] === 'string' ? value[0] : undefined
+  return typeof value === 'string' ? value : undefined
+}
+
+function isLoopbackHostname(hostname) {
+  if (hostname === 'localhost' || hostname === '[::1]') return true
+  const parts = hostname.split('.')
+  return parts.length === 4 && parts[0] === '127' && parts.every((part) => /^\d{1,3}$/.test(part) && Number(part) <= 255)
+}
+
+function isTrustedLocalApiRequest(req, requireOrigin) {
+  const host = requestHeader(req, 'host')
+  if (host === undefined) return false
+  let hostUrl
+  try {
+    hostUrl = new URL('http://' + host)
+  } catch (err) {
+    return false
+  }
+  if (!isLoopbackHostname(hostUrl.hostname)) return false
+  if (requestHeader(req, 'sec-fetch-site') === 'cross-site') return false
+  const origin = requestHeader(req, 'origin')
+  if (origin === undefined) return requireOrigin !== true
+  try {
+    const originUrl = new URL(origin)
+    return originUrl.protocol === 'http:' && originUrl.host === hostUrl.host
+  } catch (err) {
+    return false
+  }
+}
+
+function hasWriteToken(req, expected) {
+  const actual = requestHeader(req, 'x-all-usage-request-token')
+  if (typeof actual !== 'string' || typeof expected !== 'string') return false
+  const actualBytes = Buffer.from(actual)
+  const expectedBytes = Buffer.from(expected)
+  return actualBytes.length === expectedBytes.length && timingSafeEqual(actualBytes, expectedBytes)
+}
+
+function sendJson(res, code, value) {
+  res.statusCode = code
+  res.setHeader('content-type', 'application/json; charset=utf-8')
+  res.setHeader('cache-control', 'no-store')
+  res.end(JSON.stringify(value))
+}
+
+function readBody(req, maxBytes) {
+  return new Promise((resolve) => {
+    const chunks = []
+    let size = 0
+    req.on('data', (chunk) => {
+      size += chunk.length
+      if (size <= maxBytes) chunks.push(chunk)
+    })
+    req.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')))
+    req.on('error', () => resolve(''))
+  })
+}
+
+function apply(ctx) {
+  const credentials = ctx.get('credentials')
+  const settings = ctx.get('settings')
+  const storage = ctx.get('storage')
+  const webServer = ctx.get('webServer')
+
+  // ---------- owned aggregation state ----------
+  const wsMeta = new Map()
+  const pathIndex = new Map()
+  const memberOf = new Map()
+  const byDay = new Map()
+  const byDayUtc = new Map()
+  const perWorkspace = new Map()
+  const perModel = new Map()
+  // One canonical usage contribution per session turn/step. This makes retries and
+  // replacement messages update a logical model call instead of double-counting it.
+  const usageByStep = new Map()
+  const sessionModel = new Map()
+  const totals = { turns: 0, input: 0, output: 0, cacheRead: 0, cacheWrite: 0, reasoning: 0 }
+  const sessionCount = new Set()
+  const sessionSeq = new Map()
+  const chains = new Map()
+  const scan = { started: false, done: false, scanned: 0, total: 0, failed: 0 }
+  const aliases = {}
+  let kvUnit = null
+  let aliasWriteChain = Promise.resolve()
+  let balanceCache = { fetchedAt: 0, payload: null }
+  const requestToken = randomBytes(32).toString('base64url')
+  let disposed = false
+  let baselineRetryDelay = 1000
+  let baselineRetryScheduled = false
+
+  function dayKey(ms) {
+    const d = new Date(ms)
+    return d.getFullYear() + '-' + String(d.getMonth() + 1).padStart(2, '0') + '-' + String(d.getDate()).padStart(2, '0')
+  }
+  function dayKeyUtc(ms) {
+    const d = new Date(ms)
+    return d.getUTCFullYear() + '-' + String(d.getUTCMonth() + 1).padStart(2, '0') + '-' + String(d.getUTCDate()).padStart(2, '0')
+  }
+  function num(v) {
+    return typeof v === 'number' && Number.isFinite(v) ? v : 0
+  }
+  function ensureDay(dayMap, date) {
+    let day = dayMap.get(date)
+    if (day === undefined) {
+      day = { turns: 0, tokens: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, reasoning: 0 }, perWs: new Map(), byWs: new Map(), byModel: new Map(), sessionIds: new Set() }
+      dayMap.set(date, day)
+    }
+    return day
+  }
+  function ensureWs(wsId) {
+    let ws = perWorkspace.get(wsId)
+    if (ws === undefined) {
+      ws = { turns: 0, input: 0, output: 0, cacheRead: 0, cacheWrite: 0, reasoning: 0 }
+      perWorkspace.set(wsId, ws)
+    }
+    return ws
+  }
+  function ensureDayWs(day, wsId) {
+    let w = day.byWs.get(wsId)
+    if (w === undefined) {
+      w = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, reasoning: 0 }
+      day.byWs.set(wsId, w)
+    }
+    return w
+  }
+  function ensureModel(model) {
+    let item = perModel.get(model)
+    if (item === undefined) {
+      item = { calls: 0, input: 0, output: 0, cacheRead: 0, cacheWrite: 0, reasoning: 0 }
+      perModel.set(model, item)
+    }
+    return item
+  }
+  function ensureDayModel(day, model) {
+    let item = day.byModel.get(model)
+    if (item === undefined) {
+      item = { calls: 0, input: 0, output: 0, cacheRead: 0, cacheWrite: 0, reasoning: 0 }
+      day.byModel.set(model, item)
+    }
+    return item
+  }
+  function usageValues(usage) {
+    return {
+      input: num(usage && usage.inputTokens),
+      output: num(usage && usage.outputTokens),
+      cacheRead: num(usage && usage.cacheReadTokens),
+      cacheWrite: num(usage && usage.cacheWriteTokens),
+      reasoning: num(usage && usage.reasoningTokens),
+    }
+  }
+  function adjustValues(target, values, direction) {
+    target.input += values.input * direction
+    target.output += values.output * direction
+    target.cacheRead += values.cacheRead * direction
+    target.cacheWrite += values.cacheWrite * direction
+    target.reasoning += values.reasoning * direction
+  }
+  function noValues(target) {
+    return target.input === 0 && target.output === 0 && target.cacheRead === 0 && target.cacheWrite === 0 && target.reasoning === 0
+  }
+  function adjustDay(dayMap, date, wsId, values, modelId, direction, sid) {
+    const day = ensureDay(dayMap, date)
+    if (sid !== undefined && sid !== null) day.sessionIds.add(sid)
+    adjustValues(day.tokens, values, direction)
+    const dayWs = ensureDayWs(day, wsId)
+    adjustValues(dayWs, values, direction)
+    if (noValues(dayWs)) day.byWs.delete(wsId)
+    const dayModel = ensureDayModel(day, modelId)
+    dayModel.calls += direction
+    adjustValues(dayModel, values, direction)
+    if (dayModel.calls === 0 && noValues(dayModel)) day.byModel.delete(modelId)
+  }
+  function adjustUsage(wsId, time, values, modelId, direction, sid) {
+    const modelTotals = ensureModel(modelId)
+    modelTotals.calls += direction
+    adjustValues(modelTotals, values, direction)
+    if (modelTotals.calls === 0 && noValues(modelTotals)) perModel.delete(modelId)
+    adjustValues(totals, values, direction)
+    const ws = ensureWs(wsId)
+    adjustValues(ws, values, direction)
+    adjustDay(byDay, dayKey(time), wsId, values, modelId, direction, sid)
+    adjustDay(byDayUtc, dayKeyUtc(time), wsId, values, modelId, direction, sid)
+  }
+  function usageStepKey(sid, data, seq) {
+    const turn = data && typeof data.turn === 'number' ? data.turn : null
+    const step = data && typeof data.step === 'number' ? data.step : null
+    if (turn !== null && step !== null) return sid + ':step:' + turn + ':' + step
+    return sid + ':event:' + (typeof seq === 'number' ? seq : String(Date.now()))
+  }
+  function addUsage(wsId, time, usage, model, sid, data, seq) {
+    const values = usageValues(usage)
+    const modelId = typeof model === 'string' && model !== '' ? model : '未知模型（历史记录缺少路由）'
+    const eventSeq = typeof seq === 'number' ? seq : -1
+    const key = usageStepKey(sid, data, seq)
+    const previous = usageByStep.get(key)
+    // A late replay of an older raw event cannot replace the canonical later step.
+    if (previous !== undefined && eventSeq >= 0 && previous.seq > eventSeq) return
+    if (previous !== undefined) adjustUsage(previous.wsId, previous.time, previous.values, previous.modelId, -1, previous.sid)
+    const next = { seq: eventSeq, wsId, time, values, modelId, sid }
+    usageByStep.set(key, next)
+    adjustUsage(wsId, time, values, modelId, 1, sid)
+  }
+  function addDayTurn(dayMap, date, wsId, sid) {
+    const day = ensureDay(dayMap, date)
+    if (sid !== undefined && sid !== null) day.sessionIds.add(sid)
+    day.turns += 1
+    day.perWs.set(wsId, (day.perWs.get(wsId) || 0) + 1)
+  }
+  function addTurn(wsId, time, sid) {
+    ensureWs(wsId).turns += 1
+    totals.turns += 1
+    addDayTurn(byDay, dayKey(time), wsId, sid)
+    addDayTurn(byDayUtc, dayKeyUtc(time), wsId, sid)
+  }
+  function routeLabel(route) {
+    if (route && typeof route.model === 'string' && route.model !== '') return (typeof route.provider === 'string' && route.provider !== '' ? route.provider + ' / ' : '') + route.model
+    return undefined
+  }
+  function modelFromRoute(data) {
+    return routeLabel(data) || routeLabel(data && data.header && data.header.config)
+  }
+  function modelFromMessage(data, fallback) {
+    return routeLabel(data && data.message && data.message.source) || fallback
+  }
+  function foldEvent(wsId, time, type, data, sid, seq) {
+    if (type === 'request/context' || type === 'request/header') {
+      const model = modelFromRoute(data)
+      if (model !== undefined) sessionModel.set(sid, model)
+    } else if (type === 'turn/end') addTurn(wsId, time, sid)
+    else if (type === 'assistant/message' && data && data.usage) addUsage(wsId, time, data.usage, modelFromMessage(data, sessionModel.get(sid)), sid, data, seq)
+  }
+  function foldEvents(wsId, events, fromSeq, sid) {
+    for (const ev of events) {
+      if (fromSeq !== undefined) {
+        const s = typeof ev.seq === 'number' ? ev.seq : -1
+        if (s <= fromSeq) continue
+      }
+      if (ev.type === 'turn/end' || ev.type === 'assistant/message' || ev.type === 'request/context' || ev.type === 'request/header') foldEvent(wsId, ev.time, ev.type, ev.data, sid, ev.seq)
+    }
+  }
+  function lastSeqOf(events) {
+    let last = 0
+    for (const ev of events) {
+      const s = typeof ev.seq === 'number' ? ev.seq : -1
+      if (s > last) last = s
+    }
+    return last
+  }
+  function enqueue(sid, task) {
+    const prev = chains.get(sid) || Promise.resolve()
+    const next = prev.then(() => task(), () => task())
+    chains.set(sid, next)
+    return next
+  }
+  function wsForLiveSession(session, sid) {
+    let wsId = memberOf.get(sid)
+    if (wsId !== undefined) return wsId
+    const header = session && session.header
+    const cwd = header && typeof header.cwd === 'string' ? header.cwd : ''
+    if (cwd === '') return undefined
+    wsId = pathIndex.get(cwd)
+    if (wsId !== undefined) memberOf.set(sid, wsId)
+    return wsId
+  }
+  async function processLiveEvent(sid, wsId, event) {
+    if (disposed) return
+    const seq = typeof event.seq === 'number' ? event.seq : -1
+    const last = sessionSeq.get(sid)
+    if (last === undefined) {
+      try {
+        const snap = await ctx.sessionQuery.readSession(sid)
+        if (snap && Array.isArray(snap.events)) {
+          foldEvents(wsId, snap.events, undefined, sid)
+          sessionSeq.set(sid, lastSeqOf(snap.events))
+          sessionCount.add(sid)
+        }
+      } catch (err) { /* retry on the next event */ }
+      return
+    }
+    if (seq <= last) return
+    if (seq > last + 1) {
+      try {
+        const snap = await ctx.sessionQuery.readSession(sid)
+        if (snap && Array.isArray(snap.events)) {
+          foldEvents(wsId, snap.events, last, sid)
+          sessionSeq.set(sid, lastSeqOf(snap.events))
+        }
+      } catch (err) { /* keep last; retry later */ }
+      return
+    }
+    foldEvent(wsId, event.time, event.type, event.data, sid, event.seq)
+    sessionSeq.set(sid, seq)
+    sessionCount.add(sid)
+  }
+
+  // ---------- baseline scan over durable logs ----------
+  function scheduleBaselineRetry() {
+    if (disposed || baselineRetryScheduled || scan.done) return
+    baselineRetryScheduled = true
+    const delay = baselineRetryDelay
+    baselineRetryDelay = Math.min(baselineRetryDelay * 2, 30000)
+    void Promise.resolve(ctx.timeout(delay)).then(() => {
+      baselineRetryScheduled = false
+      if (!disposed && !scan.started && !scan.done) return runBaseline()
+      return undefined
+    })
+  }
+  async function runBaseline() {
+    if (scan.started || disposed) return
+    scan.started = true
+    let setupFailed = false
+    try {
+      const workspaces = ctx.workspaceRegistry.list()
+      for (const w of workspaces) {
+        const id = w && w.id
+        const path = w && typeof w.path === 'string' ? w.path : ''
+        const title = w && typeof w.title === 'string' ? w.title : ''
+        if (id === undefined) continue
+        wsMeta.set(id, { id, title, path })
+        if (path !== '') pathIndex.set(path, id)
+        if (w && Array.isArray(w.sessionIds)) {
+          for (const sid of w.sessionIds) memberOf.set(sid, id)
+        }
+      }
+    } catch (err) {
+      console.error('[all-usage] workspace list failed:', err)
+      setupFailed = true
+    }
+    let records = null
+    try {
+      records = await ctx.sessionQuery.listSessions()
+    } catch (err) {
+      console.error('[all-usage] session list failed:', err)
+    }
+    if (disposed) return
+    if (setupFailed || !Array.isArray(records)) {
+      // A transient registry failure must not be reported as a completed empty scan.
+      scan.started = false
+      scheduleBaselineRetry()
+      return
+    }
+    scan.total = records.length
+    for (const record of records) {
+      if (disposed) return
+      if (record === undefined || record === null || record.header === undefined) {
+        scan.scanned += 1
+        continue
+      }
+      const sid = record.header.id
+      const cwd = typeof record.header.cwd === 'string' ? record.header.cwd : ''
+      const wsId = cwd === '' ? undefined : pathIndex.get(cwd)
+      if (sid === undefined || wsId === undefined) {
+        scan.scanned += 1
+        continue
+      }
+      await enqueue(sid, async () => {
+        if (disposed) return
+        try {
+          if (sessionSeq.has(sid)) return
+          const snap = await ctx.sessionQuery.readSession(sid)
+          if (snap && Array.isArray(snap.events)) {
+            foldEvents(wsId, snap.events, undefined, sid)
+            sessionSeq.set(sid, lastSeqOf(snap.events))
+            sessionCount.add(sid)
+          }
+        } catch (err) {
+          sessionSeq.set(sid, -1)
+          scan.failed += 1
+        } finally {
+          scan.scanned += 1
+        }
+      })
+      await ctx.timeout(0)
+    }
+    scan.done = true
+  }
+
+  // ---------- live feed ----------
+  ctx.on('session/event', (session, event) => {
+    if (disposed) return
+    if (event === undefined || event === null) return
+    const type = event.type
+    if (type !== 'turn/end' && type !== 'assistant/message' && type !== 'request/context' && type !== 'request/header') return
+    const sid = session && session.id
+    if (typeof sid !== 'string') return
+    const wsId = wsForLiveSession(session, sid)
+    if (wsId === undefined) return
+    enqueue(sid, () => processLiveEvent(sid, wsId, event))
+  })
+
+  // ---------- workspace aliases (durable, schema-free KV unit) ----------
+  async function loadAliases() {
+    if (storage === undefined) return
+    try {
+      const backend = storage.backend.get('json')
+      if (backend === undefined || backend === null || backend.kv === undefined) return
+      const unit = await backend.kv.open({ name: 'all-usage-aliases', version: 0, tables: [], hasGlobal: true })
+      kvUnit = unit
+      const snap = await unit.loadAll()
+      const g = snap && snap.global
+      if (g !== null && g !== undefined && typeof g === 'object') {
+        for (const key of Object.keys(g)) {
+          const value = g[key]
+          if (typeof value === 'string' && value.trim() !== '') aliases[key] = value
+        }
+      }
+    } catch (err) {
+      console.error('[all-usage] alias storage unavailable:', err)
+    }
+  }
+  function persistAliases() {
+    const snapshotAliases = {}
+    for (const key of Object.keys(aliases)) snapshotAliases[key] = aliases[key]
+    aliasWriteChain = aliasWriteChain.then(() => {
+      if (kvUnit === null || kvUnit === undefined) return undefined
+      return kvUnit.setGlobal(snapshotAliases).catch((err) => {
+        console.error('[all-usage] alias persist failed:', err)
+      })
+    })
+  }
+  function setAlias(wsId, raw) {
+    const alias = typeof raw === 'string' ? raw.trim().slice(0, 80) : ''
+    if (!wsMeta.has(wsId)) return { ok: false, message: 'unknown-workspace', aliases: Object.assign({}, aliases) }
+    if (alias === '') delete aliases[wsId]
+    else aliases[wsId] = alias
+    persistAliases()
+    return { ok: true, aliases: Object.assign({}, aliases) }
+  }
+  ctx.effect(() => () => {
+    disposed = true
+  })
+  ctx.effect(() => () => {
+    const unit = kvUnit
+    kvUnit = null
+    if (unit !== null && unit !== undefined) void unit.close().catch(() => {})
+  })
+
+  // ---------- snapshot for the client ----------
+  function serializeDays(dayMap) {
+    const result = []
+    for (const pair of dayMap) {
+      const date = pair[0]
+      const day = pair[1]
+      result.push({
+        date,
+        turns: day.turns,
+        sessions: day.sessionIds.size,
+        sessionIds: Array.from(day.sessionIds).sort(),
+        tokens: { input: day.tokens.input, output: day.tokens.output, cacheRead: day.tokens.cacheRead, cacheWrite: day.tokens.cacheWrite, reasoning: day.tokens.reasoning },
+        perWorkspace: Array.from(day.perWs, (p) => ({ workspaceId: p[0], turns: p[1] })),
+        byWorkspace: Array.from(day.byWs, (p) => ({ workspaceId: p[0], input: p[1].input, output: p[1].output, cacheRead: p[1].cacheRead, cacheWrite: p[1].cacheWrite, reasoning: p[1].reasoning })),
+        byModel: Array.from(day.byModel, (p) => ({ model: p[0], calls: p[1].calls, input: p[1].input, output: p[1].output, cacheRead: p[1].cacheRead, cacheWrite: p[1].cacheWrite, reasoning: p[1].reasoning })),
+      })
+    }
+    result.sort((a, b) => (a.date < b.date ? -1 : a.date > b.date ? 1 : 0))
+    return result
+  }
+  function snapshot() {
+    return {
+      scan: { started: scan.started, done: scan.done, scanned: scan.scanned, total: scan.total, failed: scan.failed },
+      generatedAt: Date.now(),
+      requestToken,
+      workspaces: Array.from(wsMeta.values(), (w) => ({ id: w.id, title: w.title, path: w.path })),
+      aliases: Object.assign({}, aliases),
+      tokenSemantics: {
+        processedTotal: 'input + output + cacheRead + cacheWrite + reasoning',
+        cacheRead: 'reused context tokens; not newly generated output',
+        cacheWrite: 'tokens written into a provider cache',
+      },
+      totals: { turns: totals.turns, sessions: sessionCount.size, input: totals.input, output: totals.output, cacheRead: totals.cacheRead, cacheWrite: totals.cacheWrite, reasoning: totals.reasoning },
+      perWorkspace: Array.from(perWorkspace, (p) => ({ workspaceId: p[0], turns: p[1].turns, input: p[1].input, output: p[1].output, cacheRead: p[1].cacheRead, cacheWrite: p[1].cacheWrite, reasoning: p[1].reasoning })),
+      perModel: Array.from(perModel, (p) => ({ model: p[0], calls: p[1].calls, input: p[1].input, output: p[1].output, cacheRead: p[1].cacheRead, cacheWrite: p[1].cacheWrite, reasoning: p[1].reasoning })),
+      byDay: serializeDays(byDay),
+      byDayUtc: serializeDays(byDayUtc),
+    }
+  }
+
+  // ---------- account balance (DeepSeek open platform) ----------
+  async function requestBalance(url, key) {
+    let controller = null
+    let timer = null
+    try {
+      if (typeof AbortController === 'function') {
+        controller = new AbortController()
+        timer = setTimeout(() => controller.abort(), 30000)
+      }
+      const response = await fetch(url, {
+        method: 'GET',
+        headers: { accept: 'application/json', authorization: 'Bearer ' + key },
+        ...(controller === null ? {} : { signal: controller.signal }),
+      })
+      return { ok: response.ok, status: response.status, text: await response.text() }
+    } catch (err) {
+      return { ok: false, status: 0, text: '', error: 'network request failed' }
+    } finally {
+      if (timer !== null) clearTimeout(timer)
+    }
+  }
+  function moneyOf(v) {
+    if (typeof v === 'number' && Number.isFinite(v)) return v
+    if (typeof v === 'string' && v.trim() !== '') {
+      const n = parseFloat(v)
+      if (Number.isFinite(n)) return n
+    }
+    return null
+  }
+  function parseBalance(text) {
+    let obj = null
+    try {
+      obj = JSON.parse(String(text).replace(/^\uFEFF/, ''))
+    } catch (err) {
+      return null
+    }
+    if (obj === null || typeof obj !== 'object') return null
+    if (obj.is_available === false) return { unavailable: true, currencies: [] }
+    const infos = (Array.isArray(obj.balance_infos) && obj.balance_infos) || (Array.isArray(obj.balance) && obj.balance) || null
+    if (!infos) return null
+    const out = []
+    for (const info of infos) {
+      if (info === null || typeof info !== 'object') continue
+      if (typeof info.currency !== 'string') continue
+      out.push({
+        currency: info.currency,
+        total: moneyOf(info.total_balance !== undefined ? info.total_balance : info.balance),
+        granted: moneyOf(info.granted_balance),
+        toppedUp: moneyOf(info.topped_up_balance),
+      })
+    }
+    return { unavailable: false, currencies: out }
+  }
+  async function fetchBalance(force) {
+    const now = Date.now()
+    if (force !== true && balanceCache.payload !== null && now - balanceCache.fetchedAt < 300000) return balanceCache.payload
+    let ref = 'DEEPSEEK_API_KEY'
+    if (settings !== undefined) {
+      try {
+        const section = settings.get('llm-deepseek')
+        if (section !== null && typeof section === 'object' && typeof section.apiKeyEnv === 'string' && section.apiKeyEnv.length > 0) ref = section.apiKeyEnv
+      } catch (err) { /* default ref */ }
+    }
+    let key
+    if (credentials !== undefined) {
+      try {
+        const hit = await credentials.resolve(ref)
+        if (hit !== null && hit !== undefined && typeof hit.value === 'string' && hit.value.length > 0) key = hit.value
+      } catch (err) { /* unconfigured */ }
+    }
+    if (key === undefined) {
+      const payload = { status: 'missing-key' }
+      balanceCache = { fetchedAt: now, payload }
+      return payload
+    }
+    if (typeof fetch !== 'function') {
+      const payload = { status: 'error', message: '当前 DSH 运行时不支持余额查询' }
+      balanceCache = { fetchedAt: now, payload }
+      return payload
+    }
+    const result = await requestBalance('https://api.deepseek.com/user/balance', key)
+    const body = (result.text || '').trim()
+    if (result.ok && body.length > 0) {
+      const parsed = parseBalance(body)
+      if (parsed !== null && parsed.unavailable) {
+        const payload = { status: 'unavailable', message: 'DeepSeek 接口返回余额不可用（is_available=false）' }
+        balanceCache = { fetchedAt: now, payload }
+        return payload
+      }
+      if (parsed !== null && parsed.currencies.length > 0) {
+        const payload = { status: 'ok', currencies: parsed.currencies, fetchedAt: now }
+        balanceCache = { fetchedAt: now, payload }
+        return payload
+      }
+    }
+    const detail = body.length > 0 ? body.slice(0, 300) : (result.status > 0 ? 'HTTP ' + result.status : result.error || 'network request failed')
+    const payload = { status: 'error', message: '余额查询失败', detail }
+    balanceCache = { fetchedAt: now, payload }
+    return payload
+  }
+
+  // ---------- HTTP data routes for the client half ----------
+  if (webServer !== undefined) {
+    const rejectRequest = (res) => sendJson(res, 403, { ok: false, message: 'forbidden' })
+    ctx.effect(() => webServer.register({
+      kind: 'exact',
+      path: '/api/all-usage',
+      handler: (req, res) => {
+        if (req.method !== 'GET') { res.statusCode = 405; res.end(); return }
+        if (!isTrustedLocalApiRequest(req, false)) { rejectRequest(res); return }
+        if (!scan.started) void runBaseline()
+        sendJson(res, 200, snapshot())
+      },
+    }))
+    ctx.effect(() => webServer.register({
+      kind: 'exact',
+      path: '/api/all-usage/balance',
+      handler: async (req, res) => {
+        if (req.method !== 'GET') { res.statusCode = 405; res.end(); return }
+        // Browsers may omit Origin on same-origin GET; the process token remains required.
+        if (!isTrustedLocalApiRequest(req, false) || !hasWriteToken(req, requestToken)) { rejectRequest(res); return }
+        let force = false
+        try {
+          const url = new URL(req.url ?? '/', 'http://x')
+          force = url.searchParams.get('force') === '1'
+        } catch (err) { /* default */ }
+        sendJson(res, 200, await fetchBalance(force))
+      },
+    }))
+    ctx.effect(() => webServer.register({
+      kind: 'exact',
+      path: '/api/all-usage/alias',
+      handler: async (req, res) => {
+        if (req.method !== 'POST') {
+          res.statusCode = 405
+          res.end()
+          return
+        }
+        if (!isTrustedLocalApiRequest(req, true) || !hasWriteToken(req, requestToken)) { rejectRequest(res); return }
+        const body = await readBody(req, 16 * 1024)
+        let args = null
+        try {
+          args = JSON.parse(body)
+        } catch (err) { /* invalid json */ }
+        const result = args !== null && args !== undefined && typeof args.workspaceId === 'string'
+          ? setAlias(args.workspaceId, args.alias)
+          : { ok: false, message: 'bad-request', aliases: Object.assign({}, aliases) }
+        sendJson(res, 200, result)
+      },
+    }))
+  }
+
+  // ---------- start the historical backfill immediately ----------
+  void runBaseline()
+  void loadAliases()
+}
+
+export { name, inject, apply }
+export default { name, inject, apply }