@feiyang666/dsh-usage-plugin 1.12.2 → 1.13.0

package/README.zh.md

@@ -36,11 +36,12 @@ dsh-usage-plugin 是 DeepSeek Harness 生态的**用量与消耗统计插件**
 - **用量日历**：按月查看每日用量热力图（按消耗或调用数着色），悬停查看详情（含高峰 / 空闲消耗拆分）、点击某天查看当日调用明细与高峰/空闲消耗统计，附本月每日统计表（高峰消耗 / 空闲消耗 / 总消耗分列）与月度汇总。
 - **缓存命中列表**：最新记录排在最前，支持 今天 / 近7天 / 近30天 / 全部 快捷筛选与自定义起止日期区间，汇总行与表尾合计区分高峰消耗 / 空闲消耗 / 总费用合计；列表分页渲染（每页 100 条），记录量大也不卡顿。
 - **价格表**：**DeepSeek 官方 API 价格表**（覆盖官方模型 `deepseek-v4-flash` / `deepseek-v4-flash-vision-exp` / `deepseek-v4-pro`），展示基础价与峰谷价（高峰/空闲）单价表，高峰价与空闲价分列展示，支持在面板内直接编辑价格并持久化（数据目录 `pricing.json`），也可一键恢复默认。
-- **剩余余额查询**：用当前配置的 `DEEPSEEK_API_KEY` 查询 DeepSeek 账户余额。
+- **剩余余额查询**：用当前配置的 `DEEPSEEK_API_KEY` 查询 DeepSeek 账户余额；并支持 **百炼 Token Plan 配额查询**（复用 `bl auth login --console` 的控制台 OAuth token，无需阿里云 AccessKey，展示本周配额已用百分比与重置时间）。
 - **导出**：CSV / JSON / **PNG 长图**（按最新在前展示，最多含最近 2000 条，超出会提示；PNG 报告含高峰 / 空闲消耗分列统计），可导出到任意目录（原生目录选择器），导出后自动打开所在目录。
 - **导入**：选择文件（JSON / CSV）合并导入，按时间去重。
 - **持久化**：记录实时落盘到**固定专用数据目录**（如 `%LOCALAPPDATA%\dsh-usage-plugin\dsh-usage\usage-records.json`，详见下文「数据目录」），与当前工作区无关，重启自动恢复（上限 100000 条，尽量多存）。
 - **界面适配**：面板字号跟随应用「显示大小」设置自动缩放（em 相对字号），面板宽度以视口封顶、宽表格在容器内横向滑动（max-content + overflow-x），任何窗口大小下所有列与合计都完整可见，不会裁掉右侧内容。
+- **英文界面（i18n）**：面板按浏览器语言自动选择界面语言（中文浏览器保持中文，其他默认英文）；「用量与消耗」头部新增切换按钮，点击即时生效，选择保存在 `localStorage`（键 `dsh-usage-lang`）。面板内容即时切换；外部「会话 / 设置」标签页名在启动时注册一次，页面刷新后更新为新语言。
 
 ---
 
@@ -299,6 +300,8 @@ pnpm dsh web
 
 ## 致谢
 
+- **[@ayleen](https://github.com/ayleen)**：为 Web 面板实现完整的英文界面（i18n 层）与响应式语言切换，余额查询改为语义化字段（[#7](https://github.com/feiyang-dev/dsh-usage-plugin/pull/7)）。
+- **[@wuhuqif176](https://github.com/wuhuqif176)**：在「剩余余额查询」中新增百炼（Qwen）Token Plan 配额查询（[#8](https://github.com/feiyang-dev/dsh-usage-plugin/pull/8)）。
 - **[@Martin-soaring-dev](https://github.com/Martin-soaring-dev)**：筹备了插件开源贡献（打包、插件契约校验、文档与 CI），并提交贡献分支，成为后续开源版本的基础（[#6](https://github.com/feiyang-dev/dsh-usage-plugin/pull/6)）。
 - **[@mumuer1024](https://github.com/mumuer1024)**：报告并定位了持久化路径随会话工作区漂移导致历史数据"消失/统计为 0"的问题，提出把数据写到固定专用目录的方案（[#4](https://github.com/feiyang-dev/dsh-usage-plugin/issues/4)）。
 - **[@liu3734](https://github.com/liu3734)**：报告并定位 macOS（POSIX）下路径处理与 spawn 的 Windows 专用问题，提出跨平台修复方案（[#1](https://github.com/feiyang-dev/dsh-usage-plugin/issues/1)）。

package/lib/balance.js

@@ -4,7 +4,7 @@ const PROVIDERS = {
     name: 'DeepSeek',
     credentialNames: ['DEEPSEEK_API_KEY'],
     endpoint: 'https://api.deepseek.com/user/balance',
-    credentialHint: 'DEEPSEEK_API_KEY（推理 Key）',
+    credentialHintKey: 'hint.deepseek',
     queryMode: 'direct',
     modelProviderAliases: ['deepseek']
   },
@@ -13,7 +13,7 @@ const PROVIDERS = {
     name: 'SiliconFlow',
     credentialNames: [],
     endpoint: 'https://api.siliconflow.cn/v1/user/info',
-    credentialHint: '模型设置中名为 siliconflow 的提供商所引用的 API Key',
+    credentialHintKey: 'hint.siliconflow',
     queryMode: 'direct',
     modelProviderAliases: ['siliconflow', 'silicon-flow'],
     credentialHelpUrl: 'https://cloud.siliconflow.cn/account/ak'
@@ -23,7 +23,7 @@ const PROVIDERS = {
     name: 'DigitalOcean',
     credentialNames: ['DIGITALOCEAN_TOKEN', 'DIGITALOCEAN_ACCESS_TOKEN'],
     endpoint: 'https://api.digitalocean.com/v2/customers/my/balance',
-    credentialHint: 'DIGITALOCEAN_TOKEN（账户级 Personal Access Token，不是 DO AI 推理 Key）',
+    credentialHintKey: 'hint.digitalocean',
     queryMode: 'account',
     modelProviderAliases: ['digitalocean', 'digital-ocean'],
     credentialHelpUrl: 'https://cloud.digitalocean.com/account/api/tokens'
@@ -33,10 +33,20 @@ const PROVIDERS = {
     name: 'AMD GPU Cloud',
     credentialNames: [],
     endpoint: '',
-    credentialHint: 'AMD GPU Cloud 当前未公开余额查询端点',
+    credentialHintKey: 'hint.amd',
     queryMode: 'unsupported',
     modelProviderAliases: ['amd', 'amd-gpu-cloud'],
     credentialHelpUrl: 'https://www.amd.com/en/developer/resources/cloud-access/amd-developer-cloud.html'
+  },
+  'qwen-token-plan': {
+    id: 'qwen-token-plan',
+    name: '百炼 Token Plan',
+    credentialNames: ['BAILIAN_CONSOLE_TOKEN'],
+    endpoint: '',
+    credentialHint: '百炼控制台 OAuth 登录 token（~/.bailian/config.json 的 access_token，用 bl auth login --console 生成）',
+    queryMode: 'console-token',
+    modelProviderAliases: ['aliyun', 'qwen', 'bailian', 'token-plan', '百炼', '阿里云百炼'],
+    credentialHelpUrl: 'https://bailian.console.aliyun.com/cli'
   }
 }
 
@@ -46,7 +56,7 @@ export function providerList() {
   return Object.values(PROVIDERS).map((p) => ({
     id: p.id,
     name: p.name,
-    credentialHint: p.credentialHint,
+    credentialHintKey: p.credentialHintKey,
     queryMode: p.queryMode,
     credentialHelpUrl: p.credentialHelpUrl || ''
   }))
@@ -56,6 +66,16 @@ export function getBalanceProvider(id) {
   return PROVIDERS[String(id || 'deepseek').toLowerCase()] || null
 }
 
+export function missingCredentialError(provider) {
+  const names = ((provider && provider.credentialNames) || []).join(' / ')
+  const subject = names || ((provider && provider.name) || 'provider')
+  return {
+    ok: false,
+    errorCode: 'missing-credential',
+    error: '未找到 ' + subject + '，请配置后重试'
+  }
+}
+
 function normalizedRoute(value) {
   return String(value || '').toLowerCase().replace(/[^a-z0-9]/g, '')
 }
@@ -130,10 +150,10 @@ function parseDeepSeek(provider, data) {
     totalBalance: legacyInfo.totalBalance,
     infos: [legacyInfo],
     details: [
-      { label: '充值余额', value: legacyInfo.toppedUpBalance, hint: '实际充值' },
-      { label: '赠送余额', value: legacyInfo.grantedBalance, hint: '平台赠送' }
+      { labelKey: 'toppedUp', value: legacyInfo.toppedUpBalance, hintKey: 'actualTopUp' },
+      { labelKey: 'granted', value: legacyInfo.grantedBalance, hintKey: 'platformGift' }
     ],
-    sourceNote: '数据来自 DeepSeek 官方 /user/balance 接口。'
+    sourceNoteKey: 'note.deepseek'
   })
 }
 
@@ -156,15 +176,94 @@ function parseSiliconFlow(provider, data) {
     totalBalance: money(computed),
     zeroBalance: numeric.every((entry) => Number.isFinite(entry) && entry === 0),
     details: [
-      { label: '充值余额', value: money(charged), hint: 'chargeBalance · 用户充值余额' },
-      { label: '赠送/旧免费余额', value: money(granted), hint: 'balance · 旧版赠送余额字段' }
+      { labelKey: 'toppedUp', value: money(charged), hintKey: 'field.chargeBalance' },
+      { labelKey: 'grantedLegacy', value: money(granted), hintKey: 'field.balance' }
     ],
     fieldDefinitions: [
-      { name: 'totalBalance', meaning: '公开 API 返回的总余额，通常为 balance 与 chargeBalance 的合计' },
-      { name: 'chargeBalance', meaning: '用户充值形成的余额' },
-      { name: 'balance', meaning: '赠送或旧版免费余额字段' }
+      { name: 'totalBalance', meaningKey: 'meaning.totalBalance' },
+      { name: 'chargeBalance', meaningKey: 'meaning.chargeBalance' },
+      { name: 'balance', meaningKey: 'meaning.balance' }
     ],
-    sourceNote: '数据来自 SiliconFlow 官方 /v1/user/info 接口；该接口未公开代金券或历史用量字段，数值可能与控制台可用总额不同。'
+    sourceNoteKey: 'note.siliconflow'
+  })
+}
+
+function fmtPct(value) {
+  const n = Number(value)
+  if (!Number.isFinite(n)) return null
+  const t = Math.round(n * 1000) / 10
+  return (Number.isInteger(t) ? String(t) : t.toFixed(1)) + '%'
+}
+
+function fmtResetEpoch(epochMs) {
+  const n = Number(epochMs)
+  if (!Number.isFinite(n) || n <= 0) return null
+  const d = new Date(n + 8 * 3600 * 1000)
+  const pad = (x) => (x < 10 ? '0' : '') + x
+  const local = d.getUTCFullYear() + '-' + pad(d.getUTCMonth() + 1) + '-' + pad(d.getUTCDate()) + ' ' + pad(d.getUTCHours()) + ':' + pad(d.getUTCMinutes()) + ':' + pad(d.getUTCSeconds())
+  let diff = Math.max(0, n - Date.now())
+  const minutes = Math.floor(diff / 60000)
+  const days = Math.floor(minutes / 1440)
+  const hours = Math.floor((minutes % 1440) / 60)
+  const mins = minutes % 60
+  let rel
+  if (minutes <= 0) rel = 'now'
+  else {
+    const parts = []
+    if (days) parts.push(days + 'd')
+    if (hours) parts.push(hours + 'h')
+    if (mins) parts.push(mins + 'm')
+    rel = parts.join(' ') || 'now'
+  }
+  return local + '（' + rel + '）'
+}
+
+function parseQwenTokenPlan(provider, data) {
+  // 百炼 Token Plan 只有 1 周配额（无 5 小时配额）：
+  //   per1WeekPercentage  0~1 的已用比例
+  //   per1WeekResetTime   毫秒时间戳，即本周配额重置（结束）时间
+  const hasPct = data && data.per1WeekPercentage != null
+  const hasEnd = data && data.per1WeekResetTime != null
+  if (!hasPct && !hasEnd) return fail('百炼 Token Plan 响应中没有可识别的配额字段')
+
+  // 进度条需要 0~1 的数值
+  const ratio = Number(data.per1WeekPercentage)
+  const ratioNum = Number.isFinite(ratio) ? Math.min(Math.max(ratio, 0), 1) : null
+  const usedPct = ratioNum != null ? fmtPct(ratioNum) : null
+
+  // 结束（重置）时间 -> 开始时间 = 结束 - 整周
+  let weekEnd = null
+  let weekStart = null
+  if (data.per1WeekResetTime != null) {
+    const endNum = Number(data.per1WeekResetTime)
+    if (Number.isFinite(endNum) && endNum > 0) {
+      weekEnd = endNum
+      weekStart = endNum - 7 * 24 * 3600 * 1000
+    }
+  }
+
+  const formatDate = (ms) => {
+    if (!Number.isFinite(ms)) return null
+    const d = new Date(ms + 8 * 3600 * 1000)
+    const pad = (x) => (x < 10 ? '0' : '') + x
+    return d.getUTCFullYear() + '-' + pad(d.getUTCMonth() + 1) + '-' + pad(d.getUTCDate())
+  }
+
+  return result(provider, {
+    currency: '',
+    isAvailable: null,
+    totalBalance: usedPct || '暂无信息',
+    balanceLabel: '百炼 Token Plan 配额用量',
+    kind: 'quota-usage',          // 标记为配额进度类，非货币余额
+    qwenQuota: {
+      ratio: ratioNum,            // 0~1 已用比例（进度条用）
+      usedPercent: usedPct,       // 如 "39.7%"
+      weekStart: formatDate(weekStart),  // "2026-08-21"
+      weekEnd: formatDate(weekEnd),      // "2026-08-28"
+      ratioLabel: usedPct ? '已用 ' + usedPct : '暂无信息'
+    },
+    details: [],
+    sourceNote: '数据来自阿里云百炼控制台内部门户网关（zeldaHttp.apikeyMgr./tokenplan/personal/api/v2/usage），展示的是 1 周配额已用进度与周期。'
   })
 }
 
@@ -181,15 +280,15 @@ function parseDigitalOcean(provider, data) {
     isAvailable: null,
     totalBalance: money(credit > 0 ? credit : due),
     balanceKind,
-    balanceLabel: balanceKind === 'credit' ? '可用信用余额' : (balanceKind === 'due' ? '待结算账户余额' : '账户余额'),
+    balanceLabelKey: balanceKind === 'credit' ? 'bal.credit' : (balanceKind === 'due' ? 'bal.due' : 'bal.settled'),
     rawAccountBalance: money(account),
     monthToDateUsage: money(value(data, ['month_to_date_usage'])),
     monthToDateBalance: money(value(data, ['month_to_date_balance'])),
     details: [
-      { label: '本月至今使用', value: money(value(data, ['month_to_date_usage'])), hint: 'month_to_date_usage · 当前账期使用金额' }
+      { labelKey: 'monthToDateUsage', value: money(value(data, ['month_to_date_usage'])), hintKey: 'field.monthToDateUsage' }
     ],
     generatedAt: String(value(data, ['generated_at']) || ''),
-    sourceNote: '数据来自 DigitalOcean 账户级 Billing API；负数账户余额按可用信用额取绝对值展示，DO AI 推理 Key 不能用于此查询。'
+    sourceNoteKey: 'note.digitalocean'
   })
 }
 
@@ -201,5 +300,6 @@ export function parseBalanceResponse(providerId, text) {
   if (provider.id === 'deepseek') return parseDeepSeek(provider, data)
   if (provider.id === 'siliconflow') return parseSiliconFlow(provider, data)
   if (provider.id === 'digitalocean') return parseDigitalOcean(provider, data)
+  if (provider.id === 'qwen-token-plan') return parseQwenTokenPlan(provider, data)
   return fail(provider.name + ' 当前没有可用的公开余额查询接口')
 }