@loommii/dsh-provider-usage 0.6.1 → 0.8.0

package/lib/daily-stats.js

@@ -8,7 +8,9 @@ import { promises as fs } from 'node:fs'
 import { init as zstdInit, decompress as zstdWasmDec } from '@bokuweb/zstd-wasm'
 import { decompress as zstdFzDec } from 'fzstd'
 
-export const DAILY_VERSION = 1
+// v2（v0.7.0）：byModel 升级为按提供方嵌套 { 提供方: { 模型: 计数 } }；v1 为扁平 { 模型: 计数 }。
+// .backfilled 哨兵按版本判定：v1 哨兵会触发一次性全量重折（从会话文件恢复提供方归属）。
+export const DAILY_VERSION = 2
 
 /** 本地时区日期键：YYYY-MM-DD。 */
 export function dayKey(ms) {
@@ -152,7 +154,8 @@ export function parseEvents(text) {
 /** 把事件流中落在 [dayStart, dayEnd) 的 assistant/message 记账折叠成按天 totals。
  * 归属：message.source.provider/model，缺失回退 request/header；targetProvider 为空 = 全部 provider；
  * 事件 time 缺失按当天计入（宽松）。返回 { byProvider, byModel }，键值含
- * { requests, inputTokens, outputTokens, cacheReadTokens }。 */
+ * { requests, inputTokens, outputTokens, cacheReadTokens }；
+ * byModel 为按提供方嵌套：{ <provider>: { <model>: e } }（v0.7.0 起，支持按提供方过滤模型汇总）。 */
 /** 内部：把一条记账累加到 byProvider/byModel 桶。 */
 function bump(map, key, usage) {
   let e = map[key]
@@ -203,13 +206,16 @@ export function foldEventsByDay(events, dayStart, dayEnd, targetProvider) {
     const guess = stepGuess(data, headerProvider, headerModel)
     if (target !== null && guess.stepProvider !== target) continue
     bump(byProvider, guess.stepProvider || 'unknown', usage)
-    bump(byModel, guess.stepModel || 'unknown', usage)
+    const provKey = guess.stepProvider || 'unknown'
+    if (!byModel[provKey]) byModel[provKey] = {}
+    bump(byModel[provKey], guess.stepModel || 'unknown', usage)
   }
   return { byProvider, byModel }
 }
 
 /** 把事件流按天分组折叠（首次全量回填用）：返回 { <YYYY-MM-DD>: { byProvider, byModel },
- * unknown: {...} }——time 缺失的事件归 unknown 桶。targetProvider 为空 = 全部 provider。 */
+ * unknown: {...} }——time 缺失的事件归 unknown 桶。targetProvider 为空 = 全部 provider。
+ * byModel 按提供方嵌套（v0.7.0 起，见 foldEventsByDay）。 */
 export function foldEventsByDays(events, targetProvider) {
   const target = (typeof targetProvider === 'string' && targetProvider.trim() !== '') ? targetProvider.trim() : null
   const days = {}
@@ -236,14 +242,29 @@ export function foldEventsByDays(events, targetProvider) {
     let bucket = days[key]
     if (!bucket) { bucket = { byProvider: {}, byModel: {} }; days[key] = bucket }
     bump(bucket.byProvider, guess.stepProvider || 'unknown', usage)
-    bump(bucket.byModel, guess.stepModel || 'unknown', usage)
+    const provKey = guess.stepProvider || 'unknown'
+    if (!bucket.byModel[provKey]) bucket.byModel[provKey] = {}
+    bump(bucket.byModel[provKey], guess.stepModel || 'unknown', usage)
   }
   return days
 }
 
-/** 把 src 的 byProvider/byModel 累加进 dst（同键相加）。 */
+/** 判断 byModel 是否为 v1 扁平形态（顶层直接是计数条目，无提供方层）。 */
+export function isFlatByModel(map) {
+  for (const k of Object.keys(map || {})) {
+    const v = map[k]
+    if (v && typeof v === 'object' && typeof v.requests === 'number') return true
+  }
+  return false
+}
+
+/** 把 src 的 byProvider/byModel 累加进 dst（同键相加）。
+ * byModel 兼容 v0.6.1 扁平形态（{ <model>: e }，双向）：src 顶层条目并入 unknown 提供方桶，
+ * dst 顶层条目迁移到 unknown 桶后再合并（旧天文件被今天的重算复写时保持形态一致）。 */
 export function mergeTotals(dst, src) {
   if (!src) return
+  if (!dst.byProvider || typeof dst.byProvider !== 'object') dst.byProvider = {}
+  if (!dst.byModel || typeof dst.byModel !== 'object') dst.byModel = {}
   function mergeInto(map, srcMap) {
     for (const k of Object.keys(srcMap || {})) {
       const s = srcMap[k], t = map[k] || (map[k] = { requests: 0, inputTokens: 0, outputTokens: 0, cacheReadTokens: 0 })
@@ -254,7 +275,21 @@ export function mergeTotals(dst, src) {
     }
   }
   mergeInto(dst.byProvider, src.byProvider)
-  mergeInto(dst.byModel, src.byModel)
+  if (isFlatByModel(dst.byModel)) {
+    const legacy = dst.byModel
+    dst.byModel = {}
+    mergeInto(dst.byModel.unknown || (dst.byModel.unknown = {}), legacy)
+  }
+  for (const prov of Object.keys(src.byModel || {})) {
+    const bucket = src.byModel[prov]
+    if (!bucket || typeof bucket !== 'object') continue
+    if (typeof bucket.requests === 'number') { mergeInto(dst.byModel.unknown || (dst.byModel.unknown = {}), { [prov]: bucket }); continue }
+    if (!dst.byModel[prov] || typeof dst.byModel[prov] !== 'object' || typeof dst.byModel[prov].requests === 'number') {
+      const legacy = dst.byModel[prov] && typeof dst.byModel[prov] === 'object' ? dst.byModel[prov] : null
+      dst.byModel[prov] = legacy ? { unknown: legacy } : {}
+    }
+    mergeInto(dst.byModel[prov], bucket)
+  }
 }
 
 /** 读某天文件；损坏/缺失返回 null。 */
@@ -289,15 +324,38 @@ export async function saveCursors(dir, cursors) {
   await fs.rename(tmp, join(dir, 'cursors.json'))
 }
 
-/** 回填哨兵：标记"全量历史回填已完成"（防止无历史数据时每次请求都重扫）。 */
+/** 回填哨兵：标记"全量历史回填已完成且天文件为当前格式"（防止每次请求都重扫）。
+ * v0.7.0 起（DAILY_VERSION=2）按哨兵内容版本判定：旧版写的 version 1 哨兵视为未完成，
+ * 触发一次性全量重折，把 v1 扁平 byModel 天文件重算成嵌套形态（会话文件仍是事实源）。 */
 export async function hasBackfilled(dir) {
-  try { await fs.access(join(dir, '.backfilled')); return true } catch { return false }
+  try {
+    const raw = await fs.readFile(join(dir, '.backfilled'), 'utf8')
+    const j = JSON.parse(raw)
+    return !!(j && typeof j === 'object' && Number(j.version) >= DAILY_VERSION)
+  } catch { return false }
 }
 export async function writeBackfilled(dir) {
   await fs.mkdir(dir, { recursive: true, mode: 0o700 })
   await fs.writeFile(join(dir, '.backfilled'), JSON.stringify({ version: DAILY_VERSION, at: Date.now() }) + '\n', { mode: 0o600 })
 }
 
+/** 重置本地统计：删除全部派生数据（天文件/游标/回填哨兵/格式标记），不触碰会话原文。
+ * 下一次 local-usage 查询会自动从会话文件重新全量回填。返回删除的天文件数。 */
+export async function resetDailyStats(dir) {
+  let removed = 0
+  let names
+  try { names = await fs.readdir(dir) } catch { return 0 }
+  for (const n of names) {
+    if (n === 'cursors.json' || n === '.backfilled' || n === '.format' || /^\.\d{4}-\d{2}-\d{2}\.tmp-/.test(n)) {
+      try { await fs.rm(join(dir, n)); removed++; continue } catch { /* ignore */ }
+    }
+    if (/^\d{4}-\d{2}-\d{2}\.json$/.test(n)) {
+      try { await fs.rm(join(dir, n)); removed++ } catch { /* ignore */ }
+    }
+  }
+  return removed
+}
+
 /** 校验 deps（path -> mtime）：返回变化的与缺失的路径。 */
 export async function validateDeps(deps) {
   const changed = []

package/lib/index.js

@@ -4,14 +4,15 @@
 //   balance-json（余额型）  ：DeepSeek     {{baseUrl}}/user/balance    → balance_infos[]
 // 凭证链 per provider：DSH 设置 provider.apiKeyEnv → 凭证服务 → 环境变量。
 // 路由：/api/provider-usage/opencode-go（兼容旧版）、/api/provider-usage/query?provider=<id>、
-//       /api/provider-usage/templates / credentials / dsh-providers / credential-refs（仅回环）。
+//       /api/provider-usage/templates / credentials / dsh-providers / credential-refs / reset-local-stats（仅回环）、
+//       /api/provider-usage/providers（提供方实例清单持久化，v0.8.0 —— host 端 providers.json 为单一事实源）。
 // 本地 Token 统计（v0.5.0）：/api/provider-usage/local-usage（累计+按模型汇总，按天物化存储），
 //       数据源 = 自读 $DSH_HOME/sessions 会话文件（fzstd 解压，assistant/message 事件 data.usage），只读、不联网；
 //       存储 = $DSH_HOME/provider-usage/daily-stats/YYYY-MM-DD.json：历史天封存（deps mtime 校验），只算今天。
 // 缓存：每 provider 独立 30s 新鲜窗口 + 并发去重 + 3 快照环；stale-while-error。
 
 import { join, dirname } from 'node:path'
-import { stat as fsStat } from 'node:fs/promises'
+import { stat as fsStat, readFile, writeFile, rename, chmod, mkdir } from 'node:fs/promises'
 import { readFileSync } from 'node:fs'
 import { createSecureStore, resolveProviderUsageDir } from './secure-store.js'
 import * as daily from './daily-stats.js'
@@ -20,8 +21,8 @@ export const name = 'provider-usage'
 
 /** 插件版本单一来源：package.json（UA 标识用；bundle 内嵌等读不到时回退字面量）。 */
 const PLUGIN_VERSION = (() => {
-  try { return JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version || '0.6.0' }
-  catch { return '0.6.0' }
+  try { return JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version || '0.7.0' }
+  catch { return '0.7.0' }
 })()
 const USER_AGENT = 'dsh-provider-usage/' + PLUGIN_VERSION
 
@@ -298,6 +299,15 @@ function commandcodeMonthlyUsedPct(totalQuota, monthlyCredits) {
   return Math.max(0, Math.min(100, ((totalQuota - remaining) / totalQuota) * 100))
 }
 
+/** 月剩余百分比：钳制 [0,100] 后保留 3 位小数向下取整（如 89.918878… → 89.918）；无法推算返回 null。 */
+function commandcodeMonthlyRemainingPct(totalQuota, monthlyCredits) {
+  if (totalQuota === null || totalQuota === undefined || !(totalQuota > 0)) return null
+  const remaining = Number(monthlyCredits)
+  if (!Number.isFinite(remaining)) return null
+  const pct = Math.max(0, Math.min(100, (remaining / totalQuota) * 100))
+  return Math.floor(pct * 1000) / 1000
+}
+
 /** 把 credits + subscriptions 两个端点的响应换算成混合模型（订阅使用量 + 剩余额度）。 */
 function parseCommandCodeCredits(creditsBody, subBody) {
   let credits = creditsBody
@@ -334,6 +344,7 @@ function parseCommandCodeCredits(creditsBody, subBody) {
     ? subData.currentPeriodEnd : null
 
   const monthlyUsedPct = commandcodeMonthlyUsedPct(totalQuota, monthlyCredits)
+  const monthlyRemainingPct = commandcodeMonthlyRemainingPct(totalQuota, monthlyCredits)
   const monthlyUsed = (monthlyUsedPct === null || totalQuota === null) ? null
     : Math.max(0, totalQuota - monthlyCredits)
 
@@ -367,7 +378,7 @@ function parseCommandCodeCredits(creditsBody, subBody) {
       fiveHour: windowOf(fiveHourUsed, fiveHourCap, fiveHourResetAt),
       weekly: windowOf(weeklyUsed, weeklyCap, weeklyResetAt),
     },
-    monthly: { usedPct: monthlyUsedPct, used: monthlyUsed, totalQuota, remaining: monthlyCredits, resetsAt: nextResetAt },
+    monthly: { usedPct: monthlyUsedPct, remainingPct: monthlyRemainingPct, used: monthlyUsed, totalQuota, remaining: monthlyCredits, resetsAt: nextResetAt },
     cards: null,
     isValid: true,
     invalidMessage: null,
@@ -396,12 +407,67 @@ export function apply(ctx, rawConfig) {
       ? rawConfig.sessionsDir
       : join(dirname(resolveProviderUsageDir()), 'sessions'),
     dailyDir: join(resolveProviderUsageDir(), 'daily-stats'),
+    // 提供方实例清单（v0.8.0）：host 端单一事实源（localStorage 只是缓存），防重启后清单被静默重建
+    providersFile: join(resolveProviderUsageDir(), 'providers.json'),
   }
 
   // cordis 配置的 baseUrl 仅覆盖 opencode-go（历史语义），其余 preset 用内置 URL（插件自维护）
   const effectiveBaseUrl = (cfg) =>
     cfg.id === 'usage-percent' && config.baseUrlOverride ? config.baseUrlOverride : cfg.baseUrl
 
+  // ── 提供方实例清单持久化（v0.8.0）─
+  // 修复「重启后提供方清单被静默重建」：实例清单此前只存浏览器 localStorage，
+  // 存储 key 丢失（换 origin/清站点数据/浏览器驱逐）后 loadProviders() 走 DEFAULT_PROVIDERS
+  // 兜底 → 已删除的默认实例复活、自定义实例（如 Command Code）永久消失。
+  // 现在 host 端 providers.json 为单一事实源；客户端启动时从 host 恢复，写操作同步落盘。
+  const PROVIDER_ADAPTER_IDS = new Set(ADAPTERS.map((a) => a.id))
+  const PROVIDERS_MAX = 64
+
+  /** 规范并校验一个提供方实例（不合法字段一律剔除，而非整单拒绝——避免脏数据把恢复流程卡死）。 */
+  function normalizeProviderEntry(raw) {
+    if (!raw || typeof raw !== 'object') return null
+    if (typeof raw.adapter !== 'string' || !PROVIDER_ADAPTER_IDS.has(raw.adapter)) return null
+    const id = typeof raw.id === 'string' && raw.id.trim() !== '' ? raw.id.trim().slice(0, 128) : null
+    if (!id) return null
+    const name = typeof raw.name === 'string' && raw.name.trim() !== '' ? raw.name.trim().slice(0, 64) : ''
+    const ref = typeof raw.ref === 'string' ? raw.ref.slice(0, 128) : ''
+    const source = raw.source === 'vault' ? 'vault' : 'dsh'
+    const type = raw.type === 'manual' || raw.type === 'import' ? raw.type : (source === 'vault' ? 'manual' : 'import')
+    return { id, name, adapter: raw.adapter, ref, source, type, paused: raw.paused === true }
+  }
+
+  /** 读清单：providers.json 缺失/损坏 → null（调用方决定兜底，损坏文件同时改名留证）。 */
+  async function readProvidersDoc() {
+    let raw
+    try {
+      raw = await readFile(config.providersFile, 'utf8')
+    } catch (e) {
+      if (e && e.code === 'ENOENT') return null
+      return null // 其它读错误按缺失处理
+    }
+    try {
+      const doc = JSON.parse(raw)
+      if (!doc || doc.version !== 1 || !Array.isArray(doc.providers)) throw new Error('bad doc')
+      const providers = doc.providers.map(normalizeProviderEntry).filter(Boolean)
+      return { version: 1, providers }
+    } catch (e) {
+      // 损坏文件改名留证（.corrupt-<ts>），下次写盘重建；绝不静默吞掉用户清单
+      try { await rename(config.providersFile, config.providersFile + '.corrupt-' + Date.now()) } catch { /* ignore */ }
+      return null
+    }
+  }
+
+  /** 写清单：原子写（tmp → rename）+ 0600（与 credentials.json 同款边界）；目录缺失时先建（0700）。 */
+  async function writeProvidersDoc(providers) {
+    const doc = { version: 1, providers, savedAt: Date.now() }
+    await mkdir(dirname(config.providersFile), { recursive: true, mode: 0o700 }).catch(() => {})
+    const tmp = config.providersFile + '.tmp'
+    await writeFile(tmp, JSON.stringify(doc, null, 2), { mode: 0o600 })
+    await chmod(tmp, 0o600)
+    try { await rename(tmp, config.providersFile) } catch (e) { await writeFile(config.providersFile, JSON.stringify(doc, null, 2), { mode: 0o600 }) }
+    return doc
+  }
+
   // 私有加密凭证库（方案 B，懒初始化：首次使用时生成密钥）
   let secure = null
   async function secureStore() {
@@ -696,7 +762,7 @@ export function apply(ctx, rawConfig) {
     if (state.lastGood) {
       return { ...state.lastGood.payload, cached: true, stale: true, ok: false, error: { type, message, httpStatus: null } }
     }
-    return { ok: false, error: { type, message, httpStatus: null }, provider: null, detected: true, days: 0, scanned: 0, totals: null, byModel: null, providers: [], fetchedAt: null, cached: false, stale: false, snapshots: (state.snapshots || []).slice(), parseVersion: LOCAL_PARSE_VERSION }
+    return { ok: false, error: { type, message, httpStatus: null }, provider: null, detected: true, days: 0, scanned: 0, totals: null, byModel: { unknown: {} }, providers: [], fetchedAt: null, cached: false, stale: false, snapshots: (state.snapshots || []).slice(), parseVersion: LOCAL_PARSE_VERSION }
   }
 
   /** 校验待查天的 deps：unique 路径并行 stat，按天判定 mtime 变化/缺失，必要时重算该天并刷新缓存。 */
@@ -723,7 +789,15 @@ export function apply(ctx, rawConfig) {
         if (c.missing) missing.push(p)
         else if (Math.abs(c.currentMtime - Number(data.deps[p])) > 1) changed.push(p)
       }
-      if (changed.length > 0 || missing.length > 0) {
+      // v1 扁平 byModel（v0.6.1 落盘）：deps 仍全部指向存在的会话文件 → 重折恢复提供方归属（一次性，重写为 v2 嵌套）
+      let flatLegacy = daily.isFlatByModel(data.byModel || {}) && Object.keys(data.deps || {}).length > 0
+      if (flatLegacy) {
+        for (const p of Object.keys(data.deps)) {
+          const c = current.get(p)
+          if (!c || c.missing) { flatLegacy = false; break }
+        }
+      }
+      if (changed.length > 0 || missing.length > 0 || flatLegacy) {
         const repaired = await recomputeDay(day, data.deps || {})
         data.byProvider = repaired.byProvider
         data.byModel = repaired.byModel
@@ -799,19 +873,22 @@ export function apply(ctx, rawConfig) {
     const files = await daily.scanSessionFiles(config.sessionsDir, config.maxSessions, todayStart - 3600000)
     const cursors = await daily.loadCursors(config.dailyDir)
     // 今天 totals = 上次累积的天文件 + 本轮新增帧（文件 mtime 未变则完全跳过）
+    // 例外：天文件还是 v0.6.1 的扁平 byModel（无提供方维度）→ 不种子、当天全量重折（v2 嵌套），
+    // 游标一并重置，避免旧扁平数据进 unknown 桶 / 增量与重折双计
     const prevDay = await cachedDay(toDay)
-    const out = prevDay ? {
+    const prevFlat = !!(prevDay && daily.isFlatByModel(prevDay.byModel || {}))
+    const out = prevDay && !prevFlat ? {
       byProvider: JSON.parse(JSON.stringify(prevDay.byProvider || {})),
       byModel: JSON.parse(JSON.stringify(prevDay.byModel || {})),
     } : { byProvider: {}, byModel: {} }
-    const deps = prevDay && prevDay.deps ? { ...prevDay.deps } : {}
-    let anyWork = false
+    const deps = prevDay && prevDay.deps && !prevFlat ? { ...prevDay.deps } : {}
+    let anyWork = prevFlat
     for (const f of files) {
       deps[f.path] = f.mtimeMs
       const cur = cursors[f.path]
-      if (cur && cur.mtimeMs === f.mtimeMs) continue // 文件无新写入：本轮零成本跳过
+      if (!prevFlat && cur && cur.mtimeMs === f.mtimeMs) continue // 文件无新写入：本轮零成本跳过
       anyWork = true
-      if (cur && typeof cur.offset === 'number') {
+      if (!prevFlat && cur && typeof cur.offset === 'number') {
         const inc = await daily.readSessionFileFrom(f.path, cur.offset)
         if (inc.changed && inc.text) {
           daily.mergeTotals(out, daily.foldEventsByDay(daily.parseEvents(inc.text), todayStart, todayEnd, null))
@@ -840,6 +917,18 @@ export function apply(ctx, rawConfig) {
     return { toDay, out, scanned: files.length }
   }
 
+  /** 按提供方过滤嵌套 byModel（v0.6.1 扁平旧数据已由 mergeTotals 迁到 unknown 桶）。
+   * pick 为空 = 全部提供方（原样返回嵌套形态）；选中提供方无数据 = 空对象。
+   * 恒返回嵌套形态（选中时只含该提供方键），客户端据此统一判别新旧服务端。 */
+  function filterModelByProvider(byModel, pick) {
+    const src = byModel && typeof byModel === 'object' ? byModel : {}
+    if (!pick) return src
+    const out = {}
+    const inner = src[pick]
+    if (inner && typeof inner === 'object' && typeof inner.requests !== 'number') out[pick] = inner
+    return out
+  }
+
   async function doLocalUsage(target, since, key, state) {
     let st
     try { st = await fsStat(config.sessionsDir) } catch { return localFail(state, 'no-sessions', '未找到 DSH 会话目录：' + config.sessionsDir) }
@@ -858,12 +947,15 @@ export function apply(ctx, rawConfig) {
       await backfillAll(nowMs)
       await daily.writeBackfilled(config.dailyDir)
     }
+    // agg = 全量聚合（providers/totals 用）；modelAgg = 模型维度聚合（按提供方嵌套，v0.7.0）
     const agg = { byProvider: {}, byModel: {} }
+    const modelAgg = { byModel: {} }
     const dayCount = new Set()
     dayCount.add(toDay)
     // 今天：只算今天变过的文件
     const today = await computeToday(nowMs)
     daily.mergeTotals(agg, today.out)
+    daily.mergeTotals(modelAgg, { byModel: today.out.byModel || {} })
     // 历史天：读天文件（内存缓存；5 分钟周期内只校验一次 deps；mtime 变化才重算该天）
     const existing = await daily.listDayFiles(config.dailyDir)
     const pending = []
@@ -883,14 +975,16 @@ export function apply(ctx, rawConfig) {
     for (const day of Object.keys(dayData)) {
       const data = dayData[day]
       daily.mergeTotals(agg, { byProvider: data.byProvider || {}, byModel: data.byModel || {} })
+      daily.mergeTotals(modelAgg, { byModel: data.byModel || {} })
       dayCount.add(day)
     }
     // unknown 桶（time 缺失事件）：并入聚合（不占天数）
     const unknownData = await cachedDay('unknown')
     if (unknownData) {
       daily.mergeTotals(agg, { byProvider: unknownData.byProvider || {}, byModel: unknownData.byModel || {} })
+      daily.mergeTotals(modelAgg, { byModel: unknownData.byModel || {} })
     }
-    // 组装响应（chips 只过滤 totals；byModel 恒为全量）
+    // 组装响应（chips/totals/byModel 均按选中提供方过滤；v0.7.0 起 byModel 按提供方嵌套可过滤）
     const providers = Object.keys(agg.byProvider).sort()
     const pick = target ? (agg.byProvider[target] || null) : null
     const t = pick || { requests: 0, inputTokens: 0, outputTokens: 0, cacheReadTokens: 0 }
@@ -917,7 +1011,7 @@ export function apply(ctx, rawConfig) {
           ? t.cacheReadTokens / (t.inputTokens + t.cacheReadTokens)
           : 0,
       },
-      byModel: agg.byModel || null,
+      byModel: filterModelByProvider(modelAgg.byModel, target || null),
       providers,
       fetchedAt: Date.now(), cached: false, stale: false,
       snapshots: (state.snapshots || []).slice(),
@@ -928,6 +1022,18 @@ export function apply(ctx, rawConfig) {
     return payload
   }
 
+  /** 重置本地统计：删派生天文件/游标/哨兵（会话原文只读不动），清空 30s 缓存与去重态。 */
+  async function resetLocalUsage() {
+    const st = await fsStat(config.sessionsDir).then(() => true, () => false)
+    if (!st) return { ok: false, error: { type: 'no-sessions', message: '未找到 DSH 会话目录：' + config.sessionsDir, httpStatus: null } }
+    const removed = await daily.resetDailyStats(config.dailyDir)
+    dayCache.clear() // 天文件内存缓存一并清除：否则重查会用旧天数据做种子，重置对损坏天文件无效
+    for (const [k, s] of states) {
+      if (k.startsWith('local|')) { s.lastGood = null; s.fetching = null; s.validatedDays = new Set(); s.depsCheckAt = 0 }
+    }
+    return { ok: true, removed }
+  }
+
   async function localUsage(params) {
     const target = (params && typeof params.provider === 'string' && params.provider.trim() !== '') ? params.provider.trim() : null
     const since = (params && typeof params.since === 'string' && Number(params.since) > 0) ? Number(params.since) : 0
@@ -1018,6 +1124,12 @@ export function apply(ctx, rawConfig) {
         path: '/api/provider-usage/local-usage',
         handler: jsonRoute((req) => localUsage(queryParamsFromUrl(req))),
       }),
+      // 重置本地统计：删除按天物化的派生数据（天文件/游标/哨兵），下次查询自动全量重算；会话原文只读不动
+      ctx.webServer.register({
+        kind: 'exact',
+        path: '/api/provider-usage/reset-local-stats',
+        handler: jsonRoute(() => resetLocalUsage(), true),
+      }),
 
       // 适配器清单（不含任何 secret；客户端据此渲染"添加供应商"选项）
       ctx.webServer.register({
@@ -1098,6 +1210,28 @@ export function apply(ctx, rawConfig) {
           return { ok: true, refs }
         }),
       }),
+      // 提供方实例清单持久化（v0.8.0）─：host 端 providers.json 为单一事实源。
+      // GET 读清单（缺失返回 ok:true + items:null，由客户端走一次性迁移）；
+      // POST 整单覆盖保存（幂等）。仅回环，条目逐个规范化，不合法条目剔除。
+      ctx.webServer.register({
+        kind: 'exact',
+        path: '/api/provider-usage/providers',
+        handler: jsonRoute(async (req, body) => {
+          if (req.method === 'POST') {
+            if (!body || !Array.isArray(body.providers)) {
+              return { ok: false, error: { type: 'bad-providers', message: 'providers 必须是数组', httpStatus: 400 } }
+            }
+            if (body.providers.length > PROVIDERS_MAX) {
+              return { ok: false, error: { type: 'too-many-providers', message: '提供方实例最多 ' + PROVIDERS_MAX + ' 个', httpStatus: 400 } }
+            }
+            const providers = body.providers.map(normalizeProviderEntry).filter(Boolean)
+            await writeProvidersDoc(providers)
+            return { ok: true, providers }
+          }
+          const doc = await readProvidersDoc()
+          return { ok: true, providers: doc ? doc.providers : null, exists: doc !== null }
+        }, true),
+      }),
     ]
     return () => { for (const dispose of disposers) { if (typeof dispose === 'function') dispose() } }
   }, 'provider-usage: routes')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loommii/dsh-provider-usage",
-  "version": "0.6.1",
+  "version": "0.8.0",
   "description": "DSH 插件（用量中心）：常驻用量卡片 · 多提供方用量/余额查询（OpenCode Go 订阅 + DeepSeek 余额 + Command Code 订阅/余额，对齐 cc-switch 查询语义）",
   "type": "module",
   "main": "lib/index.js",
@@ -48,15 +48,12 @@
       "patch": "./cordis.patch.yml"
     },
     "client": {
-      "platform": "web",
-      "inject": [
-        "@deepseek-ai/dsh-client-runtime"
-      ]
+      "platform": "web"
     }
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-host-webserver": ">=0.1.0-rc.6",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },