dsh-cost-meter 1.6.13 → 1.7.1

package/lib/index.js

@@ -941,11 +941,12 @@ function secretMigrationNotice(ledger) {
  * @param balance - 官方余额快照。
  * @param goQuota - OpenCode Go 额度快照。
  * @param codingPlans - 各家 coding plan 合并快照(mergedCodingPlans 产出)。
- * @param customBalance - 自定义 Provider 余额快照。
+ * @param customBalance - 自定义 Provider 余额快照(旧单条镜像;多配置形态为第一条可见)。
  * @param reconcile - 余额差对账提示。
  * @param ctx - 宿主上下文(可选;用于查询密钥配置状态,缺省则只下发未配置)。
+ * @param customBalances - 多配置形态的全部条目快照(v1.7.0,issue #79;缺省 = [])。
  */
-async function buildState(ledger, balance = emptyBalance(), goQuota = emptyGoQuota(), codingPlans = {}, customBalance = emptyCustomBalance(), reconcile = { ok: true, message: '' }, ctx = null) {
+async function buildState(ledger, balance = emptyBalance(), goQuota = emptyGoQuota(), codingPlans = {}, customBalance = emptyCustomBalance(), reconcile = { ok: true, message: '' }, ctx = null, customBalances = []) {
   const now = Date.now()
   const dayKey = localDayKey(now)
   const monthKey = dayKey.slice(0, 7)
@@ -1011,6 +1012,8 @@ async function buildState(ledger, balance = emptyBalance(), goQuota = emptyGoQuo
     balance,
     goQuota,
     customBalance,
+    // 多配置形态(v1.7.0,issue #79):全部自定义 Provider 余额条目快照。
+    customBalances,
     // 余额差交叉校验提示(issue #18):本地今日合计与官方余额当日变动偏差超阈时 ok=false。
     reconcile,
     codingPlans,
@@ -1044,7 +1047,7 @@ async function buildState(ledger, balance = emptyBalance(), goQuota = emptyGoQuo
   const attempts = [
     stateNoCatalog,
     { ...stateNoCatalog, codingPlans: {} },
-    { ...stateNoCatalog, codingPlans: {}, balance: emptyBalance(), goQuota: emptyGoQuota(), customBalance: emptyCustomBalance() },
+    { ...stateNoCatalog, codingPlans: {}, balance: emptyBalance(), goQuota: emptyGoQuota(), customBalance: emptyCustomBalance(), customBalances: [] },
   ]
   for (const fallback of attempts) {
     if (stateSchema.safeParse(fallback).success) return fallback
@@ -1153,7 +1156,6 @@ function createService(ctx, ledger) {
   let balanceCache = { fetchedAt: 0, value: emptyBalance() }
   // OpenCode Go 订阅额度进程内缓存(同上策略)。
   let goQuotaCache = { fetchedAt: 0, value: emptyGoQuota() }
-  let customBalanceCache = { fetchedAt: 0, value: emptyCustomBalance() }
   // Coding plan 额度进程内缓存(每家一个条目,同上策略)。
   let codingPlanCaches = {}
   // 余额差对账提示(drift 时 ok=false 携带文案,其余静默)。
@@ -1161,7 +1163,6 @@ function createService(ctx, ledger) {
 
   const balanceConfig = () => ledger.config?.balance ?? { display: 'both', refreshMinutes: 5 }
   const goQuotaConfig = () => ledger.config?.goQuota ?? { enabled: true, display: 'both', refreshMinutes: 15, apiKey: '' }
-  const customBalanceConfig = () => ledger.config?.customBalance ?? { enabled: false, display: 'off', refreshMinutes: 15, label: '', request: { url: '' }, extract: {} }
   const codingPlanConfigOf = id => ({
     enabled: false,
     display: 'settings',
@@ -1287,27 +1288,61 @@ function createService(ctx, ledger) {
     await task
   }
 
-  /** 按需刷新自定义 Provider 余额(过期或 force)。 */
-  const ensureCustomBalance = async (force = false) => {
-    const config = customBalanceConfig()
-    if (config.enabled !== true || config.display === 'off') {
-      customBalanceCache = { fetchedAt: Date.now(), value: emptyCustomBalance() }
-      return
+  /** 按需刷新自定义 Provider 余额(过期或 force)。
+   * v1.7.0(issue #79)起为多配置形态:每条 config.customBalances[i] 独立缓存
+   * (customBalanceCaches[i] = { fetchedAt, value, inFlight });旧单配置形态由
+   * sanitizeConfig 迁移为 entries[0],运行期统一按数组处理。index 指定时只刷
+   * 该条;缺省(ambient 快照)刷全部可见条目。
+   */
+  const customBalanceConfigs = () => Array.isArray(ledger.config?.customBalances)
+    ? ledger.config.customBalances : []
+  const customBalanceCaches = {}
+  const customBalanceCacheAt = index => {
+    if (customBalanceCaches[index] === undefined) {
+      customBalanceCaches[index] = { fetchedAt: 0, value: emptyCustomBalance() }
     }
-    const interval = Math.max(1, Number(config.refreshMinutes) || 15) * 60_000
-    if (!force && Date.now() - customBalanceCache.fetchedAt < interval) return
-    while (customBalanceCache.inFlight !== undefined) {
-      const prev = customBalanceCache.inFlight
+    return customBalanceCaches[index]
+  }
+  const ensureCustomBalance = async (force = false, index = null) => {
+    const entries = customBalanceConfigs()
+    const targets = []
+    if (index === null) {
+      // ambient:全部启用且非 off 的条目;一条都没有时清理出空缓存(与旧单条 off 行为一致)。
+      entries.forEach((entry, i) => {
+        if (entry?.enabled === true && entry.display !== 'off') targets.push(i)
+      })
+      if (targets.length === 0) {
+        for (const key of Object.keys(customBalanceCaches)) {
+          customBalanceCaches[key] = { fetchedAt: Date.now(), value: emptyCustomBalance() }
+        }
+        return
+      }
+    } else {
+      if (entries[index]?.enabled !== true || entries[index].display === 'off') return
+      targets.push(index)
+    }
+    await Promise.all(targets.map(i => ensureCustomBalanceEntry(force, i)))
+  }
+  const ensureCustomBalanceEntry = async (force, index) => {
+    const config = customBalanceConfigs()[index]
+    const cache = customBalanceCacheAt(index)
+    const interval = Math.max(1, Number(config?.refreshMinutes) || 15) * 60_000
+    if (!force && Date.now() - cache.fetchedAt < interval) return
+    while (cache.inFlight !== undefined) {
+      const prev = cache.inFlight
       if (!force) { await prev; return }
       // force 链式等待:等上一个任务结束后由本调用继续走新建流程,
       // 保证手动强制刷新不被在途任务吞掉(否则返回的是即将过期的旧数据)。
       await prev.catch(() => {})
-      if (customBalanceCache.inFlight === prev) break // 上一个任务结束后由本调用继续走新建流程
+      if (cache.inFlight === prev) break // 上一个任务结束后由本调用继续走新建流程
     }
-    const task = queryCustomBalance(ctx, ledger.config).then(result => {
-      customBalanceCache = {
+    // queryCustomBalance 的单条入参重载:customBalances[i] 视图(兼容旧键,设置页
+    // 面向 entries 编辑)。
+    const configForEntry = { ...ledger.config, customBalance: config, customBalances: undefined }
+    const task = queryCustomBalance(ctx, configForEntry).then(result => {
+      customBalanceCaches[index] = {
         fetchedAt: Date.now(),
-        value: { status: 'ok', message: '', fetchedAt: Date.now(), ...result },
+        value: { status: 'ok', message: '', fetchedAt: Date.now(), index, ...result },
       }
     }, error => {
       // 失败不更新外层 fetchedAt:让下次轮询重试(PR #40,与 ensureGoQuota 同策略)。
@@ -1315,34 +1350,53 @@ function createService(ctx, ledger) {
       const now = Date.now()
       const message = error instanceof Error ? error.message : String(error)
       if (error && error.soft === true) {
-        customBalanceCache = {
+        customBalanceCaches[index] = {
           fetchedAt: now,
           value: {
             ...emptyCustomBalance(),
-            label: typeof config.label === 'string' ? config.label : '',
+            label: typeof config?.label === 'string' ? config.label : '',
             status: 'off',
             message,
             fetchedAt: now,
+            index,
           },
         }
       } else {
-        customBalanceCache = {
-          ...customBalanceCache,
+        customBalanceCaches[index] = {
+          ...cache,
           value: {
             ...emptyCustomBalance(),
-            label: typeof config.label === 'string' ? config.label : '',
+            label: typeof config?.label === 'string' ? config.label : '',
             status: 'error',
             message,
             fetchedAt: now,
+            index,
           },
         }
       }
     }).finally(() => {
-      if (customBalanceCache.inFlight === task) delete customBalanceCache.inFlight
+      if (customBalanceCaches[index]?.inFlight === task) delete customBalanceCaches[index].inFlight
     })
-    customBalanceCache.inFlight = task
+    customBalanceCaches[index] = { ...cache, inFlight: task }
     await task
   }
+  /** 多条快照(仅含有缓存值的条目;旧单条镜像取第一条可见条目)。 */
+  const customBalanceSnapshots = () => {
+    const entries = customBalanceConfigs()
+    const out = []
+    entries.forEach((entry, index) => {
+      const cached = customBalanceCaches[index]
+      if (cached === undefined) return
+      out.push({ ...emptyCustomBalance(), ...cached.value, index })
+    })
+    return out
+  }
+  const customBalanceMirror = () => {
+    const snapshots = customBalanceSnapshots()
+    if (snapshots.length === 0) return emptyCustomBalance()
+    // 旧客户端镜像:优先取「侧边栏可见且 ok」的第一条,否则第一条。
+    return snapshots.find(s => s.status === 'ok') ?? snapshots[0]
+  }
 
   /**
    * 合并配置与运行时额度状态,得到对客户端的 codingPlans 快照。
@@ -1468,10 +1522,10 @@ function createService(ctx, ledger) {
     }
     kick(balanceCache.fetchedAt > 0, () => ensureBalance(forceBalance))
     kick(goQuotaCache.fetchedAt > 0, () => ensureGoQuota(false))
-    kick(customBalanceCache.fetchedAt > 0, () => ensureCustomBalance(false))
+    kick(Object.values(customBalanceCaches).some(cache => (cache?.fetchedAt ?? 0) > 0), () => ensureCustomBalance(false))
     kick(Object.values(codingPlanCaches).some(cache => (cache?.fetchedAt ?? 0) > 0), () => ensureCodingPlans(false))
     await Promise.all(pending)
-    return await buildState(ledger, balanceCache.value, goQuotaCache.value, await mergedCodingPlans(), customBalanceCache.value, reconcileNotice, ctx)
+    return await buildState(ledger, balanceCache.value, goQuotaCache.value, await mergedCodingPlans(), customBalanceMirror(), reconcileNotice, ctx, customBalanceSnapshots())
   }
 
   const service = {
@@ -1525,26 +1579,30 @@ function createService(ctx, ledger) {
       return {
         ok: value.status === 'ok',
         message: value.status === 'ok' ? tmsg(locale, 'balanceRefreshed') : tmsg(locale, 'balanceQueryFailed', { message: value.message }),
-        state: await buildState(ledger, value, goQuotaCache.value, await mergedCodingPlans(), customBalanceCache.value, reconcileNotice, ctx),
+        state: await buildState(ledger, value, goQuotaCache.value, await mergedCodingPlans(), customBalanceMirror(), reconcileNotice, ctx, customBalanceSnapshots()),
       }
     },
 
-    async refreshCustomBalance() {
+    async refreshCustomBalance(index = null) {
       const locale = localeOf(ledger.config)
-      if (customBalanceConfig().enabled !== true) {
+      const entries = customBalanceConfigs()
+      // index 指定:单条强刷(多配置形态设置页/侧边栏逐条刷新按钮);缺省:全量。
+      const idx = Number.isInteger(index) && index >= 0 && index < 8 ? index : null
+      const entry = idx !== null ? entries[idx] : entries.find(e => e?.enabled === true && e.display !== 'off')
+      if (entry === undefined || entry === null || entry.enabled !== true) {
         return { ok: false, message: tmsg(locale, 'customBalanceDisabled') }
       }
-      if (customBalanceConfig().display === 'off') {
+      if (entry.display === 'off') {
         return { ok: false, message: tmsg(locale, 'customBalanceDisplayOff') }
       }
-      await ensureCustomBalance(true)
-      const value = customBalanceCache.value
+      await ensureCustomBalance(true, idx)
+      const value = idx !== null ? (customBalanceCaches[idx]?.value ?? emptyCustomBalance()) : customBalanceMirror()
       return {
         ok: value.status === 'ok',
         message: value.status === 'ok' ? tmsg(locale, 'customBalanceRefreshed')
           : value.status === 'off' && value.message ? value.message
             : tmsg(locale, 'customBalanceQueryFailed', { message: value.message }),
-        state: await buildState(ledger, balanceCache.value, goQuotaCache.value, await mergedCodingPlans(), value, reconcileNotice, ctx),
+        state: await buildState(ledger, balanceCache.value, goQuotaCache.value, await mergedCodingPlans(), customBalanceMirror(), reconcileNotice, ctx, customBalanceSnapshots()),
       }
     },
 
@@ -1563,7 +1621,7 @@ function createService(ctx, ledger) {
         message: value.status === 'ok' ? tmsg(locale, 'goQuotaRefreshed')
           : value.status === 'off' && value.message ? value.message
             : tmsg(locale, 'goQuotaQueryFailed', { message: value.message }),
-        state: await buildState(ledger, balanceCache.value, value, await mergedCodingPlans(), customBalanceCache.value, reconcileNotice, ctx),
+        state: await buildState(ledger, balanceCache.value, value, await mergedCodingPlans(), customBalanceMirror(), reconcileNotice, ctx, customBalanceSnapshots()),
       }
     },
 
@@ -1588,7 +1646,7 @@ function createService(ctx, ledger) {
         message: value.status === 'ok' ? tmsg(locale, 'codingPlanRefreshed', { provider: label })
           : value.status === 'off' && value.message ? value.message
             : tmsg(locale, 'codingPlanQueryFailed', { provider: label, message: value.message }),
-        state: await buildState(ledger, balanceCache.value, goQuotaCache.value, await mergedCodingPlans(), customBalanceCache.value, reconcileNotice, ctx),
+        state: await buildState(ledger, balanceCache.value, goQuotaCache.value, await mergedCodingPlans(), customBalanceMirror(), reconcileNotice, ctx, customBalanceSnapshots()),
       }
     },
 
@@ -1626,7 +1684,7 @@ function createService(ctx, ledger) {
       return {
         ok: true,
         message: tmsg(locale, 'credentialSaved'),
-        state: await buildState(ledger, balanceCache.value, goQuotaCache.value, await mergedCodingPlans(), customBalanceCache.value, reconcileNotice, ctx),
+        state: await buildState(ledger, balanceCache.value, goQuotaCache.value, await mergedCodingPlans(), customBalanceMirror(), reconcileNotice, ctx, customBalanceSnapshots()),
       }
     },
 
@@ -1658,7 +1716,7 @@ function createService(ctx, ledger) {
       return {
         ok: true,
         message: tmsg(locale, 'credentialCleared'),
-        state: await buildState(ledger, balanceCache.value, goQuotaCache.value, await mergedCodingPlans(), customBalanceCache.value, reconcileNotice, ctx),
+        state: await buildState(ledger, balanceCache.value, goQuotaCache.value, await mergedCodingPlans(), customBalanceMirror(), reconcileNotice, ctx, customBalanceSnapshots()),
       }
     },
 

package/lib/store.js

@@ -130,6 +130,10 @@ export function defaultConfig() {
         unit: 'USD',
       },
     },
+    // 多配置形态(v1.7.0,issue #79):自定义 Provider 余额支持多条并行,每条
+    // 独立 enabled/display/刷新间隔/请求与解析规则。旧 customBalance 单配置
+    // 在 sanitizeConfig 中自动迁移为 entries[0](有值时),运行期以本数组为准。
+    customBalances: [],
     corner: {
       enabled: false, // 右下角(composer dock)显示 Go 额度 / 预算 chips
       goRolling: true, // 滚动 5 小时额度
@@ -664,6 +668,8 @@ const VALIDATION_MESSAGES = {
     customBalanceRequest: 'customBalance.request.url 必须是非空字符串',
     customBalanceHeaders: 'customBalance.request.headers 必须是字符串→字符串映射',
     customBalanceExtract: 'customBalance.extract 必须是对象',
+    customBalances: 'customBalances 必须是数组',
+    customBalancesTooMany: '自定义 Provider 余额配置最多 8 条',
     goQuotaEnabled: 'goQuota.enabled 必须是布尔值',
     goQuotaDisplay: 'goQuota.display 必须是 sidebar / settings / both / off',
     goQuotaRefresh: 'goQuota.refreshMinutes 必须是 1-1440 的整数',
@@ -743,6 +749,8 @@ const VALIDATION_MESSAGES = {
     customBalanceRequest: 'customBalance.request.url must be a non-empty string',
     customBalanceHeaders: 'customBalance.request.headers must be a string→string map',
     customBalanceExtract: 'customBalance.extract must be an object',
+    customBalances: 'customBalances must be an array',
+    customBalancesTooMany: 'At most 8 custom provider balance entries are allowed',
     goQuotaEnabled: 'goQuota.enabled must be a boolean',
     goQuotaDisplay: 'goQuota.display must be sidebar / settings / both / off',
     goQuotaRefresh: 'goQuota.refreshMinutes must be an integer from 1 to 1440',
@@ -1000,31 +1008,43 @@ export function applyConfigPatch(current, rawPatch) {
       else balance.budgetCap = cap > 0 ? cap : null
     }
   }
-  // 自定义 Provider 余额校验。
-  const customBalance = candidate.customBalance
-  if (customBalance !== undefined) {
-    if (customBalance === null || typeof customBalance !== 'object' || Array.isArray(customBalance)) {
+  // 自定义 Provider 余额校验(v1.7.0 起支持多配置,issue #79)。
+  // 单条校验逻辑对 customBalance(旧单配置)与 customBalances[n](新数组)复用。
+  const validateCustomBalanceEntry = (entry, fieldPrefix) => {
+    if (entry === null || typeof entry !== 'object' || Array.isArray(entry)) {
       errors.push(vmsg(locale, 'customBalance'))
+      return
+    }
+    if (typeof entry.enabled !== 'boolean') errors.push(vmsg(locale, fieldPrefix + 'Enabled'))
+    if (!['sidebar', 'settings', 'both', 'off'].includes(entry.display)) errors.push(vmsg(locale, fieldPrefix + 'Display'))
+    const refreshMinutes = Number(entry.refreshMinutes)
+    if (!Number.isInteger(refreshMinutes) || refreshMinutes < 1 || refreshMinutes > 1440) errors.push(vmsg(locale, fieldPrefix + 'Refresh'))
+    else entry.refreshMinutes = refreshMinutes
+    if (typeof entry.label !== 'string') errors.push(vmsg(locale, fieldPrefix + 'Label'))
+    if (entry.labelEn !== undefined && typeof entry.labelEn !== 'string') errors.push(vmsg(locale, fieldPrefix + 'LabelEn'))
+    if (entry.unit !== undefined && !['USD', 'CNY', 'EUR'].includes(entry.unit)) errors.push(vmsg(locale, fieldPrefix + 'Unit'))
+    const request = entry.request
+    // url 仅在启用时必填:默认禁用状态下不能阻断其它配置项的保存。
+    if (request === null || typeof request !== 'object' || Array.isArray(request) || typeof request.url !== 'string' || (entry.enabled === true && request.url.length === 0)) {
+      errors.push(vmsg(locale, fieldPrefix + 'Request'))
+    } else if (request.headers !== undefined && (request.headers === null || typeof request.headers !== 'object' || Array.isArray(request.headers)
+      || Object.values(request.headers).some(value => typeof value !== 'string'))) {
+      // 值非字符串会击穿 typert strict configSchema(z.record(string, string)),导致整个 getState 被拒。
+      errors.push(vmsg(locale, fieldPrefix + 'Headers'))
+    }
+    const extract = entry.extract
+    if (extract === null || typeof extract !== 'object' || Array.isArray(extract)) errors.push(vmsg(locale, fieldPrefix + 'Extract'))
+  }
+  const customBalance = candidate.customBalance
+  if (customBalance !== undefined) validateCustomBalanceEntry(customBalance, 'customBalance')
+  // 数组形态:上限 8 条(设置页逐条编辑,超出的截断并报错)。
+  const customBalances = candidate.customBalances
+  if (customBalances !== undefined) {
+    if (!Array.isArray(customBalances)) {
+      errors.push(vmsg(locale, 'customBalances'))
     } else {
-      if (typeof customBalance.enabled !== 'boolean') errors.push(vmsg(locale, 'customBalanceEnabled'))
-      if (!['sidebar', 'settings', 'both', 'off'].includes(customBalance.display)) errors.push(vmsg(locale, 'customBalanceDisplay'))
-      const refreshMinutes = Number(customBalance.refreshMinutes)
-      if (!Number.isInteger(refreshMinutes) || refreshMinutes < 1 || refreshMinutes > 1440) errors.push(vmsg(locale, 'customBalanceRefresh'))
-      else customBalance.refreshMinutes = refreshMinutes
-      if (typeof customBalance.label !== 'string') errors.push(vmsg(locale, 'customBalanceLabel'))
-      if (customBalance.labelEn !== undefined && typeof customBalance.labelEn !== 'string') errors.push(vmsg(locale, 'customBalanceLabelEn'))
-      if (customBalance.unit !== undefined && !['USD', 'CNY', 'EUR'].includes(customBalance.unit)) errors.push(vmsg(locale, 'customBalanceUnit'))
-      const request = customBalance.request
-      // url 仅在启用时必填:默认禁用状态下不能阻断其它配置项的保存。
-      if (request === null || typeof request !== 'object' || Array.isArray(request) || typeof request.url !== 'string' || (customBalance.enabled === true && request.url.length === 0)) {
-        errors.push(vmsg(locale, 'customBalanceRequest'))
-      } else if (request.headers !== undefined && (request.headers === null || typeof request.headers !== 'object' || Array.isArray(request.headers)
-        || Object.values(request.headers).some(value => typeof value !== 'string'))) {
-        // 值非字符串会击穿 typert strict configSchema(z.record(string, string)),导致整个 getState 被拒。
-        errors.push(vmsg(locale, 'customBalanceHeaders'))
-      }
-      const extract = customBalance.extract
-      if (extract === null || typeof extract !== 'object' || Array.isArray(extract)) errors.push(vmsg(locale, 'customBalanceExtract'))
+      if (customBalances.length > 8) errors.push(vmsg(locale, 'customBalancesTooMany'))
+      customBalances.slice(0, 8).forEach(entry => validateCustomBalanceEntry(entry, 'customBalance'))
     }
   }
   // OpenCode Go 订阅额度显示校验。
@@ -1239,37 +1259,61 @@ export function sanitizeConfig(raw) {
   goQuota.main = oneOf(goQuota.main, ['rolling', 'weekly', 'monthly'], 'rolling')
   goQuota.detail = goQuota.detail !== false
   const customBalance = out.customBalance ?? base.customBalance
-  customBalance.enabled = customBalance.enabled === true
-  customBalance.display = oneOf(customBalance.display, ['sidebar', 'settings', 'both', 'off'], 'both')
-  customBalance.refreshMinutes = Math.min(1440, Math.max(1, Math.floor(Number(customBalance.refreshMinutes) || 15)))
-  customBalance.label = typeof customBalance.label === 'string' ? customBalance.label : base.customBalance.label
-  customBalance.labelEn = typeof customBalance.labelEn === 'string' ? customBalance.labelEn : base.customBalance.labelEn
-  customBalance.unit = oneOf(customBalance.unit, ['USD', 'CNY', 'EUR'], base.customBalance.unit)
-  if (customBalance.request === null || typeof customBalance.request !== 'object' || Array.isArray(customBalance.request)) {
-    customBalance.request = { ...base.customBalance.request }
-  } else {
-    // 加载边界清洗:url/method 回落字符串,headers 只保留字符串→字符串(手改账本防击穿 strict codec)。
-    const cleanedHeaders = {}
-    for (const [key, value] of Object.entries(customBalance.request.headers ?? {})) {
-      if (typeof key === 'string' && typeof value === 'string') cleanedHeaders[key] = value
+  // 单条收敛(旧 customBalance 形态,加载/补丁均经此处;字段口径与数组条目一致)。
+  const sanitizeCustomEntry = (raw, baseEntry) => {
+    const entry = raw ?? {}
+    const clean = {
+      enabled: entry.enabled === true,
+      display: oneOf(entry.display, ['sidebar', 'settings', 'both', 'off'], 'both'),
+      refreshMinutes: Math.min(1440, Math.max(1, Math.floor(Number(entry.refreshMinutes) || 15))),
+      label: typeof entry.label === 'string' ? entry.label : baseEntry.label,
+      labelEn: typeof entry.labelEn === 'string' ? entry.labelEn : baseEntry.labelEn,
+      unit: oneOf(entry.unit, ['USD', 'CNY', 'EUR'], baseEntry.unit),
     }
-    customBalance.request = {
-      ...base.customBalance.request,
-      ...customBalance.request,
-      url: typeof customBalance.request.url === 'string' ? customBalance.request.url : '',
-      method: typeof customBalance.request.method === 'string' ? customBalance.request.method : 'GET',
-      headers: {
-        ...(base.customBalance.request?.headers ?? {}),
-        ...cleanedHeaders,
-      },
+    if (entry.request === null || typeof entry.request !== 'object' || Array.isArray(entry.request)) {
+      clean.request = { ...baseEntry.request }
+    } else {
+      // 加载边界清洗:url/method 回落字符串,headers 只保留字符串→字符串(手改账本防击穿 strict codec)。
+      const cleanedHeaders = {}
+      for (const [key, value] of Object.entries(entry.request.headers ?? {})) {
+        if (typeof key === 'string' && typeof value === 'string') cleanedHeaders[key] = value
+      }
+      clean.request = {
+        ...baseEntry.request,
+        ...entry.request,
+        url: typeof entry.request.url === 'string' ? entry.request.url : '',
+        method: typeof entry.request.method === 'string' ? entry.request.method : 'GET',
+        headers: {
+          ...(baseEntry.request?.headers ?? {}),
+          ...cleanedHeaders,
+        },
+      }
     }
-  }
-  if (customBalance.extract === null || typeof customBalance.extract !== 'object' || Array.isArray(customBalance.extract)) {
-    customBalance.extract = { ...base.customBalance.extract }
-  } else {
-    customBalance.extract = { ...base.customBalance.extract, ...customBalance.extract }
-  }
-  out.customBalance = customBalance
+    if (entry.extract === null || typeof entry.extract !== 'object' || Array.isArray(entry.extract)) {
+      clean.extract = { ...baseEntry.extract }
+    } else {
+      clean.extract = { ...baseEntry.extract, ...entry.extract }
+    }
+    // 凭据外带白名单(v1.6.8)随行:字符串数组,仅保留非空串。
+    if (Array.isArray(entry.allowedHosts)) {
+      const hosts = entry.allowedHosts.filter(h => typeof h === 'string' && h.length > 0)
+      if (hosts.length > 0) clean.allowedHosts = hosts
+    }
+    return clean
+  }
+  const sanitizedSingle = sanitizeCustomEntry(customBalance, base.customBalance)
+  out.customBalance = sanitizedSingle
+  // 多配置形态(v1.7.0,issue #79):数组为运行期真源。旧单配置有实际内容
+  // (启用或配置过 URL)时自动迁移为 entries[0],保证升级无缝;数组缺席/非法
+  // 时回落「单条迁移结果」;上限 8 条。
+  let rawEntries = out.customBalances
+  if (!Array.isArray(rawEntries)) rawEntries = []
+  const baseEntry = base.customBalances?.[0] ?? base.customBalance
+  const entries = rawEntries.slice(0, 8).map(raw => sanitizeCustomEntry(raw, baseEntry))
+  const legacyHasContent = sanitizedSingle.enabled === true
+    || (typeof sanitizedSingle.request?.url === 'string' && sanitizedSingle.request.url.length > 0)
+  if (entries.length === 0 && legacyHasContent) entries.push(sanitizedSingle)
+  out.customBalances = entries
   const corner = out.corner
   for (const key of ['enabled', 'goRolling', 'goWeekly', 'goMonthly', 'budget']) corner[key] = corner[key] === true || (corner[key] !== false && key !== 'enabled')
   // 输入框上方额度横条:enabled/promptSeen 缺省 false,budget/go/plans 缺省 true。

package/lib/typert.host.js

@@ -197,7 +197,26 @@ const configSchema = z.object({
       body: z.unknown().optional(),
     }),
     extract: z.record(z.string(), z.unknown()),
+    allowedHosts: z.array(z.string()).optional(),
   }).optional(),
+  // 多配置形态(v1.7.0,issue #79):自定义 Provider 余额多条并行,数组为运行期
+  // 真源;customBalance 单配置键仅为旧客户端兼容保留(= entries[0] 的镜像)。
+  customBalances: z.array(z.object({
+    enabled: z.boolean(),
+    label: z.string(),
+    labelEn: z.string().optional(),
+    display: z.enum(['sidebar', 'settings', 'both', 'off']),
+    unit: z.enum(['USD', 'CNY', 'EUR']).optional(),
+    refreshMinutes: num,
+    request: z.object({
+      url: z.string(),
+      method: z.string().optional(),
+      headers: z.record(z.string(), z.string()).optional(),
+      body: z.unknown().optional(),
+    }),
+    extract: z.record(z.string(), z.unknown()),
+    allowedHosts: z.array(z.string()).optional(),
+  })).optional(),
   corner: z.object({
     enabled: z.boolean(),
     goRolling: z.boolean(),
@@ -265,6 +284,9 @@ const customBalanceSchema = z.object({
   remaining: num,
   maxBudget: z.union([num, z.null()]),
   spend: z.union([num, z.null()]),
+  // 条目索引(v1.7.0,issue #79):多配置形态下每条快照自带其在
+  // config.customBalances 中的下标,客户端据此定位刷新按钮对应的条目。
+  index: num.optional(),
 })
 
 // Coding plan 额度状态条目(运行时合并配置与查询结果;windows 为各用量窗口)。
@@ -336,6 +358,9 @@ export const stateSchema = z.object({
   goQuota: goQuotaSchema,
   // optional:兼容旧快照/降级路径(与 codingPlans/priceCatalog 同策略,避免 strict codec 击穿)。
   customBalance: customBalanceSchema.optional(),
+  // 多配置形态(v1.7.0,issue #79):每条独立快照;customBalance 单条键为
+  // 旧客户端兼容镜像(= 第一条 sidebar 可见条目或 entries[0])。
+  customBalances: z.array(customBalanceSchema).optional(),
   // 余额差交叉校验提示(issue #18):旧快照无此字段,optional 防击穿。
   reconcile: z.object({ ok: z.boolean(), message: z.string() }).optional(),
   codingPlans: z.record(z.string(), codingPlanSchema),
@@ -437,7 +462,18 @@ export const TYPERT = {
       namespace: 'costMeter',
       method: 'refreshCustomBalance',
       invocation: { kind: 'direct' },
-      parameters: [],
+      // index(v1.7.0,issue #79):多配置形态下指定刷新的条目下标;缺省 = 全部刷新。
+      // acceptsUndefined(v1.7.1):网关按「期望 wire 字段是否在 args 中」判缺失——
+      // 无此标志的 json 参数缺省会以 arguments-invalid 拒绝调用;标志允许旧客户端
+      // 的无参调用(等价全量刷新)继续走通。codec 必须是 strict 对象(裸 zod schema
+      // 会被 typert-loader 以「parameter codec must use a strict codec」拒绝注册,
+      // v1.7.0 因此无法启动宿主——本版回归)。
+      parameters: [
+        {
+          name: 'index', wire: 'index', source: 'json', acceptsUndefined: true,
+          codec: { mode: 'strict', typeSymbol: 'dsh-cost-meter#CustomBalanceIndex', schema: z.number().int().min(0).max(7).optional() },
+        },
+      ],
       result: _fetch$codec,
     },
     {
@@ -571,9 +607,9 @@ export const TYPERT = {
           {
             kind: 'method',
             name: 'refreshCustomBalance',
-            signature: 'refreshCustomBalance(): Promise<FetchPricesResult>',
-            summary: '立即查询自定义 Provider 余额。Query the configured custom provider balance immediately.',
-            jsDoc: '/**\n * 立即查询自定义 Provider 余额(可配置 HTTP 请求 + extract 规则)。\n * @returns 查询结果与最新快照。\n * Query the configured custom provider balance immediately (configurable HTTP request + extract rules).\n * @returns The query result and the latest snapshot.\n */',
+            signature: 'refreshCustomBalance(index?: number): Promise<FetchPricesResult>',
+            summary: '立即查询自定义 Provider 余额(可指定条目)。Query custom provider balances immediately (optionally one entry).',
+            jsDoc: '/**\n * 立即查询自定义 Provider 余额(可配置 HTTP 请求 + extract 规则)。\n * @param index - 可选:多配置形态下要刷新的条目下标(0-7);缺省刷新全部条目。\n * @returns 查询结果与最新快照。\n * Query custom provider balances immediately (configurable HTTP request + extract rules).\n * @param index - Optional: entry index (0-7) to refresh in the multi-entry form; omit to refresh all.\n * @returns The query result and the latest snapshot.\n */',
           },
           {
             kind: 'method',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-cost-meter",
-  "version": "1.6.13",
+  "version": "1.7.1",
   "description": "DeepSeek Harness 会话费用统计插件:本会话成本、当日费用、历史记录与官方价格同步,支持多厂商多模型价格计费(内置 90+ 模型价格目录与自动匹配)、主流 Coding Plan 订阅额度查询与显示(9 家,含 SCNet Token Plan 本地 Credits 计量与火山方舟 Volcano Ark Coding Plan AK/SK 签名查询)、自定义 Provider 余额查询(可配任意 HTTP 端点)与余额进度条、峰谷计价时段显示与切换前弹窗/系统通知提醒(位置/提前量/类型可配),界面中英双语。Session cost tracking plugin for DeepSeek Harness: per-conversation cost, daily totals, history and official price sync, with multi-vendor model pricing (built-in 90+ model catalog with auto-matching), Coding Plan quota queries & display for 9 vendors (incl. local credits metering for the SCNet Token Plan and Volcano Ark Coding Plan via AK/SK signature), plan/API dual-track billing with per-1% & full-window Token Plan usage estimates, custom provider balance lookup (configurable HTTP endpoint) and balance progress bar, plus peak/off-peak pricing display with pre-switch popup & system-notification alerts (position / lead time / type configurable), in a bilingual (Chinese/English) UI.",
   "type": "module",
   "main": "lib/index.js",