dsh-api-dashboard 1.0.0 → 1.0.2

package/README.md

@@ -5,7 +5,7 @@
 > [!CAUTION]
 > **给安装/维护本插件的 AI 代理的一则警告 —— 动手前必读 [`AGENTS.md`](AGENTS.md)。**
 >
-> 1. **安装请用「下载→解压→`dsh plugin add file:`」三步法**，`dsh plugin add dsh-api-dashboard`（裸包名）和 `pnpm add <远程tarball>` **都装不上**。
+> 1. **推荐安装方式**：`dsh plugin --profile web add dsh-api-dashboard`（已发布到 npm，一行命令搞定）。也可用「下载→解压→`dsh plugin add file:`」三步法。`pnpm add <远程tarball>` **装不上**。
 > 2. **数据准确性红线**：部分平台余额解析有待验证项（OpenRouter/SiliconFlow/Novita/one-api/xAI），且「限流窗口 ≠ 真实余额」——**不要伪造或硬塞一个数字**，查不到就如实显示「未开放」。
 > 3. **推送前先问用户**；改 `client/client.js` 后需**重启 dsh web GUI** 才生效。
 >
@@ -103,7 +103,7 @@ dsh plugin --profile web add file:/root/dsha-api-dashboard
 
 | 方式 | 结果 |
 |------|------|
-| `dsh plugin add dsh-api-dashboard`（裸包名） | ❌ 本插件未发布到 npm，pnpm 会报 404 |
+| `dsh plugin add dsh-api-dashboard`（裸包名） | ✅ 推荐！已发布到 npm，一行命令安装 |
 | `pnpm add <远程 tarball URL>` | ❌ pnpm 不剥离 codeload 压缩包的顶层目录，装出来是空壳 |
 | 手动软链 node_modules | ✅ 可用但繁琐，层级写错会被启动校准摘除，不推荐 |
 
@@ -186,6 +186,7 @@ v0.6.2 — 检查更新补全反馈：无论「已是最新」还是「有新版
 v0.7.0 — 玻璃 UI 改造（方案 A 第一阶段）：半屏抽屉玻璃拟态（blur 仅限抽屉主背景）、卡片/按钮/输入框半透明+高光、大圆角、输入框 focus 高光阴影；用 color-mix 让玻璃色跟随主题 token（暗色不发白）
 v0.7.1 — 修复负余额显示正常（负数→红）；智谱解析保留百分比（不把限流窗口当余额）；设置面板新增「返回」按钮与 IconBack；新增 AGENTS.md（给维护 AI 的必读须知）+ README 顶部 AI 警告块
 v1.0.0 — 正式版：插件改名「哦鲸鲸」+ 自定义图标（/api-dashboard/icon）；全量 UI 改版（固定色值去主题变量、三段式头部、卡片右栏上下结构、选中模型置顶、分组折叠、详情/设置/版本更新区重排）；若干样式补全与清理
+v1.0.2 — 余额解析稳健性（平台字段存在性校验，缺字段时如实显示「无法解析/未开放」而非误报 0）；智谱配额解析重写（按 `limits.unit` 区分 5 小时窗口、周配额、工具维度，`percentage` 修正为「已用/填充度」，不再把「已用完」误显示为「余额 100%」）；价格表更新（DeepSeek V4 新增 `deepseek-v4-flash-vision-exp`、`deepseek-chat/reasoner/r1` 标记为已退役；通用价格表新增现役主力 OpenAI GPT-5.6 / Claude 4.x / Gemini 3.x / Kimi K3 / StepFun 3.x，旧模型标为历史参考）；自更新下载包增加包名校验
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-api-dashboard",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "多平台 API 余额/用量看板插件：官方真实品牌图标，三层 UI 直接在输入框下方显示当前选中平台余额与估算消耗，点开底部抽屉切换所有平台；支持国内外平台与自定义中转站自动探测余额（查不到标未开放）；自定义安全/预警阈值，余额告警提醒；进入页面自动刷新",
   "keywords": [
     "dsh",
@@ -46,13 +46,11 @@
       ]
     }
   },
-  "dependencies": {
-    "@deepseek-ai/schemastery": "^3.18.1",
-    "zod": "^4.4.3"
-  },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-credentials": "^0.1.0-rc.6"
+    "@deepseek-ai/dsh-credentials": "^0.1.0-rc.6",
+    "@deepseek-ai/schemastery": "^3.18.1",
+    "zod": "^4.4.3"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/cordis": {
@@ -60,6 +58,12 @@
     },
     "@deepseek-ai/dsh-credentials": {
       "optional": true
+    },
+    "@deepseek-ai/schemastery": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
     }
   },
   "license": "MIT"

package/src/index.js

@@ -123,8 +123,11 @@ export async function applyUpdate({ targets = null, timeoutMs = 30000, remoteVer
     // 2) 解压 (--strip-components=1 剥离 codeload 顶层目录)
     mkdirSync(extractDir, { recursive: true })
     execFileSync('tar', ['xzf', tgzPath, '-C', extractDir, '--strip-components=1'], { timeout: 20000 })
-    // 3) 校验: 版本号匹配预期 + 关键文件齐全 (装坏了宁可拒绝, 保住回滚机会)
+    // 3) 校验: 版本号匹配预期 + 关键文件齐全 + 包名一致 (装坏了宁可拒绝, 保住回滚机会)
     if (readVersionAt(extractDir) !== wantVersion) throw new Error('extracted version mismatch')
+    let extractedName = null
+    try { extractedName = JSON.parse(readFileSync(join(extractDir, 'package.json'), 'utf8')).name } catch { /* 忽略 */ }
+    if (extractedName !== 'dsh-api-dashboard') throw new Error('extracted package name mismatch')
     for (const rel of ['src/index.js', 'client/client.js', 'cordis.patch.yml']) {
       if (!existsSync(join(extractDir, rel))) throw new Error(`missing file after extract: ${rel}`)
     }
@@ -261,12 +264,37 @@ export const isWeekend = (timestamp = Date.now()) => {
 
 
 // ============================================================
-// 通用模型价格表 (CNY, 每百万token)
-// 用于 balanceCost 投影中非 DeepSeek 模型的计费估算.
-// 来源: 各平台官方定价 (2025-08), 仅做参考, 实际以平台为准.
+// 通用模型价格表 — 每百万token, 币种按各平台官方数字直接填入(多为 USD, 本表不做 CNY 换算,
+// 仅用于 balanceCost 投影中非 DeepSeek 模型的"估算", 不保证精确).
+// ⚠️ DeepSeek 计费请走上面 V4_RATES 峰谷 CNY 表(官方价, 准确); 本通用表覆盖 OpenAI/Claude/Gemini/国产等。
+// 来源: ① 现役主力(2026-08) 来自 NousResearch hermes-agent usage_pricing.py(追踪各官方文档, 逐条注明 source_url);
+//       ② 旧模型(2025-08) 为历史参考价. 仅做参考, 实际以平台为准.
 // ============================================================
 export const MODEL_PRICES = {
-  // OpenAI
+  // —— 现役主力 (2026-08, USD/百万tokens, 来源: hermes-agent 追踪官方文档) ——
+  // OpenAI GPT-5.6 系列
+  'gpt-5.6-sol':          { cacheHit: 0.50,  cacheMiss: 5.00,  output: 30.00 },
+  'gpt-5.6-terra':        { cacheHit: 0.25,  cacheMiss: 2.50,  output: 15.00 },
+  'gpt-5.6-luna':         { cacheHit: 0.10,  cacheMiss: 1.00,  output: 6.00 },
+  // Anthropic Claude 4.x / 5
+  'claude-opus-4-8':      { cacheHit: 0.50,  cacheMiss: 5.00,  output: 25.00 },
+  'claude-sonnet-5':      { cacheHit: 0.20,  cacheMiss: 2.00,  output: 10.00 },
+  'claude-sonnet-4-6':    { cacheHit: 0.30,  cacheMiss: 3.00,  output: 15.00 },
+  'claude-haiku-4-5':     { cacheHit: 0.10,  cacheMiss: 1.00,  output: 5.00 },
+  // Google Gemini 3.x
+  'gemini-3.6-flash':     { cacheHit: 0.15,  cacheMiss: 1.50,  output: 7.50 },
+  'gemini-3.5-flash':     { cacheHit: 0.15,  cacheMiss: 1.50,  output: 9.00 },
+  'gemini-3.1-pro':       { cacheHit: 0.20,  cacheMiss: 2.00,  output: 12.00 },
+  'gemini-2.5-pro':       { cacheHit: 0.125, cacheMiss: 1.25,  output: 10.00 },
+  // —— 国产主力 (2026-08) ——
+  // Kimi K3 (来源: benchlm.ai / morphllm.com 2026-08, 输入/输出 $3/$15; 缓存折扣未取到 → 暂按无折扣)
+  'kimi-k3':           { cacheHit: 3.00,  cacheMiss: 3.00,  output: 15.00 },
+  // 阶跃星辰 (来源: platform.stepfun.com 官方定价 2026; 列序=输入/缓存命中/输出, CNY1M)
+  'step-3.7-flash':    { cacheHit: 0.27,  cacheMiss: 1.35,  output: 8.10 },
+  'step-3.5-flash':    { cacheHit: 0.14,  cacheMiss: 0.70,  output: 2.10 },
+  // ⚠️ 通义 Qwen3 / 智谱 GLM-5 的现役官方一手价未取到可信数字, 不虚构; 遇到这些模型会落 defaultPrices(未定价),
+  //    旧 qwen-*/glm-4 条目仍在下方作历史参考.
+  // —— 以下为历史/参考模型 (2025-08, 实际以平台为准) ——
   'gpt-4o':               { cacheHit: 1.25,  cacheMiss: 2.5,  output: 10 },
   'gpt-4o-mini':          { cacheHit: 0.075, cacheMiss: 0.15, output: 0.6 },
   'gpt-4-turbo':          { cacheHit: 5,     cacheMiss: 10,   output: 30 },
@@ -282,7 +310,9 @@ export const MODEL_PRICES = {
   'gemini-2.0-flash':     { cacheHit: 0.05,  cacheMiss: 0.1,  output: 0.4 },
   'gemini-2.0-pro':       { cacheHit: 1.25,  cacheMiss: 2.5,  output: 10 },
   'gemini-1.5-pro':       { cacheHit: 1.75,  cacheMiss: 3.5,  output: 10.5 },
-  // DeepSeek (标准价兜底)
+  // DeepSeek (标准价兜底) — ⚠️ 2026-07-24 起 deepseek-chat / deepseek-reasoner / deepseek-r1 已 RETIRED,
+  // 官方 API 调用会直接报错(不再重定向到 V4)。现役仅 deepseek-v4-flash / deepseek-v4-pro / deepseek-v4-flash-vision-exp。
+  // 保留这三条仅作为「若仍在用的旧配置」的估算占位, 真实计费请走上面 V4 峰谷表。
   'deepseek-chat':        { cacheHit: 0.1,   cacheMiss: 1,    output: 2 },
   'deepseek-reasoner':    { cacheHit: 0.2,   cacheMiss: 2,    output: 8 },
   'deepseek-r1':          { cacheHit: 0.2,   cacheMiss: 2,    output: 8 },
@@ -462,7 +492,8 @@ function checkAlerts(balances, config, ctx) {
 // 余额解析适配器
 // ============================================================
 
-function parseResponse(queryType, json) {
+// 纯函数, 导出便于单测 (不影响对外行为)
+export function parseResponse(queryType, json) {
   switch (queryType) {
     case 'deepseek': {
       const infos = Array.isArray(json?.balance_infos) ? json.balance_infos : []
@@ -488,12 +519,17 @@ function parseResponse(queryType, json) {
     case 'siliconflow': {
       const d = json?.data
       if (!d) return null
-      return { total: toAmount(d.totalBalance), currency: 'CNY', available: null, used: null, note: '硅基流动总余额' }
+      // 数据红线: totalBalance 字段名/单位未实测, 缺字段即放弃, 不造假 0。
+      if (d.totalBalance == null) return null
+      return { total: toAmount(d.totalBalance), currency: 'CNY', available: null, used: null, note: '硅基流动总余额(字段待实测)' }
     }
     case 'openrouter': {
       const d = json?.data
       if (!d) return null
-      return { total: toAmount(d.total_credits) - toAmount(d.total_usage), currency: 'USD', available: toAmount(d.total_credits), used: toAmount(d.total_usage), note: 'OpenRouter 余额' }
+      // 数据红线: total_credits / total_usage 字段名未用真实 key 实测, 可能不叫这个名。
+      // 若两个预期字段都缺失 → 视为解析失败(返回 null, 前端标"无法解析/未开放"), 绝不显示假"余额0"。
+      if (d.total_credits == null && d.total_usage == null) return null
+      return { total: toAmount(d.total_credits) - toAmount(d.total_usage), currency: 'USD', available: toAmount(d.total_credits), used: toAmount(d.total_usage), note: 'OpenRouter 余额(字段待实测)' }
     }
     case 'novita': {
       if (!json || !('availableBalance' in json)) return null
@@ -501,14 +537,15 @@ function parseResponse(queryType, json) {
       return { total: raw / 10000, currency: 'USD', available: null, used: null, note: 'Novita (0.0001单位)' }
     }
     case 'stepfun': {
-      if (!json || !('balance' in json)) return null
-      const b = toAmount(json?.balance)
-      return { total: b, currency: 'CNY', available: null, used: null, note: '阶梯星辰余额' }
+      if (!json || json.balance == null) return null
+      const b = toAmount(json.balance)
+      return { total: b, currency: 'CNY', available: null, used: null, note: '阶跃星辰余额' }
     }
     case 'quota': {
-      const quota = toAmount(json?.data?.quota)
-      if (quota === 0 && !json?.data?.username) return null
-      return { total: quota / 500000, currency: 'USD', available: null, used: null, note: 'one-api quota (÷500000)' }
+      const q = json?.data
+      if (!q || (q.quota == null && q.username == null)) return null
+      const quota = toAmount(q.quota)
+      return { total: quota / 500000, currency: 'USD', available: null, used: null, note: 'one-api quota (÷500000, 系数待实测)' }
     }
     case 'openai-billing': {
       const limit = toAmount(json?.hard_limit_usd)
@@ -516,27 +553,45 @@ function parseResponse(queryType, json) {
       return { total: limit, currency: 'USD', available: limit, used: null, note: 'OpenAI 订阅硬上限' }
     }
     case 'glm': {
-      // 智谱 monitor 返回 data.limits[], 同时存在「套餐%」与「限流配额(五小时×2000 token)」。
-      // 判决口径(用户确认): 保留「百分比」显示——积分/套餐的 percentage 较准确。
-      // 仅当完全无 percentage 时才回退到 remaining(带"剩余 token"标注, 不冒充真实余额),
-      // 避免把「五小时限流窗口」误当账户余额误导用户。
+      // 智谱 Coding Plan 配额(实测 2026-08-30; unit 含义转自 z.ai 前端源码 / cc-switch)：
+      //   unit=3 → TOKENS_LIMIT 5小时滚动窗口(主显示)      [Lite:2000]
+      //   unit=6 → TOKENS_LIMIT 周配额(部分套餐/国际站)    [Lite:10000]
+      //   unit=5 → TIME_LIMIT 工具/搜索类(月度)
+      //   limit.remaining      = 该维度当前剩余(积分);
+      //   limit.percentage     = 该维度【填充度/已用】(100=用完, 0=未用)——绝不是"剩余%";
+      //   limit.nextResetTime  = 该维度下次重置时间(仅滚动/周期维度有)。
+      //   ⚠️ 严禁把 percentage 当"剩余%"显示: 会把"周配额已用完(remaining:0)"误显示成"余额 100%, 剩 100"。
+      //   真实返回: [{unit:3,remaining:2000,pct:0},{unit:6,remaining:0,pct:100,nextResetTime:...}]
       const limits = Array.isArray(json?.data?.limits) ? json.data.limits : []
       const num = (v) => { const n = Number(v); return Number.isFinite(n) ? n : null }
+      const rem = (l) => num(l?.remaining ?? l?.remaining_quota)
       const pctOf = (l) => { const n = Number(l?.percentage ?? l?.remaining_percentage); return Number.isFinite(n) && n >= 0 && n <= 100 ? n : null }
-      const near = (a, b) => (Number(a?.nextResetTime) || 0) - (Number(b?.nextResetTime) || 0)
-      // 1) 优先: 百分比套餐
-      const pctCands = limits.map((l) => ({ l, p: pctOf(l) })).filter((x) => x.p !== null)
-      let pk = pctCands.find((x) => x.l.type === 'TOKENS_LIMIT') || (pctCands.sort((a, b) => near(b.l, a.l))[0] ?? null)
-      if (pk) {
-        const p = pk.p
-        return { total: p, currency: '%', available: p, used: 100 - p, note: '智谱剩余%', percent: true, resetAt: pk.l.nextResetTime ?? null }
+      const UNIT_LABEL = { 3: '5小时窗口', 6: '周配额', 5: '工具(月度)' }
+      // 主显示优先: unit=3(5小时滚动窗口), 其次 unit=6(周配额), 再按剩余降序
+      const score = (l) => (l.unit === 3 ? 0 : (l.unit === 6 ? 1 : 2))
+      const sorted = limits.slice().sort((a, b) => score(a) - score(b) || (rem(b) ?? -1) - (rem(a) ?? -1))
+      const main = sorted.find((l) => rem(l) !== null && rem(l) > 0)
+      const usedUp = limits.filter((l) => rem(l) === 0 && pctOf(l) === 100)
+      if (main) {
+        const r = rem(main)
+        const extra = usedUp.length
+          ? '; ' + usedUp.map((l) => `${UNIT_LABEL[l.unit] ?? '其他'}已用完(${l.nextResetTime ? '待重置' : '已限流'})`).join('; ')
+          : ''
+        return {
+          total: r, currency: 'tokens', available: r, used: null, percent: null,
+          note: `智谱${UNIT_LABEL[main.unit] ?? ''}剩 ${r} 积分${extra}`,
+          resetAt: usedUp[0]?.nextResetTime ?? main?.nextResetTime ?? null,
+        }
       }
-      // 2) 兜底: 无任何 percentage → 只剩配额/remaining 值; 明确标注是"剩余 token"而非金额余额
-      const rem = (l) => num(l?.remaining ?? l?.remaining_quota)
-      const balCands = limits.map((l) => ({ l, r: rem(l) })).filter((x) => x.r !== null && x.r > 0)
-      if (balCands.length > 0) {
-        const best = balCands.sort((a, b) => b.r - a.r)[0]
-        return { total: best.r, currency: 'tokens', available: best.r, used: null, note: '智谱剩余 token(限流配额)', percent: null, resetAt: best.l.nextResetTime ?? null }
+      // 无可用>0 → 全部用尽
+      if (usedUp.length) {
+        const l = usedUp[0]
+        return { total: 0, currency: 'tokens', available: 0, used: null, percent: null, note: '智谱配额已用完(0)' + (l.nextResetTime ? ', 待重置' : ''), resetAt: l?.nextResetTime ?? null }
+      }
+      // 兜底: 只有 percentage 无 remaining → 限流填充度(非余额)
+      if (limits.length > 0) {
+        const p = pctOf(limits[0])
+        if (p !== null) return { total: p, currency: '%', available: null, used: null, percent: true, note: '智谱限流填充度%(非余额)', resetAt: limits[0]?.nextResetTime ?? null }
       }
       return null
     }
@@ -544,6 +599,7 @@ function parseResponse(queryType, json) {
     case 'kimi': {
       const u = json?.usage
       if (!u) return null
+      if (u.limit == null && u.remaining == null) return null
       const limit = toAmount(u.limit), remaining = toAmount(u.remaining)
       return { total: limit, currency: 'tokens', available: remaining, used: limit - remaining, note: 'Kimi 套餐剩余 tokens', percent: limit > 0 ? (remaining / limit) * 100 : null }
     }
@@ -1046,8 +1102,10 @@ export function apply(ctx, config) {
         const mk = (p) => p ? { cacheHit: p.cacheHit, cacheMiss: p.cacheMiss, output: p.output } : null
         // v4 峰谷系列
         const models = []
-        for (const key of ['deepseek-v4-flash', 'deepseek-v4-pro']) {
-          models.push({ model: key, peak: mk(table.peak[key]), offPeak: mk(table.offPeak[key]), peakValley: true })
+        for (const key of ['deepseek-v4-flash', 'deepseek-v4-pro', 'deepseek-v4-flash-vision-exp']) {
+          // v4-flash-vision-exp 与 flash 同价 (vision 不加价), 复用 flash 费率
+          const src = key === 'deepseek-v4-flash-vision-exp' ? 'deepseek-v4-flash' : key
+          models.push({ model: key, peak: mk(table.peak[src]), offPeak: mk(table.offPeak[src]), peakValley: true })
         }
         sendJson(res, 200, { ok: true, currency: cfg.currency ?? 'CNY', peakNow: isPeakTime(), weekend: isWeekend(), models })
       },