dsh-whale-widget 0.3.2 → 0.3.3

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
@@ -1006,7 +1113,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 +1132,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 +1140,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 +1148,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() {
@@ -3484,7 +3591,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 +12243,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 +12275,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 +12311,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
@@ -12438,12 +12558,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 +13597,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
     }
@@ -14644,8 +14764,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.3', 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),
@@ -1965,7 +1973,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.3', 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()),

package/package.json

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