dsh-whale-widget 0.3.4 → 0.3.6

package/assets/whale-widget.js

@@ -6,10 +6,21 @@ 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"]') ||
+    r.querySelector('[data-composer-input]') ||
+    r.querySelector('[role="textbox"]')
+  )
 }
 var dshwStarted = false
 function dshwStartOnce() {
@@ -1342,6 +1353,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')
@@ -10107,6 +10129,30 @@ root.appendChild(menuBtn)
 document.body.appendChild(root)
 document.body.appendChild(menuBox)
 
+// ===== PR #105 后半：DOM 守护（SPA 切路由 / 别的插件替换 body 子树时把节点摘掉）=====
+// 背景：DSH 是 SPA，切到会话列表 / 设置 / 插件市场再回来、或其它客户端插件整体替换
+// document.body 的子树时，挂件节点会被顺带移除，而它不会自己回来（脚本只初始化一次）。
+// 做法：暴露 window.__dshWhaleRoot 供外部定位/调试，并用一个 MutationObserver 盯着；
+// 一旦发现节点已不在文档里就**把同一个节点补挂回 body**（不重建、不重新初始化，
+// 位置/设置/状态全部保留）。
+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)
+  } catch (err) {}
+}
+try {
+  if (typeof MutationObserver === 'function') {
+    var dshwRootGuard = new MutationObserver(function () {
+      if (root && !root.isConnected) dshwReattachRoot()
+    })
+    dshwRootGuard.observe(document.documentElement, { childList: true, subtree: true })
+  }
+} catch (err) {}
+
 // 泡泡内容整体与视觉中心对齐:
 // 读取 SVG 主体(bshape)的包围盒,取其中点作为文字内容区的视觉中心,
 // 写入 --dshw-vx/--dshw-vy(相对 .dshwv-pop 尺寸的百分比)。
@@ -10885,8 +10931,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) {
@@ -12345,6 +12401,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} 完全没人读。
@@ -12378,7 +12437,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) {
@@ -12508,6 +12567,14 @@ function setMenuBtnHide(v) {
   saveConfig()
   applyMenuBtnHideUI()
 }
+// issue #116：Codex 本机统计开关。关掉后宿主不扫描 ~/.codex/sessions；
+// 打开/关闭都要重取一次模型列表，让 Codex 那行的统计/提示立刻跟着变。
+function setCodexStatsOn(v) {
+  codexStatsOn = v !== false
+  if (codexStatsToggle) codexStatsToggle.checked = codexStatsOn
+  saveConfig()
+  try { refreshModelList() } catch (err) {}
+}
 function scaleToDisplay(s) {
   return Math.round((s - MIN_SCALE) / ((MAX_SCALE - MIN_SCALE) / 19)) + 1
 }
@@ -14387,7 +14454,7 @@ function onDocPointerUp(e) {
   try { if (isWhaleHit(e)) { e.preventDefault(); e.stopPropagation() } } catch (err) {}
   endDrag(e, true)
 }
-function onDocPointerCancel(e) { endDrag(e, false) }
+function onDocPointerCancel(e) { endDrag(e, false, true) }
 function onDocClickStopper(e) {
   // 只在鲸鱼命中区域拦截 click（保持透明区 pass-through）。
   // 持久注册（不随 endDrag 移除）——click 在 pointerup 之后派发，
@@ -14548,7 +14615,7 @@ document.addEventListener('pointermove', onDocPointerMoveCursor, true)
 // 配置读回来之后还会再应用一次，这里是配置请求失败时的兜底。
 try { applyMenuBtnHideUI() } catch (err) {}
 
-function endDrag(e, clickAllowed) {
+function endDrag(e, clickAllowed, cancelled) {
   if (!drag || !drag.active) return
   drag.active = false
   document.removeEventListener('pointermove', onDocPointerMove, true)
@@ -14556,6 +14623,20 @@ function endDrag(e, clickAllowed) {
   document.removeEventListener('pointercancel', onDocPointerCancel, true)
   pressUp()
   root.classList.remove('dshwv-dragging')
+  // issue #79 缺陷2：pointercancel（Android 把手势判成页面滚动、或系统抢走手势时派发）的
+  // clientX/clientY 常常是 0，而 endDrag 又是「按坐标收尾 + saveConfig() 落盘」——
+  // 于是位移被算成"一口气拖到了 (0,0)"，归边判定吃进左上角，损坏锚点被写进 localStorage。
+  // 0.3.2 的「非法距离自愈」只治负数 / 超出视口，救不回这个**合法的 (0,0)**，所以必须在这里拦住。
+  // 处理：取消的手势一律回到按下前的位置、并且**不落盘**（取消不该提交位置）。
+  var noCoord = (!e || typeof e.clientX !== 'number' || typeof e.clientY !== 'number' ||
+                 !isFinite(e.clientX) || !isFinite(e.clientY))
+  var zeroBoth = (e && e.clientX === 0 && e.clientY === 0 && drag.moved)
+  if (cancelled || noCoord || zeroBoth) {
+    try { state.left = drag.origLeft; state.top = drag.origTop } catch (err) {}
+    setWidgetCursor('')
+    settle()
+    return
+  }
   setWidgetCursor(isWhaleHit(e) ? 'grab' : '')
   if (clickAllowed && !drag.moved) {
     // 长按刚唤出菜单:这次抬手不再当作点击(避免顺带弹出余额泡)
@@ -14727,6 +14808,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.4', today: todayData, days7,
+        ok: true, version: '0.3.6', 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,70 @@ 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 }
+    function codexStatsOn() {
+      try {
+        const cfg = readSizeConfig()
+        return !cfg || cfg.codexStatsOn !== false
+      } catch (err) { return true }
+    }
+    function codexBackgroundRefresh(delayMs) {
+      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)
+        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 +1371,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 +1513,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 +2010,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 +2094,7 @@ export default {
       const led = readUsageLedger()
       const summary = daySummary(led, todayKey())
       return {
-        ...visible, version: '0.3.4', isPeak: isPeakTime(Math.floor(Date.now() / 1000)),
+        ...visible, version: '0.3.6', 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 +2145,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 +2155,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 +2164,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,8 +2178,10 @@ export default {
         scrollGapOn: sgo,
         scrollGapPx: sgp,
         menuBtnHide: mbh,
+        codexStatsOn: cso,
         updatedAt: new Date().toISOString(),
       })
+      let lastSizeErr = null
       for (const p of SIZE_FILE_CANDIDATES) {
         try {
           fs.writeFileSync(p, body, 'utf8')
@@ -2104,10 +2199,13 @@ export default {
             scrollGapOn: sgo,
             scrollGapPx: sgp,
             menuBtnHide: mbh,
+            codexStatsOn: cso,
           }
-        } catch (err) {}
+        } catch (err) { lastSizeErr = err }
       }
-      return { ok: false, error: '无法持久化挂件尺寸' }
+      // #88 / #97 报告者建议：把底层原因（EPERM / EACCES / 路径问题…）带出去。
+      // 原先无论哪个候选路径失败，返回的都是同一句固定文案，即使前端检查了响应也定位不到原因。
+      return { ok: false, error: '无法持久化挂件尺寸' + (lastSizeErr && lastSizeErr.message ? '：' + lastSizeErr.message : '') }
     }
 
     function readBody(req) {
@@ -2509,9 +2607,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.4",
+  "version": "0.3.6",
   "description": "DSH Web 界面右下角的 DeepSeek 余额小鲸鱼挂件:余额/今日已用/峰谷定价、自定义泡泡点击序列(文本/余额/今日/峰谷/图片/随机语句与并列加权选择)、逐行样式与字体、悬浮快捷编辑、音效与每轮消耗、自定义角色/动图/音效、吸附与翻转自定义",
   "keywords": [
     "dsh",