dsh-whale-widget 0.3.2 → 0.3.4

package/README.md

@@ -4,6 +4,21 @@
 
 DeepSeek Harness（DSH）Web 界面右下角的常驻挂件：小鲸鱼气泡图 + DeepSeek API 余额 + 今日已用 + 每轮对话消耗，并且**泡泡内容可以完全自定义**（点击序列、模块化排版、并列加权出泡、随机语句/随机图片）。标准 DSH bundle 插件，`dsh plugin` 一键安装，无需任何会话令牌。
 
+## 两条分支怎么选
+
+本仓库有两条**互不兼容**的产品线，按你要挂在哪里选一条：
+
+| 你要挂在哪 | 用哪条分支 | 安装方式 |
+|---|---|---|
+| **DSH Web 界面右下角**（就是这个 README 描述的插件） | `main`（默认分支） | `dsh plugin --profile web add dsh-whale-widget`（推荐，装 npm 已发布版）；也可以从本仓库装 `dsh plugin --profile web add github:MeteorNOX/DeepSeek-Balance-Whale-Widget`，但那样装的是 **main 当前状态、不跟随已发布版本** |
+| **Codex 桌面应用**（跟随 Codex 窗口、无独立网页） | [`For-Codex`](https://github.com/MeteorNOX/DeepSeek-Balance-Whale-Widget/tree/For-Codex) | 该分支的 `api-balance-whale`：解压到 `%USERPROFILE%\plugins\api-balance-whale`，再按分支内的 [安装说明](https://github.com/MeteorNOX/DeepSeek-Balance-Whale-Widget/blob/For-Codex/docs/INSTALL-AND-ROLLBACK-0.2.0.md) 注册计划任务（也可以直接交给 Codex 自己装喵~） |
+
+⚠️ **两条分支互不兼容**：`For-Codex` 的插件不能用 `dsh plugin … add` 装进 DSH 网页；本主分支的插件也不能在 Codex 桌面里运行。上表第一行是本仓库默认分支（`main`）的能力，第二行是另一个分支的能力。
+
+⚠️ 同一分支的两种安装方式（npm 名 / `github:`）**二选一、别混用** —— 它们是同一个包名，先后安装会并存冲突；已经是 `github:` 装的，要换 npm 名请先 `dsh plugin --profile web remove dsh-whale-widget`。
+
+> 两条产品线**各自独立维护**（无共享代码/无跨分支依赖）：`main` = DSH Web 插件，`For-Codex` = Codex 桌面端口，各自的版本线、发布方式与测试互不影响。
+
 ## 特性
 
 ### 记账与显示

package/assets/whale-widget.js

@@ -11,38 +11,145 @@ window.__dshWhaleWidget = true
 function dshwIsChatRoot(r) {
   return !!(r && (r.querySelector('textarea') || r.querySelector('[contenteditable="true"]')))
 }
-var dshwEnabled = false
+var dshwStarted = false
+function dshwStartOnce() {
+  if (dshwStarted) return
+  dshwStarted = true
+  try { dshwInit() } catch (err) {}
+}
+// 是否已到主聊天界面；是则启动（只启动一次，之后由 dshwInit 内部标记去重）
+var dshwLastCheck = 0
+function dshwTryStart(force) {
+  if (dshwStarted) return true
+  var now = Date.now()
+  // 连续 DOM 变化时合并检查，避免每次 mutation 都 querySelector
+  if (!force && now - dshwLastCheck < 200) return false
+  dshwLastCheck = now
+  try {
+    if (dshwIsChatRoot(document.getElementById('root'))) { dshwStartOnce(); return true }
+  } catch (err) {}
+  return false
+}
 try {
-  var dshwRoot = document.getElementById('root')
-  // 初始已有 composer → 主界面
-  if (dshwIsChatRoot(dshwRoot)) {
-    dshwEnabled = true
-  } else {
-    // 尚未渲染：轮询等待（主界面异步挂载），超过 5s 视为非主界面（市场/设置等）放弃
-    var dshwPollTries = 0
-    var dshwPoll = setInterval(function () {
-      dshwPollTries++
-      if (dshwIsChatRoot(document.getElementById('root'))) {
-        clearInterval(dshwPoll)
-        dshwEnabled = true
-        try { dshwInit() } catch (err) {}
-        return
+  if (!dshwIsChatRoot(document.getElementById('root'))) {
+    // 尚未渲染：MutationObserver 无限等待（v739 去掉原来的「5 秒死线」）。
+    // 原来 500ms × 10 次就永久放弃，而 window.__dshWhaleWidget 是一次性闸门 ——
+    // 慢启动机器、或页面最小化时定时器被浏览器节流，都会让"第一次没赶上"变成
+    // "这次会话永远不出现"（用户反馈 / issue #102 第 2 条）。
+    // 约束不变：检测到 composer 之前一行 DOM 都不碰、不注册任何全局监听。
+    var dshwObserver = null
+    try {
+      if (typeof MutationObserver === 'function') {
+        dshwObserver = new MutationObserver(function () {
+          if (dshwTryStart()) { try { dshwObserver.disconnect() } catch (err) {} }
+        })
+        dshwObserver.observe(document.documentElement || document.body, { childList: true, subtree: true })
       }
-      if (dshwPollTries >= 10) {
-        clearInterval(dshwPoll)
-        // 非主界面：直接退出，不初始化
+    } catch (err) {}
+    // 兜底：observer 不可用时低频轮询继续等（不设上限，找到即停）
+    var dshwFallbackPoll = setInterval(function () {
+      if (dshwTryStart(true)) {
+        clearInterval(dshwFallbackPoll)
+        try { if (dshwObserver) dshwObserver.disconnect() } catch (err) {}
       }
-    }, 500)
+    }, 2000)
   }
 } catch (err) {}
-if (!dshwEnabled) {
-  // 非主界面（或等待超时）：不初始化挂件
-  return
-}
 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），这样既有的播放、音量、重播、结束回调逻辑一行都不用改。
+var dshwvAudioCtx = null
+function dshwvAudio() {
+  try {
+    if (!dshwvAudioCtx) dshwvAudioCtx = new (window.AudioContext || window.webkitAudioContext)()
+    if (dshwvAudioCtx.state === 'suspended') { try { dshwvAudioCtx.resume() } catch (err) {} }
+    return dshwvAudioCtx
+  } catch (err) { return null }
+}
+var dshwvAudioBuffers = {} // url -> Promise<AudioBuffer>（解码结果缓存，同一片段不重复下载/解码）
+function dshwvAudioBuffer(url) {
+  if (!url) return Promise.reject(new Error('empty url'))
+  if (!dshwvAudioBuffers[url]) {
+    dshwvAudioBuffers[url] = fetch(url, { cache: 'force-cache' })
+      .then(function (r) { if (!r.ok) throw new Error('HTTP ' + r.status); return r.arrayBuffer() })
+      .then(function (raw) {
+        var c = dshwvAudio()
+        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 })
+  }
+  return dshwvAudioBuffers[url]
+}
+function dshwvSoundStop(el) {
+  el._token = (el._token || 0) + 1
+  var node = el._node
+  el._node = null
+  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 }
+  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 },
+    // 既有逻辑用「currentTime = 0」表示重播 → 这里顺手停掉正在播的那一份
+    set: function (v) { el._offset = Number(v) || 0; dshwvSoundStop(el) },
+  })
+  el.play = function () {
+    var c = dshwvAudio()
+    if (!c || !el._url) return Promise.resolve()
+    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 token = (el._token = (el._token || 0) + 1)
+    var url = el._url
+    dshwvAudioBuffer(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) {}
+    }).catch(function () {})
+    return Promise.resolve()
+  }
+  el.pause = function () { dshwvSoundStop(el) }
+  return el
+}
+// 自动播放策略：AudioContext 初始是 suspended，要有一次用户手势才能出声。
+// 任务结束音不是手势触发的，所以先挂一次性解锁（首次点击/按键后移除）。
+try {
+  var dshwvAudioUnlock = function () {
+    dshwvAudio()
+    try { document.removeEventListener('pointerdown', dshwvAudioUnlock, true) } catch (err) {}
+    try { document.removeEventListener('keydown', dshwvAudioUnlock, true) } catch (err) {}
+  }
+  document.addEventListener('pointerdown', dshwvAudioUnlock, true)
+  document.addEventListener('keydown', dshwvAudioUnlock, true)
+} catch (err) {}
+
 var MIN_SCALE = 0.6
 var MAX_SCALE = 2.5
 var STEP = 0.1
@@ -564,6 +671,11 @@ var css = [
 ].join('\n')
 
 var styleEl = document.createElement('style')
+// PR #114：不带 data-plugin 的 <style> 会被 DSH 客户端模块系统 claimStyles 认领到
+// 「当前正在物化的那个插件」名下，之后该插件热重载/失效时 removeOwnedStyles 会把它
+// 一起删掉。样式一没，挂件 20 多个 dshwv-* 节点就从 position:fixed 掉回文档流堆在
+// 页面底部（页面被撑到几千像素高）。打上自己的名字后就不会被任何人认领/删除。
+styleEl.setAttribute('data-plugin', 'dsh-whale-widget')
 styleEl.textContent = css
 document.head.appendChild(styleEl)
 
@@ -1006,7 +1118,7 @@ function playTaskEndSound() {
       url = '/dsh-whale/sound/' + (parts[2] === 'release' ? 'release' : 'press') + '.mp3?set=' + parts[1]
     }
     if (!url) return
-    var a = new Audio(url)
+    var a = dshwvSound(url)
     try { a.volume = Number(soundVol) || 0.9 } catch (err) {}
     a.play().catch(function () {})
   } catch (err) {}
@@ -1025,7 +1137,7 @@ function playTaskEndGroupClick(groupId) {
     // 按压留空:无按下音,直接播松开(模拟按下即松开的完整点按);松开留空:只播按压
     if (pressEmpty) {
       if (!releaseEmpty) {
-        var relOnly = new Audio('/dsh-whale/sound/release.mp3?set=' + encodeURIComponent(groupId))
+        var relOnly = dshwvSound('/dsh-whale/sound/release.mp3?set=' + encodeURIComponent(groupId))
         try { relOnly.volume = vol } catch (err) {}
         relOnly.currentTime = 0
         var pr = relOnly.play()
@@ -1033,7 +1145,7 @@ function playTaskEndGroupClick(groupId) {
       }
       return
     }
-    var press = new Audio('/dsh-whale/sound/press.mp3?set=' + encodeURIComponent(groupId))
+    var press = dshwvSound('/dsh-whale/sound/press.mp3?set=' + encodeURIComponent(groupId))
     try { press.volume = vol } catch (err) {}
     if (releaseEmpty) {
       press.currentTime = 0
@@ -1041,7 +1153,7 @@ function playTaskEndGroupClick(groupId) {
       if (pp && pp.catch) pp.catch(function () {})
       return
     }
-    var release = new Audio('/dsh-whale/sound/release.mp3?set=' + encodeURIComponent(groupId))
+    var release = dshwvSound('/dsh-whale/sound/release.mp3?set=' + encodeURIComponent(groupId))
     try { release.volume = vol } catch (err) {}
     var relPlayed = false
     function playRel() {
@@ -1809,6 +1921,9 @@ function usageAlertBudgetEditor(key, onSave) {
     // 提醒编辑期间:窗口内可能弹出的各类全屏遮罩(确认/裁剪/音频/快照/用量)统一置顶,杜绝层级错位
     var remindZStyle = document.createElement('style')
     remindZStyle.id = 'dshw-remind-overlay-z'
+    // 同上（PR #114）：本文本表同样必须自带 data-plugin，否则会被别的客户端插件
+    // 热重载时顺带删掉，提醒编辑期的遮罩层级就失效了。
+    remindZStyle.setAttribute('data-plugin', 'dsh-whale-widget')
     // 提醒编辑期间:窗口内可能弹出的全屏遮罩(确认/裁剪/音频/快照)统一置顶,杜绝层级错位。
     // 注意:不要把 .dshwv-usage-mask 放进来——「模型子菜单/模型设置」用的是这个类(29000),
     // 一提权就会反盖到提醒编辑器(30000)上面。
@@ -3484,7 +3599,7 @@ function resPlayFragment(fid) {
   try {
     if (!fid) return
     if (resAudEl) { try { resAudEl.pause() } catch (err) {} resAudEl = null }
-    var a = new Audio('/dsh-whale/audio-fragment.wav?id=' + encodeURIComponent(fid))
+    var a = dshwvSound('/dsh-whale/audio-fragment.wav?id=' + encodeURIComponent(fid))
     try { a.volume = Number(soundVol) || 0.9 } catch (err) {}
     a.onended = function () { resAudEl = null }
     resAudEl = a
@@ -12136,6 +12251,16 @@ function artCenterAt(left, top, w, h, flipped) {
   var cy = top + h - iw / 2
   return { cx: cx, cy: cy }
 }
+// v739（用户反馈「每次新实例的第一次余额请求都失败」）：冷启动时凭据服务可能还没就绪，
+// 首次 DNS+TLS 也最慢；而客户端 25s 超时会先于宿主的两段重试结束 —— 结果是第一次必失败、
+// 只能干等 60 秒后的下一轮。这里失败后快速重试两次（1.5s / 3s），成功即重置计数。
+var balanceRetryLeft = 2
+function balanceRetryLater() {
+  if (balanceRetryLeft <= 0) return
+  var delay = balanceRetryLeft === 2 ? 1500 : 3000
+  balanceRetryLeft--
+  setTimeout(function () { try { refresh(false) } catch (err) {} }, delay)
+}
 function refresh(manual) {
   if (busy) return
   busy = true
@@ -12158,6 +12283,7 @@ function refresh(manual) {
         state.balance = nb
         state.currency = nc
         state.message = ''
+        balanceRetryLeft = 2
         state.todayUsage = data.todayUsage !== undefined ? data.todayUsage : null
         state.todayUsageCurrency = data.todayUsageCurrency || data.currency || 'CNY'
         state.usageLabel = data.usageLabel || '本地估算'
@@ -12193,12 +12319,14 @@ function refresh(manual) {
         state.status = 'error'
         state.message = (data && data.error) ? String(data.error) : '获取失败'
         render()
+        balanceRetryLater()
       }
     })
     .catch(function () {
       state.status = 'error'
       state.message = '获取失败'
       render()
+      balanceRetryLater()
     })
     .finally(function () {
       busy = false
@@ -12350,10 +12478,28 @@ function setScrollGapPx(v) {
   saveConfig()
   settle()
 }
+// issue #91 缺陷2：触屏设备上没有任何进菜单的路径 —— ☰ 按钮默认 opacity:0，只由
+// pointermove 命中鲸鱼时才加 dshwv-menu-btn-visible，而触摸端没有 hover；长按唤出又只在
+// 「隐藏菜单按钮」开启时挂计时（默认关闭）。这里判定「主输入是否为无 hover 的触摸」：
+// 只用 (hover: none)，或 (pointer: coarse) + 有触点。触屏笔记本（主输入是鼠标）不受影响。
+function dshwvTouchUI() {
+  try {
+    if (typeof window !== 'undefined' && window.matchMedia) {
+      if (window.matchMedia('(hover: none)').matches) return true
+      if (window.matchMedia('(pointer: coarse)').matches && (navigator.maxTouchPoints || 0) > 0) return true
+    }
+    if (typeof window !== 'undefined' && typeof navigator !== 'undefined') {
+      return (navigator.maxTouchPoints || 0) > 0 && ('ontouchstart' in window)
+    }
+  } catch (err) {}
+  return false
+}
 function applyMenuBtnHideUI() {
   try {
     menuBtn.classList.toggle('dshwv-menu-btn-hidden', menuBtnHide)
     if (menuBtnHide) menuBtn.classList.remove('dshwv-menu-btn-visible')
+    // 触屏：没有 hover 可以显形 → 常显（仍受上面的 hidden 开关控制）
+    else if (dshwvTouchUI()) menuBtn.classList.add('dshwv-menu-btn-visible')
   } catch (err) {}
 }
 function setMenuBtnHide(v) {
@@ -12438,12 +12584,12 @@ function applySoundSet() {
     var pEmpty = audioGroupSlotEmpty(soundSet, 'press')
     var rEmpty = audioGroupSlotEmpty(soundSet, 'release')
     if (pEmpty) { pressAudio = null } else {
-      pressAudio = new Audio('/dsh-whale/sound/press.mp3?set=' + soundSet)
+      pressAudio = dshwvSound('/dsh-whale/sound/press.mp3?set=' + soundSet)
       pressAudio.preload = 'auto'
       pressAudio.volume = soundVol
     }
     if (rEmpty) { releaseAudio = null } else {
-      releaseAudio = new Audio('/dsh-whale/sound/release.mp3?set=' + soundSet)
+      releaseAudio = dshwvSound('/dsh-whale/sound/release.mp3?set=' + soundSet)
       releaseAudio.preload = 'auto'
       releaseAudio.volume = soundVol
     }
@@ -13477,12 +13623,12 @@ function audioEditPreviewEnsure(force) {
       if (audioEditPreviewRelease) { audioEditPreviewRelease.pause(); audioEditPreviewRelease = null }
     } catch (err) {}
     if (pressId) {
-      audioEditPreviewEl = new Audio('/dsh-whale/audio-fragment.wav?id=' + encodeURIComponent(pressId))
+      audioEditPreviewEl = dshwvSound('/dsh-whale/audio-fragment.wav?id=' + encodeURIComponent(pressId))
       audioEditPreviewEl.preload = 'auto'
       audioEditPreviewEl.volume = soundVol
     }
     if (releaseId) {
-      audioEditPreviewRelease = new Audio('/dsh-whale/audio-fragment.wav?id=' + encodeURIComponent(releaseId))
+      audioEditPreviewRelease = dshwvSound('/dsh-whale/audio-fragment.wav?id=' + encodeURIComponent(releaseId))
       audioEditPreviewRelease.preload = 'auto'
       audioEditPreviewRelease.volume = soundVol
     }
@@ -14334,8 +14480,10 @@ function onDocTouchStart(e) {
     touchDrag = { id: t.identifier }
     touchStartPt = { x: t.clientX, y: t.clientY }
     touchNowPt = { x: t.clientX, y: t.clientY }
-    // 长按唤出菜单:仅「隐藏菜单按钮」开启且菜单未打开时挂计时(位移超标即取消)
-    if (menuBtnHide && !menuOpen && (Date.now() - menuClosedAt > 600)) {
+    // 长按唤出菜单：原本只在「隐藏菜单按钮」开启且菜单未打开时挂计时(位移超标即取消)。
+    // 触屏上默认配置(按钮永远不显形)就完全没有进菜单的路径 → 无 hover 的设备一律允许长按
+    // 唤出（issue #91 缺陷2）；桌面端行为不变。
+    if ((menuBtnHide || dshwvTouchUI()) && !menuOpen && (Date.now() - menuClosedAt > 600)) {
       cancelTouchLongPress()
       touchLongPressTimer = setTimeout(fireTouchLongPressMenu, TOUCH_LONG_PRESS_MS)
     }
@@ -14391,9 +14539,14 @@ function onDocPointerMoveCursor(e) {
   }
   var over = isWhaleHit(e)
   setWidgetCursor(over ? 'grab' : '')
-  if (!menuBtnHide) menuBtn.classList.toggle('dshwv-menu-btn-visible', over || menuOpen)
+  // 触屏上必须把 dshwvTouchUI() 也当作"该显示"：拖动鲸鱼时 pointermove 的 over 为 false，
+  // 否则这一次 toggle 会把常显状态撤掉（issue #91 缺陷2 修完又被自己抹掉）。
+  if (!menuBtnHide) menuBtn.classList.toggle('dshwv-menu-btn-visible', over || menuOpen || dshwvTouchUI())
 }
 document.addEventListener('pointermove', onDocPointerMoveCursor, true)
+// 启动即应用一次菜单按钮可见性：触屏上 ☰ 常显（issue #91 缺陷2）。
+// 配置读回来之后还会再应用一次，这里是配置请求失败时的兜底。
+try { applyMenuBtnHideUI() } catch (err) {}
 
 function endDrag(e, clickAllowed) {
   if (!drag || !drag.active) return
@@ -14573,8 +14726,10 @@ fetch(SIZE_URL, { cache: 'no-store' })
     if (d && typeof d.menuBtnHide === 'boolean') {
       menuBtnHide = d.menuBtnHide
       if (menuHideToggle) menuHideToggle.checked = menuBtnHide
-      applyMenuBtnHideUI()
     }
+    // 无论服务端带没带这个键都要应用一次：触屏上 ☰ 需要常显（issue #91 缺陷2），
+    // 而旧写法只在键存在时才调用，空配置下按钮永远是透明的。
+    applyMenuBtnHideUI()
     // 相对边框恢复（localStorage 锚点）：窗口变化后保持离边距离。
     // 仅认 v:2 净距离格式；旧格式（含避让距离）废弃，挂件保持默认右下角吸附。
     // issue #102：这里原与 applyAnchorPos() 各写了一份恢复逻辑（两份都只做下限夹紧），
@@ -14644,8 +14799,6 @@ function pollLastTurn() {
 }
 setInterval(pollLastTurn, 1000)
 }
-// 主界面检测通过后执行挂件初始化（非主界面时 dshwInit 不会执行）
-if (dshwEnabled) {
-  try { dshwInit() } catch (err) {}
-}
+// 主界面检测通过（或稍后由 MutationObserver 检测到）后执行挂件初始化；非主界面不启动
+try { dshwTryStart(true) } catch (err) {}
 })()

package/lib/index.js

@@ -716,11 +716,19 @@ export default {
     }
 
     async function fetchBalance() {
-      let cred
-      try {
-        cred = await ctx.credentials.resolve('DEEPSEEK_API_KEY')
-      } catch (err) {
-        return { ok: false, code: 'NO_KEY', error: '凭据读取失败: ' + String((err && err.message) || err).slice(0, 160) }
+      // v739（用户反馈「每次新实例的第一次余额请求都失败」）：
+      // ① 冷启动时凭据服务可能尚未就绪（resolve 抛错），这与「确实没配置」不同 → 短延迟重试一次；
+      // ② 单次超时从 20s 收到 8s，保证「2 次尝试 + 退避」明显短于前端 FETCH_TIMEOUT_MS(25s) ——
+      //    否则前端先 abort，用户看到的永远是「第一次失败」，只能干等 60 秒后的下一轮。
+      let cred = null
+      for (let attempt = 0; attempt < 2; attempt++) {
+        try {
+          cred = await ctx.credentials.resolve('DEEPSEEK_API_KEY')
+          break
+        } catch (err) {
+          if (attempt === 0) { await new Promise((r) => setTimeout(r, 700)); continue }
+          return { ok: false, code: 'NO_KEY', error: '凭据读取失败: ' + String((err && err.message) || err).slice(0, 160) }
+        }
       }
       if (!cred) {
         return { ok: false, code: 'NO_KEY', error: '未配置 DEEPSEEK_API_KEY' }
@@ -731,7 +739,7 @@ export default {
         try {
           res = await fetch(BALANCE_URL, {
             headers: { Authorization: 'Bearer ' + cred.value },
-            signal: AbortSignal.timeout(20000),
+            signal: AbortSignal.timeout(8000),
           })
         } catch (err) {
           lastErr = err
@@ -921,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.2', today: todayData, days7,
+        ok: true, version: '0.3.4', 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),
@@ -1265,9 +1273,19 @@ export default {
     // 后台预热：codexSummary 首次要同步读全部 rollout 日志（可能几十 MB），
     // 放在请求路径里会阻塞事件循环。这里在插件启动后预热一次，并每 5 分钟刷新一次缓存，
     // 请求进来时通常直接命中 codexSummaryCached 的 5 秒记忆。
+    let codexPrewarmT = null, codexPrewarmI = null
     try {
-      setTimeout(function () { try { codexSummaryCached() } catch (err) {} }, 1500)
-      setInterval(function () { try { codexSummaryCached() } catch (err) {} }, 5 * 60 * 1000)
+      codexPrewarmT = setTimeout(function () { try { codexSummaryCached() } catch (err) {} }, 1500)
+      codexPrewarmI = setInterval(function () { try { codexSummaryCached() } catch (err) {} }, 5 * 60 * 1000)
+      // issue #109：这两个定时器原先不存句柄、也不进 disposers，插件树 dispose 之后
+      // 事件循环里仍有一个被引用的 interval → 用户退出 dsh 时进程不结束（只能 Ctrl+C）。
+      // 存句柄并纳入 disposers，卸载时一并清掉；unref 作为兜底（正常运行时由 HTTP 服务维持事件循环）。
+      try { if (codexPrewarmT && codexPrewarmT.unref) codexPrewarmT.unref() } catch (err) {}
+      try { if (codexPrewarmI && codexPrewarmI.unref) codexPrewarmI.unref() } catch (err) {}
+      disposers.push(function () {
+        if (codexPrewarmT !== null) { clearTimeout(codexPrewarmT); codexPrewarmT = null }
+        if (codexPrewarmI !== null) { clearInterval(codexPrewarmI); codexPrewarmI = null }
+      })
     } catch (err) {}
     // ===== 自定义 API 模型注册表（v655）=====
     // 文件：$DSH_HOME/.dshw-api.json → { version, models:[…], usage:{ [id]:{day,dayStart,lastBalance,delta,eventCost} } }
@@ -1353,12 +1371,34 @@ export default {
       }
       return out
     }
+    // PR #104（收窄版）：只放行 http/https，并挡掉云厂商元数据与 link-local 地址。
+    // 关键取舍：**不拦回环与内网** —— 我们内置的 ollama 模板就推荐用户填
+    // http://127.0.0.1:11434/v1（本地 Ollama / LM Studio），自建网关（New API 之类，
+    // 见 issue #53）也跑在本机；拦掉它们会把正当用法一起打死。接口地址由用户自己在面板/
+    // 注册表里填写，且所有 /dsh-whale/* 路由都在受信任栅栏之后 —— 真正要挡的是
+    // 「被诱导去读云元数据把凭据带出来」，而不是「访问本机服务」。
+    // decimal / octal / hex 形式的 IPv4 已由 WHATWG URL 规范化成点分十进制，这里只按规范化结果判定。
+    function assertSafeApiUrl(u) {
+      let parsed
+      try { parsed = new URL(u) } catch { throw new Error('无效的接口地址') }
+      if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') throw new Error('不支持的协议: ' + parsed.protocol)
+      const host = parsed.hostname.toLowerCase().replace(/^\[|\]$/g, '')
+      if (host === 'metadata.google.internal' || host === 'metadata.goog' || host === '100.100.100.200') throw new Error('禁止访问云元数据地址')
+      const m = host.match(/^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/)
+      if (m) {
+        const [a, b] = [Number(m[1]), Number(m[2])]
+        if (a === 169 && b === 254) throw new Error('禁止访问 link-local 地址')
+        if (a === 0) throw new Error('禁止访问该地址')
+      }
+      if (/^fe[89ab][0-9a-f]:/i.test(host)) throw new Error('禁止访问 link-local 地址')
+    }
     async function apiFetchJson(url, auth, key) {
       const headers = {}
       const a = String(auth == null ? 'Bearer {key}' : auth)
       if (a) headers.Authorization = a.replace('{key}', key)
       // v724：URL 里也支持 {key}（如 Gemini 的 ?key=… 形式；auth 传空串时不带 Authorization 头）
       const u = String(url).replace('{key}', key)
+      assertSafeApiUrl(u)
       const res = await fetch(u, { headers, signal: AbortSignal.timeout(15000) })
       if (!res.ok) throw new Error('HTTP ' + res.status)
       return await res.json()
@@ -1965,7 +2005,7 @@ export default {
       const led = readUsageLedger()
       const summary = daySummary(led, todayKey())
       return {
-        ...visible, version: '0.3.2', isPeak: isPeakTime(Math.floor(Date.now() / 1000)),
+        ...visible, version: '0.3.4', 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()),
@@ -2596,7 +2636,7 @@ export default {
               const r = apiDeleteModel(parsed.id)
               const list = await apiModelsPayload()
               res.writeHead(r.ok ? 200 : 400, JSON_HEADERS)
-              res.end(JSON.stringify(Object.assign({}, r, { models: list.models })))
+              res.end(JSON.stringify({ ...r, models: list.models }))
               return
             }
             if (action === 'probe') {
@@ -2632,10 +2672,10 @@ export default {
             }
             // 注意：keyValue 在提交体上（不在 model 里），必须合并进去，
             // 否则前端面板里填的 API key 会被丢弃（密钥永远存不进去）
-            const r = await apiSaveModel(Object.assign({}, parsed.model || parsed, { keyValue: parsed.keyValue }))
+            const r = await apiSaveModel({ ...(parsed.model || parsed), keyValue: parsed.keyValue })
             const list2 = await apiModelsPayload()
             res.writeHead(r.ok ? 200 : 400, JSON_HEADERS)
-            res.end(JSON.stringify(Object.assign({}, r, { models: list2.models })))
+            res.end(JSON.stringify({ ...r, models: list2.models }))
             return
           }
           const payload = await apiModelsPayload()

package/package.json

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