dsh-whale-widget 0.3.17 → 0.3.18

package/README.md

@@ -50,7 +50,8 @@ DeepSeek Harness（DSH）Web 界面右下角的常驻挂件：小鲸鱼气泡图
   - **随机语句**（多条句子带权重，每次显示抽 1 条且不连续重复）
   - **图片/动图**（从泡泡图库选，独占一整行）
   - **随机图片**（多张图带权重，抽 1 张且不连续重复，同样独占一行）
-  - 余额数值、今日已用、峰谷时段、**对话名**（内置数值，内容自动获取，可调占位符与样式；对话名可设「**保留长度**」，超出部分显示为 `...`，`0` = 不截断）
+  - **总余额(充值金额+赠金)**、**赠金**、**充值余额**、今日已用、峰谷时段、**对话名**（内置数值，内容自动获取，可调占位符与样式；对话名可设「**保留长度**」，超出部分显示为 `...`，`0` = 不截断）
+    - 三个余额类模块的分工：**总余额(充值金额+赠金)** = 充值余额 + 赠金（`{balance_ds}`，老配置里的模块照旧显示，无需重配）；**赠金**（`{bonus_ds}`）与**充值余额**（`{recharge_ds}`）是单独拆出来的两个模块，取不到数时显示 `—`（真的为 0 才显示 `0.00`）
 - 🎨 **逐模块样式**：字体（含自定义字体）、字号、加粗/斜体/下划线、纯色或**跑马灯渐变**配色、底色；文本与随机语句支持悬浮快捷编辑
 - 🖐️ **拖拽排版**：桌面端原生拖拽、移动端长按拖拽；模块可并入某行首/尾、可拆行、整行可排序；**每行最多 6 个模块、泡泡最多 6 行**，图片类模块独占一行且一个泡泡只允许一个
 - 📚 **模块库**：把常用模块"另存"进库，之后在任意泡泡里点击或拖入复用

package/assets/whale-widget.js

@@ -308,8 +308,26 @@ function dshwvSound(url) {
 
 // 自动播放策略：AudioContext 初始是 suspended，要有一次用户手势才能出声；任务结束音不是手势触发的，
 // 所以挂一次性解锁（首次点击/按键后移除）。
+// v789（issue #179）：**输入法组字期间一律不做事**。用户实测"装了插件后微软拼音打字会自动上屏、
+//   光标跳到最前端"（0.3.16/0.3.17 均复现，卸载即恢复）。我们能做的、也是最有把握的一条，是
+//   让挂件在 composition 期间**完全不碰 DOM、不做重活**：往 document.body 挂节点会触发布局，
+//   而首次按键同步创建/预热 AudioContext 也会让组字被打断。所以：
+//   ① 记录 composition 状态，组字中的 keydown 不解锁音频；
+//   ② 组字期间所有 body 增删一律排队，等 compositionend 之后再补（见 dshwBodyAppend）。
+var dshwvComposing = false
+var dshwvDeferredBody = []
+function dshwvComposingNow() { return dshwvComposing === true }
 try {
-  var dshwvAudioUnlock = function () {
+  document.addEventListener('compositionstart', function () { dshwvComposing = true }, true)
+  document.addEventListener('compositionend', function () {
+    dshwvComposing = false
+    setTimeout(function () { try { dshwvFlushDeferredBody() } catch (err) {} }, 0)
+  }, true)
+} catch (err) {}
+try {
+  var dshwvAudioUnlock = function (ev) {
+    // v789（issue #179）：组字中的按键不做音频解锁（isComposing / keyCode 229 = IME 处理中）
+    try { if (dshwvComposing || (ev && (ev.isComposing === true || ev.keyCode === 229))) return } catch (err) {}
     // v753（issue #135）：音效关掉时**不预解锁** —— 否则一次普通点击就会把 context 转成 running，
     // 断言照挂。注意这里**不摘监听**：之后重新打开开关，下一次点击仍能完成解锁。
     if (dshwvSoundOff()) return
@@ -891,9 +909,23 @@ document.head.appendChild(styleEl)
 // 所以这里统一登记：所有挂到 body 的节点都走 dshwBodyAppend()，守护时逐个补挂；
 // 主动移除（目前只有一处）走 dshwBodyDetach()，避免被守护逻辑"复活"。
 var dshwBodyNodes = []
+// v789（issue #179）：输入法组字期间把"往 body 挂节点"的请求排队 —— 改 document.body 的子节点会触发布局，
+//   在 composition 期间做这件事会让浏览器/输入法重置组字（用户实测：打字自动上屏、光标跳到最前端）。
+//   排队到 compositionend 之后再补挂（正常输入时行为完全不变：非组字状态下一律立即挂）。
+function dshwvFlushDeferredBody() {
+  try {
+    if (dshwvComposing || !dshwvDeferredBody.length) return
+    var list = dshwvDeferredBody.slice()
+    dshwvDeferredBody.length = 0
+    for (var i = 0; i < list.length; i++) {
+      try { if (list[i] && list[i].__detach) dshwBodyDetach(list[i].el); else dshwBodyAppend(list[i]) } catch (err) {}
+    }
+  } catch (err) {}
+}
 function dshwBodyAppend(el) {
   try {
     if (!el) return el
+    if (dshwvComposing && dshwvDeferredBody.indexOf(el) < 0) { dshwvDeferredBody.push(el); return el }
     // 注意：这里必须是**原始**的 document.body.appendChild —— 不能走 dshwBodyAppend 自己
     // （v743 批量改写时曾误替换成自我递归，被 try/catch 吞掉后表现为"登记了但从未挂上"）
     document.body.appendChild(el)
@@ -903,6 +935,8 @@ function dshwBodyAppend(el) {
 }
 function dshwBodyDetach(el) {
   try {
+    // v789（issue #179）：组字期间连"移除"也排队（同样是 body 子节点变更，会打断组字）
+    if (dshwvComposing) { dshwvDeferredBody.push({ __detach: true, el: el }); return }
     var i = dshwBodyNodes.indexOf(el)
     if (i >= 0) dshwBodyNodes.splice(i, 1)
     if (el && el.parentNode) el.parentNode.removeChild(el)
@@ -1038,6 +1072,8 @@ if (!window.__dshwCustBound) {
     dshwCustSelClose()
   }, true)
   document.addEventListener('keydown', function (e) {
+    // v789（issue #179）：组字中按 Esc 是输入法的「取消组字」，别抢
+    if (dshwvComposingNow()) return
     if (e.key === 'Escape') dshwCustCloseNow()
   }, true)
   window.addEventListener('resize', function () { dshwCustCloseNow() })
@@ -3576,6 +3612,33 @@ function openApiModelPanel(modelId) {
     var authInp = apiTextInput(bal.auth == null ? 'Bearer {key}' : bal.auth, '请求头模板，{key} 会被替换成密钥')
     var authRow = apiPanelRow('请求头', authInp)
     card.appendChild(authRow)
+    // v789（issue #190）：余额接口不再只能是 GET —— 可选 POST/PUT… + JSON 请求体。
+    //   请求体支持 {key}（密钥）、{base}（Base URL）、{uuid}（下面「请求参数」里的键）
+    var balMethod = apiSelectEl([['GET', 'GET（默认）'], ['POST', 'POST'], ['PUT', 'PUT'], ['PATCH', 'PATCH']],
+      String(bal.method || 'GET').toUpperCase() === 'POST' ? 'POST' : String(bal.method || 'GET').toUpperCase() === 'PUT' ? 'PUT' : String(bal.method || 'GET').toUpperCase() === 'PATCH' ? 'PATCH' : 'GET')
+    var balMethodRow = apiPanelRow('请求方法', balMethod)
+    card.appendChild(balMethodRow)
+    var balBody = apiTextInput(bal.body || '', '如 {"uuid":"{uuid}"}（非 GET 时以 JSON 发送）')
+    var balBodyRow = apiPanelRow('请求体', balBody)
+    card.appendChild(balBodyRow)
+    var prm = (m && m.params) || {}
+    var prmInp = apiTextInput(Object.keys(prm).map(function (k) { return k + '=' + prm[k] }).join(','), '请求体占位符，如 uuid=abc123（逗号分隔）')
+    var prmRow = apiPanelRow('请求参数', prmInp)
+    card.appendChild(prmRow)
+    // v789（issue #189）：0.3.15 起的"凭据目的地白名单"唯一例外必须能在界面上勾 ——
+    //   宿主侧 model.allowCustomHost 一直是齐的，缺的就是这个入口（README/FAQ 都在指引用户来勾）。
+    //   勾选/取消都**显式**传 true/false（宿主按 === true / === false 分支，缺省表示"不改动"）。
+    var allowHost = document.createElement('input')
+    allowHost.type = 'checkbox'
+    allowHost.checked = !!(m && m.balanceDesc && m.balanceDesc.allowCustomHost === true) || !!(m && m.allowCustomHost === true)
+    var allowHostRow = apiPanelRow('允许把凭据发送到自定义地址', allowHost)
+    card.appendChild(allowHostRow)
+    var allowHint = document.createElement('div')
+    allowHint.className = 'dshwv-bubhint'
+    allowHint.style.margin = '0 0 6px'
+    allowHint.textContent = '默认不勾：地址不是该厂商内置端点时，插件会拒绝把密钥发出去。自建网关（New API / 自托管 / Ollama 等）确认是自己的服务后再勾。' +
+      '该开关只能由本机（回环）来源的写请求置位，远端会话改不了它。'
+    card.appendChild(allowHint)
     var jr = (bal.json || {})
     var jRem = apiTextInput(jr.remaining || '', '如 balance_infos[0].total_balance')
     var jTot = apiTextInput(jr.total || '', '如 data.total_credits')
@@ -3648,8 +3711,24 @@ function openApiModelPanel(modelId) {
           balance: {
             url: (balUrl.value || '').trim(),
             auth: (authInp.value || '').trim(),
+            // v789：显式带上方法/请求体（GET + 空体 = 老行为；宿主侧空值不覆盖模板）
+            method: (balMethod.value || 'GET').toUpperCase(),
+            body: (balBody.value || '').trim(),
             json: json,
           },
+          // v789（issue #189）：显式 true/false（不是"仅 true 才传"）—— 用户要能**取消**勾选
+          allowCustomHost: !!allowHost.checked,
+          params: (function () {
+            var o = {}
+            String(prmInp.value || '').split(',').forEach(function (kv) {
+              var i = kv.indexOf('=')
+              if (i <= 0) return
+              var k = kv.slice(0, i).trim()
+              var v = kv.slice(i + 1).trim()
+              if (/^[A-Za-z_][A-Za-z0-9_]{0,30}$/.test(k)) o[k] = v
+            })
+            return o
+          })(),
           matchIds: (matchInp.value || '').split(',').map(function (s) { return s.trim() }).filter(function (s) { return s.length > 0 }),
           price: { hit: (pHit.value || '').trim(), miss: (pMiss.value || '').trim(), out: (pOut.value || '').trim(), cur: pCur.value, rate: (pRate.value || '').trim() },
         },
@@ -6487,7 +6566,7 @@ var bubbleMoreListEl = null
 var bubbleFirstChipEl = null
 var BUBBLE_KIND_LABEL = { normal: '余额内容', random: '随机语句', custom: '自定义内容' }
 // v209 默认泡泡内容 = 与开发者当前线上生效配置一致(全新安装/恢复默认时即此体验)
-// —— 首次点击:标题文本 + 余额数值 + 今日已用 + 峰谷时段
+// —— 首次点击:标题文本 + 总余额 + 今日已用 + 峰谷时段
 function bubbleDefaultFirstModules() {
   // v630:normal/首次 兜底默认 = v615 冻结出厂默认第 1 泡(靛蓝余额卡 5 模块),与「恢复默认」一致;
   // 以下旧体(macaron 版)仅在常量缺失时作兜底参照,不再作为默认内容
@@ -7318,6 +7397,13 @@ var BUBBLE_DEFAULT_ITEMS = [
                                                                                "rgb":  "macaron",
                                                                                "italic":  true,
                                                                                "ul":  false
+                                                                           },
+                                                                           {
+                                                                               "t":  "token 来!",
+                                                                               "w":  3,
+                                                                               "size":  16,
+                                                                               "rgb":  "candy",
+                                                                               "color":  ""
                                                                            }
                                                                        ],
                                                              "size":  8
@@ -7610,7 +7696,10 @@ function bubbleDefaultModules(kind) {
 }
 function bubbleModuleSummary(m) {
   m = m || {}
-  if (m.type === 'balance') return bubbleIsModelMod(m) ? ('余额·' + ((apiModelBalanceInfo(m.modelId) || {}).name || m.modelId)) : '余额数值'
+  if (m.type === 'balance') return bubbleIsModelMod(m) ? ('余额·' + ((apiModelBalanceInfo(m.modelId) || {}).name || m.modelId)) : '总余额(充值金额+赠金)'
+  // v782：赠金 / 充值余额（均为内置数值模块，无 modelId）；v787 按用户要求改显示文案
+  if (m.type === 'bonus') return '赠金'
+  if (m.type === 'recharge') return '充值余额'
   if (m.type === 'today') return bubbleIsModelMod(m) ? ('今日已用·' + ((apiModelBalanceInfo(m.modelId) || {}).name || m.modelId)) : '今日已用'
   if (m.type === 'session') return '对话名' + (Number(m.len) > 0 ? '(保留 ' + Math.round(Number(m.len)) + ' 字)' : '(不截断)')
   if (m.type === 'quota') return '额度·' + ((apiModelById(m.modelId) || {}).name || m.modelId)
@@ -7628,7 +7717,10 @@ function bubbleModuleListLabel(m) {
   if (m.type === 'text') return '文本: ' + (String(m.text || '').slice(0, 24) || '(空)')
   if (m.type === 'link') return '超链接: ' + (String(m.text || '').slice(0, 24) || '打开链接')
   if (m.type === 'random') return m.name || '随机语句' // 只显示模块名,不展示内部句子
-  if (m.type === 'balance') return bubbleIsModelMod(m) ? ('余额·' + ((apiModelBalanceInfo(m.modelId) || {}).name || m.modelId)) : '余额数值'
+  if (m.type === 'balance') return bubbleIsModelMod(m) ? ('余额·' + ((apiModelBalanceInfo(m.modelId) || {}).name || m.modelId)) : '总余额(充值金额+赠金)'
+  // v782：赠金 / 充值余额（v787 改显示文案）
+  if (m.type === 'bonus') return '赠金'
+  if (m.type === 'recharge') return '充值余额'
   if (m.type === 'today') return bubbleIsModelMod(m) ? ('今日已用·' + ((apiModelBalanceInfo(m.modelId) || {}).name || m.modelId)) : '今日已用'
   if (m.type === 'session') return '对话名' + (Number(m.len) > 0 ? '(保留 ' + Math.round(Number(m.len)) + ' 字)' : '(不截断)')
   if (m.type === 'quota') return '额度·' + ((apiModelById(m.modelId) || {}).name || m.modelId)
@@ -8168,7 +8260,31 @@ function bubbleEditorDirty() {
     return bubbleEditorSnap !== JSON.stringify([bubbleEditItems, bubbleLib, bubbleTapAdvChk.checked])
   } catch (err) { return true }
 }
+// v783：打开编辑器前**先从宿主重读一遍配置**。为什么必须重读：泡泡配置只在页面加载时取一次
+//   （loadBubbleCfg），之后一直用内存里的 bubbleCfg 副本；而桌面端 + 网页端（或两个标签页）会**各持一份**，
+//   谁最后点「保存」谁就把自己那份写回去 ⇒ 在 A 里删掉的模块（或模块库条目）会被 B 的过期副本**写回来**，
+//   表现就是"删了很久的自定义模块又冒出来了"。读失败时保持原值（离线/接口异常行为不变）。
+function refreshBubbleCfgFromHost(cb) {
+  var done = function () { try { cb() } catch (err) {} }
+  try {
+    fetch(BUBBLE_URL, { cache: 'no-store' })
+      .then(function (r) { return r.json() })
+      .then(function (d) {
+        if (d && d.ok && d.config) {
+          bubbleCfg = d.config
+          bubbleLib = (d.config.lib && Array.isArray(d.config.lib)) ? JSON.parse(JSON.stringify(d.config.lib)) : []
+          bubbleTapAdvance = d.config.tapAdvance === true // v727
+          try { applyBubbleCfgSeq() } catch (err) {}
+        }
+      })
+      .catch(function () {})
+      .then(done, done)
+  } catch (err) { done() }
+}
 function openBubbleEditor() {
+  refreshBubbleCfgFromHost(function () { openBubbleEditorWithCache() })
+}
+function openBubbleEditorWithCache() {
   try {
     closeRolePanel()
     closeAudioGroupPanel()
@@ -8355,6 +8471,8 @@ function qeditEnsure() {
       qeditClose()
     }, true)
     document.addEventListener('keydown', function (e) {
+      // v789（issue #179）：组字中按 Esc 是输入法的事，别抢
+      if (dshwvComposingNow()) return
       if (e.key === 'Escape') qeditClose()
     })
   }
@@ -8676,8 +8794,8 @@ function openQuickModuleEditor(m, anchorBtn) {
     var isModelBal = bubbleIsModelMod(m) && (m.type === 'balance' || m.type === 'today')
     var isModelQuota = bubbleIsModelMod(m) && m.type === 'quota'
     var isModelPlan = bubbleIsModelMod(m) && m.type === 'plan'
-    inp.placeholder = isModelPlan ? '例: {plan} 额度 · {plan_reset} 刷新时间' : (isModelQuota ? '例: 额度 {quota} · 剩 {quota_left}' : (isModelBal ? '例: {balance} 或 今日 {today}' : (m.type === 'balance' ? '例: {balance_ds}' : (m.type === 'today' ? '例: 今日已用 {expense_ds}' : (m.type === 'session' ? '例: {session} 或 当前对话 {session}' : (bubbleIsPeakCount(m) ? '例: 距空闲 {countdown}' : '例: 当前 {status}'))))))
-    inp.title = '可用占位符(英文): ' + (isModelPlan ? '{plan} 额度 / {plan_left} 剩余 / {plan_reset} 刷新时间（多窗口时随「显示样式」所选窗口变化）' : (isModelQuota ? '{quota} / {quota_used} / {quota_left} / {quota_total} / {quota_reset}' : (isModelBal ? '{balance} / {today}' : (m.type === 'peak' || m.type === 'nextpeak' ? '{status} / {countdown}' : (m.type === 'balance' ? '{balance_ds}' : (m.type === 'today' ? '{expense_ds}' : (m.type === 'session' ? '{session} 当前对话名（按「保留长度」截断）' : '{expense_ds}')))))))
+    inp.placeholder = isModelPlan ? '例: {plan} 额度 · {plan_reset} 刷新时间' : (isModelQuota ? '例: 额度 {quota} · 剩 {quota_left}' : (isModelBal ? '例: {balance} 或 今日 {today}' : (m.type === 'balance' ? '例: {balance_ds}' : (m.type === 'bonus' ? '例: {bonus_ds} 或 赠金 {bonus_ds}' : (m.type === 'recharge' ? '例: {recharge_ds} 或 余额 {recharge_ds}' : (m.type === 'today' ? '例: 今日已用 {expense_ds}' : (m.type === 'session' ? '例: {session} 或 当前对话 {session}' : (bubbleIsPeakCount(m) ? '例: 距空闲 {countdown}' : '例: 当前 {status}'))))))))
+    inp.title = '可用占位符(英文): ' + (isModelPlan ? '{plan} 额度 / {plan_left} 剩余 / {plan_reset} 刷新时间（多窗口时随「显示样式」所选窗口变化）' : (isModelQuota ? '{quota} / {quota_used} / {quota_left} / {quota_total} / {quota_reset}' : (isModelBal ? '{balance} / {today}' : (m.type === 'peak' || m.type === 'nextpeak' ? '{status} / {countdown}' : (m.type === 'balance' ? '{balance_ds}' : (m.type === 'bonus' ? '{bonus_ds}' : (m.type === 'recharge' ? '{recharge_ds}' : (m.type === 'today' ? '{expense_ds}' : (m.type === 'session' ? '{session} 当前对话名（按「保留长度」截断）' : '{expense_ds}')))))))))
     inp.addEventListener('input', function () { m.tpl = inp.value; changed() })
     r.appendChild(inp)
     var qb2 = document.createElement('button')
@@ -8874,7 +8992,12 @@ function renderBubblePal() {
   bubblePalEl.innerHTML = ''
   var defs = [
     { key: 'text', label: '文本', cb: function () { bubbleModuleAdd({ type: 'text', text: '新内容', size: 6, bold: true }) } },
-    { key: 'balance', label: '余额数值', pin: true, cb: function () { bubbleModuleAdd({ type: 'balance', size: 11, tpl: '{balance_ds}' }) } },
+    { key: 'balance', label: '总余额(充值金额+赠金)', pin: true, cb: function () { bubbleModuleAdd({ type: 'balance', size: 11, tpl: '{balance_ds}' }) } },
+    // v782：把「总余额」拆出的两个分量各自做成模块 —— 赠金（未过期赠送余额）与充值余额。
+    //   ⚠️ 上面那条 `balance` / `{balance_ds}` 的**代码名字与行为一律不动**（历史泡泡与已保存的模块里
+    //   存的是 type/tpl 字面量，改代码名会让老内容显示不出来）；v787 只按用户要求改了**显示文案**。
+    { key: 'bonus', label: '赠金', pin: true, cb: function () { bubbleModuleAdd({ type: 'bonus', size: 11, tpl: '{bonus_ds}' }) } },
+    { key: 'recharge', label: '充值余额', pin: true, cb: function () { bubbleModuleAdd({ type: 'recharge', size: 11, tpl: '{recharge_ds}' }) } },
     { key: 'today', label: '今日已用', pin: true, cb: function () { bubbleModuleAdd({ type: 'today', size: 1, tpl: '今日已用 {expense_ds}' }) } },
     { key: 'peak', label: '峰谷时段', pin: true, cb: function () { bubbleModuleAdd({ type: 'peak', size: 4, peakColor: '#e0433f', offColor: '#2fa24c', tpl: '{status}' }) } },
     { key: 'nextpeak', label: '时段倒计时', pin: true, cb: function () { bubbleModuleAdd({ type: 'peak', size: 6, bold: true, peakStyle: 'count', peakColor: '#e0433f', offColor: '#2fa24c', tpl: '{countdown}' }) } },
@@ -9098,7 +9221,8 @@ function bubbleModuleEdit(m, anchorBtn) {
   try {
     if (m && (m.type === 'text' || m.type === 'link')) { openQuickTextEditor(m, anchorBtn); return }
     // v769：对话名也走悬浮编辑（像文本那样边改边看效果），不再开整窗编辑器
-    if (m && (m.type === 'balance' || m.type === 'today' || m.type === 'peak' || m.type === 'nextpeak' || m.type === 'session')) { openQuickModuleEditor(m, anchorBtn); return }
+    // v782：赠金 / 充值余额同样是内置数值模块 ⇒ 也走悬浮编辑（内容锁定，只调字号/颜色/模板）
+    if (m && (m.type === 'balance' || m.type === 'bonus' || m.type === 'recharge' || m.type === 'today' || m.type === 'peak' || m.type === 'nextpeak' || m.type === 'session')) { openQuickModuleEditor(m, anchorBtn); return }
     openModuleEditor(m, function (saved) { if (saved) renderBubblePv() })
   } catch (err) {}
 }
@@ -9197,6 +9321,9 @@ function bubblePvPaletteToRow(key, ri) {
 function bubblePaletteModule(key) {
   if (key === 'text') return { type: 'text', text: '新内容', size: 6, bold: true }
   if (key === 'balance') return { type: 'balance', size: 11, tpl: '{balance_ds}' }
+  // v782：赠金 / 充值余额（拖拽路径；与上面「总余额(充值金额+赠金)」并列的两个内置数值模块）
+  if (key === 'bonus') return { type: 'bonus', size: 11, tpl: '{bonus_ds}' }
+  if (key === 'recharge') return { type: 'recharge', size: 11, tpl: '{recharge_ds}' }
   if (key === 'today') return { type: 'today', size: 1, tpl: '今日已用 {expense_ds}' }
   if (key === 'peak') return { type: 'peak', size: 4, peakColor: '#e0433f', offColor: '#2fa24c', tpl: '{status}' }
   if (key === 'nextpeak') return { type: 'peak', size: 6, bold: true, peakStyle: 'count', peakColor: '#e0433f', offColor: '#2fa24c', tpl: '{countdown}' }
@@ -10278,7 +10405,10 @@ function bubbleFontEditRow(getVal, setVal) {
   return row
 }
 function moduleTypeName(t, m) {
-  if (t === 'balance') return '余额数值'
+  if (t === 'balance') return '总余额(充值金额+赠金)'
+  // v782：赠金 / 充值余额两个数值模块的类型名（v787 改显示文案）
+  if (t === 'bonus') return '赠金'
+  if (t === 'recharge') return '充值余额'
   if (t === 'today') return '今日已用'
   if (t === 'session') return '对话名'
   if (t === 'peak' || t === 'nextpeak') {
@@ -10326,6 +10456,8 @@ function renderModuleEditor() {
     inp.value = m.tpl || ''
     function hintOf() {
       if (m.type === 'balance') return '例: {balance_ds}'
+      if (m.type === 'bonus') return '例: {bonus_ds} 或 赠金 {bonus_ds}'
+      if (m.type === 'recharge') return '例: {recharge_ds} 或 余额 {recharge_ds}'
       if (m.type === 'today') return '例: 今日已用 {expense_ds}'
       if (m.type === 'session') return '例: {session} 或 当前对话 {session}'
       if (bubbleIsPeakCount(m)) return '例: 距空闲 {countdown}'
@@ -11728,6 +11860,42 @@ bubbleBox.addEventListener('click', function (e) {
   bubbleNext()
 })
 
+// ===== v785：桌面客户端「窗口控件带」不进入挂件的可移动范围 =====
+// 背景（用户 2026-10-02 反馈）：客户端右上角的最小化/最大化/关闭会盖在泡泡上方。
+// 查证：DSH 桌面端产品窗口用 Electron `titleBarStyle:'hidden'` + **`titleBarOverlay`**
+//   （主进程写死 height:40；macOS 是 `hiddenInset` + 左上 traffic light）—— 那三个键由**浏览器引擎**
+//   画在所有页面内容之上 ⇒ **CSS/z-index 永远盖不过去**（不是我们层级写低了）。
+// 修法（用户指定）：不做层级对抗、也不平移泡泡，而是**把整条顶带排除在挂件的可移动范围之外**：
+//   挂件顶边（root.top）一律 ≥ 叠层下沿 ⇒ 画在 root 内部的泡泡自然也在带下，
+//   而鲸鱼与泡泡的相对位置**完全不变**（比"泡泡自己下移"更干净）。
+var DESKTOP_TITLEBAR_FALLBACK = 44 // 主进程 titleBarOverlay.height = 40，+4 余量
+function desktopTitlebarBottom() {
+  var wco = null
+  try { wco = navigator.windowControlsOverlay } catch (err) { wco = null }
+  // 没有叠层对象（普通浏览器 / 手机浏览器）或叠层不可见 ⇒ 不需要排除
+  if (!wco || wco.visible === false) return 0
+  // 有叠层：优先用官方矩形；取不到（旧内核/异常）就退回主进程里那个高度，**不能返回 0**
+  try {
+    if (typeof wco.getTitlebarAreaRect === 'function') {
+      var r = wco.getTitlebarAreaRect()
+      if (r && isFinite(r.y) && isFinite(r.height) && r.height > 0) return Math.max(0, Math.round(r.y + r.height))
+    }
+  } catch (err) {}
+  return DESKTOP_TITLEBAR_FALLBACK
+}
+// 挂件顶边的**下限**（0 = 不限制，普通浏览器就是 0）
+function widgetTopMin() {
+  try { return Math.max(0, desktopTitlebarBottom()) } catch (err) { return 0 }
+}
+// 把「挂件顶边」夹进可移动范围：[顶带下沿, 视口内上限]
+function clampWidgetTop(v, maxT) {
+  var min = widgetTopMin()
+  var t = Number(v)
+  if (!isFinite(t)) t = min
+  var hi = Infinity
+  if (maxT !== undefined && isFinite(Number(maxT))) hi = Math.max(min, Number(maxT))
+  return Math.max(min, Math.min(t, hi))
+}
 var body = document.createElement('div')
 body.className = 'dshwv-body'
 body.appendChild(img)
@@ -11828,6 +11996,10 @@ var state = {
   top: 0,
   balance: null,
   currency: null,
+  // v781：余额的两个分量（赠金 / 充值余额）。宿主在 API key 路与 DSH 账号路都会下发；
+  //   取不到时保持 null ⇒ 模块显示 `—`（见 bubbleBonusText/bubbleRechargeText）。
+  bonusBalance: null,
+  rechargeBalance: null,
   todayUsage: null,
   todayUsageCurrency: 'CNY',
   usageLabel: '本地估算',
@@ -12080,6 +12252,32 @@ function restoreBubbleLines() {
 // 消耗=showCostBubble)独立触发, 消耗优先级最高可顶掉当前并暂停手动轮。
 var costBubbleTimer = null // 旧版计时器保留声明(新版 bubbleClearAll 仍清理)
 var bubbleTtlTimer = null
+// v789（issue #188/#172）：泡泡的自动收起**不能只靠 setTimeout** —— 页面被遮挡 / 最小化 / 切到后台时，
+// 浏览器会把定时器节流甚至挂起，于是"5 秒后收起"变成几十秒甚至永远不收（用户实测：点击泡一直不消失、
+// 刷新即恢复）。所以同时记一个**截止时刻**，在页面重新可见 / 拿到焦点时结算一次；再配一个每秒巡检兜底。
+var bubbleTtlDeadline = 0
+function bubbleTtlArmed(ttlMs) {
+  try { if (ttlMs > 0) bubbleTtlDeadline = Date.now() + ttlMs; else bubbleTtlDeadline = 0 } catch (err) { bubbleTtlDeadline = 0 }
+}
+function bubbleTtlClear() { bubbleTtlDeadline = 0 }
+// 巡检：只在"本该已经到期"且计时器已经不在了（被节流/挂起）时补收一次
+function bubbleTtlSweep() {
+  try {
+    if (bubbleTtlTimer || !bubbleTtlDeadline) return
+    if (!bubbleScene || !(bubbleScene.ttlMs > 0)) { bubbleTtlDeadline = 0; return }
+    if (Date.now() < bubbleTtlDeadline) return
+    bubbleTtlDeadline = 0
+    bubbleAutoClose()
+  } catch (err) {}
+}
+// 三条触发路径：页面重新可见（切标签回来）、窗口重新拿到焦点（最小化还原）、以及每秒一次的兜底巡检。
+// 正常前台运行时计时器按时收敛，巡检永远提前返回（不会误收下一个泡泡）。
+try {
+  document.addEventListener('visibilitychange', function () { try { if (!document.hidden) bubbleTtlSweep() } catch (err) {} })
+  window.addEventListener('focus', function () { bubbleTtlSweep() })
+  window.addEventListener('pageshow', function () { bubbleTtlSweep() })
+  setInterval(bubbleTtlSweep, 1000)
+} catch (err) {}
 var bubbleScene = null // { kind:'normal'|'random'|'cost', ttlMs }
 var bubbleSeq = bubbleDefaultQueue() // 默认序列 = 与开发者线上生效一致(首次=余额,再次=随机语句);有配置后由 applyBubbleCfgSeq 覆盖
 var bubbleSeqIdx = 0 // 下一项下标(手动轮内推进)
@@ -12301,6 +12499,8 @@ function bubbleClearAll() {
   try { if (settleTimer) { clearTimeout(settleTimer); settleTimer = null } } catch (err) {}
 }
 function bubbleCloseVisual() {
+  // v789（issue #188）：视觉收起是"泡泡真的收掉了"的唯一出口 ⇒ 顺带把截止时刻清零（三处对齐之二）
+  bubbleTtlClear()
   // v771：泡泡一旦真的收起，等待标记必须一起复位。`waitShown` 平时由 bubbleRenderModules 按场景重算，
   // 但"整泡关闭"（hideBubble/hideCostBubble/hideWaitBubble…）不走渲染 ⇒ 不复位就会残留成 true，
   // 之后 showWaitBubble 会误判"已经在显示等待泡泡"（历史上正是这类不同步把等待泡泡卡死的）。
@@ -12349,7 +12549,8 @@ function sceneOpen(kind, renderFn, ttlMs) {
         }, 180)
       } catch (err) {}
     }
-    if (ttlMs > 0) bubbleTtlTimer = setTimeout(bubbleAutoClose, ttlMs)
+    if (ttlMs > 0) { bubbleTtlArmed(ttlMs); bubbleTtlTimer = setTimeout(bubbleAutoClose, ttlMs) }
+    else bubbleTtlClear()
   }
   if (wasOpen) {
     // 内容切换:旧内容先淡出,再换新内容并淡入(可被新场景/关闭随时打断)
@@ -12369,6 +12570,8 @@ function sceneOpen(kind, renderFn, ttlMs) {
 }
 function bubbleAutoClose() {
   bubbleTtlTimer = null
+  // v789：走完这条就说明本次 TTL 已经结算，截止时刻必须清零，否则巡检会误收下一个泡泡
+  bubbleTtlClear()
   if (bubbleScene && bubbleScene.kind === 'cost') { if (whaleSysSwapNext()) return; hideCostBubble(); return }
   if (bubbleScene && bubbleScene.kind === 'alert') { if (whaleSysSwapNext()) return; hideUsageAlertBubble(); return }
   // v761（#161 C5）：等待交互泡泡是**常驻**的（sceneOpen 收到 ttl 0 不布计时器），正常永远走不到这里；
@@ -12379,7 +12582,9 @@ function bubbleAutoClose() {
 // 重置当前泡泡的留存计时(点鲸鱼给第 1 泡续时,不清内容)
 function bubbleResetTtl() {
   try { if (bubbleTtlTimer) { clearTimeout(bubbleTtlTimer); bubbleTtlTimer = null } } catch (err) {}
-  if (bubbleScene && bubbleScene.ttlMs > 0) bubbleTtlTimer = setTimeout(bubbleAutoClose, bubbleScene.ttlMs)
+  // v789：续时也要同步截止时刻，否则巡检会在"刚续过"的泡泡上提前动作（issue #188 提醒的三处对齐之一）
+  if (bubbleScene && bubbleScene.ttlMs > 0) { bubbleTtlArmed(bubbleScene.ttlMs); bubbleTtlTimer = setTimeout(bubbleAutoClose, bubbleScene.ttlMs) }
+  else bubbleTtlClear()
 }
 // 默认内容视图 = 现在待机内容(余额/今日已用),由 render/restore 维护
 function bubbleRenderDefault() { restoreBubbleLines() }
@@ -12444,8 +12649,11 @@ function bubbleShowSeqNext() {
   }
 }
 // ===== 模块渲染引擎(B1) =====
-// 模块:{type:'text'|'balance'|'today'|'peak'|'session'|'image'|'random', text?, imgId?, color?, size?(1..8 档),
+// 模块:{type:'text'|'balance'|'bonus'|'recharge'|'today'|'peak'|'session'|'image'|'random', text?, imgId?, color?, size?(1..8 档),
 //        lines?:[{t,w}] (random 自带句子列表), tpl?(占位符模板), len?(session 的「保留长度」，0=不截断)}
+//   v782 新增 'bonus'（赠金）与 'recharge'（充值余额）：与 'balance' 并列的内置数值模块，
+//   分别用占位符 {bonus_ds} / {recharge_ds}；**'balance' / '{balance_ds}' 的名字与行为一律不动**
+//   （历史泡泡里存的是这些字面量，改名会让老内容显示不出来）。
 // 字号档位 1..50,线性细分(1→40u … 50→240u,相对 --dshw-u 的倍数)
 function bubbleModuleFontU(level) {
   var n = Number(level) || 6
@@ -12460,6 +12668,19 @@ function bubbleAmountText() {
 function bubbleTodayText() {
   return (state.usageLabel || '今日已用') + ' ' + (state.todayUsage !== null && state.todayUsage !== undefined ? fmt(state.todayUsage, state.todayUsageCurrency || state.currency) : '--')
 }
+// v782：赠金 / 充值余额两个数值模块的取数（与「总余额(充值金额+赠金)」同源：宿主余额返回体）。
+//   ⚠️ 两个数字**可能拿不到**（厂商没有该字段、或未登录账号）⇒ 显示 `—`，**不显示 0**
+//   —— 0 的意思是"确实没有了"，与"读不到"是两件事（记账也依赖这个区分）。
+function bubbleBonusText() {
+  var v = state.bonusBalance
+  if (v === null || v === undefined || !isFinite(Number(v))) return '—'
+  return fmt(Number(v), state.currency)
+}
+function bubbleRechargeText() {
+  var v = state.rechargeBalance
+  if (v === null || v === undefined || !isFinite(Number(v))) return '—'
+  return fmt(Number(v), state.currency)
+}
 // 模块「内容」模板:占位符统一英文(便于兼容其他模型 API 时区分来源/字段):
 //   {expense_ds} 今日已用金额 · {balance_ds} 余额 · {status} 高峰/空闲状态字 · {countdown} 倒计时
 // —— 自定义 API 模型的余额/今日已用（Phase 3）——
@@ -12829,6 +13050,12 @@ function bubbleContentTokenMap(m) {
   if (m.type === 'balance') {
     v = bubbleAmountText()
     map['balance_ds'] = v
+  } else if (m.type === 'bonus') {
+    // v782：赠金模块（{bonus_ds}）。取不到数 = '—'，不显示 0。
+    map['bonus_ds'] = bubbleBonusText()
+  } else if (m.type === 'recharge') {
+    // v782：充值余额模块（{recharge_ds}）。
+    map['recharge_ds'] = bubbleRechargeText()
   } else if (m.type === 'today') {
     v = (state.todayUsage !== null && state.todayUsage !== undefined ? fmt(state.todayUsage, state.todayUsageCurrency || state.currency) : '--')
     map['expense_ds'] = v
@@ -12866,7 +13093,9 @@ function bubbleTplHelpItems(m) {
     add('plan_reset', '订阅额度刷新倒计时（同上；全部窗口时为紧凑倒计时）')
     return arr
   }
-  if (m.type === 'balance') add('balance_ds', '余额数值')
+  if (m.type === 'balance') add('balance_ds', '总余额(充值金额+赠金)')
+  if (m.type === 'bonus') add('bonus_ds', '赠金余额（未过期的赠送余额；取不到显示 —）')
+  if (m.type === 'recharge') add('recharge_ds', '充值余额（不含赠金；取不到显示 —）')
   else if (m.type === 'today') add('expense_ds', '今日已用金额')
   else if (m.type === 'session') add('session', '当前对话名（超过「保留长度」会截断为 前N字...）')
   else if (m.type === 'peak' || m.type === 'nextpeak') {
@@ -12889,7 +13118,7 @@ function bubbleTplHelpToggle(m, anchor) {
         } catch (err) {}
         dshwvTplHelpEl.style.display = 'none'
       }, true)
-      document.addEventListener('keydown', function (e) { if (e.key === 'Escape') dshwvTplHelpEl.style.display = 'none' })
+      document.addEventListener('keydown', function (e) { if (dshwvComposingNow()) return; if (e.key === 'Escape') dshwvTplHelpEl.style.display = 'none' })
     }
     if (dshwvTplHelpEl.style.display === 'block') { dshwvTplHelpEl.style.display = 'none'; return }
     var items = bubbleTplHelpItems(m)
@@ -12933,7 +13162,7 @@ function dshwvHintEnsure() {
     } catch (err) {}
     dshwvHintHide()
   }, true)
-  document.addEventListener('keydown', function (e) { if (e.key === 'Escape') dshwvHintHide() })
+  document.addEventListener('keydown', function (e) { if (dshwvComposingNow()) return; if (e.key === 'Escape') dshwvHintHide() })
   return dshwvHintEl
 }
 function dshwvHintShow(html, anchor, pinned) {
@@ -13264,6 +13493,9 @@ function bubbleRowContentOf(mod) {
     var bv = bubbleIsModelMod(mod) ? apiModelBalanceText(mod.modelId) : bubbleAmountText()
     return { txt: bubbleContentText(mod, bv), line: null }
   }
+  // v782：赠金 / 充值余额两个数值模块（与「总余额(充值金额+赠金)」并列，取不到数时自动文案是 —）
+  if (mod.type === 'bonus') return { txt: bubbleContentText(mod, bubbleBonusText()), line: null }
+  if (mod.type === 'recharge') return { txt: bubbleContentText(mod, bubbleRechargeText()), line: null }
   if (mod.type === 'today') {
     var tv2 = bubbleIsModelMod(mod) ? apiModelTodayText(mod.modelId) : (state.todayUsage !== null && state.todayUsage !== undefined ? fmt(state.todayUsage, state.todayUsageCurrency || state.currency) : '--')
     return { txt: bubbleContentText(mod, '今日已用 ' + tv2), line: null }
@@ -14032,6 +14264,10 @@ function express() {
   root.style.right = 'auto'
   root.style.bottom = 'auto'
   root.style.left = state.left + 'px'
+  // v785：最后一道保险 —— 所有"写 state.top"的路径最终都会走到这里，统一把顶边夹出"窗口控件带"
+  // （拖动/吸附/settle 各自也夹了一次；这里兜住启动、自愈、外部直接改 state 等路径）。
+  // 见 clampWidgetTop：下限 = 叠层下沿（普通浏览器为 0 ⇒ 与以前完全一致）。
+  state.top = clampWidgetTop(state.top)
   root.style.top = state.top + 'px'
   root.classList.toggle('dshwv-left', !!state.flip)
 }
@@ -14042,7 +14278,7 @@ function settle() {
   if (drag && drag.active) {
     // mid-drag resize: keep the pointer-follow position, just clamp into view
     state.left = clamp(state.left, 0, Math.max(0, vp.w - w - rightGap()))
-    state.top = clamp(state.top, 0, Math.max(0, vp.h - h))
+    state.top = clampWidgetTop(state.top, Math.max(0, vp.h - h))
     express()
     return
   }
@@ -14066,22 +14302,22 @@ function settle() {
   }
   if (state.v === 'bottom') {
     var rawB = vp.h - h - state.vOff
-    state.top = clamp(rawB, 0, maxT)
+    state.top = clampWidgetTop(rawB, maxT)
     if (state.top !== rawB) outOfRange = true
   } else if (state.v === 'top') {
     var rawT = state.vOff
-    state.top = clamp(rawT, 0, maxT)
+    state.top = clampWidgetTop(rawT, maxT)
     if (state.top !== rawT) outOfRange = true
   } else {
-    state.top = clamp(state.top, 0, maxT)
+    state.top = clampWidgetTop(state.top, maxT)
   }
   // 偏移确实越界（脏数据 / 视口变小）：先把偏移夹回合法范围再落盘，下次启动不再复现。
   // 只在真的越界时写，正常 resize 不会产生额外的 localStorage 写入。
   if (outOfRange) {
     if (state.h === 'right') state.hOff = clamp(state.hOff, 0, Math.max(0, vp.w - w - rightGap()))
     else if (state.h === 'left') state.hOff = clamp(state.hOff, 0, maxLAnchor)
-    if (state.v === 'bottom') state.vOff = clamp(state.vOff, 0, maxT)
-    else if (state.v === 'top') state.vOff = clamp(state.vOff, 0, maxT)
+    if (state.v === 'bottom') state.vOff = clamp(state.vOff, 0, Math.max(0, maxT - widgetTopMin()))
+    else if (state.v === 'top') state.vOff = clamp(state.vOff, widgetTopMin(), maxT)
     try { saveAnchorPos() } catch (err) {}
   }
   refreshFlip()
@@ -14189,6 +14425,9 @@ function refresh(manual) {
         balanceRetryLeft = 2
         state.todayUsage = data.todayUsage !== undefined ? data.todayUsage : null
         state.todayUsageCurrency = data.todayUsageCurrency || data.currency || 'CNY'
+        // v781：赠金 / 充值余额（宿主两条路都下发；缺失给 null ⇒ 模块显示 —）
+        state.bonusBalance = isFinite(Number(data.bonusBalance)) ? Number(data.bonusBalance) : null
+        state.rechargeBalance = isFinite(Number(data.rechargeBalance)) ? Number(data.rechargeBalance) : null
         state.usageLabel = data.usageLabel || '本地估算'
         if (data.stale) state.usageLabel += ' · 余额未刷新'
         state.isPeak = !!data.isPeak
@@ -14223,6 +14462,9 @@ function refresh(manual) {
       } else {
         state.status = 'error'
         state.message = (data && data.error) ? String(data.error) : '获取失败'
+        // v781：把宿主的错误码也打到控制台 —— "只登录客户端读不到余额"这类反馈里，
+        //   界面只显示一句人类可读的文案，而 code（NO_KEY / BOTH_FAILED / SHAPE …）才是排查入口。
+        try { console.warn('[dsh-whale] 余额读取失败', (data && data.code) || '', state.message) } catch (err) {}
         render()
         balanceRetryLater()
       }
@@ -14478,7 +14720,7 @@ function setScale(v) {
   } else {
     state.left = Math.min(Math.max(fx - r2.width, 0), Math.max(0, vp.w - r2.width))
   }
-  state.top = Math.min(Math.max(fy - r2.height, 0), Math.max(0, vp.h - r2.height))
+  state.top = clampWidgetTop(Math.min(Math.max(fy - r2.height, 0), Math.max(0, vp.h - r2.height)))
   express()
   // 恢复过渡必须延迟到下一帧：本帧 left/top 已在 none 下设置并提交，
   // 立即恢复会让浏览器对「刚改过的 left/top」重新评估并播放过渡动画
@@ -16489,7 +16731,8 @@ function onDocPointerMove(e) {
   // were); on release endDrag() recomputes the anchors and settle() flips the
   // class with a smooth transition instead of reverting instantly.
   state.left = clamp(drag.origLeft + dx, 0, Math.max(0, drag.vp.w - drag.w))
-  state.top = clamp(drag.origTop + dy, 0, Math.max(0, drag.vp.h - drag.h))
+  // v785：拖拽时就把"桌面端窗口控件带"排除在可移动范围外（顶边下限 = 叠层下沿）
+  state.top = clampWidgetTop(drag.origTop + dy, Math.max(0, drag.vp.h - drag.h))
   express()
 }
 function onDocPointerUp(e) {
@@ -16741,7 +16984,8 @@ function endDrag(e, clickAllowed, cancelled) {
   var dx = e.clientX - drag.startX
   var dy = e.clientY - drag.startY
   var left = clamp(drag.origLeft + dx, 0, Math.max(0, drag.vp.w - drag.w))
-  var top = clamp(drag.origTop + dy, 0, Math.max(0, drag.vp.h - drag.h))
+  // v785：落位计算也要先排除"窗口控件带"（否则吸附判定点会用到带内的 top）
+  var top = clampWidgetTop(drag.origTop + dy, Math.max(0, drag.vp.h - drag.h))
   // 自定义吸附区（比例/绝对/关闭）。判定点：左右吸附/翻转 = 图像中心 x，
   // 下吸附 = 图像中心 y，上吸附 = 挂件盒中心 y。
   // 解析计算，避免拖动结束过渡期强制布局。
@@ -16797,7 +17041,8 @@ function applyAnchorPos() {
     var l = a.hAnchor === 'left' ? hDist : vp.w - effectiveRightDist - w
     var t = a.vAnchor === 'top' ? vDist : vp.h - vDist - h
     state.left = clamp(l, 0, maxOffH)
-    state.top = clamp(t, 0, maxOffV)
+    // v785：锚点自愈/恢复也要排除"窗口控件带"（这条路径不一定紧跟 express，所以就地夹）
+    state.top = clampWidgetTop(clamp(t, 0, maxOffV), maxOffV)
     state.h = a.hAnchor
     // 净距离直接还给 hOff/vOff：settle() 对锚定状态从偏移量重算，
     // 若置 0 会把刚恢复的距离覆盖成贴边（issue #43）

package/lib/accounting.mjs

@@ -29,6 +29,41 @@ export function dayOffset(day, offset) {
   return beijingDay(Date.parse(day + 'T00:00:00+08:00') + offset * 86400000)
 }
 
+// v789（issue #184）：partialDay 改为**按实际观测缺口就地计算**，不再是硬编码 true。
+//   为什么要有这个：记账只发生在「客户端界面开着 + 余额能取到」的时候，任一条不成立就完全不观测；
+//   跨零点的那一段（新建当日行时 openingUnits 直接取"此刻余额"）会被新当天的起点吞掉，
+//   于是「今日已用」长期显示一个明显偏小的数字，而界面上**没有任何"这是部分数据"的提示**。
+//   判据（issue 里给出的算法）：观测起点距当日 00:00、或（对已经过去的日子）最后一次观测距次日 00:00，
+//   超过 GAP_MS 就视为部分数据。正常运行时两个缺口都只有几分钟 ⇒ false，不会误伤正常日。
+const PARTIAL_GAP_MS = 10 * 60 * 1000
+function partialDayOf(day, row, now) {
+  try {
+    const start = Date.parse(String(day) + 'T00:00:00+08:00')
+    if (!Number.isFinite(start)) return true
+    const end = start + 86400000
+    const first = Number(row && row.firstAt)
+    const last = Number(row && row.lastAt)
+    if (!Number.isFinite(first) || !Number.isFinite(last)) return true
+    const beforeGap = first - start
+    const afterGap = Number(now) >= end ? (end - last) : 0
+    return beforeGap > PARTIAL_GAP_MS || afterGap > PARTIAL_GAP_MS
+  } catch (err) { return true }
+}
+export function partialDayInfo(day, row, now = Date.now()) {
+  const start = Date.parse(String(day) + 'T00:00:00+08:00')
+  const partialDay = partialDayOf(day, row, now)
+  const first = Number(row && row.firstAt)
+  const last = Number(row && row.lastAt)
+  return {
+    partialDay,
+    // 给界面用：从几点才开始有观测（缺口在起点）/ 那天几点之后就没再观测（缺口在末尾）
+    observedFromMs: Number.isFinite(first) ? first : null,
+    observedToMs: Number.isFinite(last) ? last : null,
+    leadingGapMs: Number.isFinite(first) && Number.isFinite(start) ? Math.max(0, first - start) : null,
+    trailingGapMs: Number.isFinite(last) && Number.isFinite(start) && now >= start + 86400000 ? Math.max(0, start + 86400000 - last) : 0,
+  }
+}
+
 function currentBook(ledger) {
   const a = ledger.accounting
   return a && a.version === ACCOUNTING_VERSION && a.books && a.books[a.active]
@@ -98,7 +133,8 @@ export function balanceSummary(ledger, day = beijingDay()) {
     firstObservedAt: row.firstAt, lastObservedAt: row.lastAt,
     openingBalance: row.openingUnits / SCALE, currentBalance: row.lastUnits / SCALE,
     observedDecrease: row.debitUnits / SCALE, observedIncrease: row.creditUnits / SCALE,
-    needsReview, partialDay: true, revision: revisionOf(ledger, row),
+    needsReview, revision: revisionOf(ledger, row),
+    ...partialDayInfo(day, row),
     credits: correction ? correction.creditsUnits / SCALE : null,
     otherDebits: correction ? correction.otherDebitsUnits / SCALE : null,
     correctedAt: correction ? correction.at : null,
@@ -237,7 +273,8 @@ export function daySummary(ledger, day) {
       day, amount: fromOther.amount, currency: fromOther.currency,
       source: 'balance-observed-other-account', label: '已观测消费 · 历史账户',
       firstObservedAt: fromOther.firstObservedAt, lastObservedAt: fromOther.lastObservedAt,
-      needsReview: fromOther.needsReview, partialDay: true, ...common,
+      needsReview: fromOther.needsReview, ...common,
+      ...partialDayInfo(day, { firstAt: fromOther.firstObservedAt, lastAt: fromOther.lastObservedAt }),
     }
   }
   // An explicit historical total (even zero) wins over a conflicting estimate.

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.17', 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),
@@ -1999,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()
     }
@@ -2042,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'
@@ -2060,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)
@@ -2076,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），每个窗口各有「已用% + 重置时间」。模板用
@@ -2111,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
@@ -2168,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
@@ -2407,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),
@@ -2513,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
@@ -2635,7 +2869,7 @@ export default {
       const summary = daySummary(led, todayKey())
       const nowSec = Math.floor(Date.now() / 1000)
       return {
-        ...visible, version: '0.3.17', 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.17",
+  "version": "0.3.18",
   "description": "DSH Web 界面右下角的 DeepSeek 余额小鲸鱼挂件:余额/今日已用/峰谷定价、自定义泡泡点击序列(文本/余额/今日/峰谷/图片/随机语句与并列加权选择)、逐行样式与字体、悬浮快捷编辑、音效与每轮消耗、自定义角色/动图/音效、吸附与翻转自定义",
   "keywords": [
     "dsh",