dsh-whale-widget 0.3.6 → 0.3.8

package/assets/whale-widget.js

@@ -18,8 +18,17 @@ function dshwIsChatRoot(r) {
   return !!(
     r.querySelector('textarea') ||
     r.querySelector('[contenteditable="true"]') ||
+    // DSH 0.1.6-alpha.1 起的新版 composer：data-composer-input 在整个 DSH 前端产物里
+    // **只出现在对话组件**（v742 时实测：1515 个前端文件里仅 dsh-client-ui-conversation 命中），
+    // 所以它是最精确的判据。
     r.querySelector('[data-composer-input]') ||
-    r.querySelector('[role="textbox"]')
+    // 同一层的 composer 容器属性（data-composer-seat / -card 也各只有一个出处），
+    // 万一将来输入框本身的属性改名，容器还在就仍能识别。
+    r.querySelector('[data-composer-seat],[data-composer-card]') ||
+    // 通用兜底：多行 textbox。注意**不要**用裸的 [role="textbox"] —— pdf.js 的批注编辑器
+    // （dsh-client-ui-sidebar-documentpreview）也会设 role=textbox，用它会把判定放宽到
+    // 非输入框的元素；加上 aria-multiline 至少排除掉单行输入框。
+    r.querySelector('[role="textbox"][aria-multiline="true"]')
   )
 }
 var dshwStarted = false
@@ -70,21 +79,34 @@ function dshwInit() {
 if (window.__dshWhaleInit) return
 window.__dshWhaleInit = true
 
-// ===== v739：音效改用 Web Audio 播放（不再用 <audio> / HTMLAudioElement）=====
-// 为什么改：HTMLAudioElement 会被 macOS 注册进系统「正在播放」，带 Touch Bar 的机器上
-// 每次按小鲸鱼都会弹出音频播放条并持续动画 → 明显卡顿（用户反馈）。AudioBufferSourceNode
-// 不经过媒体元素，系统媒体控件不会出现，也没有那层额外的解码/合成开销。
-// 兼容做法：给一个与 HTMLAudioElement 常用表面一致的 shim（play/pause/currentTime/volume/
-// onended/preload/src），这样既有的播放、音量、重播、结束回调逻辑一行都不用改。
+// ===== 音效播放（v745：Web Audio + 预解码 + 同步起播 + 可调衔接）=====
+// 目标：既要 0.3.0 那种"贴手"的响应，又不让 macOS 把音效注册进系统「正在播放」（Touch Bar 播放条 + 卡顿）。
+// 之前 0.3.3~0.3.7 换成 Web Audio 后手感变钝，不是引擎的问题，而是丢了四样里的三样：
+//   ① 垫片的 preload='auto' 只是占位 → 不预取、不解码 → 第一次点按要现 fetch+decode；
+//   ② 垫片没有 duration、currentTime 也不前进 → 点按退化成 onended 兜底「按压音放完才接松开音」；
+//   ③ 起播要经过一次 Promise/微任务。
+// 现在四件齐备：
+//   ① 引擎仍是不经过 media element 的 AudioBufferSourceNode（系统媒体控件不会出现 → 无 Touch Bar 条）；
+//   ② dshwvWarm() 在切音效组 / 打开试听 / 页面初始化时就**预取 + 预解码**（URL 级缓存，只解一次）；
+//   ③ 补齐 duration / currentTime（播放中真实前进）→ 能算"按压音还剩多久"；
+//   ④ **同步起播**：缓冲区已预热时，start() 在 pointerdown 的**同一个任务**里调用（不再经过 Promise）。
+// 衔接时机由 RELEASE_LEAD_MS 决定（0 = 正好接上；30/50 = 轻微交叠）—— 改这个数字即可按耳朵微调，
+// 不用动任何逻辑。
 var dshwvAudioCtx = null
 function dshwvAudio() {
   try {
-    if (!dshwvAudioCtx) dshwvAudioCtx = new (window.AudioContext || window.webkitAudioContext)()
+    if (!dshwvAudioCtx) {
+      var AC = window.AudioContext || window.webkitAudioContext
+      // 显式用 'interactive'（该 API 的最低延迟档），起播尽量贴手
+      dshwvAudioCtx = new AC({ latencyHint: 'interactive' })
+    }
     if (dshwvAudioCtx.state === 'suspended') { try { dshwvAudioCtx.resume() } catch (err) {} }
     return dshwvAudioCtx
   } catch (err) { return null }
 }
-var dshwvAudioBuffers = {} // url -> Promise<AudioBuffer>（解码结果缓存，同一片段不重复下载/解码）
+var dshwvAudioBuffers = {} // url -> Promise<AudioBuffer>（同一片段不重复下载/解码）
+var dshwvAudioDecoded = {} // url -> AudioBuffer（解码完成后**同步可读**：起播走同步路径的关键）
+function nowMs() { try { return (typeof performance !== 'undefined' && performance.now) ? performance.now() : Date.now() } catch (err) { return Date.now() } }
 function dshwvAudioBuffer(url) {
   if (!url) return Promise.reject(new Error('empty url'))
   if (!dshwvAudioBuffers[url]) {
@@ -95,62 +117,99 @@ function dshwvAudioBuffer(url) {
         if (!c) throw new Error('no audio context')
         return new Promise(function (res, rej) { c.decodeAudioData(raw, res, rej) })
       })
-      .catch(function (err) { delete dshwvAudioBuffers[url]; throw err })
+      .then(function (buf) { dshwvAudioDecoded[url] = buf; return buf })
+      .catch(function (err) { delete dshwvAudioBuffers[url]; delete dshwvAudioDecoded[url]; throw err })
   }
   return dshwvAudioBuffers[url]
 }
+// 预热：垫片的 preload='auto' 在 Web Audio 下不解码，必须显式预取+预解码。
+// 不预热 → 第一次点按要现 fetch+decodeAudioData，表现就是"按下音慢半拍、中间衔接发飘"。
+// URL 级缓存保证同一片段只解一次；失败静默吞掉（真正播放时还会自己重试一次）。
+function dshwvWarm(urls) {
+  try { dshwvAudio() } catch (err) {}
+  for (var i = 0; i < (urls || []).length; i++) {
+    var u = urls[i]
+    if (!u) continue
+    try { dshwvAudioBuffer(u).catch(function () {}) } catch (err) {}
+  }
+}
 function dshwvSoundStop(el) {
   el._token = (el._token || 0) + 1
   var node = el._node
   el._node = null
+  el._playingSince = 0
   if (node) {
     try { node.onended = null } catch (err) {}
     try { node.stop() } catch (err) {}
   }
 }
 function dshwvSound(url) {
-  var el = { preload: 'auto', volume: 1, onended: null, loop: false, _url: String(url || ''), _node: null, _gain: null, _offset: 0, _token: 0 }
+  var el = { preload: 'auto', volume: 1, onended: null, loop: false, _url: String(url || ''), _node: null, _gain: null, _offset: 0, _token: 0, _playingSince: 0 }
   Object.defineProperty(el, 'src', {
     get: function () { return el._url },
     set: function (v) { dshwvSoundStop(el); el._url = String(v || ''); el._offset = 0 },
   })
   Object.defineProperty(el, 'currentTime', {
-    get: function () { return el._offset },
+    // 播放中真实前进：pressUp 靠它算"按压音还剩多久"，据此把松开音排到按压音结束（或提前 lead）那一刻
+    get: function () {
+      if (el._node && el._playingSince) {
+        var t = el._offset + (nowMs() - el._playingSince) / 1000
+        var d = el.duration
+        return Math.max(0, isFinite(d) && d > 0 ? Math.min(t, d) : t)
+      }
+      return el._offset
+    },
     // 既有逻辑用「currentTime = 0」表示重播 → 这里顺手停掉正在播的那一份
-    set: function (v) { el._offset = Number(v) || 0; dshwvSoundStop(el) },
+    set: function (v) { el._offset = Number(v) || 0; el._playingSince = 0; dshwvSoundStop(el) },
   })
-  el.play = function () {
-    var c = dshwvAudio()
-    if (!c || !el._url) return Promise.resolve()
+  Object.defineProperty(el, 'duration', {
+    // 与 HTMLAudioElement 对齐：未解码时 NaN（调用方用 isFinite 判定），解码后是真实时长
+    get: function () {
+      var b = dshwvAudioDecoded[el._url]
+      return b && isFinite(b.duration) && b.duration > 0 ? b.duration : NaN
+    },
+  })
+  // 拿到 buffer 后真正起播。delay>0 时用音频线程时间轴（start(when)）排期，不受主线程抖动影响。
+  function beginWithBuffer(c, buf, delay) {
     try {
       if (!el._gain) { el._gain = c.createGain(); el._gain.connect(c.destination) }
       el._gain.gain.value = Math.max(0, Math.min(1, Number(el.volume) || 0))
-    } catch (err) { return Promise.resolve() }
+      var src = c.createBufferSource()
+      src.buffer = buf
+      src.connect(el._gain)
+      src.onended = function () {
+        if (el._node !== src) return
+        el._node = null
+        el._playingSince = 0
+        if (typeof el.onended === 'function') { try { el.onended() } catch (err) {} }
+      }
+      el._node = src
+      el._playingSince = nowMs() + delay * 1000
+      var dur = Math.max(0.001, buf.duration)
+      src.start(delay > 0 ? c.currentTime + delay : 0, Math.max(0, el._offset) % dur)
+    } catch (err) {}
+  }
+  function startSound(delaySec) {
+    var c = dshwvAudio()
+    if (!c || !el._url) return Promise.resolve()
     var token = (el._token = (el._token || 0) + 1)
-    var url = el._url
-    dshwvAudioBuffer(url).then(function (buf) {
+    var delay = Math.max(0, Number(delaySec) || 0)
+    // ④ 同步起播：缓冲区已预热（dshwvWarm）过 → 直接在当前任务里 start()，不再等 Promise
+    var cached = dshwvAudioDecoded[el._url]
+    if (cached) { beginWithBuffer(c, cached, delay); return Promise.resolve() }
+    dshwvAudioBuffer(el._url).then(function (buf) {
       if (token !== el._token) return // 期间被重播/暂停/换源 → 丢弃这次
-      try {
-        var src = c.createBufferSource()
-        src.buffer = buf
-        src.connect(el._gain)
-        src.onended = function () {
-          if (el._node !== src) return
-          el._node = null
-          if (typeof el.onended === 'function') { try { el.onended() } catch (err) {} }
-        }
-        el._node = src
-        var dur = Math.max(0.001, buf.duration)
-        src.start(0, Math.max(0, el._offset) % dur)
-      } catch (err) {}
+      beginWithBuffer(c, buf, delay)
     }).catch(function () {})
     return Promise.resolve()
   }
+  el.play = function () { return startSound(0) }
+  el.playAt = function (delaySec) { return startSound(delaySec) }
   el.pause = function () { dshwvSoundStop(el) }
   return el
 }
-// 自动播放策略：AudioContext 初始是 suspended，要有一次用户手势才能出声。
-// 任务结束音不是手势触发的，所以先挂一次性解锁（首次点击/按键后移除）。
+// 自动播放策略：AudioContext 初始是 suspended，要有一次用户手势才能出声；任务结束音不是手势触发的，
+// 所以挂一次性解锁（首次点击/按键后移除）。
 try {
   var dshwvAudioUnlock = function () {
     dshwvAudio()
@@ -690,6 +749,38 @@ styleEl.setAttribute('data-plugin', 'dsh-whale-widget')
 styleEl.textContent = css
 document.head.appendChild(styleEl)
 
+// ===== v743：body 挂载登记器（DOM 守护的基础设施，见下面 dshwReattachRoot）=====
+// 挂件会把 30 多个节点挂到 document.body 上（主节点、菜单、各种遮罩/面板、隐藏的 file input…）。
+// 早先的守护只补挂 root + menuBox：SPA 切路由或别的插件整体替换 body 子树后，其余节点会变成
+// "存在但不在文档里"的孤儿 —— 界面看起来恢复了，可一旦点开对应功能就静默失效。
+// 所以这里统一登记：所有挂到 body 的节点都走 dshwBodyAppend()，守护时逐个补挂；
+// 主动移除（目前只有一处）走 dshwBodyDetach()，避免被守护逻辑"复活"。
+var dshwBodyNodes = []
+function dshwBodyAppend(el) {
+  try {
+    if (!el) return el
+    // 注意：这里必须是**原始**的 document.body.appendChild —— 不能走 dshwBodyAppend 自己
+    // （v743 批量改写时曾误替换成自我递归，被 try/catch 吞掉后表现为"登记了但从未挂上"）
+    document.body.appendChild(el)
+    if (dshwBodyNodes.indexOf(el) < 0) dshwBodyNodes.push(el)
+  } catch (err) {}
+  return el
+}
+function dshwBodyDetach(el) {
+  try {
+    var i = dshwBodyNodes.indexOf(el)
+    if (i >= 0) dshwBodyNodes.splice(i, 1)
+    if (el && el.parentNode) el.parentNode.removeChild(el)
+  } catch (err) {}
+}
+// 兼容性：老 WebView 可能没有 Element.isConnected（Chrome 51+ 才有）。
+// 若直接 `!el.isConnected`，在那种环境里会恒为 true → 每个 DOM 变更批次都会重复 appendChild。
+function dshwConnected(el) {
+  if (!el) return false
+  try { if (typeof el.isConnected === 'boolean') return el.isConnected } catch (err) {}
+  try { return document.documentElement.contains(el) } catch (err) { return true }
+}
+
 var root = document.createElement('div')
 root.className = 'dshwv-root'
 
@@ -774,7 +865,7 @@ audioImportBtn.textContent = '导入'
 audioImportBtn.title = '新建/编辑音效组'
 audioGroupBtn.addEventListener('click', function (e) { e.stopPropagation(); toggleAudioGroupPanel() })
 audioImportBtn.addEventListener('click', function (e) { e.stopPropagation(); openAudioGroupEditor(null) })
-document.body.appendChild(audioGroupPanel)
+dshwBodyAppend(audioGroupPanel)
 function soundOpt(value, label) {
   var o = document.createElement('option')
   o.value = value
@@ -792,7 +883,7 @@ function dshwCustSelClose() {
   if (!o) return
   try {
     o.menu.classList.remove('dshwv-rgbopen')
-    if (o.menu.parentNode === document.body) document.body.removeChild(o.menu)
+    dshwBodyDetach(o.menu) // v744：登记过的 body 节点必须走 detach，否则会被 DOM 守护补挂回来
   } catch (err) {}
 }
 if (!window.__dshwCustBound) {
@@ -910,7 +1001,7 @@ function dshwCustSel(sel, opts) {
     dshwCustSelClose()
     fill()
     sync()
-    if (menu.parentNode !== document.body) document.body.appendChild(menu)
+    if (menu.parentNode !== document.body) dshwBodyAppend(menu)
     dshwDropOpen(menu, btn)
     // 可选底部参照元素:展开高度不超过该元素的上缘(内部滚动),用于
     // 主菜单内“任务结束音效”等下拉,避免列表盖住底部「小鲸鱼记账」按钮
@@ -1148,6 +1239,7 @@ function playTaskEndGroupClick(groupId) {
     // 按压留空:无按下音,直接播松开(模拟按下即松开的完整点按);松开留空:只播按压
     if (pressEmpty) {
       if (!releaseEmpty) {
+        dshwvWarm(['/dsh-whale/sound/release.mp3?set=' + encodeURIComponent(groupId)]) // v745：先预热
         var relOnly = dshwvSound('/dsh-whale/sound/release.mp3?set=' + encodeURIComponent(groupId))
         try { relOnly.volume = vol } catch (err) {}
         relOnly.currentTime = 0
@@ -1158,6 +1250,11 @@ function playTaskEndGroupClick(groupId) {
     }
     var press = dshwvSound('/dsh-whale/sound/press.mp3?set=' + encodeURIComponent(groupId))
     try { press.volume = vol } catch (err) {}
+    // v745：菜单里的"点一下试听"同样先预热解码，否则第一次听有明显延迟
+    dshwvWarm([
+      '/dsh-whale/sound/press.mp3?set=' + encodeURIComponent(groupId),
+      releaseEmpty ? '' : '/dsh-whale/sound/release.mp3?set=' + encodeURIComponent(groupId),
+    ])
     if (releaseEmpty) {
       press.currentTime = 0
       var pp = press.play()
@@ -1872,7 +1969,7 @@ function usageAlertBudgetEditor(key, onSave) {
           turnCostCloseDefer = false
           turnCostCloseInput.disabled = !turnCostOn // 回到菜单态的禁用逻辑
         }
-        document.body.removeChild(mask)
+        dshwBodyDetach(mask) // v744：走 detach 注销登记，否则 DOM 守护会把这个刚关掉的编辑器补挂回来
         bubbleEditItems = bkEditItems
         bubbleEditorSnap = bkEditorSnap
         bubbleItemSnap = bkItemSnap
@@ -1991,7 +2088,7 @@ function usageAlertBudgetEditor(key, onSave) {
     mask.appendChild(card)
     mask.addEventListener('click', function (e) { if (e.target === mask) cleanup() })
     window.__dshwRemindMask = mask
-    document.body.appendChild(mask)
+    dshwBodyAppend(mask)
     renderBubblePal()
     renderBubblePv()
   } catch (err) {}
@@ -2455,7 +2552,9 @@ function openApiModelPanel(modelId) {
         // 新建模型：保存后给一个明确的收尾——弹「保存成功」，点确认即关掉本面板。
         // （原先是重新打开为编辑态，新建流程会停在一个没有明显关闭入口的面板上）
         if (isNew) {
-          try { confirmMask.style.setProperty('z-index', '29500', 'important') } catch (err) {}
+          // v744 清理：这里原先有 `confirmMask.style.zIndex = '29500' !important`，但紧接着的
+          // showConfirm() 会把确认框统一提到 40000 !important，所以那行是**无效设置**（立刻被覆盖），
+          // 只会让"层级"更难读。已删除 —— 确认框永远由 showConfirm 统一抬到 40000。
           showConfirm('✓ 保存成功：' + (nm || '新模型') + '\n已加入模型列表', function () {
             try { closeApiModelPanel() } catch (err) {}
             // 背后的「- = 小鲸鱼记账 = -」列表同步刷新（模型行在静态区，需重建子界面）
@@ -2563,7 +2662,7 @@ function openApiModelPanel(modelId) {
     } catch (err) {}
     mask.appendChild(card)
     mask.addEventListener('click', function (e) { if (e.target === mask) closeApiModelPanel() })
-    document.body.appendChild(mask)
+    dshwBodyAppend(mask)
     apiModelMaskEl = mask
     // 模板切换：把模板默认值填进各字段（仅新增态）
     if (isNew) {
@@ -2614,7 +2713,10 @@ function openApiModelPanel(modelId) {
 }
 var apiModelMaskEl = null
 function closeApiModelPanel() {
-  try { if (apiModelMaskEl && apiModelMaskEl.parentNode) apiModelMaskEl.parentNode.removeChild(apiModelMaskEl) } catch (err) {}
+  // v744：必须走 dshwBodyDetach —— 这个遮罩是登记在案的 body 节点，
+  // 若用 parentNode.removeChild 直接摘掉，DOM 守护会认为"被别的插件摘走了"并把它补挂回来，
+  // 表现就是**点「取消」关不掉这个窗口**（0.3.7 引入的回归）。
+  try { if (apiModelMaskEl) dshwBodyDetach(apiModelMaskEl) } catch (err) {}
   apiModelMaskEl = null
 }
 // 列宽受限 + 悬浮滚动：内容超出列宽时，鼠标移上去文字自动横向滚动，移开回到起点。
@@ -2914,7 +3016,7 @@ function openModelQuotaEditor(modelId) {
     card.appendChild(btns)
     mask.appendChild(card)
     mask.addEventListener('click', function (e) { if (e.target === mask) closeApiModelPanel() })
-    document.body.appendChild(mask)
+    dshwBodyAppend(mask)
     apiModelMaskEl = mask
   } catch (err) {}
 }
@@ -3102,7 +3204,7 @@ function openApiModelMenu(modelId) {
     card.appendChild(btns)
     mask.appendChild(card)
     mask.addEventListener('click', function (e) { if (e.target === mask) closeApiModelPanel() })
-    document.body.appendChild(mask)
+    dshwBodyAppend(mask)
     apiModelMaskEl = mask
   } catch (err) {}
 }
@@ -3260,7 +3362,8 @@ function openBalanceAdjustment(modelId) {
   function close() {
     if (busy) return
     document.removeEventListener('keydown', keyHandler)
-    mask.remove()
+    // v743：主动移除要走 dshwBodyDetach —— 否则它已被登记，DOM 守护会把这个刚关掉的窗口"复活"
+    dshwBodyDetach(mask)
     accountingMask = null
     // 关掉校正窗口后回到同一个设置菜单，并把焦点放回「校正」按钮
     openApiModelMenu(modelId)
@@ -3293,7 +3396,7 @@ function openBalanceAdjustment(modelId) {
   card.appendChild(actions)
   mask.appendChild(card)
   mask.addEventListener('click', function (e) { if (e.target === mask) close() })
-  document.body.appendChild(mask)
+  dshwBodyAppend(mask)
   accountingMask = mask
   document.addEventListener('keydown', keyHandler)
   var rows = []
@@ -3489,7 +3592,7 @@ var usageMoreCard = document.createElement('div')
 usageMoreCard.className = 'dshwv-usage-card'
 usageMoreMask.appendChild(usageMoreCard)
 usageMoreMask.addEventListener('click', function (e) { if (e.target === usageMoreMask) closeUsageRecordsWindow() })
-document.body.appendChild(usageMoreMask)
+dshwBodyAppend(usageMoreMask)
 function openUsageRecordsWindow() {
   usageMoreCard.innerHTML = '<div style="padding:10px;color:#203170">加载中…</div>'
   usageMoreMask.style.display = 'flex'
@@ -3512,7 +3615,7 @@ function resMaskOpen() {
       resCardEl.className = 'dshwv-usage-card dshwv-rescard'
       resMaskEl.appendChild(resCardEl)
       resMaskEl.addEventListener('click', function (e) { if (e.target === resMaskEl) resManagerClose() })
-      document.body.appendChild(resMaskEl)
+      dshwBodyAppend(resMaskEl)
     }
     resManagerRender()
     resMaskEl.style.display = 'flex'
@@ -4107,12 +4210,12 @@ function usagePopupCard(title, content, below, amount) {
     ok.type = 'button'
     ok.className = 'dshwv-bubbtn dshwv-bubbtn-ok'
     ok.textContent = '知道了'
-    ok.addEventListener('click', function () { try { document.body.removeChild(mask) } catch (err) {} })
+    ok.addEventListener('click', function () { try { dshwBodyDetach(mask) } catch (err) {} })
     btns.appendChild(ok)
     card.appendChild(btns)
     mask.appendChild(card)
-    mask.addEventListener('click', function (e) { if (e.target === mask) { try { document.body.removeChild(mask) } catch (err) {} } })
-    document.body.appendChild(mask)
+    mask.addEventListener('click', function (e) { if (e.target === mask) { try { dshwBodyDetach(mask) } catch (err) {} } })
+    dshwBodyAppend(mask)
   } catch (err) {}
 }
 var USAGE_PALETTE = ['#203170', '#e0433f', '#2fa24c', '#b060c8', '#e89a2e', '#3aa6c8', '#d06a8a', '#7a8b2f', '#6a6ad0', '#c84a8a']
@@ -4617,7 +4720,7 @@ function fillUsageRecordsWindow(d) {
     renderGroups('')
   })
 }
-document.body.appendChild(rolePanel)
+dshwBodyAppend(rolePanel)
 
 // —— 吸附与翻转自定义弹窗 ——
 // 预览方框内五条可拖线：左/右/上/下四条吸附区边界 + 红色翻转线（竖中线位置）。
@@ -5034,7 +5137,7 @@ snapBtns.appendChild(snapBtn('重置', 'dshwv-snapbtn-no', resetSnapEdit))
 snapBtns.appendChild(snapBtn('确认', 'dshwv-snapbtn-ok', function () { closeSnapModal(true) }))
 snapCard.appendChild(snapBtns)
 snapMask.appendChild(snapCard)
-document.body.appendChild(snapMask)
+dshwBodyAppend(snapMask)
 
 // —— 自定义泡泡:主编辑窗口(点击队列) + 单泡模块编辑 + 模块编辑 ——
 var bubbleMask = null
@@ -6890,7 +6993,7 @@ function qeditEnsure() {
   qeditEl = document.createElement('div')
   qeditEl.className = 'dshwv-qedit'
   qeditEl.style.display = 'none'
-  document.body.appendChild(qeditEl)
+  dshwBodyAppend(qeditEl)
   if (!window.__dshwQeditBound) {
     window.__dshwQeditBound = true
     document.addEventListener('pointerdown', function (e) {
@@ -8212,7 +8315,7 @@ bubbleBtns.appendChild(bubbleBtn('重置', 'dshwv-bubbtn-no', bubbleEditorReset)
 bubbleBtns.appendChild(bubbleBtn('保存', 'dshwv-bubbtn-ok', bubbleEditorSave))
 bubbleCard.appendChild(bubbleBtns)
 bubbleMask.appendChild(bubbleCard)
-document.body.appendChild(bubbleMask)
+dshwBodyAppend(bubbleMask)
 
 // ===== W2 单泡编辑窗口 =====
 bubbleItemMask = document.createElement('div')
@@ -8296,7 +8399,7 @@ bubbleItemBtns.appendChild(bubbleBtn('恢复默认', 'dshwv-bubbtn-no', bubbleIt
 bubbleItemBtns.appendChild(bubbleBtn('保存', 'dshwv-bubbtn-ok', bubbleItemSave))
 bubbleItemCard.appendChild(bubbleItemBtns)
 bubbleItemMask.appendChild(bubbleItemCard)
-document.body.appendChild(bubbleItemMask)
+dshwBodyAppend(bubbleItemMask)
 
 // ===== W3 模块编辑器(文本/随机/图片 + 样式) =====
 var moduleMask = null
@@ -8395,9 +8498,46 @@ var bubbleRgbOpenMenu = null // 当前展开的 .dshwv-rgbmenu
 var bubbleFontOpenMenu = null // 当前展开的字体下拉(复用 rgbmenu 类,额外限高)
 var bubbleColorOpenMenu = null // 当前展开的颜色下拉(纯色/跑马灯,限高)
 // —— 弹层/菜单层级统一助手(所有下拉与弹窗据此取高于当前可见层,避免互相压制) ——
+// ============================================================================
+// 层级（z-index）分层表 —— **改层之前先读这里**
+// 所有浮层都直接挂在 <body> 上，谁盖谁完全由 z-index 决定。历史上出过
+// 「子窗口被父窗口盖住点不到」「窗口关不掉」这类问题，所以这里把层段定死，并约定三条铁律：
+//   ① 新增浮层**先在下面的表里选一个层段**，不要随手写数字；
+//   ② 凡是「可能从别的窗口里被打开」的窗口，必须用 dshwLayerUp(el, 本段起点)，
+//      这样父窗口在 29000 时子窗口自动落到 29010，永远不会被盖住；
+//   ③ visibleTopZ() 的候选表必须包含**全部**浮层节点（漏一个就会低估"当前最高层"），
+//      唯一例外是 toast —— 它是刻意的最顶层，不参与追赶。
+//
+//   层段              用途                          载体
+//   ---------------------------------------------------------------------------
+//   1 – 999          挂件本体内部元素               .dshwv-pop(1) / .dshwv-menu-btn(2) / 拖拽把手(3-5)
+//   30 / 60          面板内的自绘下拉               .dshwv-colpop(30) / .dshwv-rgbmenu(60)
+//   9999             挂件本体                       .dshwv-root
+//   10000 – 19999    主菜单与其列表                 .dshwv-menu(10000) / .dshwv-rolelist·audiolist(10001)
+//   20000 – 20999    一级编辑器                     .dshwv-cropmask·gifmask(20000) / .dshwv-resmask(20300) /
+//                                                   .dshwv-audiomask·bubmask(20500) / .dshwv-slotlist(20600)
+//   21000 – 21999    对话框基础层                   .dshwv-confirmmask(21000，实际被 showConfirm 提到 40000)
+//   22000 – 22999    记账 / 吸附窗口                .dshwv-snapmask·usage-mask(22000)
+//   26000 – 26999    小浮层                         .dshwv-qedit(26000) / .dshwv-usagepanel(26020) /
+//                                                   .dshwv-tplhelp·动态提示(26080+)
+//   29000 – 29999    模型子菜单 / 模型设置           JS 显式写入（refreshModelList / openApiModelMenu）
+//   30000 – 30999    提醒·额度·余额校正编辑器        JS 显式写入（含 openModelQuotaEditor / openBalanceAdjustment）
+//   31000 – 31999    提醒编辑期间需提到顶层的浮层    JS 显式写入（moduleMask / qedit / token 提示）
+//   32000 – 32999    提醒编辑期间统一置顶的遮罩      remindZStyle 的 !important 规则
+//   40000            确认对话框（永远在所有窗口之上） showConfirm() 的 !important
+//   2147483600       提示条 toast（最高，且不参与 visibleTopZ）
+// ============================================================================
 function visibleTopZ() {
   var top = 20500
-  var cand = [bubbleMask, bubbleItemMask, moduleMask, usageMoreMask, qeditEl, window.__dshwRemindMask, apiModelMaskEl, accountingMask]
+  // 注意：这里必须列全 —— 少一个浮层，dshwLayerUp/下拉/提示就会低估"当前最高层"而被盖住。
+  // toast 刻意不列入（它是永远的最顶层，不该让别的层去追它）。
+  var cand = [
+    bubbleMask, bubbleItemMask, moduleMask, moduleNamePromptMask,
+    cropMask, gifMask, audioCropMask, audioEditMask, resMaskEl,
+    confirmMask, snapMask, usageMask, usageMoreMask,
+    qeditEl, dshwvTplHelpEl, dshwvHintEl,
+    apiModelMaskEl, accountingMask, window.__dshwRemindMask
+  ]
   function eff(el) {
     try {
       if (!el) return 0
@@ -8417,6 +8557,13 @@ function visibleTopZ() {
   }
   return top
 }
+// 「永远在打开它的那个窗口之上」：取 本层段起点 与 当前可见最高层+10 的较大值。
+// 用在裁剪 / GIF / 音频裁剪 / 模块编辑器这些**既可能从主菜单(10000)打开、也可能从资源管理(20300)、
+// 泡泡编辑器(20500)、模型设置(29000)里打开**的窗口上 —— 固定层号在后者场景会被父窗口盖住。
+function dshwLayerUp(el, base) {
+  try { if (el && el.style) el.style.zIndex = String(Math.max(base, Math.round(visibleTopZ()) + 10)) } catch (err) {}
+  return el
+}
 // 打开主要编辑器前清理可能残留的临时层级(提醒会话遗留的 moduleMask/qedit 提升与样式)
 function whaleZClean() {
   try {
@@ -8432,7 +8579,7 @@ function whaleZClean() {
 // 菜单宽度与触发按钮保持一致(原样式 min-width:100% 在 body 下会按视口撑满,须归零)
 function dshwDropOpen(menuEl, anchorEl) {
   try {
-    if (menuEl.parentNode !== document.body) document.body.appendChild(menuEl)
+    if (menuEl.parentNode !== document.body) dshwBodyAppend(menuEl)
     menuEl.style.position = 'fixed'
     menuEl.style.minWidth = '0px'
     menuEl.style.left = '0px'
@@ -9428,6 +9575,9 @@ function openModuleEditor(m, onSave, isNew) {
     moduleOnSave = onSave || null
     moduleEditNew = !!isNew
     renderModuleEditor()
+    // v744：模块编辑器从泡泡编辑器(20500)/资源管理(20300)里打开时，固定 20500 会与父窗口同层
+    // （只靠 DOM 顺序决定谁在上面），这里统一抬到"当前最高层之上"
+    dshwLayerUp(moduleMask, 20500)
     moduleMask.style.display = 'flex'
   } catch (err) {}
 }
@@ -9483,7 +9633,7 @@ moduleBtns.appendChild(saveAsBtn)
 moduleBtns.appendChild(bubbleBtn('保存', 'dshwv-bubbtn-ok', function () { closeModuleEditor(true) }))
 moduleCard.appendChild(moduleBtns)
 moduleMask.appendChild(moduleCard)
-document.body.appendChild(moduleMask)
+dshwBodyAppend(moduleMask)
 // 存为可选模块:名称输入弹窗
 var moduleNamePromptMask = document.createElement('div')
 moduleNamePromptMask.className = 'dshwv-confirmmask'
@@ -9516,7 +9666,7 @@ moduleNameBtns.appendChild(moduleNameCancel)
 moduleNameBtns.appendChild(moduleNameOk)
 moduleNamePromptCard.appendChild(moduleNameBtns)
 moduleNamePromptMask.appendChild(moduleNamePromptCard)
-document.body.appendChild(moduleNamePromptMask)
+dshwBodyAppend(moduleNamePromptMask)
 // 回车保存/关闭
 moduleNameInput.addEventListener('keydown', function (e) {
   try {
@@ -9629,7 +9779,7 @@ cropCard.appendChild(cropZoomWrap)
 cropCard.appendChild(cropAngleWrap)
 cropCard.appendChild(cropBtns)
 cropMask.appendChild(cropCard)
-document.body.appendChild(cropMask)
+dshwBodyAppend(cropMask)
 cropBox.addEventListener('pointerdown', onCropDown)
 cropBox.addEventListener('pointermove', onCropMove)
 cropBox.addEventListener('pointerup', onCropUp)
@@ -9729,7 +9879,7 @@ gifCard.appendChild(gifHint)
 gifCard.appendChild(gifNameInput)
 gifCard.appendChild(gifBtns)
 gifMask.appendChild(gifCard)
-document.body.appendChild(gifMask)
+dshwBodyAppend(gifMask)
 gifCancelBtn.addEventListener('click', hideGifRoleModal)
 gifOkBtn.addEventListener('click', confirmGifRole)
 var gifRoleDataUrl = null
@@ -9749,6 +9899,7 @@ function openGifRoleModal(dataUrl, fileName, animType) {
   }
   gifNameInput.value = ''
   gifPreviewImg.src = dataUrl
+  dshwLayerUp(gifMask, 20000) // v744：同上，GIF 窗口也可能从资源管理/泡泡编辑器里打开
   gifMask.style.display = 'flex'
 }
 function hideGifRoleModal() {
@@ -9810,7 +9961,7 @@ confirmBtns.appendChild(confirmYesBtn)
 confirmCard.appendChild(confirmText)
 confirmCard.appendChild(confirmBtns)
 confirmMask.appendChild(confirmCard)
-document.body.appendChild(confirmMask)
+dshwBodyAppend(confirmMask)
 confirmNoBtn.addEventListener('click', hideConfirm)
 confirmYesBtn.addEventListener('click', function () {
   var cb = confirmCb
@@ -9902,7 +10053,7 @@ audioEditCard.appendChild(audioEditPressRow)
 audioEditCard.appendChild(audioEditReleaseRow)
 audioEditCard.appendChild(audioEditBtns)
 audioEditMask.appendChild(audioEditCard)
-document.body.appendChild(audioEditMask)
+dshwBodyAppend(audioEditMask)
 audioEditCancel.addEventListener('click', hideAudioEditor)
 audioEditPlay.addEventListener('pointerdown', function (e) { e.stopPropagation(); audioEditPreviewDown() })
 audioEditPlay.addEventListener('pointerup', function (e) { e.stopPropagation(); audioEditPreviewUp() })
@@ -10055,7 +10206,7 @@ audioCropCard.appendChild(audioCropTime)
 audioCropCard.appendChild(audioCropNameRow)
 audioCropCard.appendChild(audioCropBtns)
 audioCropMask.appendChild(audioCropCard)
-document.body.appendChild(audioCropMask)
+dshwBodyAppend(audioCropMask)
 audioCropCancel.addEventListener('click', hideAudioCrop)
 audioCropOk.addEventListener('click', confirmAudioCrop)
 audioCropPlay.addEventListener('click', previewAudioCrop)
@@ -10126,8 +10277,8 @@ body.appendChild(img)
 body.appendChild(bubbleBox)
 root.appendChild(body)
 root.appendChild(menuBtn)
-document.body.appendChild(root)
-document.body.appendChild(menuBox)
+dshwBodyAppend(root)
+dshwBodyAppend(menuBox)
 
 // ===== PR #105 后半：DOM 守护（SPA 切路由 / 别的插件替换 body 子树时把节点摘掉）=====
 // 背景：DSH 是 SPA，切到会话列表 / 设置 / 插件市场再回来、或其它客户端插件整体替换
@@ -10135,19 +10286,29 @@ document.body.appendChild(menuBox)
 // 做法：暴露 window.__dshWhaleRoot 供外部定位/调试，并用一个 MutationObserver 盯着；
 // 一旦发现节点已不在文档里就**把同一个节点补挂回 body**（不重建、不重新初始化，
 // 位置/设置/状态全部保留）。
+// v743：补挂范围从 root+menuBox 扩到**全部登记过的 body 节点**（见 dshwBodyNodes）——
+// 否则被整体替换后，遮罩/面板/隐藏 file input 会变成孤儿，功能静默失效；
+// 另外 root 还在、只有个别节点被摘掉的"局部移除"也要能自愈，所以做了节流的全量核对。
 try { window.__dshWhaleRoot = root } catch (err) {}
 function dshwReattachRoot() {
   try {
-    if (!root || root.isConnected) return
-    document.body.appendChild(root)
-    // 菜单是独立挂在 body 上的浮层：它也被摘掉且当前正打开时一并补回，否则菜单会"消失"
-    if (menuBox && menuOpen && !menuBox.isConnected) document.body.appendChild(menuBox)
+    for (var i = 0; i < dshwBodyNodes.length; i++) {
+      var el = dshwBodyNodes[i]
+      if (el && !dshwConnected(el)) dshwBodyAppend(el)
+    }
   } catch (err) {}
 }
 try {
   if (typeof MutationObserver === 'function') {
+    var dshwGuardLastFull = 0
     var dshwRootGuard = new MutationObserver(function () {
-      if (root && !root.isConnected) dshwReattachRoot()
+      try {
+        if (!root) return
+        if (!dshwConnected(root)) { dshwReattachRoot(); dshwGuardLastFull = Date.now(); return }
+        // root 正常时也定期全量核对一次（最多 1.5 秒一次）：覆盖"只有个别浮层被摘掉"的情况
+        var now = Date.now()
+        if (now - dshwGuardLastFull > 1500) { dshwGuardLastFull = now; dshwReattachRoot() }
+      } catch (err) {}
     })
     dshwRootGuard.observe(document.documentElement, { childList: true, subtree: true })
   }
@@ -10209,6 +10370,8 @@ var state = {
   todayUsageCurrency: 'CNY',
   usageLabel: '本地估算',
   isPeak: false,
+  peakNextChangeAt: null,
+  peakHolidays: null,
   status: 'loading',
   message: '',
   flip: false
@@ -11236,7 +11399,7 @@ function bubbleTplHelpToggle(m, anchor) {
     if (!dshwvTplHelpEl) {
       dshwvTplHelpEl = document.createElement('div')
       dshwvTplHelpEl.className = 'dshwv-tplhelp'
-      document.body.appendChild(dshwvTplHelpEl)
+      dshwBodyAppend(dshwvTplHelpEl)
       document.addEventListener('pointerdown', function (e) {
         if (!dshwvTplHelpEl || dshwvTplHelpEl.style.display === 'none') return
         try {
@@ -11280,7 +11443,7 @@ function dshwvHintEnsure() {
   dshwvHintEl = document.createElement('div')
   dshwvHintEl.className = 'dshwv-tplhelp dshwv-hintbox'
   dshwvHintEl.style.display = 'none'
-  document.body.appendChild(dshwvHintEl)
+  dshwBodyAppend(dshwvHintEl)
   document.addEventListener('pointerdown', function (e) {
     if (!dshwvHintEl || dshwvHintEl.style.display === 'none') return
     try {
@@ -11423,9 +11586,28 @@ function bubbleModuleText(m, avoidIdx) {
   return t
 }
 // —— 下个时段倒计时模块:按“工作日9-12/14-18为高峰,周末全天谷价”推算下一时段切换 ——
+// v746：法定节假日同样全天谷价。前端无法自己知道放假安排，节假日清单由宿主随余额接口下发
+// （state.peakHolidays，单一来源），切换点也优先用宿主算好的绝对值（state.peakNextChangeAt）。
+var bubbleHolidaySet = null
+var bubbleHolidaySetKey = ''
+function bubbleHolidaySetOf() {
+  var list = (state && state.peakHolidays) || null
+  var key = Array.isArray(list) ? list.join(',') : ''
+  if (key !== bubbleHolidaySetKey) {
+    bubbleHolidaySetKey = key
+    bubbleHolidaySet = {}
+    if (Array.isArray(list)) for (var i = 0; i < list.length; i++) bubbleHolidaySet[String(list[i])] = 1
+  }
+  return bubbleHolidaySet
+}
+function bubbleBJHolidayKey(bj) {
+  try { return bj.toISOString().slice(0, 10) } catch (err) { return '' }
+}
 function bubbleCountdownIsPeak(sec) {
   sec = isFinite(Number(sec)) ? Number(sec) : Math.floor(Date.now() / 1000)
   var bj = new Date((sec + 8 * 3600) * 1000)
+  var hs = bubbleHolidaySetOf()
+  if (hs && hs[bubbleBJHolidayKey(bj)]) return false // 法定节假日全天谷价
   var dow = bj.getUTCDay()
   var h = bj.getUTCHours()
   if (dow === 0 || dow === 6) return false
@@ -11433,10 +11615,14 @@ function bubbleCountdownIsPeak(sec) {
 }
 function bubbleCountdownNextChange(sec) {
   sec = isFinite(Number(sec)) ? Number(sec) : Math.floor(Date.now() / 1000)
+  // 宿主已就绪时直接用其算好的切换点（与计费同源，含法定节假日）；
+  // 只接受未来 12 天内的值——切过去之后该值会过期，回退到本地推算，避免倒计时卡在 00:00:00
+  var hostCand = Number(state && state.peakNextChangeAt)
+  if (isFinite(hostCand) && hostCand > sec + 1 && hostCand - sec <= 12 * 86400) return hostCand
   var cur = bubbleCountdownIsPeak(sec)
   var bjDay0 = Math.floor((sec + 8 * 3600) / 86400) * 86400
   var best = null
-  for (var d = 0; d <= 8 && best === null; d++) {
+  for (var d = 0; d <= 12 && best === null; d++) {
     var dayStartBj = bjDay0 + d * 86400
     var edges = [0, 9 * 3600, 12 * 3600, 14 * 3600, 18 * 3600]
     for (var i = 0; i < edges.length; i++) {
@@ -12345,6 +12531,8 @@ function refresh(manual) {
         state.usageLabel = data.usageLabel || '本地估算'
         if (data.stale) state.usageLabel += ' · 余额未刷新'
         state.isPeak = !!data.isPeak
+        state.peakNextChangeAt = isFinite(Number(data.peakNextChangeAt)) ? Number(data.peakNextChangeAt) : null
+        state.peakHolidays = Array.isArray(data.peakHolidays) ? data.peakHolidays : null
         checkUsageAlerts(nb, state.todayUsage)
         if (changed && !currencyChanged) {
           if (!manual) {
@@ -12420,13 +12608,14 @@ function dshwvToast(msg) {
         'max-width:min(560px,calc(100vw - 32px));box-sizing:border-box;padding:10px 14px;border-radius:10px;' +
         'background:#8a1f1f;color:#fff;font-size:13px;line-height:1.6;box-shadow:0 6px 20px rgba(0,0,0,.28);' +
         'pointer-events:none;text-align:center'
-      document.body.appendChild(el)
+      dshwBodyAppend(el)
       dshwvToastEl = el
     }
     dshwvToastEl.innerHTML = msg
     if (dshwvToastTimer) clearTimeout(dshwvToastTimer)
     dshwvToastTimer = setTimeout(function () {
-      try { if (dshwvToastEl && dshwvToastEl.parentNode) dshwvToastEl.parentNode.removeChild(dshwvToastEl) } catch (err) {}
+      // v744：toast 也是登记过的 body 节点，必须 detach（否则 DOM 守护会把它补挂回来 → 提示条永不消失）
+      try { if (dshwvToastEl) dshwBodyDetach(dshwvToastEl) } catch (err) {}
       dshwvToastEl = null
     }, 8000)
   } catch (err) {}
@@ -12459,12 +12648,15 @@ function configPut(payload, retried) {
 }
 function saveConfig() {
   // issue #97：加载完成前只记待办，绝不 PUT（否则把默认值整包写进服务端）
-  if (!configLoaded) { configSavePending = true; return }
+  if (!configLoaded) { configSavePending = true; return null }
   try {
-    configPut(configPayload(), false)
+    // 返回 Promise（v743：Codex 统计开关需要"等服务端确认后再刷新"）。
+    // configPut 自带重试与失败提示、且链尾有 catch，所以不会有 unhandled rejection。
+    var p = configPut(configPayload(), false)
     // 锚点位置记忆：记录相对边框的离边距离，窗口 resize 后保持（localStorage）。
     saveAnchorPos()
-  } catch (err) {}
+    return p
+  } catch (err) { return null }
 }
 // 单独抽出：只写 localStorage 锚点（不碰尺寸设置）；applyAnchorPos / settle 自愈时也要用。
 // v:2 = 净距离格式（剥离避让距离），v:1 旧格式含避让距离，恢复时废弃旧格式。
@@ -12572,8 +12764,12 @@ function setMenuBtnHide(v) {
 function setCodexStatsOn(v) {
   codexStatsOn = v !== false
   if (codexStatsToggle) codexStatsToggle.checked = codexStatsOn
-  saveConfig()
-  try { refreshModelList() } catch (err) {}
+  var after = function () { try { refreshModelList() } catch (err) {} }
+  var p = null
+  try { p = saveConfig() } catch (err) {}
+  // 等服务端确认落盘后再重取模型列表：否则可能读到旧配置，那一行会先显示上一次的状态再跳变
+  if (p && typeof p.then === 'function') p.then(after, after)
+  else after()
 }
 function scaleToDisplay(s) {
   return Math.round((s - MIN_SCALE) / ((MAX_SCALE - MIN_SCALE) / 19)) + 1
@@ -12639,12 +12835,11 @@ var releaseAudio = null
 var pressing = false
 var pressEnded = false
 var releasePlayed = false
-var releaseTimer = null
+// v745：不再需要 releaseTimer —— 点按时由 playReleaseAt() 在**音频线程**排期（见 pressUp）
 function applySoundSet() {
   try {
     // v729：切音效组 / 开关音效时把本轮播放状态一并复位，
     // 避免残留 releasePlayed=true 把新组的松开音整体吃掉（与 playPress 的修复配套）
-    if (releaseTimer) { clearTimeout(releaseTimer); releaseTimer = null }
     pressEnded = false
     releasePlayed = false
     // 槽位显式留空(该事件静音)时,对应音频元素置空;playPress/playRelease 已判空
@@ -12660,6 +12855,12 @@ function applySoundSet() {
       releaseAudio.preload = 'auto'
       releaseAudio.volume = soundVol
     }
+    // v745：把这组的按压/松开音**预取+预解码**（Web Audio 下 preload='auto' 不解码）。
+    // 预热过之后，起播走 dshwvSound 的同步路径（pointerdown 同一任务里 start），手感才贴手。
+    dshwvWarm([
+      pEmpty ? '' : '/dsh-whale/sound/press.mp3?set=' + soundSet,
+      rEmpty ? '' : '/dsh-whale/sound/release.mp3?set=' + soundSet,
+    ])
   } catch (err) {}
 }
 function playPress() {
@@ -12668,7 +12869,6 @@ function playPress() {
   // 原实现里 pressAudio 为空时直接 return，跳过了 releasePlayed = false；而 playRelease()
   // 一旦把 releasePlayed 置为 true 就再没有任何地方复位它 → 结果是只有第一次松开有声音，
   // 之后每次点击都静音（用户实测：新建音效组只填松开音时复现）。
-  if (releaseTimer) { clearTimeout(releaseTimer); releaseTimer = null }
   if (releaseAudio) {
     releaseAudio.pause()
     releaseAudio.currentTime = 0
@@ -12692,6 +12892,13 @@ function playPress() {
     if (p && typeof p.catch === 'function') p.catch(function () {})
   } catch (err) {}
 }
+// 点按时"松开音提前多少毫秒进场"（v745 把它做成**可调参数**，按耳朵微调即可）：
+//   0  = 松开音正好接在按压音结束那一刻（无缝、不重叠）
+//   30 / 50 = 轻微交叠（更"黏"）
+//   100 = 明显重叠（听感上可能像"重复播放"。0.3.0 代码里写的是 100，但它的主线程 setTimeout
+//         经常迟到、实际几乎听不到重叠；我们用音频线程精确排期，所以别照抄 100）
+// 当前取值：**40**（用户在 30/50 之间试听后选定）
+var RELEASE_LEAD_MS = 40
 function playRelease() {
   if (releasePlayed || !releaseAudio || !soundOn) return
   releasePlayed = true
@@ -12701,6 +12908,20 @@ function playRelease() {
     if (p && typeof p.catch === 'function') p.catch(function () {})
   } catch (err) {}
 }
+// 把松开音**排期到 delaySec 秒之后**（音频线程时间轴）：起播时刻精确、不受主线程抖动影响。
+function playReleaseAt(delaySec) {
+  if (releasePlayed || !releaseAudio || !soundOn) return
+  releasePlayed = true
+  try {
+    releaseAudio.currentTime = 0 // 复位（同时停掉上一条已排期/在播的松开音）
+    if (delaySec > 0 && typeof releaseAudio.playAt === 'function') {
+      releaseAudio.playAt(delaySec)
+      return
+    }
+    var p = releaseAudio.play()
+    if (p && typeof p.catch === 'function') p.catch(function () {})
+  } catch (err) {}
+}
 function pressDown() {
   body.style.transform = SQUISH
   pressing = true
@@ -12714,23 +12935,21 @@ function pressUp() {
     playRelease()
     return
   }
-  // click: start Ya2 in the last 100ms of Ya1's playback
+  // click：把松开音排到"按压音结束前 RELEASE_LEAD_MS 毫秒"（默认 0 = 正好接上）
   var durKnown = false
-  var remainMs = 0
+  var remainSec = 0
   try {
     var dur = pressAudio ? pressAudio.duration : 0
     if (isFinite(dur) && dur > 0) {
       durKnown = true
-      remainMs = (dur - pressAudio.currentTime) * 1000
+      remainSec = Math.max(0, dur - pressAudio.currentTime)
     }
   } catch (err) {}
   if (durKnown) {
-    releaseTimer = setTimeout(function () {
-      releaseTimer = null
-      playRelease()
-    }, Math.max(0, remainMs - 100))
+    playReleaseAt(Math.max(0, remainSec - RELEASE_LEAD_MS / 1000))
+    return
   }
-  // duration unknown → pressAudio.onended fallback plays Ya2 after Ya1 ends
+  // 时长未知（预热失败/解码异常）→ 交给 pressAudio.onended 兜底（见 playPress）
 }
 var menuOpen = false
 var menuClosedAt = 0 // 最近一次关闭菜单的时刻(用于避免"关掉后同一次手势又把它长按打开")
@@ -13218,6 +13437,9 @@ function openCropModal(dataUrl, fileName) {
       cropAngle.value = '0'
       cropAngleNum.value = '0'
       positionCrop()
+      // v744：裁剪窗口既可能从主菜单打开，也可能从资源管理(20300)/泡泡编辑器(20500)里打开，
+      // 固定 20000 在后者会被父窗口盖住 → 动态抬层（见 visibleTopZ 上方的分层表）
+      dshwLayerUp(cropMask, 20000)
       cropMask.style.display = 'flex'
     }
     imgEl.onerror = function () {}
@@ -13668,10 +13890,10 @@ function hideAudioEditor() {
 }
 // 组编辑弹窗试听：完全模拟挂件按压交互。
 // pointerdown（按下）→ 播放按压片段，进入"按住"状态（按压音播完仍按着则静默等待，不重复）；
-// pointerup/cancel/leave（松开）→ 若按压音已结束则立即播松开片段，否则在按压音最后 100ms 播松开（同挂件 click 重叠逻辑）。
+// pointerup/cancel/leave（松开）→ 若按压音已结束则立即播松开片段，
+// 否则把松开音**排期到按压音正好放完**的那一刻（音频线程排期；与挂件本体同一套做法，不重叠）。
 var audioEditPreviewEl = null
 var audioEditPreviewRelease = null
-var audioEditPreviewTimer = null
 var audioEditPreviewReady = false
 var audioEditPreviewPressing = false // 按住状态
 var audioEditPreviewPressEnded = false // 按压音已播完
@@ -13699,6 +13921,11 @@ function audioEditPreviewEnsure(force) {
       audioEditPreviewRelease.preload = 'auto'
       audioEditPreviewRelease.volume = soundVol
     }
+    // v745：试听也要预热（否则第一次点按试听同样是"按下音慢半拍"）
+    dshwvWarm([
+      pressId ? '/dsh-whale/audio-fragment.wav?id=' + encodeURIComponent(pressId) : '',
+      releaseId ? '/dsh-whale/audio-fragment.wav?id=' + encodeURIComponent(releaseId) : '',
+    ])
     audioEditPreviewReady = true
     return true
   } catch (err) { return false }
@@ -13715,8 +13942,11 @@ function audioEditPreviewDown() {
     // 按下：播放按压音
     audioEditPreviewEl.onended = function () {
       audioEditPreviewPressEnded = true
-      // fallback：若松手发生在按压音结束之后，立即播松开
-      if (!audioEditPreviewPressing && !audioEditPreviewReleasePlayed) audioEditPreviewUp()
+      // fallback：松手发生在按压音结束**之前**（= 直接点按）时，按压音播完立刻补上松开音。
+      // ⚠️ 这里必须直接调 audioEditPreviewPlayRelease()，**不能**调 audioEditPreviewUp()：
+      // 后者开头是 `if (!audioEditPreviewPressing) return`，而点按松手时 pressing 已经是 false
+      // → 直接 return，松开音永远不响（这就是"直接点按只有按下音、长按才听到松开音"的根因）。
+      if (!audioEditPreviewPressing && !audioEditPreviewReleasePlayed) audioEditPreviewPlayRelease()
     }
     var p = audioEditPreviewEl.play()
     if (p && typeof p.catch === 'function') p.catch(function () {})
@@ -13732,38 +13962,42 @@ function audioEditPreviewUp() {
       audioEditPreviewPlayRelease()
       return
     }
-    // 快速点击（松手时按压音未播完）：在按压音最后 100ms 播松开
+    // 快速点击（松手时按压音未播完）：与本体一致 —— 排到"按压音结束前 RELEASE_LEAD_MS"
+    // （默认 0 = 正好接上；音频线程排期，不依赖主线程定时器）
     var durKnown = false
-    var remainMs = 0
+    var remainSec = 0
     try {
       var dur = audioEditPreviewEl ? audioEditPreviewEl.duration : 0
       if (isFinite(dur) && dur > 0) {
         durKnown = true
-        remainMs = (dur - audioEditPreviewEl.currentTime) * 1000
+        remainSec = Math.max(0, dur - audioEditPreviewEl.currentTime)
       }
     } catch (err) {}
     if (durKnown) {
-      audioEditPreviewTimer = setTimeout(function () {
-        audioEditPreviewTimer = null
-        audioEditPreviewPlayRelease()
-      }, Math.max(0, remainMs - 100))
+      audioEditPreviewPlayRelease(Math.max(0, remainSec - RELEASE_LEAD_MS / 1000))
+      return
     }
     // duration 未知 → onended fallback 播放松开
   } catch (err) {}
 }
-function audioEditPreviewPlayRelease() {
+// 兜底里必须**直接**调它（不能调 audioEditPreviewUp() —— 后者以 pressing 为前置，
+// 点按松手时已为 false 会直接 return，导致"直接点按只有按下音"）。delaySec>0 时走音频线程排期。
+function audioEditPreviewPlayRelease(delaySec) {
   try {
     if (audioEditPreviewReleasePlayed || !audioEditPreviewRelease) return
     audioEditPreviewReleasePlayed = true
     audioEditPreviewRelease.currentTime = 0
+    if (delaySec > 0 && typeof audioEditPreviewRelease.playAt === 'function') {
+      audioEditPreviewRelease.playAt(delaySec)
+      return
+    }
     var p = audioEditPreviewRelease.play()
     if (p && typeof p.catch === 'function') p.catch(function () {})
   } catch (err) {}
 }
 function stopAudioEditPreview() {
   try {
-    if (audioEditPreviewTimer) { clearTimeout(audioEditPreviewTimer); audioEditPreviewTimer = null }
-    // 不销毁 Audio 元素（保持预加载状态，与挂件持久 Audio 一致），只暂停复位
+    // v745：松开音改由音频线程排期，没有主线程定时器要清
     if (audioEditPreviewEl) {
       audioEditPreviewEl.pause()
       audioEditPreviewEl.currentTime = 0
@@ -13819,7 +14053,7 @@ var audioCropFileInput = document.createElement('input')
 audioCropFileInput.type = 'file'
 audioCropFileInput.accept = 'audio/*'
 audioCropFileInput.style.display = 'none'
-document.body.appendChild(audioCropFileInput)
+dshwBodyAppend(audioCropFileInput)
 var audioCropTarget = null // 'press' | 'release'
 var audioCropCtx = null // AudioContext
 var audioCropBuffer = null // AudioBuffer
@@ -13866,6 +14100,7 @@ function openAudioCrop(arrayBuf, fileName) {
       drawAudioCrop()
       try { audioCropName.value = '' } catch (err) {}
       updateAudioCropOkState()
+      dshwLayerUp(audioCropMask, 20500) // v744：音频裁剪也可能从资源管理(20300)里打开
       audioCropMask.style.display = 'flex'
     }, function () { alert('音频解码失败') })
   } catch (err) {}

package/lib/index.js

@@ -434,10 +434,15 @@ const RUA_GIF_CANDIDATES = [
   path.join(PACKAGE_ROOT, 'assets', 'rua.gif'),
 ]
 // DeepSeek CNY prices per million tokens: [空闲时段价, 高峰时段价].
-// 高峰时段：工作日 9:00–12:00 和 14:00–18:00（北京时间）；2026-08-23 起周末全天谷价。
+// 高峰时段（官方 2026-09-19 说明，见 docs 脚注 (2)）：**北京时间周一至周五（不含中国法定节假日）
+// 9:00–12:00、14:00–18:00**；其余时段 —— 包括**周末、调休上班的周末、以及中国法定节假日全天** ——
+// 一律按空闲时段计费。
+//   时间线：2026-08-17 峰谷定价正式实施 → 2026-08-23 00:00 起周末全天谷价 →
+//           2026-09-19 明确「调休上班的周末 + 法定节假日全天」也按空闲计。
 // 价格来源：官方 https://api-docs.deepseek.com/zh-cn/quick_start/pricing
 // 2026-09-10 起 Flash 系列降价：缓存命中 0.05→0.02、未命中 1.5→1、输出 4.5→4（高峰=空闲×2）。
-// 2026-09-14 复核：价格数字与上表一致,无需改动。
+// 2026-09-19 复核：价格数字与上表一致（Flash 0.02/1/4 与 0.04/2/8；Pro 0.15/4.5/13.5 与 0.30/9/27），
+//           峰谷规则新增「法定节假日全天谷价」这一条，见下方 HOLIDAY_VALLEY。
 const PEAK_HOURS = [
   [9, 12],
   [14, 18],
@@ -483,6 +488,37 @@ function priceFor(model) {
 // 2026-08-23 起（北京时间）周末（周六/周日）全天按谷价；生效时刻之前的历史
 // 分桶仍按旧规则计价，所以周末判定带生效分界。
 const WEEKEND_VALLEY_FROM_SEC = Math.floor(Date.UTC(2026, 7, 22, 16, 0, 0) / 1000) // = 北京时间 2026-08-23 00:00
+// ===== 法定节假日全天谷价（官方 2026-09-19 说明）=====
+// 依据：《国务院办公厅关于 2026 年部分节假日安排的通知》（国办发明电〔2025〕7 号，2025-11-04）
+//       + DeepSeek API 官方计费脚注「周一至周五（不含中国法定节假日）…其余时段，包括周末及
+//       中国法定节假日全天均为空闲时段」。
+// 只需列**放假**的日期：调休上班日全部落在周末（2026 年为 1/4、2/14、2/28、5/9、9/20、10/10），
+// 按"周末也算谷价"的规则本来就是谷价，无需单列。
+// ⚠️ **每年 11 月国务院发布次年安排后，必须在这里补下一年的日期**（探针 `_peak-holiday-check.mjs`
+// 会检查当年是否已覆盖并给出提醒）。
+const HOLIDAY_VALLEY = {
+  '2026-01-01': 1, '2026-01-02': 1, '2026-01-03': 1, // 元旦 1/1–1/3（1/4 周日上班）
+  '2026-02-15': 1, '2026-02-16': 1, '2026-02-17': 1, '2026-02-18': 1, '2026-02-19': 1, // 春节 2/15–2/23（9 天）
+  '2026-02-20': 1, '2026-02-21': 1, '2026-02-22': 1, '2026-02-23': 1,
+  '2026-04-04': 1, '2026-04-05': 1, '2026-04-06': 1, // 清明 4/4–4/6
+  '2026-05-01': 1, '2026-05-02': 1, '2026-05-03': 1, '2026-05-04': 1, '2026-05-05': 1, // 劳动节 5/1–5/5（5/9 周六上班）
+  '2026-06-19': 1, '2026-06-20': 1, '2026-06-21': 1, // 端午 6/19–6/21
+  '2026-09-25': 1, '2026-09-26': 1, '2026-09-27': 1, // 中秋 9/25–9/27
+  '2026-10-01': 1, '2026-10-02': 1, '2026-10-03': 1, '2026-10-04': 1, // 国庆 10/1–10/7（9/20 周日、10/10 周六上班）
+  '2026-10-05': 1, '2026-10-06': 1, '2026-10-07': 1,
+}
+// 这条规则自 2026-09-19 起生效（此前历史分桶按旧规则计价）。2026 年内落在 8/17（峰谷机制实施）
+// 与 9/19 之间没有任何"工作日的法定节假日"，所以对 2026 年的账目没有影响；次年（2027）之后
+// 整年的节假日都会走到这个分支。
+const HOLIDAY_VALLEY_FROM_SEC = Math.floor(Date.UTC(2026, 8, 18, 16, 0, 0) / 1000) // = 北京时间 2026-09-19 00:00
+// 下发给前端（挂件）的节假日清单：前端「时段倒计时」也要按节假日算下一切换点，
+// 而前端无法自己知道法定安排，所以由宿主单一来源下发。每次 /dsh-whale/balance 都会带上。
+const HOLIDAY_VALLEY_LIST = Object.keys(HOLIDAY_VALLEY).sort()
+function isHolidayValley(bjDate) {
+  try {
+    return !!HOLIDAY_VALLEY[bjDate.toISOString().slice(0, 10)]
+  } catch (err) { return false }
+}
 function isPeakTime(timeSec) {
   if (!isFinite(Number(timeSec))) return false
   const n = Number(timeSec)
@@ -491,12 +527,32 @@ function isPeakTime(timeSec) {
     const dow = bj.getUTCDay() // 0=周日 6=周六（bj 按 UTC 读即为北京日历日）
     if (dow === 0 || dow === 6) return false
   }
+  // 法定节假日全天谷价（含调休放假的工作日）
+  if (n >= HOLIDAY_VALLEY_FROM_SEC && isHolidayValley(bj)) return false
   const hour = bj.getUTCHours()
   for (const [start, end] of PEAK_HOURS) {
     if (hour >= start && hour < end) return true
   }
   return false
 }
+// 下一个峰谷切换时刻（epoch 秒）：与 isPeakTime 完全同源（含周末 + 法定节假日规则）。
+// 只需扫北京时间的小时边界 0/9/12/14/18 点；最长假期（春节 9 天）也只到第 9 天，
+// 这里扫 12 天留足余量。返回 null 表示 12 天内没有切换点（当前规则下不会发生），
+// 由前端回退到自己的本地推算。
+function nextPeakChangeAt(timeSec) {
+  const n = Number(timeSec)
+  if (!isFinite(n)) return null
+  const cur = isPeakTime(n)
+  const day0 = Math.floor((n + 8 * 3600) / 86400) * 86400 // 北京当日 00:00（在 +8h 平移坐标系里）
+  for (let d = 0; d <= 12; d++) {
+    for (const edge of [0, 9, 12, 14, 18]) {
+      const cand = day0 + d * 86400 + edge * 3600 - 8 * 3600
+      if (cand <= n + 1) continue
+      if (isPeakTime(cand) !== cur) return cand
+    }
+  }
+  return null
+}
 
 const JSON_HEADERS = {
   'Content-Type': 'application/json; charset=utf-8',
@@ -929,7 +985,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.6', today: todayData, days7,
+        ok: true, version: '0.3.8', 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),
@@ -1312,20 +1368,30 @@ export default {
     let codexCatchupT = null
     // 配置变更（例如用户在设置里关掉 Codex 统计）后必须让快照失效，
     // 否则下一次请求还会命中关闭前的旧快照、开关看起来"没生效"。
-    function codexInvalidate() { codexSnap = null; codexSnapAt = 0 }
+    function codexInvalidate() { codexSnap = null; codexSnapAt = 0; codexStatsOnV = null; codexStatsOnAt = 0 }
+    // 开关读取加 2 秒缓存：codexBackgroundRefresh 可能被高频调用（快照过期时每次 payload
+    // 构建都会试一次），而 readSizeConfig() 是同步文件读 —— 不能放在热路径上。
+    // 用户改设置时 codexInvalidate() 会清掉缓存，所以开关仍然是"立刻生效"。
+    let codexStatsOnV = null, codexStatsOnAt = 0
     function codexStatsOn() {
+      const now = Date.now()
+      if (codexStatsOnV !== null && now - codexStatsOnAt < 2000) return codexStatsOnV
+      let v = true
       try {
         const cfg = readSizeConfig()
-        return !cfg || cfg.codexStatsOn !== false
-      } catch (err) { return true }
+        v = !cfg || cfg.codexStatsOn !== false
+      } catch (err) { v = true }
+      codexStatsOnV = v
+      codexStatsOnAt = now
+      return v
     }
     function codexBackgroundRefresh(delayMs) {
+      if (codexScanP) return codexScanP // 已在扫：先返回，避免重复读配置/重复排队
       if (!codexStatsOn()) {
         codexSnap = { ok: false, disabled: true, error: 'Codex 统计已在设置里关闭' }
         codexSnapAt = Date.now()
         return null
       }
-      if (codexScanP) return codexScanP
       if (delayMs > 0) {
         if (codexCatchupT) return null
         codexCatchupT = setTimeout(() => { codexCatchupT = null; codexBackgroundRefresh(0) }, delayMs)
@@ -2093,8 +2159,12 @@ export default {
       const { accountTag, ...visible } = payload
       const led = readUsageLedger()
       const summary = daySummary(led, todayKey())
+      const nowSec = Math.floor(Date.now() / 1000)
       return {
-        ...visible, version: '0.3.6', isPeak: isPeakTime(Math.floor(Date.now() / 1000)),
+        ...visible, version: '0.3.8', isPeak: isPeakTime(nowSec),
+        // 峰谷切换点与节假日清单：前端倒计时要与宿主同源（否则法定节假日会算错切换点）
+        peakNextChangeAt: nextPeakChangeAt(nowSec),
+        peakHolidays: HOLIDAY_VALLEY_LIST,
         todayUsage: summary.amount, todayUsageCurrency: summary.currency,
         usageSource: summary.source, usageLabel: summary.label, usageMode: 'ledger',
         accounting: balanceSummary(led, todayKey()),

package/package.json

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