dsh-whale-widget 0.3.16 → 0.3.18

package/lib/index.js

@@ -28,9 +28,20 @@ const IMAGE_CANDIDATES = [
   path.join(PACKAGE_ROOT, 'assets', 'DSniang02.png'),
 ]
 // 自定义角色图片存放目录（第一个可写的会被使用；roles.json 存角色元数据）
+// ⭐ 2026-10-02（用户要求"并成一份"）：**用户数据的候选表一律 $DSH_HOME 优先**，开发机路径降级为兜底。
+//   原因：桌面客户端加载的是 strip 过的发布副本（只认 $DSH_HOME），而开发版宿主原先把开发机路径排在第一位
+//   ⇒ 本机上网页端与桌面端**各写各的**（实测两端同时各写一份 .dshw-usage.json / .dshw-bubble.json），
+//   互相看不到对方的改动 —— 表现就是"删掉的模块又冒出来""记账数对不上"。
+//   ⚠️ 这个常量必须在**所有**用到它的候选表之前定义（const 有 TDZ），所以放在最前面。
+//   ⚠️ `_strip-dev-paths.mjs` 会把发布副本里含开发机路径的行删掉，发布版只剩前两条 $DSH_HOME ✓
+const DATA_CANDIDATES_TAIL = [
+]
+// ⭐ 2026-10-02（用户要求"并成一份"）：**角色图库目录也 $DSH_HOME 优先**（开发机路径降级为兜底）。
 const ROLE_DIR_CANDIDATES = [
   path.join(DSH_HOME, 'whale-roles'),
   path.join(DSH_HOME, 'profiles', 'web', 'whale-roles'),
+  DATA_CANDIDATES_TAIL[0] + 'whale-roles/',
+  DATA_CANDIDATES_TAIL[1] + 'whale-roles/',
 ]
 const ROLE_INDEX_NAME = 'roles.json'
 const ROLE_DEFAULT_ID = 'default'
@@ -38,6 +49,8 @@ const ROLE_DEFAULT_ID = 'default'
 const AUDIO_DIR_CANDIDATES = [
   path.join(DSH_HOME, 'whale-audio'),
   path.join(DSH_HOME, 'profiles', 'web', 'whale-audio'),
+  DATA_CANDIDATES_TAIL[0] + 'whale-audio/',
+  DATA_CANDIDATES_TAIL[1] + 'whale-audio/',
 ]
 const AUDIO_INDEX_NAME = 'audio.json'
 // 内置预设音效组（不可删、不可改），对应 assets 里的 Ya/D 系列
@@ -70,9 +83,12 @@ const BUILTIN_FRAGMENT_FILES = {
 }
 // —— 自定义 API 模型（v655）：非 DeepSeek 厂商的余额 / 用量 / 提醒 ——
 // 注册表落在 $DSH_HOME/.dshw-api.json；密钥走 DSH 官方凭据（ctx.credentials），本文件不存明文。
+// ⭐ 2026-10-02（用户要求"并成一份"）：$DSH_HOME 优先（自定义 API 模型清单也属于用户数据，原先两端各存一份）。
 const API_FILE_CANDIDATES = [
   path.join(DSH_HOME, '.dshw-api.json'),
   path.join(DSH_HOME, 'profiles', 'web', '.dshw-api.json'),
+  DATA_CANDIDATES_TAIL[0] + '.dshw-api.json',
+  DATA_CANDIDATES_TAIL[1] + '.dshw-api.json',
 ]
 const API_BUILTIN_ID = 'deepseek'
 // 「充值 / 余额校正」只属于固定的 DeepSeek（内置）：模型条目下发 canAdjustBalance，路由层再校验一次。
@@ -163,7 +179,17 @@ const API_TEMPLATES = {
     quota: {
       url: 'https://open.bigmodel.cn/api/monitor/usage/quota/limit',
       auth: '{key}', // 智谱此接口不带 Bearer
-      json: { percent: 'data.limits[0].TOKENS_LIMIT.percentage', resetAt: 'data.limits[0].nextResetTime', level: 'data.level' },
+      // v789（issue #180/#181 修）：`data.limits[]` 是扁平条目数组，`TOKENS_LIMIT` 是条目的 `type` **值**，
+      //   且 5h 窗口不保证排在 [0]（pro 账号 [0] 是 TIME_LIMIT、max 账号 [0] 才是 TOKENS_LIMIT）
+      //   ⇒ 一律按 type(+unit) 选条目：unit=3 = 5 小时窗口、unit=6 = 周窗口；
+      //   新注册/credit 制账号的 type 是 CREDIT_LIMIT ⇒ 一并兼容。
+      json: {
+        level: 'data.level',
+        windows: [
+          { key: 'rolling', label: '5h', pick: { list: 'data.limits', types: ['TOKENS_LIMIT', 'CREDIT_LIMIT'], unit: 3 }, percent: 'percentage', resetAt: 'nextResetTime' },
+          { key: 'weekly', label: '周', pick: { list: 'data.limits', types: ['TOKENS_LIMIT', 'CREDIT_LIMIT'], unit: 6 }, percent: 'percentage', resetAt: 'nextResetTime' },
+        ],
+      },
     },
     probeUrl: 'https://open.bigmodel.cn/api/monitor/usage/quota/limit',
   },
@@ -346,7 +372,14 @@ const API_TEMPLATES = {
     quota: {
       url: 'https://api.z.ai/api/monitor/usage/quota/limit',
       auth: '{key}', // 与国内站一样不带 Bearer
-      json: { percent: 'data.limits[0].TOKENS_LIMIT.percentage', resetAt: 'data.limits[0].nextResetTime', level: 'data.level' },
+      // v789：与国内站同一套 `data.limits[]` 结构（见 zhipu_glm_coding 的注释），一并按 type+unit 选条目
+      json: {
+        level: 'data.level',
+        windows: [
+          { key: 'rolling', label: '5h', pick: { list: 'data.limits', types: ['TOKENS_LIMIT', 'CREDIT_LIMIT'], unit: 3 }, percent: 'percentage', resetAt: 'nextResetTime' },
+          { key: 'weekly', label: '周', pick: { list: 'data.limits', types: ['TOKENS_LIMIT', 'CREDIT_LIMIT'], unit: 6 }, percent: 'percentage', resetAt: 'nextResetTime' },
+        ],
+      },
     },
     probeUrl: 'https://api.z.ai/api/monitor/usage/quota/limit',
   },
@@ -365,20 +398,28 @@ const API_TEMPLATES = {
   },
 }
 
+// ⭐ 2026-10-02（用户要求"并成一份"）：这些**用户数据文件一律 $DSH_HOME 优先**，开发机路径降级为只读兜底。
+//   原因见上方 AUDIO_DIR_CANDIDATES 的说明（桌面端只认 $DSH_HOME，两端原先各写各的）。
 // Size memory file: prefer writable DSH home locations, then legacy fallbacks.
 const SIZE_FILE_CANDIDATES = [
   path.join(DSH_HOME, '.dshw-size.json'),
   path.join(DSH_HOME, 'profiles', 'web', '.dshw-size.json'),
+  DATA_CANDIDATES_TAIL[0] + '.dshw-size.json',
+  DATA_CANDIDATES_TAIL[1] + '.dshw-size.json',
 ]
 // Usage ledger file (小鲸鱼记账 mode): same policy as the size file.
 const USAGE_FILE_CANDIDATES = [
   path.join(DSH_HOME, '.dshw-usage.json'),
   path.join(DSH_HOME, 'profiles', 'web', '.dshw-usage.json'),
+  DATA_CANDIDATES_TAIL[0] + '.dshw-usage.json',
+  DATA_CANDIDATES_TAIL[1] + '.dshw-usage.json',
 ]
 // 每轮消耗 seq 持久化文件：避免插件热重载后 seq 归零导致页面把新轮次误判为旧轮次吞掉
 const TURN_FILE_CANDIDATES = [
   path.join(DSH_HOME, '.dshw-turn.json'),
   path.join(DSH_HOME, 'profiles', 'web', '.dshw-turn.json'),
+  DATA_CANDIDATES_TAIL[0] + '.dshw-turn.json',
+  DATA_CANDIDATES_TAIL[1] + '.dshw-turn.json',
 ]
 // Sound assets: package-relative first (ship Ya1/Ya2/D1/D2.mp3 in assets/),
 // legacy absolute paths as fallback.
@@ -387,6 +428,8 @@ const BUBBLE_FILE_CANDIDATES = [
   // 否则清完这个数组会变成空的：泡泡配置读不了也存不了（自定义泡泡整体失效）。
   path.join(DSH_HOME, '.dshw-bubble.json'),
   path.join(DSH_HOME, 'profiles', 'web', '.dshw-bubble.json'),
+  DATA_CANDIDATES_TAIL[0] + '.dshw-bubble.json',
+  DATA_CANDIDATES_TAIL[1] + '.dshw-bubble.json',
 ]
 // 泡泡图库(独立于角色图库):图片文件目录 + 索引
 const BUBBLE_IMG_DIR_CANDIDATES = [
@@ -394,6 +437,8 @@ const BUBBLE_IMG_DIR_CANDIDATES = [
   // 空数组会让图库上传直接报错。
   path.join(DSH_HOME, 'whale-bubble-imgs'),
   path.join(DSH_HOME, 'profiles', 'web', 'whale-bubble-imgs'),
+  DATA_CANDIDATES_TAIL[0] + 'whale-bubble-imgs/',
+  DATA_CANDIDATES_TAIL[1] + 'whale-bubble-imgs/',
 ]
 const BUBBLE_IMG_INDEX_NAME = 'bubble-imgs.json'
 // 内置默认泡泡图(语义 id → assets 文件):面板常驻可选;全新安装无用户图库时
@@ -430,6 +475,8 @@ function soundSetFromUrl(url) {
 }
 const BALANCE_URL = 'https://api.deepseek.com/user/balance'
 const BALANCE_TTL_MS = 25000
+// v781：账号登录路的兜底超时（毫秒）。DSH 账号服务自身默认 30s，太长会把前端 FETCH_TIMEOUT_MS(25s) 先耗掉。
+const ACCOUNT_FALLBACK_MS = 5000
 const RUA_GIF_CANDIDATES = [
   path.join(PACKAGE_ROOT, 'assets', 'rua.gif'),
 ]
@@ -1017,10 +1064,13 @@ export default {
     // ⚠️ 必须用 `ctx.get('deepseekAccount')` 读**可选服务**，**绝不能写进 inject** —— 老宿主根本没有这个服务，
     //    一旦进 inject，整个插件会永远等不到服务而**完全不 apply**（比没有这个功能严重得多）。
     // ⚠️ 与 API key 路径**互不干扰**（API key 永远优先；DSH 自己的注释也是 "Neither route falls back to the other"）。
+    // v781：账号余额路的失败原因（只用于错误文案，不参与任何判定）。fetchAccountBalance 每次开头清空。
+    let accountDiag = ''
     async function fetchAccountBalance() {
       let account = null
+      accountDiag = ''
       try { account = typeof ctx.get === 'function' ? ctx.get('deepseekAccount') : null } catch (err) { account = null }
-      if (!account || typeof account.getBalance !== 'function') return null
+      if (!account || typeof account.getBalance !== 'function') { accountDiag = '当前 DSH 没有账号服务'; return null }
       // 账户标识：优先用账号服务给的稳定 id（不同账号 → 不同账本 scope）；取不到就退回固定标识。
       // 一律 sha256[:24] 十六进制 —— accounting.mjs 校验 scope 必须匹配 /^[a-zA-Z0-9_-]{1,80}$/
       // （带冒号这种可读写法会直接抛「账户标识无效」，见 issue #157 报告人踩的坑 1）。
@@ -1036,25 +1086,52 @@ export default {
           locale: String(process.env.DSH_LOCALE || '') || 'zh_CN',
           timezoneOffsetSeconds: -new Date().getTimezoneOffset() * 60, // 东为正的整秒
         })
-      } catch (err) { return null }
+      } catch (err) {
+        accountDiag = '账号余额接口调用失败: ' + String((err && err.message) || err).slice(0, 120)
+        return null
+      }
       // 未登录 / 没有 grant / 平台失败 → 一律返回 null，让调用方退回原来的文案（**不缓存错误**）
-      if (!result || result.status !== 'ready' || !Array.isArray(result.value) || result.value.length === 0) return null
+      // v781：失败时记下**原因**（accountDiag），供 fetchBalance 把两条路的原因一起报给界面 ——
+      //   以前只有一个笼统的"账号余额不可用"，用户/支持方分不清"没登录"和"接口失败"。
+      if (!result) { accountDiag = '未登录 DeepSeek 账号（没有账号凭据）'; return null }
+      if (result.status !== 'ready') { accountDiag = '账号余额接口未就绪（' + String(result.status || 'unknown') + '）'; return null }
       const accNum = (v) => { const n = Number(v); return Number.isFinite(n) ? n : null }
-      const wallets = result.value.filter((w) => w && accNum(w.balance) !== null)
-      if (wallets.length === 0) return null
-      const currency = wallets.some((w) => String(w.currency || '').toUpperCase() === 'CNY')
-        ? 'CNY'
-        : String((wallets[0] && wallets[0].currency) || 'CNY').toUpperCase()
-      const sumOf = (list) => (Array.isArray(list) ? list : [])
-        .filter((w) => w && String(w.currency || 'CNY').toUpperCase() === currency && accNum(w.balance) !== null)
+      // v781：**"充值钱包为空、只有赠金"必须算成功** —— 这是"只登录客户端读不到余额"的主因。
+      //   平台把钱包拆成 `normal_wallets`（充值）与 `bonus_wallets`（赠金）；新用户/没充过值的用户
+      //   常常**只有赠金**（甚至 normal_wallets 是空数组）⇒ 旧代码要求 `result.value` 非空，
+      //   直接把这类账号判成"没有余额钱包"，界面就只显示"读取不到余额"。
+      //   判据对齐 DSH 自己的账号卡片（dsh-client-ui-settings-account）：
+      //     `[...balance.value, ...balance.bonusWallets].some(w => new Big(w.balance).gt(0))`
+      //   —— 两个钱包一起看，不再单看充值钱包。
+      const normRaw = Array.isArray(result.value) ? result.value : []
+      const bonusRaw = Array.isArray(result.bonusWallets) ? result.bonusWallets : []
+      const usable = (list) => list.filter((w) => w && accNum(w.balance) !== null)
+      const normWallets = usable(normRaw)
+      const bonusWallets = usable(bonusRaw)
+      const allWallets = normWallets.concat(bonusWallets)
+      if (allWallets.length === 0) {
+        // 两边都没有可用钱包 = 真的没有数据（未激活/账号没有任何钱包），不是"余额 0"
+        accountDiag = normRaw.length || bonusRaw.length ? '钱包字段不可用' : '账号没有余额钱包'
+        return null
+      }
+      // 币种：优先「有余额的那个钱包」的币种（CNY 优先），其次任何 CNY 钱包，最后第一个
+      const curOf = (w) => String((w && w.currency) || 'CNY').toUpperCase()
+      const nonzero = allWallets.filter((w) => Number(w.balance) > 0)
+      const curPick = nonzero.find((w) => curOf(w) === 'CNY') || nonzero[0]
+        || allWallets.find((w) => curOf(w) === 'CNY') || allWallets[0]
+      const currency = curOf(curPick)
+      const sumOf = (list) => list
+        .filter((w) => w && curOf(w) === currency && accNum(w.balance) !== null)
         .reduce((s, w) => s + Number(w.balance), 0)
-      const recharge = sumOf(result.value)
-      const bonus = sumOf(result.bonusWallets)
+      const recharge = sumOf(normWallets)
+      const bonus = sumOf(bonusWallets)
+      accountDiag = ''
       return {
         ok: true,
         // 充值 + 赠金：与 API key 路径的 `total_balance` 同口径（那个字段本身也是两者相加），
         // 否则"按余额差"推算的今日已用会偏小（issue #157 报告人的坑 2）。
         totalBalance: Number((recharge + bonus).toFixed(6)),
+        // v781：两个分量单独下发，供「赠金 / 账户余额」两个自定义模块使用（见 SPEC §25）
         rechargeBalance: Number(recharge.toFixed(6)),
         bonusBalance: Number(bonus.toFixed(6)),
         currency,
@@ -1064,30 +1141,64 @@ export default {
       }
     }
 
+    // v781：账号路的兜底（**两条路都失败才报错，并把两条路的原因都带上**）。
+    //   为什么需要它：旧实现只在"完全没有 API key"时才试账号路 ⇒ 曾经配过 key（过期/写错/被删）
+    //   但现在只用客户端登录的用户，余额**永远读不到**（"只登录客户端读不到余额"报告里的另一大类）。
+    //   ⚠️ 超时上限：账号路走 DSH 自己的服务（默认 30s）⇒ 我们用 ACCOUNT_FALLBACK_MS 截断，
+    //   保证"API key 两次 8s + 退避"之后仍在**前端的 25s** 之内回来，不让界面先 abort。
+    async function accountFallback(keyErr) {
+      let acc = null
+      try {
+        acc = await Promise.race([
+          fetchAccountBalance(),
+          new Promise((r) => setTimeout(() => { accountDiag = '账号余额请求超时'; r(null) }, ACCOUNT_FALLBACK_MS)),
+        ])
+      } catch (err) {
+        acc = null
+        accountDiag = accountDiag || ('账号余额异常: ' + String((err && err.message) || err).slice(0, 120))
+      }
+      if (acc) return acc
+      const keyPart = keyErr
+        ? ('API key 路：' + String((keyErr.error || keyErr.code || '失败')).slice(0, 160))
+        : '未配置 DEEPSEEK_API_KEY'
+      return {
+        ok: false,
+        code: keyErr ? 'BOTH_FAILED' : 'NO_KEY',
+        error: keyPart + '；账号登录路：' + (accountDiag || '拿不到余额'),
+      }
+    }
     async function fetchBalance() {
       // v739（用户反馈「每次新实例的第一次余额请求都失败」）：
       // ① 冷启动时凭据服务可能尚未就绪（resolve 抛错），这与「确实没配置」不同 → 短延迟重试一次；
       // ② 单次超时从 20s 收到 8s，保证「2 次尝试 + 退避」明显短于前端 FETCH_TIMEOUT_MS(25s) ——
       //    否则前端先 abort，用户看到的永远是「第一次失败」，只能干等 60 秒后的下一轮。
       let cred = null
+      let credErr = null
       for (let attempt = 0; attempt < 2; attempt++) {
         try {
           cred = await ctx.credentials.resolve('DEEPSEEK_API_KEY')
+          credErr = null
           break
         } catch (err) {
+          credErr = err
           if (attempt === 0) { await new Promise((r) => setTimeout(r, 700)); continue }
-          return { ok: false, code: 'NO_KEY', error: '凭据读取失败: ' + String((err && err.message) || err).slice(0, 160) }
+          // v781：凭据服务报错时**也要试账号路**（以前直接 return，登录态用户就被这条挡住）
+          return await accountFallback({ code: 'NO_KEY', error: '凭据读取失败: ' + String((err && err.message) || err).slice(0, 160) })
         }
       }
       if (!cred) {
         // v759（issue #157）：没有 API key 时退回 DSH 账号登录态；两条路互不干扰，API key 始终第一优先。
-        const accountPayload = await fetchAccountBalance()
-        if (accountPayload) return accountPayload
-        return {
-          ok: false, code: 'NO_KEY',
-          error: '未配置 DEEPSEEK_API_KEY，且账号余额不可用（未登录 DeepSeek 账号，或该账号没有余额钱包）',
-        }
+        return await accountFallback(null)
       }
+      const apiFail = await fetchApiKeyBalance(cred)
+      if (apiFail.ok) return apiFail
+      // v781：key 路**任何**失败都再试一次账号路（401/结构异常/超时都算）
+      void credErr
+      return await accountFallback(apiFail)
+    }
+
+    // API key 路（原 fetchBalance 的主体，v781 抽出来以便"失败后回退账号路"）
+    async function fetchApiKeyBalance(cred) {
       let lastErr = null
       for (let attempt = 0; attempt < 2; attempt++) {
         let res
@@ -1117,9 +1228,15 @@ export default {
         if (!info || info.total_balance === undefined || !Number.isFinite(Number(info.total_balance))) {
           return { ok: false, code: 'SHAPE', error: '余额接口返回结构异常' }
         }
+        const numOr = (x) => { const n = Number(x); return Number.isFinite(n) ? n : null }
         return {
           ok: true,
           totalBalance: Number(info.total_balance),
+          // v781：官方 /user/balance 除 total_balance 外还给了 granted_balance（**未过期**赠金）与
+          //   topped_up_balance（充值）。取不到就是 null（界面显示 —，**不臆造 0** —— 0 会被记账
+          //   当成"余额真的见底"，那是另一种语义）。两个分量供自定义模块里的「赠金 / 账户余额」使用。
+          bonusBalance: numOr(info.granted_balance),
+          rechargeBalance: numOr(info.topped_up_balance),
           accountTag: createHash('sha256').update(String(cred.value)).digest('hex').slice(0, 24),
           currency: String(info.currency || 'CNY'),
           balanceSource: 'apikey',
@@ -1285,7 +1402,7 @@ export default {
       const days = new Set([today, ...Object.keys(led.history || {}), ...accountingDays(led)])
       for (const e of events) if (/^\d{4}-\d{2}-\d{2}$/.test(e.day)) days.add(e.day)
       return {
-        ok: true, version: '0.3.16', today: todayData, days7,
+        ok: true, version: '0.3.18', today: todayData, days7,
         total7: total7ByCurrency[todayData.currency] || 0, total7Currency: todayData.currency, total7ByCurrency,
         all: {
           days: Array.from(days).filter(d => /^\d{4}-\d{2}-\d{2}$/.test(d)).sort().reverse().map(forDay),
@@ -1321,7 +1438,10 @@ export default {
         //    （只冒泡）—— 要响就把音效行的 [✓] 勾上。
         // v764：turnCost **刻意不带** autoClose / ttlSec —— 自动关闭的真实来源是 .dshw-size.json 的
         //    turnCostCloseMs，留着这两个键会让同一个设置有两个来源（其中一个永远是假的）。
-        turnCost: { vol: 1, bubbleOn: true },
+        // v778：`volSet` = 用户**显式**调过②区「提示音量」没有（默认 false = 跟随①区按压音量）。
+        //    没有它就无法区分"默认 100%"与"用户设了 100%"，前端 soundVolumeOf() 靠它决定优先级。
+        //    ⚠️ 与前端 soundEventDefaults().turnCost **必须逐字段一致**（探针 §⑥ 跨端一致钉住）。
+        turnCost: { vol: 1, volSet: false, bubbleOn: true },
         question: { on: true, soundOn: false, sel: 'frag:exp_orb', vol: 1, autoClose: true, ttlSec: 180, bubbleOn: true, lines: waitDefaultLines('question') },
         approval: { on: true, soundOn: false, sel: 'frag:exp_orb', vol: 1, autoClose: true, ttlSec: 180, bubbleOn: true, lines: waitDefaultLines('approval') },
       }
@@ -1329,6 +1449,10 @@ export default {
     function usageSettingsDefaults() {
       return {        // 任务结束音：v774 起出厂默认 = **开**（作者当前用法），默认音 = 内置 A（end_a）
         taskEnd: { on: true, sel: 'frag:end_a' },
+        // v777：「等待交互提示」的交互开关（用户 2026-09-26 要求）
+        //   charClose=false（出厂默认）＝ 只有**点泡泡**能收起等待提示；true ＝ **点角色**也能收起。
+        //   两种情况下"点掉的那条挂起"都不会再被每秒轮询自动弹回（前端 waitDismissedId）。
+        wait: { charClose: false },
         // v761：四个事件的音效/自动关闭/冒泡配置（面板「全局音效设置」）
         events: soundEventsDefaults(),
         // 默认固化自开发环境当前 usage.json 设置(全新安装即此体验)
@@ -1411,6 +1535,8 @@ export default {
       if (p.budget && typeof p.budget === 'object') led.settings.budget = Object.assign({}, led.settings.budget || {}, p.budget)
       // 每轮消耗提示内容(自定义提示窗口)
       if (p.turnCost && typeof p.turnCost === 'object') led.settings.turnCost = Object.assign({}, led.settings.turnCost || {}, p.turnCost)
+      // v777：「等待交互提示」的交互开关（点角色是否也能关闭等待提示气泡）
+      if (p.wait && typeof p.wait === 'object') led.settings.wait = Object.assign({}, led.settings.wait || {}, p.wait)
       // v761（全局音效设置）：events 补丁逐事件合并（前端只发改动的那几个字段）
       if (p.events && typeof p.events === 'object') {
         led.settings.events = led.settings.events && typeof led.settings.events === 'object' ? led.settings.events : {}
@@ -1426,6 +1552,8 @@ export default {
       // 「恢复默认」：只重置音效/提示类键（不动外观、位置、账本、角色与泡泡自定义）
       if (p.resetEvents === true) {
         led.settings.events = soundEventsDefaults()
+        // v777：等待提示的交互开关也属于"提示类键" ⇒ 一起恢复出厂默认（charClose=false）
+        led.settings.wait = { charClose: false }
         // 任务结束音也属于「音效类键」：宿主重置与面板显示必须口径一致（否则面板显示与真实状态撕裂）
         // v774：重置目标 = 新的出厂默认（开 + 内置 A）
         led.settings.taskEnd = { on: true, sel: 'frag:end_a' }
@@ -1988,14 +2116,48 @@ export default {
       }
       return { key, code: '', error: '' }
     }
-    async function apiFetchJson(url, auth, key) {
+    // v789（issue #190）：余额/额度接口不再局限于 GET —— 模板或模型条目可声明 method / body。
+    //   ① method 默认 GET；非 GET 时带 `Content-Type: application/json` 并把 body 发出去；
+    //   ② body 支持占位符：`{key}`（凭据）、`{base}`（Base URL）、以及 `model.params` 里的任意键（如 `{uuid}`）
+    //      —— 这样"POST /v1/enterprise/account {"uuid":"…"}" 这类自建网关不需要再额外挂一层转换服务；
+    //   ③ 安全边界不变：body 只来自配置（不接受请求方传入），目的地仍走 credentialMayGoTo() 白名单，
+    //      URL 仍过 assertSafeApiUrl()。
+    function bodyWithPlaceholders(body, key, base, params) {
+      let s = String(body == null ? '' : body)
+      s = s.split('{key}').join(String(key == null ? '' : key))
+      s = s.split('{base}').join(String(base == null ? '' : base))
+      if (params && typeof params === 'object') {
+        for (const k of Object.keys(params)) {
+          const v = params[k]
+          if (v === undefined || v === null || typeof v === 'object') continue
+          s = s.split('{' + k + '}').join(String(v))
+        }
+      }
+      return s
+    }
+    function httpMethodOf(cfg) {
+      const m = String((cfg && cfg.method) || 'GET').trim().toUpperCase()
+      return /^[A-Z]{3,7}$/.test(m) ? m : 'GET'
+    }
+    async function apiFetchJson(url, auth, key, opts) {
+      const o = opts || {}
       const headers = {}
       const a = String(auth == null ? 'Bearer {key}' : auth)
       if (a) headers.Authorization = a.replace('{key}', key)
       // v724：URL 里也支持 {key}（如 Gemini 的 ?key=… 形式；auth 传空串时不带 Authorization 头）
       const u = String(url).replace('{key}', key)
       assertSafeApiUrl(u)
-      const res = await fetch(u, { headers, signal: AbortSignal.timeout(15000) })
+      const init = { headers, signal: AbortSignal.timeout(15000) }
+      const method = httpMethodOf(o)
+      if (method !== 'GET') {
+        init.method = method
+        const raw = o.body
+        if (raw !== undefined && raw !== null && String(raw).length) {
+          headers['Content-Type'] = 'application/json'
+          init.body = bodyWithPlaceholders(raw, key, o.base, o.params)
+        }
+      }
+      const res = await fetch(u, init)
       if (!res.ok) throw new Error('HTTP ' + res.status)
       return await res.json()
     }
@@ -2031,14 +2193,17 @@ export default {
       }
       const b = mergeNonEmpty(tpl.balance, model.balance) // v724：模型侧空串不再覆盖模板
       const base = String(model.baseUrl || '').replace(/\/+$/, '')
-      const url = String(tpl.probeUrl || b.url || (base ? base + '/v1/models' : '')).replace('{base}', base)
+      // v789（issue #190）：声明了 POST 等非 GET 方法时，测试就直接打**用户配置的余额接口**（带同一个 body）——
+      // 否则会拿 GET 去打一个只支持 POST 的地址、误报"测试失败"（probeUrl 多是 models 列表，body 不通用）。
+      const nonGet = httpMethodOf(b) !== 'GET'
+      const url = String(nonGet ? (b.url || tpl.probeUrl || '') : (tpl.probeUrl || b.url || (base ? base + '/v1/models' : ''))).replace('{base}', base)
       if (!url) return { ok: false, error: '没有可测试的接口（请填余额接口或 Base URL）' }
       // v761（安全修复 S1）：只在目的地可信时才带上凭据
       const k = await keyForDestination(model, tpl, url)
       if (!k.key) return { ok: false, code: k.code, error: k.error }
       const key = k.key
       try {
-        const data = await apiFetchJson(url, b.auth, key)
+        const data = await apiFetchJson(url, b.auth, key, { method: b.method, body: b.body, base: base, params: model.params })
         const bizErr = apiBusinessError(data)
         if (bizErr) return { ok: false, error: '测试失败: ' + bizErr }
         let detail = 'HTTP 200'
@@ -2049,14 +2214,41 @@ export default {
         return { ok: false, error: '测试失败: ' + String((err && err.message) || err).slice(0, 140) }
       }
     }
+    // v789（issue #180/#181）：额度接口里"多窗口 + 数组顺序不保证"的通用取数。
+    //   智谱 `GET /api/monitor/usage/quota/limit` 返回的 `data.limits[]` 是**扁平条目数组**：
+    //   `TOKENS_LIMIT` 是每条的 `type` 字段值（不是 `limits[0]` 的子对象），5h 窗口不保证排在 `[0]`
+    //   （实测：pro 账号 `limits[0]` 是 TIME_LIMIT，max 账号 `limits[0]` 是 TOKENS_LIMIT ⇒ 按位置取数必然出错过），
+    //   而且新注册/credit 制账号把 `type` 改成了 `CREDIT_LIMIT`。
+    //   所以模板可以声明 `pick: { list, type/types, unit, number }`：先选中**那一条**，再把它的字段当作取数根。
+    function pickQuotaEntry(data, pick) {
+      try {
+        if (!pick || !pick.list) return null
+        const arr = pickJsonPath(data, pick.list)
+        if (!Array.isArray(arr)) return null
+        const types = []
+        if (pick.type) types.push(String(pick.type))
+        if (Array.isArray(pick.types)) for (const t of pick.types) types.push(String(t))
+        const unit = (pick.unit === undefined || pick.unit === null) ? null : Number(pick.unit)
+        const number = (pick.number === undefined || pick.number === null) ? null : Number(pick.number)
+        for (const it of arr) {
+          if (!it || typeof it !== 'object') continue
+          if (types.length && types.indexOf(String(it.type)) < 0) continue
+          if (unit !== null && Number(it.unit) !== unit) continue
+          if (number !== null && Number(it.number) !== number) continue
+          return it
+        }
+        return null
+      } catch (err) { return null }
+    }
     // 订阅额度（Coding Plan）解析：各厂商字段不同，统一归一成「已用% + 重置时间 + 档位」
-    //   zhipu:    data.limits[0].TOKENS_LIMIT.percentage（已用%）+ nextResetTime
+    //   zhipu:    data.limits[] 里 type=TOKENS_LIMIT/CREDIT_LIMIT + unit=3(5h)/6(周) 的条目（v789 起按 pick 选）
     //   kimi:     usage.remaining / usage.limit（剩余/总量）
     //   minimax:  model_remains[0].current_interval_remaining_percent（剩余%）+ end_time(ms)
     async function fetchModelQuota(model) {
       if (!model) return { ok: false, error: '模型不存在' }
       const tpl = apiTemplateOf(model.provider) || {}
-      const q = tpl.quota
+      // v789（issue #180 建议 3）：模型条目也能覆盖额度配置 —— 厂商接口变动时用户可自救（不留空即覆盖）
+      const q = mergeNonEmpty(tpl.quota, model.quota)
       if (!q || !q.url) return { ok: false, code: 'NO_QUOTA', error: '该厂商没有订阅额度接口' }
       const base = String(model.baseUrl || '').replace(/\/+$/, '')
       const url = String(q.url).replace('{base}', base)
@@ -2065,31 +2257,33 @@ export default {
       if (!k.key) return { ok: false, code: k.code, error: k.error }
       const key = k.key
       try {
-        const data = await apiFetchJson(url, q.auth, key)
+        const data = await apiFetchJson(url, q.auth, key, { method: q.method, body: q.body, base: base, params: model.params })
         const bizErr = apiBusinessError(data)
         if (bizErr) return { ok: false, code: 'BIZ', error: bizErr }
         const j = q.json || {}
         const num = (v) => { const n = Number(v); return isFinite(n) ? n : null }
+        // v789：若模板声明了顶层 pick（单窗口 + 数组筛选），先把取数根换成选中的那条
+        const jroot = j.pick ? (pickQuotaEntry(data, j.pick) || {}) : data
         let usedPct = null, remainPct = null, resetAt = null, level = '', weeklyUsedPct = null
-        if (j.percent) { const p = num(pickJsonPath(data, j.percent)); if (p !== null) usedPct = p }
+        if (j.percent) { const p = num(pickJsonPath(jroot, j.percent)); if (p !== null) usedPct = p }
         if (j.remainPct) {
-          const p = num(pickJsonPath(data, j.remainPct))
+          const p = num(pickJsonPath(jroot, j.remainPct))
           if (p !== null) { remainPct = p; if (usedPct === null) usedPct = Math.max(0, 100 - p) }
         }
         if (j.weeklyRemainPct) {
-          const p = num(pickJsonPath(data, j.weeklyRemainPct))
+          const p = num(pickJsonPath(jroot, j.weeklyRemainPct))
           if (p !== null) weeklyUsedPct = Math.max(0, 100 - p)
         }
         if (j.remain && j.total) {
-          const r0 = num(pickJsonPath(data, j.remain))
-          const t0 = num(pickJsonPath(data, j.total))
+          const r0 = num(pickJsonPath(jroot, j.remain))
+          const t0 = num(pickJsonPath(jroot, j.total))
           if (r0 !== null && t0) {
             remainPct = Math.max(0, Math.min(100, r0 / t0 * 100))
             usedPct = Math.max(0, 100 - remainPct)
           }
         }
-        if (j.resetAt) resetAt = pickJsonPath(data, j.resetAt)
-        if (j.resetAtMs) { const ms = num(pickJsonPath(data, j.resetAtMs)); if (ms !== null) resetAt = ms }
+        if (j.resetAt) resetAt = pickJsonPath(jroot, j.resetAt)
+        if (j.resetAtMs) { const ms = num(pickJsonPath(jroot, j.resetAtMs)); if (ms !== null) resetAt = ms }
         if (j.level) level = String(pickJsonPath(data, j.level) || '')
         // v0.3.1：多窗口额度 —— 有些订阅额度接口一次返回多个窗口（如 OpenCode Go 的
         // rolling / weekly / monthly），每个窗口各有「已用% + 重置时间」。模板用
@@ -2100,11 +2294,13 @@ export default {
           const list = []
           for (const w of j.windows) {
             if (!w) continue
-            let wp = w.percent ? num(pickJsonPath(data, w.percent)) : null
+            // v789：每个窗口可以各自 pick 一条（智谱 5h=unit3 / 周=unit6），选中后以该条为取数根
+            const wroot = w.pick ? (pickQuotaEntry(data, w.pick) || {}) : data
+            let wp = w.percent ? num(pickJsonPath(wroot, w.percent)) : null
             if (wp !== null) wp = Math.max(0, Math.min(100, wp))
             let wr = null
             if (w.resetAt) {
-              const rv = pickJsonPath(data, w.resetAt)
+              const rv = pickJsonPath(wroot, w.resetAt)
               if (rv !== undefined && rv !== null && rv !== '') wr = rv
             }
             if (wp === null && wr === null) continue
@@ -2157,7 +2353,8 @@ export default {
       if (!k.key) return { ok: false, code: k.code, error: k.error }
       const key = k.key
       try {
-        const data = await apiFetchJson(url, b.auth, key)
+        // v789（issue #190）：把 method / body / params 一并交给取数层（默认 GET，与以前完全一致）
+        const data = await apiFetchJson(url, b.auth, key, { method: b.method, body: b.body, base: base, params: model.params })
         const j = b.json || {}
         let remaining = null
         let total = null
@@ -2396,12 +2593,56 @@ export default {
       if (p.allowCustomHost === true) model.allowCustomHost = true
       else if (p.allowCustomHost === false) delete model.allowCustomHost
       if (p.baseUrl !== undefined) model.baseUrl = String(p.baseUrl || '').slice(0, 300)
+      // v789（issue #190）：请求体里可用的 `{占位符}`（如 {uuid}）—— 只允许标量，键名受限
+      if (p.params && typeof p.params === 'object') {
+        const pr = {}
+        for (const k of Object.keys(p.params)) {
+          if (!/^[A-Za-z_][A-Za-z0-9_]{0,30}$/.test(k)) continue
+          const v = p.params[k]
+          if (v === undefined || v === null || typeof v === 'object') continue
+          pr[k] = String(v).slice(0, 300)
+        }
+        if (Object.keys(pr).length) model.params = pr
+        else delete model.params
+      }
+      if (p.quota && typeof p.quota === 'object' && p.quota.json && typeof p.quota.json === 'object') {
+        // v789（issue #180 建议 3）：允许模型条目覆盖额度配置（厂商接口变动时用户可自救）。
+        // 只收 JSON-safe 的形状，且路径字符串限长 —— 与模板同构，不做二次校验的滥用面。
+        const qj = {}
+        const pathOf = (v) => String(v || '').slice(0, 200)
+        if (p.quota.url) qj.url = String(p.quota.url).slice(0, 500)
+        if (p.quota.auth !== undefined) qj.auth = String(p.quota.auth || '').slice(0, 200)
+        const jin = p.quota.json
+        for (const k of ['percent', 'remainPct', 'weeklyRemainPct', 'remain', 'total', 'resetAt', 'resetAtMs', 'level']) {
+          if (jin[k]) qj[k] = pathOf(jin[k])
+        }
+        if (Array.isArray(jin.windows)) {
+          qj.windows = jin.windows.slice(0, 6).map((w) => {
+            const o = { key: String((w && w.key) || '').slice(0, 20), label: String((w && w.label) || '').slice(0, 20) }
+            if (w && w.percent) o.percent = pathOf(w.percent)
+            if (w && w.resetAt) o.resetAt = pathOf(w.resetAt)
+            if (w && w.pick && typeof w.pick === 'object') {
+              const pk = { list: pathOf(w.pick.list) }
+              if (w.pick.type) pk.type = String(w.pick.type).slice(0, 40)
+              if (Array.isArray(w.pick.types)) pk.types = w.pick.types.slice(0, 4).map((t) => String(t).slice(0, 40))
+              if (w.pick.unit !== undefined) pk.unit = Number(w.pick.unit)
+              if (w.pick.number !== undefined) pk.number = Number(w.pick.number)
+              o.pick = pk
+            }
+            return o
+          })
+        }
+        if (qj.url && (Object.keys(qj).length > 1)) model.quota = qj
+      }
       if (p.balance && typeof p.balance === 'object') {
         // v724：空字段不写入（stripEmptyDeep）→ 模板默认值继续生效；
         // 全部为空时直接删掉 model.balance，等于"完全用模板"
         const balIn = stripEmptyDeep({
           url: String(p.balance.url || '').slice(0, 500),
           auth: String(p.balance.auth || '').slice(0, 200),
+          // v789（issue #190）：可选的请求方法与请求体（留空 ⇒ 沿用模板/GET）
+          method: String(p.balance.method || '').slice(0, 8).toUpperCase(),
+          body: String(p.balance.body || '').slice(0, 4000),
           json: {
             remaining: String((p.balance.json && p.balance.json.remaining) || '').slice(0, 200),
             total: String((p.balance.json && p.balance.json.total) || '').slice(0, 200),
@@ -2502,6 +2743,10 @@ export default {
         // entry.balance 是数值，不能当描述用（否则面板保存会用空值覆盖描述）
         const tplE = apiTemplateOf(m.provider) || {}
         entry.balanceDesc = mergeNonEmpty(tplE.balance, m.balance) // v724：空串不覆盖模板
+        // v789（issue #189）：把当前的凭据放行标志也下发 —— 前端勾选框要能**显示现状**，
+        //   否则"看不到 → 保存时显式传 false"会把用户手改文件开的口子又关掉（反而更糟）。
+        entry.allowCustomHost = m.allowCustomHost === true
+        entry.params = (m.params && typeof m.params === 'object') ? m.params : null
         if (m.id === API_BUILTIN_ID) {
           entry.balanceMode = 'api'
           entry.hasBalanceApi = true
@@ -2624,7 +2869,7 @@ export default {
       const summary = daySummary(led, todayKey())
       const nowSec = Math.floor(Date.now() / 1000)
       return {
-        ...visible, version: '0.3.16', isPeak: isPeakTime(nowSec),
+        ...visible, version: '0.3.18', isPeak: isPeakTime(nowSec),
         // 峰谷切换点与节假日清单：前端倒计时要与宿主同源（否则法定节假日会算错切换点）
         peakNextChangeAt: nextPeakChangeAt(nowSec),
         peakHolidays: HOLIDAY_VALLEY_LIST,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-whale-widget",
-  "version": "0.3.16",
+  "version": "0.3.18",
   "description": "DSH Web 界面右下角的 DeepSeek 余额小鲸鱼挂件:余额/今日已用/峰谷定价、自定义泡泡点击序列(文本/余额/今日/峰谷/图片/随机语句与并列加权选择)、逐行样式与字体、悬浮快捷编辑、音效与每轮消耗、自定义角色/动图/音效、吸附与翻转自定义",
   "keywords": [
     "dsh",