dsh-whale-widget 0.3.5 → 0.3.7

package/assets/whale-widget.js

@@ -6,10 +6,30 @@ window.__dshWhaleWidget = true
 // 挂件脚本通过 tapIndex 注入 DSH 的每一个 index 页面（含插件市场等 SPA 视图）。
 // 市场页用 ReactDOM.createPortal 渲染到 document.body，若挂件在此初始化，
 // 会在 body 插入节点并注册全局捕获拦截，干扰 React 渲染树（removeChild 报错、页面空白）。
-// 主聊天界面的特征：composer 输入区。DSH 新版输入框为 contenteditable div，旧版为 textarea，
-// 两种都算主界面；检测到才继续，否则不碰 DOM、不注册监听。
+// 主聊天界面的特征：composer 输入区。三种形态都算主界面：
+//   (a) 旧版 textarea
+//   (b) 旧版 contenteditable 可编辑 div
+//   (c) **DSH 0.1.6-alpha.1 起的新版**：<div contenteditable="false" role="textbox"
+//       aria-multiline="true" data-composer-input="true">（编辑由 Lexical 接管，所以
+//       contenteditable 反而是 false —— 只认前两种会让挂件在新版 DSH 上**完全不初始化**，
+//       见 issue #123）。检测到才继续，否则不碰 DOM、不注册监听。
 function dshwIsChatRoot(r) {
-  return !!(r && (r.querySelector('textarea') || r.querySelector('[contenteditable="true"]')))
+  if (!r || !r.querySelector) return false
+  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]') ||
+    // 同一层的 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
 function dshwStartOnce() {
@@ -679,6 +699,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'
 
@@ -763,7 +815,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
@@ -899,7 +951,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)
     // 可选底部参照元素:展开高度不超过该元素的上缘(内部滚动),用于
     // 主菜单内“任务结束音效”等下拉,避免列表盖住底部「小鲸鱼记账」按钮
@@ -1342,6 +1394,17 @@ var rowHide = menuRow()
 rowHide.appendChild(menuLabel('隐藏菜单按钮'))
 rowHide.appendChild(menuHideToggle)
 menuBox.appendChild(rowHide)
+// —— Codex 本机统计开关（issue #116）：关掉后宿主不再扫描 ~/.codex/sessions ——
+var codexStatsToggle = document.createElement('input')
+codexStatsToggle.type = 'checkbox'
+codexStatsToggle.className = 'dshwv-check'
+codexStatsToggle.checked = true
+codexStatsToggle.title = '关闭后不再读取 ~/.codex/sessions 统计本机 Codex 用量（会话日志很大时建议关闭）'
+codexStatsToggle.addEventListener('change', function () { setCodexStatsOn(codexStatsToggle.checked) })
+var rowCodexStats = menuRow()
+rowCodexStats.appendChild(menuLabel('Codex 本机统计'))
+rowCodexStats.appendChild(codexStatsToggle)
+menuBox.appendChild(rowCodexStats)
 // —— 资源管理:集中查看/删除已导入的图片与音频(角色图/泡泡图/音频片段/音效组) ——
 var rowRes = menuRow()
 var resOpenBtn = document.createElement('button')
@@ -1969,7 +2032,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) {}
@@ -2541,7 +2604,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) {
@@ -2892,7 +2955,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) {}
 }
@@ -3080,7 +3143,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) {}
 }
@@ -3238,7 +3301,8 @@ function openBalanceAdjustment(modelId) {
   function close() {
     if (busy) return
     document.removeEventListener('keydown', keyHandler)
-    mask.remove()
+    // v743：主动移除要走 dshwBodyDetach —— 否则它已被登记，DOM 守护会把这个刚关掉的窗口"复活"
+    dshwBodyDetach(mask)
     accountingMask = null
     // 关掉校正窗口后回到同一个设置菜单，并把焦点放回「校正」按钮
     openApiModelMenu(modelId)
@@ -3271,7 +3335,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 = []
@@ -3467,7 +3531,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'
@@ -3490,7 +3554,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'
@@ -4090,7 +4154,7 @@ function usagePopupCard(title, content, below, amount) {
     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)
+    dshwBodyAppend(mask)
   } catch (err) {}
 }
 var USAGE_PALETTE = ['#203170', '#e0433f', '#2fa24c', '#b060c8', '#e89a2e', '#3aa6c8', '#d06a8a', '#7a8b2f', '#6a6ad0', '#c84a8a']
@@ -4595,7 +4659,7 @@ function fillUsageRecordsWindow(d) {
     renderGroups('')
   })
 }
-document.body.appendChild(rolePanel)
+dshwBodyAppend(rolePanel)
 
 // —— 吸附与翻转自定义弹窗 ——
 // 预览方框内五条可拖线：左/右/上/下四条吸附区边界 + 红色翻转线（竖中线位置）。
@@ -5012,7 +5076,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
@@ -6868,7 +6932,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) {
@@ -8190,7 +8254,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')
@@ -8274,7 +8338,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
@@ -8410,7 +8474,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'
@@ -9461,7 +9525,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'
@@ -9494,7 +9558,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 {
@@ -9607,7 +9671,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)
@@ -9707,7 +9771,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
@@ -9788,7 +9852,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
@@ -9880,7 +9944,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() })
@@ -10033,7 +10097,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)
@@ -10104,8 +10168,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，切到会话列表 / 设置 / 插件市场再回来、或其它客户端插件整体替换
@@ -10113,19 +10177,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 })
   }
@@ -10909,8 +10983,18 @@ function apiCodexDays7(c) {
 // 列表行摘要
 function apiCodexRowText(am) {
   var c = am && am.codex
-  if (!c || !c.ok) return c && c.error ? ('⚠ ' + c.error) : '无 Codex 数据'
-  return 'Codex 今日 ' + apiFmtTokens(c.todayTokens) + ' · 近7天 ' + apiFmtTokens(apiCodexDays7(c)) + ' tokens'
+  if (!c || !c.ok) {
+    // issue #116：把「被关掉 / 找不到目录 / 出错」区分开，不再是一句笼统的失败
+    if (c && c.disabled) return 'Codex 统计已关闭'
+    return c && c.error ? ('⚠ ' + c.error) : '无 Codex 数据'
+  }
+  var txt = 'Codex 今日 ' + apiFmtTokens(c.todayTokens) + ' · 近7天 ' + apiFmtTokens(apiCodexDays7(c)) + ' tokens'
+  // 护栏的实际情况要能看见（issue #116：原报告抱怨"无开关、无报错、无提示"）
+  var notes = []
+  if (Number(c.skipped) > 0) notes.push('已跳过 ' + c.skipped + ' 个超大日志')
+  if (Number(c.deferred) > 0) notes.push('统计更新中')
+  if (notes.length) txt += '（' + notes.join(' · ') + '）'
+  return txt
 }
 // 第二期：订阅窗口（5h / 周）。host 已把 rate_limits 归一成 { primary, secondary, planType }
 function apiCodexWinLabel(w, idx) {
@@ -11204,7 +11288,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 {
@@ -11248,7 +11332,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 {
@@ -12369,6 +12453,9 @@ var costBubbleActive = false
 var scrollGapOn = false
 var scrollGapPx = 17
 var menuBtnHide = false // 主菜单开关:隐藏挂件菜单按钮,改为右键小鲸鱼唤出菜单
+// issue #116：Codex 本机统计开关（默认开）。关掉后宿主完全不扫 ~/.codex/sessions，
+// 适合会话日志很大的机器（超大日志会让统计扫描变得很重）。
+var codexStatsOn = true
 // —— v734（issue #97 / #88）：设置保存的「防覆盖 + 失败可见」——
 // #97 根因：首次 GET 还没落地就 PUT，会把内存里的默认值整包写进服务端（重启后设置被洗成默认值）。
 // #88 根因：这个 PUT 以前是 fire-and-forget，服务端 500 / {ok:false} 完全没人读。
@@ -12385,7 +12472,7 @@ 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
@@ -12402,7 +12489,7 @@ function configSaveFailNotice(detail) {
     '<br>已自动重试一次。若持续失败，请检查 DSH 数据目录是否可写。')
 }
 function configPayload() {
-  return JSON.stringify({ scale: state.scale, sound: soundOn, vol: soundVol, soundSet: soundSet, usageMode: usageMode, peakMode: peakMode, bubbleOn: bubbleOn, turnCostOn: turnCostOn, turnCostCloseMs: turnCostCloseMs, scrollGapOn: scrollGapOn, scrollGapPx: scrollGapPx, menuBtnHide: menuBtnHide })
+  return JSON.stringify({ scale: state.scale, sound: soundOn, vol: soundVol, soundSet: soundSet, usageMode: usageMode, peakMode: peakMode, bubbleOn: bubbleOn, turnCostOn: turnCostOn, turnCostCloseMs: turnCostCloseMs, scrollGapOn: scrollGapOn, scrollGapPx: scrollGapPx, menuBtnHide: menuBtnHide, codexStatsOn: codexStatsOn })
 }
 // 真正的 PUT：读响应 → 失败（网络异常 / HTTP!=200 / {ok:false}）静默重试一次 → 仍失败才提示
 function configPut(payload, retried) {
@@ -12424,12 +12511,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 旧格式含避让距离，恢复时废弃旧格式。
@@ -12532,6 +12622,18 @@ function setMenuBtnHide(v) {
   saveConfig()
   applyMenuBtnHideUI()
 }
+// issue #116：Codex 本机统计开关。关掉后宿主不扫描 ~/.codex/sessions；
+// 打开/关闭都要重取一次模型列表，让 Codex 那行的统计/提示立刻跟着变。
+function setCodexStatsOn(v) {
+  codexStatsOn = v !== false
+  if (codexStatsToggle) codexStatsToggle.checked = codexStatsOn
+  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
 }
@@ -13776,7 +13878,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
@@ -14765,6 +14867,11 @@ fetch(SIZE_URL, { cache: 'no-store' })
       menuBtnHide = d.menuBtnHide
       if (menuHideToggle) menuHideToggle.checked = menuBtnHide
     }
+    // issue #116：Codex 本机统计开关（老配置里没有这个键 → 保持默认「开」）
+    if (d && typeof d.codexStatsOn === 'boolean') {
+      codexStatsOn = d.codexStatsOn
+      if (codexStatsToggle) codexStatsToggle.checked = codexStatsOn
+    }
     // 无论服务端带没带这个键都要应用一次：触屏上 ☰ 需要常显（issue #91 缺陷2），
     // 而旧写法只在键存在时才调用，空配置下按钮永远是透明的。
     applyMenuBtnHideUI()

package/lib/index.js

@@ -929,7 +929,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.5', today: todayData, days7,
+        ok: true, version: '0.3.7', 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),
@@ -1085,14 +1085,14 @@ export default {
       walk(path.join(root, 'archived_sessions'), 0)
       return out
     }
-    // 解析单个会话文件 → { day: { model: {in,cached,cwrite,out,reason,total,turns} } }
-    function parseCodexFile(file) {
+    // 解析单个会话文件的**文本** → { days, rl, rlTs }
+    // issue #116：读取改由调用方异步完成（先判大小、读完让出事件循环），这里只做纯解析。
+    function parseCodexFileText(text) {
       const days = {}
       let model = 'codex'
       let prevTotal = null
       let lastRl = null, rlTs = 0
-      let text = ''
-      try { text = fs.readFileSync(file, 'utf8') } catch (err) { return { days, rl: null, rlTs: 0 } }
+      if (typeof text !== 'string' || !text) return { days, rl: null, rlTs: 0 }
       const bump = (day, mk, v) => {
         days[day] = days[day] || {}
         const cur = days[day][mk] || { in: 0, cached: 0, cwrite: 0, out: 0, reason: 0, total: 0, turns: 0 }
@@ -1194,21 +1194,57 @@ export default {
       }
     }
     // 汇总（带增量缓存：只有变化的文件才重新解析）
-    function codexSummary() {
+    // ===== issue #116：Codex 本地统计的护栏 =====
+    // 旧实现是「启动 1.5s + 每 5 分钟」在事件循环上做**同步**全量扫描：递归遍历
+    // ~/.codex/sessions，对每个过期文件 readFileSync + split('\n') + 逐行 JSON.parse。
+    // 会话攒多之后，一轮扫描能冻结事件循环数分钟（整个 dsh web 不响应、满核 CPU），
+    // 而且单个超过 V8 字符串上限（约 512MB）的 rollout 会抛 ERR_STRING_TOO_LONG ——
+    // 由于是在写缓存之前就抛出，那个文件每轮都会被重读，size/mtime 又一直在变，永久复发。
+    // 现在三条护栏：
+    //   ① 单文件上限：超过 CODEX_MAX_FILE_BYTES 直接跳过（结果记进缓存，不再重读），
+    //      并在汇总里报 skipped / skippedBytes，界面上能看出"有文件被跳过"；
+    //   ② 单轮预算：一轮最多读 CODEX_BUDGET_FILES 个 / CODEX_BUDGET_BYTES 字节，超了就
+    //      带 deferred 出结果，本轮立刻返回、稍后再刷新 —— 绝不长时间占住事件循环；
+    //   ③ 全程异步（fs.promises）＋ 每个文件处理后让出一次事件循环（await setImmediate）。
+    const CODEX_MAX_FILE_BYTES = 32 * 1024 * 1024
+    const CODEX_BUDGET_FILES = 400
+    const CODEX_BUDGET_BYTES = 96 * 1024 * 1024
+    const CODEX_SNAP_TTL = 60 * 1000
+    const yieldLoop = () => new Promise((r) => setImmediate(r))
+
+    // 汇总（带增量缓存：只有变化的文件才重新解析）。异步、受预算约束。
+    async function codexScan() {
       const home = codexHome()
       if (!home) return { ok: false, error: '未找到 Codex 目录（$CODEX_HOME 或 ~/.codex）' }
       const cache = readCodexCache()
       const files = listCodexSessionFiles(home)
       const keep = {}
-      let changed = 0
+      let changed = 0, skipped = 0, skippedBytes = 0, deferred = 0, readBytes = 0, parsedCount = 0
       for (const f of files) {
         let st = null
-        try { st = fs.statSync(f) } catch (err) { continue }
+        try { st = await fs.promises.stat(f) } catch (err) { continue }
         const prev = cache.files[f]
-        if (prev && prev.size === st.size && prev.mtimeMs === st.mtimeMs && prev.days) { keep[f] = prev; continue }
-        const parsed = parseCodexFile(f)
+        if (prev && prev.size === st.size && prev.mtimeMs === st.mtimeMs && prev.days) {
+          keep[f] = prev
+          if (prev.skip === 'too-big') { skipped++; skippedBytes += Number(st.size) || 0 }
+          continue
+        }
+        // ① 单文件上限：跳过超大文件（errno 不再产生，也不再每轮重读）
+        if (st.size > CODEX_MAX_FILE_BYTES) {
+          keep[f] = { size: st.size, mtimeMs: st.mtimeMs, days: {}, rl: null, rlTs: 0, skip: 'too-big' }
+          skipped++; skippedBytes += st.size; changed++
+          continue
+        }
+        // ② 单轮预算：本轮读够了就停，剩下的留到下一次刷新
+        if (readBytes + st.size > CODEX_BUDGET_BYTES || parsedCount >= CODEX_BUDGET_FILES) { deferred++; continue }
+        let text = ''
+        try { text = await fs.promises.readFile(f, 'utf8') } catch (err) { text = '' }
+        readBytes += st.size
+        const parsed = parseCodexFileText(text)
         keep[f] = { size: st.size, mtimeMs: st.mtimeMs, days: parsed.days, rl: parsed.rl || null, rlTs: parsed.rlTs || 0 }
         changed++
+        parsedCount++
+        await yieldLoop() // ③ 每个文件让出一次，HTTP 请求不会被整轮扫描堵住
       }
       if (changed > 0 || Object.keys(cache.files).length !== Object.keys(keep).length) {
         writeCodexCache({ version: 1, files: keep, builtAt: Date.now() })
@@ -1251,6 +1287,9 @@ export default {
       }
       return {
         ok: true, home, sessions: files.length, changed,
+        // issue #116：把护栏的实际情况报出来，界面/日志能看出"有文件被跳过或本轮没扫完"
+        skipped, skippedBytes, deferred, readBytes,
+        maxFileBytes: CODEX_MAX_FILE_BYTES,
         todayTokens, monthTokens, totalTokens,
         outTokens, reasonTokens, cachedTokens,
         days7, byModel,
@@ -1260,23 +1299,80 @@ export default {
         rateLimitsTs: bestRlTs > 0 ? bestRlTs : 0,
       }
     }
-    // codexSummary 的短 TTL 记忆：payload 循环 + 额度计算 + 探活会在同一次请求里反复问同一份数据，
-    // 每次都同步 stat/读文件会白白阻塞事件循环（会话文件可能有几十 MB）
-    let codexMemo = null, codexMemoAt = 0
+    // ===== 汇总快照（issue #116）=====
+    // 关键变化：**任何调用方都不会再触发同步扫描**。
+    //   · codexSummaryCached()：同步、永不阻塞 —— 直接返回上一次快照；快照过期时
+    //     「顺手发起」一次后台刷新（不等待），所以同步调用点（额度计算）也一样安全；
+    //   · codexSummaryEnsured(ms)：需要尽量新的地方（探活 / 模型列表）用，等在途扫描，
+    //     最多等 ms 毫秒，超时就用当前快照，绝不无限等；
+    //   · 同一时刻只允许一次扫描在跑（去重），预算用完时安排一次稍后的补扫。
+    let codexSnap = null
+    let codexSnapAt = 0
+    let codexScanP = null
+    let codexCatchupT = null
+    // 配置变更（例如用户在设置里关掉 Codex 统计）后必须让快照失效，
+    // 否则下一次请求还会命中关闭前的旧快照、开关看起来"没生效"。
+    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()
+        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 (delayMs > 0) {
+        if (codexCatchupT) return null
+        codexCatchupT = setTimeout(() => { codexCatchupT = null; codexBackgroundRefresh(0) }, delayMs)
+        try { if (codexCatchupT.unref) codexCatchupT.unref() } catch (err) {}
+        return null
+      }
+      codexScanP = codexScan()
+        .then((s) => {
+          codexSnap = s
+          codexSnapAt = Date.now()
+          // 本轮没扫完（预算用尽）→ 稍后补扫，逐步把统计补齐，而不是一次占满事件循环
+          if (s && s.ok && s.deferred > 0) codexBackgroundRefresh(5000)
+        })
+        .catch((err) => {
+          codexSnap = { ok: false, error: String((err && err.message) || err) }
+          codexSnapAt = Date.now()
+        })
+        .finally(() => { codexScanP = null })
+      return codexScanP
+    }
     function codexSummaryCached() {
       const now = Date.now()
-      if (codexMemo && now - codexMemoAt < 5000) return codexMemo
-      codexMemo = codexSummary()
-      codexMemoAt = now
-      return codexMemo
-    }
-    // 后台预热：codexSummary 首次要同步读全部 rollout 日志（可能几十 MB），
-    // 放在请求路径里会阻塞事件循环。这里在插件启动后预热一次，并每 5 分钟刷新一次缓存，
-    // 请求进来时通常直接命中 codexSummaryCached 的 5 秒记忆。
+      if (!codexSnap || now - codexSnapAt > CODEX_SNAP_TTL) codexBackgroundRefresh(0)
+      return codexSnap
+    }
+    async function codexSummaryEnsured(maxWaitMs) {
+      const stale = !codexSnap || Date.now() - codexSnapAt > CODEX_SNAP_TTL
+      const p = codexScanP || (stale ? codexBackgroundRefresh(0) : null)
+      if (!p) return codexSnap
+      try { await Promise.race([p, new Promise((r) => setTimeout(r, Math.max(200, maxWaitMs || 2500)))]) } catch (err) {}
+      return codexSnap
+    }
+    // 后台预热：启动后预热一次，并每 5 分钟刷新一次缓存（现在都是异步 + 有预算的，不再阻塞）。
     let codexPrewarmT = null, codexPrewarmI = null
     try {
-      codexPrewarmT = setTimeout(function () { try { codexSummaryCached() } catch (err) {} }, 1500)
-      codexPrewarmI = setInterval(function () { try { codexSummaryCached() } catch (err) {} }, 5 * 60 * 1000)
+      codexPrewarmT = setTimeout(function () { try { codexBackgroundRefresh(0) } catch (err) {} }, 1500)
+      codexPrewarmI = setInterval(function () { try { codexBackgroundRefresh(0) } catch (err) {} }, 5 * 60 * 1000)
       // issue #109：这两个定时器原先不存句柄、也不进 disposers，插件树 dispose 之后
       // 事件循环里仍有一个被引用的 interval → 用户退出 dsh 时进程不结束（只能 Ctrl+C）。
       // 存句柄并纳入 disposers，卸载时一并清掉；unref 作为兜底（正常运行时由 HTTP 服务维持事件循环）。
@@ -1285,6 +1381,7 @@ export default {
       disposers.push(function () {
         if (codexPrewarmT !== null) { clearTimeout(codexPrewarmT); codexPrewarmT = null }
         if (codexPrewarmI !== null) { clearInterval(codexPrewarmI); codexPrewarmI = null }
+        if (codexCatchupT !== null) { clearTimeout(codexCatchupT); codexCatchupT = null }
       })
     } catch (err) {}
     // ===== 自定义 API 模型注册表（v655）=====
@@ -1426,7 +1523,7 @@ export default {
       }
       // Codex 模式：本地会话统计即「探活结果」，不需要网络与密钥
       if (tpl.kind === 'codex') {
-        const cs = codexSummaryCached()
+        const cs = await codexSummaryEnsured(2500)
         const f = (n) => (n >= 100000000 ? (n / 100000000).toFixed(2) + '亿' : (n >= 10000 ? (n / 10000).toFixed(1).replace(/\.0$/, '') + '万' : String(Math.round(Number(n) || 0))))
         if (cs && cs.ok) {
           return { ok: true, detail: 'Codex 本地会话：今日 ' + f(cs.todayTokens) + ' · 本月 ' + f(cs.monthTokens) + ' · 累计 ' + f(cs.totalTokens) + ' tokens（' + cs.sessions + ' 个会话文件）' }
@@ -1923,10 +2020,12 @@ export default {
           entry.planSupport = !!tplM.quota
           // Codex 模式：不查余额、不需要密钥，直接给本地会话统计（今日/本月/累计/近7天）
           if (tplM.kind === 'codex') {
-            if (!codexStats) codexStats = codexSummaryCached()
+            // 这里能等：模型列表请求可以稍等一下在途扫描（最多 2.5s），但绝不触发同步扫描
+            if (!codexStats) codexStats = await codexSummaryEnsured(2500)
             entry.codex = codexStats
             entry.hasKey = true
-            entry.error = codexStats && codexStats.ok ? null : ((codexStats && codexStats.error) || '未找到 Codex 会话目录')
+            entry.error = codexStats && codexStats.ok ? null
+              : (codexStats && codexStats.disabled ? null : ((codexStats && codexStats.error) || '未找到 Codex 会话目录'))
           }
           // 没有余额接口的厂商（如火山方舟）：余额显示「—」，只用会话事件估算
           entry.balanceMode = hasBalanceApi ? 'api' : 'events'
@@ -2005,7 +2104,7 @@ export default {
       const led = readUsageLedger()
       const summary = daySummary(led, todayKey())
       return {
-        ...visible, version: '0.3.5', isPeak: isPeakTime(Math.floor(Date.now() / 1000)),
+        ...visible, version: '0.3.7', isPeak: isPeakTime(Math.floor(Date.now() / 1000)),
         todayUsage: summary.amount, todayUsageCurrency: summary.currency,
         usageSource: summary.source, usageLabel: summary.label, usageMode: 'ledger',
         accounting: balanceSummary(led, todayKey()),
@@ -2056,6 +2155,9 @@ export default {
               scrollGapOn: parsed.scrollGapOn === true,
               scrollGapPx: typeof parsed.scrollGapPx === 'number' ? Math.round(parsed.scrollGapPx) : 17,
               menuBtnHide: parsed.menuBtnHide === true,
+              // issue #116：Codex 本地统计可以在设置里关掉（默认开）。关掉后宿主完全不扫
+              // ~/.codex/sessions，也不做后台预热。
+              codexStatsOn: parsed.codexStatsOn !== false,
             }
           }
         } catch (err) {}
@@ -2063,7 +2165,7 @@ export default {
       return null
     }
 
-    function writeSizeConfig(scale, sound, vol, soundSet, usageMode, peakMode, bubbleOn, turnCostOn, turnCostCloseMs, scrollGapOn, scrollGapPx, menuBtnHide) {
+    function writeSizeConfig(scale, sound, vol, soundSet, usageMode, peakMode, bubbleOn, turnCostOn, turnCostCloseMs, scrollGapOn, scrollGapPx, menuBtnHide, codexStatsOnArg) {
       const um = normalizeUsageMode(usageMode)
       const pm = peakMode === 'liangwen' || peakMode === 'qiangqiang' ? peakMode : 'default'
       const bo = bubbleOn !== false
@@ -2072,6 +2174,7 @@ export default {
       const sgo = scrollGapOn === true
       const sgp = typeof scrollGapPx === 'number' && scrollGapPx > 0 ? Math.round(scrollGapPx) : 0
       const mbh = menuBtnHide === true
+      const cso = codexStatsOnArg !== false
       const body = JSON.stringify({
         scale: scale,
         sound: sound !== false,
@@ -2085,6 +2188,7 @@ export default {
         scrollGapOn: sgo,
         scrollGapPx: sgp,
         menuBtnHide: mbh,
+        codexStatsOn: cso,
         updatedAt: new Date().toISOString(),
       })
       let lastSizeErr = null
@@ -2105,6 +2209,7 @@ export default {
             scrollGapOn: sgo,
             scrollGapPx: sgp,
             menuBtnHide: mbh,
+            codexStatsOn: cso,
           }
         } catch (err) { lastSizeErr = err }
       }
@@ -2512,9 +2617,12 @@ export default {
               pickN(parsed.turnCostCloseMs, old.turnCostCloseMs, 5000),
               pickB(parsed.scrollGapOn, old.scrollGapOn, false),
               pickN(parsed.scrollGapPx, old.scrollGapPx, 17),
-              pickB(parsed.menuBtnHide, old.menuBtnHide, false)
+              pickB(parsed.menuBtnHide, old.menuBtnHide, false),
+              pickB(parsed.codexStatsOn, old.codexStatsOn, true)
             )
             res.writeHead(result.ok ? 200 : 500, JSON_HEADERS)
+            // 配置刚变（可能刚关掉/打开 Codex 统计）→ 丢掉旧快照，让下一次请求立刻反映新设置
+            if (result.ok) { try { codexInvalidate() } catch (err) {} }
             res.end(JSON.stringify(result))
           } catch (err) {
             res.writeHead(400, JSON_HEADERS)

package/package.json

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