dsh-whale-widget 0.3.16 → 0.3.17

package/README.md

@@ -68,7 +68,7 @@ DeepSeek Harness（DSH）Web 界面右下角的常驻挂件：小鲸鱼气泡图
 - 🔊 **按压 & 松开音效**：内置「小黄鸭」「音效1」两套预置；也可导入音频片段并自由组合成**自定义音效组**（槽位可留空 = 该事件静音）
 - 🎵 **任务结束音**：一轮回复完成时播放；内置两个预设音效 —— 默认 **Minecraft·经验球**（`assets/minecraft-exp-orb.wav`）与 **A**（`assets/task-end-a.wav`），也可选任意片段或音效组
 - ⏳ **提问音 / 授权音**：DSH 需要你回答或批准时播放；与任务结束音共用同一套音效库，**各自可调音量**，音效行左侧的 `[✓]` 决定「响不响」（不响 = 仍会冒泡提示）
-- 🔉 **每个音效独立音量**：按压音效、任务结束音、提问音、授权音各自一条音量滑块（默认 100%），每行都带「试听」
+- 🔉 **音量：一条全局 + 三条按事件**：①区「按压音效」的音量是**全局基准**（按压 / 松开音用它）；②③④ 区（每轮消耗提示 / 提问提示 / 授权提示）各有一条自己的音量滑块，每行都带「试听」。**没动过某个事件的滑块时，它跟随①区音量**（入口行摘要会写明 `跟随按压音量 N%`）；**一旦你拖过那个滑块，就按你设的值播**（摘要只显示百分比）。这样既能"一个总音量管全局"，也能单独压低某类提示音。
 - ✂️ **音频片段管理**：导入时可视化裁剪、试听；资源管理窗口（菜单 → 资源管理 → 「管理」）按 **图片 / 音频 两个可折叠入口**统一查看/试听/删除 —— 入口行右侧直接显示数量（如 `角色 1 · 泡泡图 2`、`音效组 3 · 片段 4`），点一行才展开明细；「导入片段」在音频那一区里；收起/展开时会顺带停掉正在试听的那一段
 - 🐳 **自定义角色**：上传自己的鲸鱼图片（图库管理，可回退默认）
 - 🖼️ **泡泡图库**：内置 `petpet`、`money1` 两张图，也可上传 png/gif，供图片/随机图片模块使用
@@ -394,6 +394,7 @@ curl http://127.0.0.1:3080/dsh-whale/audio.json
 - `/dsh-whale/audio.json` → 200，含 `groups` / `fragments`（其中内置片段 `exp_orb` = Minecraft·经验球、`end_a` = A）
 - `/dsh-whale/audio-fragment.wav?id=exp_orb` → 200 `audio/wav`（内置任务结束音；无需用户导入）
 - `/dsh-whale/audio-fragment.wav?id=end_a` → 200 `audio/wav`（内置任务结束音 A）
+- `/dsh-whale/wait.json` → 200 JSON，含 `{ok:true, pending}`；`pending` 为当前挂起的「提问 / 授权」（`{kind:'question'|'approval', id, ts}`）或 `null` —— 这是「提问提示 / 授权提示」音效与常驻气泡的数据源（默认每秒轮询一次）
 - 浏览器 F5 后右下角出现挂件
 
 > ⚠️ **关于上面这些 `curl`**：全部 **23 个** `/dsh-whale/*` 路由都已接入 **DSH 浏览器信任栅栏**（`connection.requestRejection`）。
@@ -423,6 +424,9 @@ curl http://127.0.0.1:3080/dsh-whale/audio.json
 - **每轮消耗不显示**：确认「音效与提示 → 全局设置」里「每轮消耗提示」那一行**左边的 `[✓]`** 是勾上的（入口行右侧摘要会直接显示 `已关闭` 或当前配置）；一轮对话要完整结束（`turn/end`）才结算。余额变化泡泡与消耗泡泡抢层时，提醒会退化为居中卡片。
 - **每轮消耗泡泡的内容**：「音效与提示 → 全局设置」→ **展开「每轮消耗提示」** → 「编辑提示内容」（模块化，金额用 `{cost}`）；同一区里能设自动关闭秒数、提示音量与任务结束音效。
 - **任务结束音没响**：该开关**默认开着**（默认音是内置 **`A`**，另有内置的 Minecraft·经验球可选）；到「音效与提示 → 全局设置」→ **展开「每轮消耗提示」**，确认「任务结束音」那行左侧的 `[✓]` 是勾上的（取消勾选 = 静音）。若自定义片段文件被删，会回退/静音。
+- **提示音量调了没用 / 到底听谁的**：把「每轮消耗提示」那一行展开，拖动它自己的「**提示音量**」滑块 ⇒ 该事件的音量**立刻由它说了算**（入口行摘要从 `跟随按压音量 N%` 变成 `N%`）。**没拖过**时它跟随①区「按压音效」的音量 —— 摘要里会写明，滑块也显示实际生效值。想让某类提示更轻就把自己的滑块调小；想整体轻就调①区。点「恢复默认」会把这几条都退回"跟随①区"。（0.3.17 之前这个滑块确实不生效，是本版修好的。）
+- **保存后设置没生效 / 保存到底成没成**：0.3.17 起保存失败**不再静默** —— 点「保存」若写入失败，会自动重试一次，仍失败则弹出 `⚠ 设置保存失败：<原因>`（例如数据目录只读、接口被拦）。看到这条提示说明**这次改动没有落盘**，请按原因处理后再保存一次。
+- **等待提问 / 授权的气泡关不掉**：**点一下那个气泡即可收起**（同一条挂起不会再自动弹回；你回答/批准后，或下一次新的提问/授权到来时照常提示）。想让**点角色（鲸鱼）也能收起**提示气泡，去「音效与提示 → 全局设置」面板最下面勾上「**点按角色关闭提示气泡**」（默认关）。两处说明都收在旁边的 `?` 圈圈里。
 - **换了 / 删了 API key 之后，更早的记账天变成「本地估算 ¥0.00」**：记账按**密钥指纹分本**（一把 key 一本账），换 key 等于换了一本 —— 数据**没丢**，都在 `.dshw-usage.json` 的 `accounting.books` 里。当前版本已让界面把历史本里的日期正常显示（标注「已观测消费 · 历史账户」），并在「小鲸鱼记账」面板顶部提示「检测到 N 个记账本」；**两个本不会被相加**（插件无法判断两次是不是同一个账户），但同一天的明细可以在该面板的「每日与逐条明细」里逐日查看。
 - **手机上拖不动鲸鱼**：本版本已用触摸事件接管拖拽，请硬刷新页面拿到最新 `whale-widget.js`；仍不行请反馈浏览器型号。
 - **隐藏了菜单按钮怎么进菜单**：电脑端右键鲸鱼，手机端长按鲸鱼约 1.5 秒。
@@ -448,6 +452,11 @@ curl http://127.0.0.1:3080/dsh-whale/audio.json
 
 ## 致谢
 
+- **0.3.17 的「②区『提示音量』滑块其实不生效 + ②区『冒泡提示』没人读」**由一位 **QQ 群友**（未留 GitHub 账号）做了一轮完整的代码分析后报告：他复现了"拖到最低仍出声"、定位到 `playTaskEndSound()` 读的是①区全局音量、并附了可复用的补丁与两个预打版压缩包供对比。**这两个都是真 bug**（第二个是我顺着他的思路查出来的），0.3.17 已按"解析器 + 三态音量"的方式修复（比补丁覆盖面更广：**音效组那条路也修了**），并新增了一条 CI 检查专门拦这类"控件有值、没有消费方"的问题。感谢他的报告。
+- **0.3.16 的「换 / 删 API key 后旧记账被分本隐藏」**（切换当天金额被覆盖、更早的天数退化成「本地估算」）由 GitHub 用户 [@0Sakura721](https://github.com/0Sakura721) 在 [#163](https://github.com/MeteorNOX/DeepSeek-Balance-Whale-Widget/issues/163) 中报告，并**直接给出了根因位置**（`lib/index.js` 里用密钥哈希当账户标识、`accounting.mjs` 的 `observeBalance` / `currentBook` 只读 active 本）与数据佐证 —— 让这次能一次做实"数据没丢、只是没有入口"这个判断。0.3.16 据此修复（旧本日期照常显示并标注「已观测消费 · 历史账户」）。感谢他。
+- **0.3.16 的「下载管理器抢走挂件音效请求」**（IDM 等每次打开 DSH 弹下载框、关音效也照样弹）由 GitHub 用户 [@VaeKaras](https://github.com/VaeKaras) 在 [#158](https://github.com/MeteorNOX/DeepSeek-Balance-Whale-Widget/issues/158) 中报告，复现步骤、被抢的 URL 形态与"关音效无效"的观察都很完整 —— README 据此新增该已知问题与站点排除做法。感谢他。
+- **官方桌面端「新装也可能需要重开客户端」**由 GitHub 用户 [@MengLs1620](https://github.com/MengLs1620) 在 [#162](https://github.com/MeteorNOX/DeepSeek-Balance-Whale-Widget/issues/162) 中实测反馈，README 的生效方式据此补正。感谢他。
+- **「让鲸鱼娘响应任务状态并给出音效提示」**由 GitHub 用户 [@Jy-EggRoll](https://github.com/Jy-EggRoll) 在 [#160](https://github.com/MeteorNOX/DeepSeek-Balance-Whale-Widget/issues/160) 中提出，并**提交了实现 PR [#161](https://github.com/MeteorNOX/DeepSeek-Balance-Whale-Widget/pull/161)**（其中 `GET /dsh-whale/wait.json` 的数据形状 `{ok, pending:{kind,id,ts}}` 与主线最终方案一致；本 README 的 `wait.json` 路由说明即采纳其写法）。0.3.16 的提问/授权提示音效与常驻气泡按主线方案落地（四入口面板 / 每事件音量与试听 / 抢占置顶）。感谢他，也欢迎他继续参与这个项目的工程化改进。
 - **0.3.15 的凭据安全修复**（写入自定义模型即可让宿主动用真实 API key 去请求任意地址，从而外带凭据）由 **B 站用户「星丶白羽莲」** 负责任地报告：把复现步骤、环境与前置条件一起给出，使这次能在**不打死自建网关这类正当用法**的前提下收紧边界。感谢他的支持。
 - **DSH 账号登录态读余额**（端点与鉴权头、凭据记录的位置、DSH 自身 `deepseekAccount` 服务的推荐调用方式，以及三个集成坑：账户标识字符集、赠金要计入基准、服务可能不存在）由 GitHub 用户 [@yybai25](https://github.com/yybai25) 在 [#157](https://github.com/MeteorNOX/DeepSeek-Balance-Whale-Widget/issues/157) 中给出完整规格与**已在自己机器上验证过的参考实现**；**0.3.14 据此实现**（只调 DSH 服务、不接触账号令牌）。感谢他的贡献。
 - 充值记账修复方案（余额上升与下降分开记账、显式余额校正公式、按账户/币种隔离观测窗口、账本原子写入与迁移备份）由 GitHub 用户 [@Yang-huai406](https://github.com/Yang-huai406) 独立设计并实现为可运行的修复分支；**0.3.1 在该方案基础上移植合并**，并保留本项目既有的音效修复。感谢他的支持。

package/assets/whale-widget.js

@@ -1389,21 +1389,37 @@ function soundVolClamped(fallback) {
   if (!isFinite(v)) v = (typeof fallback === "number") ? fallback : 0.9
   return Math.max(0, Math.min(1, v))
 }
+// v778：**音量解析器 = 音量的唯一真源**。所有播放入口都必须经过它取音量（禁止各自去读全局），
+//   优先级：① 显式 override（绑定事件 / 试听传进来的值）→ ② 该事件**用户显式调过**的音量
+//   （`cfg.volSet === true`）→ ③ ①区「按压音量」。
+//   为什么需要 volSet 这一层：出厂默认 `events.turnCost.vol = 1`，而面板每次保存都会把这个键写进磁盘
+//   ⇒ 只看"有没有值"无法区分「默认 100%」和「用户设了 100%」；若让每事件无条件优先，会把
+//   「只调过①区、没碰过②区」的老用户的任务结束音静默抬到 100%（见 SPEC §24）。
+//   ⚠️ 约定：本文件里 `soundVolClamped(` 只允许出现在本函数与它自己的定义处 —— 由 `_v778` 静态钉住。
+function soundVolumeOf(kind, override) {
+  try {
+    if (typeof override === 'number' && isFinite(override) && override >= 0) {
+      return Math.max(0, Math.min(1, override))
+    }
+    if (kind) {
+      var cfg = soundEventCfg(kind) || {}
+      if (cfg.volSet === true) {
+        var v = Number(cfg.vol)
+        if (isFinite(v) && v >= 0) return Math.max(0, Math.min(1, v))
+      }
+    }
+    return soundVolClamped(0.9)
+  } catch (err) { return soundVolClamped(0.9) }
+}
+// v778：绑定音（按压 / 提问 / 授权 / 试听）—— 把 `{sel, vol}` **显式传进去**。
+//   旧实现靠"临时把全局 soundVol / usageSet.taskEnd 改掉、finally 再改回来"来传值；那正是
+//   "每轮结束音读错音量"的同源隐患：任何新增播放入口忘了临时改一下，就会静默读全局（正是 0.3.16 的 bug）。
 function playBindingSound(bind, ev) {
   try {
     if (!bind || !bind.on || soundOn === false) return
     var sel = bind.sel || ''
     if (!sel) return // 防御：空选择不出声（v762 起下拉里已无「静音」项，正常不会再为空）
-    var savedTaskEnd = usageSet ? usageSet.taskEnd : undefined
-    var savedVol = soundVol
-    try {
-      if (usageSet) usageSet.taskEnd = { on: true, sel: sel }
-      if (ev && typeof ev.vol === 'number' && ev.vol >= 0) soundVol = ev.vol
-      playTaskEndSound()
-    } finally {
-      if (usageSet) usageSet.taskEnd = savedTaskEnd
-      soundVol = savedVol
-    }
+    playTaskEndSound({ sel: sel, vol: (ev && typeof ev.vol === 'number') ? ev.vol : undefined })
   } catch (err) {}
 }
 // v761：等待交互时的**会话名**（wait.json 每秒轮询回填）+ 超长截断（默认 12 字符 + …）
@@ -1425,13 +1441,19 @@ function bubbleSessionText(m) {
   m = m || {}
   return bubbleSessionLabel(m.len === undefined || m.len === null ? WAIT_SESSION_MAX : m.len)
 }
-function playTaskEndSound() {
+// v778：`opts` = { sel?, vol? } —— 传入 sel 表示"播这个绑定音效"（绕过 taskEnd 开关，因为它自带 on）；
+//   不传 sel = 路径 A（每轮结束音），按 usageSet.taskEnd 的门控与选择。
+function playTaskEndSound(opts) {
   try {
-    if (!usageSet || !usageSet.taskEnd || !usageSet.taskEnd.on || soundOn === false) return
-    var sel = usageSet.taskEnd.sel || taskEndSel.value || ''
+    var o = opts || {}
+    if (soundOn === false) return
+    if (!o.sel) {
+      if (!usageSet || !usageSet.taskEnd || !usageSet.taskEnd.on) return
+    }
+    var sel = o.sel || usageSet.taskEnd.sel || taskEndSel.value || ''
     var url = ''
     var altUrl = ''
-    if (sel.indexOf('grp:') === 0) { playTaskEndGroupClick(sel.slice(4)); return }
+    if (sel.indexOf('grp:') === 0) { playTaskEndGroupClick(sel.slice(4), o.vol); return }
     if (sel.indexOf('frag:') === 0) url = '/dsh-whale/audio-fragment.wav?id=' + encodeURIComponent(sel.slice(5))
     else if (sel.indexOf('preset:') === 0) {
       // v752：预设片段也改走片段路由（与本体按压同一套选择逻辑 + 备用路由）
@@ -1443,13 +1465,14 @@ function playTaskEndSound() {
     if (!url) return
     var a = dshwvSound(url)
     if (altUrl) a._alt = altUrl
-    try { a.volume = soundVolClamped(0.9) } catch (err) {}
+    // v778：音量统一走解析器（②区「提示音量」显式设置过就用它，否则跟随①区「按压音量」）
+    try { a.volume = soundVolumeOf('turnCost', o.vol) } catch (err) {}
     a.play().catch(function () {})
   } catch (err) {}
 }
 // 任务结束音=音效组时:模拟点按一次该组——音1完整播放结束后立即接音2,
 // 即“按下到音1结束才松开”的无缝连续点按听感；槽位留空(该事件静音)时跳过对应音频
-function playTaskEndGroupClick(groupId) {
+function playTaskEndGroupClick(groupId, volOverride) {
   try {
     if (!groupId) return
     var g = null
@@ -1457,7 +1480,8 @@ function playTaskEndGroupClick(groupId) {
     var pressEmpty = !!(g && g.press === '') // 仅显式留空算静音;缺失字段(null)按旧数据回落预设
     var releaseEmpty = !!(g && g.release === '')
     if (pressEmpty && releaseEmpty) return
-    var vol = soundVolClamped(0.9)
+    // v778：**"任务结束音 = 音效组"也必须走解析器**（第三方补丁只改了单片段那条路，音效组仍读①区 ⇒ 滑块照旧无效）
+    var vol = soundVolumeOf('turnCost', volOverride)
     // v752：任务结束音同样改走片段路由（与本体按压同一套 URL 选择 + 备用路由逻辑）——
     // 老路由 /dsh-whale/sound/*.mp3?set=… 在部分环境会被本机那层东西拦成空的 204，
     // 不改的话"点按有声、但每轮结束音没声"会变成同一个问题的另一半。
@@ -1743,17 +1767,37 @@ function loadUsageSettings(cb) {
       .catch(function () { if (cb) cb() })
   } catch (err) { if (cb) cb() }
 }
-function saveUsageSettings(patch) {
-  try {
-    fetch(USAGE_SET_URL, {
-      method: 'PUT',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(patch || {}),
+// v778：与 `configPut()` **同一套语义**（读响应 → 失败静默重试一次 → 仍失败才提示用户）。
+//   旧实现只 `fetch(...).then(r=>r.json()).then(d=>{...}).catch(function(){})`：**不查 HTTP 状态码、
+//   失败完全静默** ⇒ 用户点了「保存」、面板正常关闭，其实一个字节都没写进磁盘（第三方分析报告点出的
+//   现象是真的，只是它把归因写成了"消耗数据丢存"——这个接口存的是**设置**，消耗记录由宿主自己记账）。
+function usageSettingsPut(patch, retried) {
+  return fetch(USAGE_SET_URL, {
+    method: 'PUT',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(patch || {}),
+  })
+    .then(function (r) {
+      return r.json().catch(function () { return null }).then(function (d) { return { ok: r.ok, status: r.status, d: d } })
     })
-      .then(function (r) { return r.json() })
-      .then(function (d) { if (d && d.ok && d.settings) usageSet = d.settings })
-      .catch(function () {})
-  } catch (err) {}
+    .then(function (x) {
+      if (x.ok && (!x.d || x.d.ok !== false)) {
+        if (x.d && x.d.settings) usageSet = x.d.settings
+        return true
+      }
+      if (!retried) return new Promise(function (res) { setTimeout(function () { res(usageSettingsPut(patch, true)) }, 900) })
+      // 复用既有 toast（内部已对动态值做转义，见 v756/issue #143）
+      configSaveFailNotice((x.d && x.d.error) || ('HTTP ' + x.status))
+      return false
+    })
+    .catch(function (err) {
+      if (!retried) return new Promise(function (res) { setTimeout(function () { res(usageSettingsPut(patch, true)) }, 900) })
+      configSaveFailNotice((err && err.message) || err)
+      return false
+    })
+}
+function saveUsageSettings(patch) {
+  try { return usageSettingsPut(patch, false) } catch (err) { return null }
 }
 // 把主菜单已有行收进 menuRootView;用量记录作为 menuBox 内的子视图切换
 var menuRootView = document.createElement('div')
@@ -2002,7 +2046,11 @@ function soundEventDefaults() {
     // ⚠️ v764：turnCost **也不再带** autoClose / ttlSec —— 它们从来没有消费方，而面板 ② 区
     //    「自动关闭」的真实落点是 .dshw-size.json 的 turnCostCloseMs（见 openSoundSettingsPanel）。
     //    给 turnCost 重新长出这两个键，会让同一个设置又变回两个来源（其中一个还是假的）。
-    turnCost: { vol: 1, bubbleOn: true },
+    turnCost: { vol: 1, volSet: false, bubbleOn: true },
+    // ⚠️ v778：`volSet` = "用户**显式**调过这一事件的音量"（默认 false）。它只表达"要不要覆盖①区"，
+    //    不是另一个音量来源 —— 取值永远看 `vol`。没有它就无法区分"默认 100%"与"用户设了 100%"，
+    //    会让"②区优先"静默改掉老用户的响度（详见 soundVolumeOf() 与 SPEC §24）。
+    //    ⚠️ 与宿主 soundEventsDefaults() 的同名字段**必须逐字段一致**（由探针 §⑥ 跨端一致钉住）。
     // v774：出厂默认 = 作者当前用法：提问/授权**开着**（要冒泡），但音效**不响**（soundOn: false）。
     // 要响就把音效行的 [✓] 勾上；不想冒泡就取消入口行的 [✓]。
     question: { on: true, soundOn: false, sel: 'frag:exp_orb', vol: 1, autoClose: true, ttlSec: 180, bubbleOn: true },
@@ -2029,6 +2077,9 @@ function soundEventOut(cfg, withBind) {
     vol: Number(cfg.vol) || 0,
     bubbleOn: cfg.bubbleOn !== false,
   }
+  // v778：`volSet` 只属于 turnCost（= `withBind` 为假的那一个）。提问/授权的音量在"用户勾了音效开关"
+  //   时才出声，不存在"默认值 vs 显式值"的歧义，所以不需要这个键。
+  if (!withBind) o.volSet = cfg.volSet === true
   if (withBind) {
     // v764：autoClose / ttlSec 跟着 on/sel/soundOn 一起，只属于提问/授权。turnCost 的「自动关闭」
     // 真实落点是 .dsh-size.json 的 turnCostCloseMs、**不走 events 载荷** —— 别再无条件塞进去，
@@ -2067,6 +2118,11 @@ function openSoundSettingsPanel() {
     // 唯一消费点 sceneOpen('cost', …, turnCostCloseMs > 0 ? turnCostCloseMs : 0)），所以它也要进快照、
     // 也要能随「取消」还原（否则面板那行「自动关闭」就是个死控件）。
     var snapTurnCostCloseMs = Math.max(0, Math.round(Number(turnCostCloseMs) || 0))
+    // v777（用户要求）：底部新增「点按角色关闭提示气泡」——默认关（默认只有点泡泡能收起等待提示）。
+    //   存在 usage.json 的 settings.wait.charClose（宿主 usageSettingsDefaults() 里默认 false）；
+    //   窗口期间只改缓冲，保存才 PUT，取消按快照还原，与其它设置项同一套语义。
+    var bufWaitCharClose = !!(((usageSet || {}).wait || {}).charClose)
+    var snapWaitCharClose = bufWaitCharClose
     // 内存缓冲：窗口期间只改这里
     var sndBuf = {
       turnCost: soundEventCfg('turnCost'),
@@ -2168,7 +2224,14 @@ function openSoundSettingsPanel() {
               var pre = (tcCloseBuf.autoClose !== false && sec > 0) ? ('自动关 ' + sec + 's') : '不自动关'
               // v768：静音时**不再显示已选的音效名**，直接告诉用户去哪儿改（用户要求的确切文案）
               txt = pre + ' · ' + (bufTaskEndOn ? (soundNameOf(e.sel) || '—') : '当前为静音，在下拉设置中修改')
-              if (bufTaskEndOn && sndPct(sndBuf.turnCost.vol) !== '100%') txt += ' · ' + sndPct(sndBuf.turnCost.vol)
+              // v778：音量的两种状态写清楚 —— 没拖过 ②区滑块 = **跟随①区按压音量**；拖过 = 用这里的值。
+              if (bufTaskEndOn) {
+                if (sndBuf.turnCost.volSet === true) {
+                  if (sndPct(sndBuf.turnCost.vol) !== '100%') txt += ' · ' + sndPct(sndBuf.turnCost.vol)
+                } else {
+                  txt += ' · 跟随按压音量 ' + sndPct(soundVol)
+                }
+              }
             }
           } else {
             var cfg = sndBuf[e.kind] || {}
@@ -2181,6 +2244,16 @@ function openSoundSettingsPanel() {
           }
           try { if (e.summary) e.summary.textContent = txt } catch (err) {}
         }
+        // v778：②区「提示音量」滑块在**未显式设置**时显示"实际生效的音量"（= ①区按压音量），
+        //   否则滑块停在 100% 而实际按 60% 播 —— 那就又变成"界面在骗人"（这次修的就是这类问题）。
+        try {
+          var tcCfg = sndBuf.turnCost || {}
+          if (tcVol && tcVol.input && tcCfg.volSet !== true) {
+            var eff = soundVolumeOf('turnCost')
+            tcVol.input.value = String(eff)
+            if (tcVol.pct) tcVol.pct.textContent = Math.round(eff * 100) + '%'
+          }
+        } catch (err) {}
         // v773：摘要与"置灰状态"永远一起刷（所有既有刷新点都会走到这里：开面板 / 卡内 input·change /
         // 点文档任意处 / 「恢复默认」末尾）—— 所以开关一动，相关设置立刻跟着灰/亮，不需要另挂监听。
         applySndDisabled()
@@ -2385,7 +2458,13 @@ function openSoundSettingsPanel() {
     fillSoundSelect(teSel, bufTaskEndSel)
     // 「静音」项删除后下拉不该留空：把兜底后的真实值回写缓冲（旧数据 sel 为空串时兜底成列表里的默认音）
     if (teSel.value) bufTaskEndSel = teSel.value
-    var tcVol = volSlider(function () { return sndBuf.turnCost.vol }, function (v) { sndBuf.turnCost.vol = v })
+    // v778：②区「提示音量」—— 拖动即视为**用户显式设置**（volSet = true），此后该事件用自己的值；
+    //   没拖过则保持"跟随①区按压音量"（见 soundVolumeOf），摘要里会写明，避免再出现"滑块看着能调、其实无效"。
+    var tcVol = volSlider(function () { return sndBuf.turnCost.vol }, function (v) {
+      sndBuf.turnCost.vol = v
+      sndBuf.turnCost.volSet = true
+      try { refreshSummaries() } catch (err) {}
+    })
     var rTcVol = row('提示音量', tcEnt.body)
     rTcVol.appendChild(tcVol.input)
     rTcVol.appendChild(tcVol.pct)
@@ -2480,6 +2559,9 @@ function openSoundSettingsPanel() {
             setTurnCostClose(Math.round(snapTurnCostCloseMs / 1000))
           }
         } catch (err) {}
+        // v777：底部「点按角色关闭提示气泡」——回滚缓冲与控件（它只活在缓冲里，没保存过就没落盘）
+        try { bufWaitCharClose = snapWaitCharClose } catch (err) {}
+        try { if (waitCharChk) waitCharChk.checked = snapWaitCharClose } catch (err) {}
       }
       try { audioGroupPanel.style.zIndex = '' } catch (err) {}
       try { audioEditMask.style.zIndex = '' } catch (err) {}
@@ -2540,7 +2622,12 @@ function openSoundSettingsPanel() {
         usageSet.taskEnd = te
         try { applyTaskEndLocal(te.on, te.sel) } catch (err) {}
         mergeEventsLocal(ev)
-        saveUsageSettings({ events: ev, taskEnd: te })
+        // v777：底部「点按角色关闭提示气泡」跟着同一次 PUT 落盘（键 = settings.wait.charClose）
+        try {
+          usageSet = usageSet || {}
+          usageSet.wait = Object.assign({}, usageSet.wait || {}, { charClose: !!bufWaitCharClose })
+        } catch (err) {}
+        saveUsageSettings({ events: ev, taskEnd: te, wait: { charClose: !!bufWaitCharClose } })
         // v763：按压音量 / 音效总开关 / 每轮消耗提示开关这三项**不在**上面这次 PUT 的覆盖范围里
         //（它们存在 .dsh-size.json，走 saveConfig()）⇒ 保存时必须各自按**当前内存值**提交一次，
         // 否则「恢复默认」对它们不生效（用户会觉得恢复默认对音量/开关没作用）。
@@ -2601,6 +2688,11 @@ function openSoundSettingsPanel() {
         bufTaskEndSel = 'frag:end_a' // = 宿主 usageSettingsDefaults().taskEnd.sel
         bufTaskEndKeep = 'frag:end_a' // = 宿主 usageSettingsDefaults().taskEnd.sel
         bufTaskEndOn = true // v774：② 音效行的 [✓] 复位（宿主 taskEnd.on 默认 true）
+        // v778：②区「提示音量」也复位成"跟随①区"（volSet=false；滑块显示由 refreshSummaries 同步成①区值）
+        try { sndBuf.turnCost.volSet = false } catch (err) {}
+        // v777：底部「点按角色关闭提示气泡」恢复出厂默认（false = 只有点泡泡能收）
+        bufWaitCharClose = false
+        try { if (waitCharChk) waitCharChk.checked = false } catch (err) {}
         // 控件回填
         try { pressOnChk.checked = true } catch (err) {}
         try { soundToggle.checked = true } catch (err) {} // v763：与 setSoundOn() 同步的那只开关（只改内存显示）
@@ -2639,6 +2731,54 @@ function openSoundSettingsPanel() {
         //   · usageSet.events 的 lines（提问/授权提示内容）不再被「恢复默认」清空（与按钮 title 一致）
       } catch (err) {}
     }
+    // v777（用户要求）：「取消/恢复默认/保存」上面一行 —— 与「自定义泡泡」窗口的
+    // 「点按角色推进泡泡队列」同款排版（[✓] + 标签 + ? 圈圈），说明收进 ? 圈圈里（复用 v647 的 dshwvAskDot）。
+    var waitCharRow = document.createElement('div')
+    waitCharRow.className = 'dshwv-bubsec'
+    waitCharRow.style.display = 'flex'
+    waitCharRow.style.alignItems = 'center'
+    waitCharRow.style.flexWrap = 'wrap'
+    waitCharRow.style.gap = '4px 6px'
+    waitCharRow.style.color = '#203170'
+    waitCharRow.style.marginTop = '8px'
+    // v777c（2026-09-27 追加要求）：
+    //   ① 与上面那几行（入口行 `dshwvFoldEntry`，如「授权提示」）的复选框**左对齐** —— 入口行是
+    //      `rowEl.style.padding = '6px 6px'` 直接挂在 card 上 ⇒ 复选框在 6px 处；本行 `dshwv-bubsec`
+    //      没有左内边距（默认 0）⇒ 补 6px 即对齐。（⚠️ 注意区分：展开后**折叠体里**的行额外有
+    //      `body.style.paddingLeft = 10px`，在 10px 处；本行是全局开关、不属于任何折叠体，故按入口行对齐。）
+    //   ② 本行**不要鼠标悬浮提示**（原生 title）：问号圈圈自带的「查看说明」与复选框那句说明都清掉 ——
+    //      说明统一收进问号圈圈的弹层里（悬停/点击问号时才显示），避免两个入口说两遍。
+    waitCharRow.style.paddingLeft = '6px'
+    var waitCharAsk = dshwvAskDot(
+      '等待提问 / 授权的提示气泡：<b>默认点气泡就能收起来</b>（点一下收起，同一条挂起不会再自动弹回；' +
+      '你回答或批准之后、或下一次新的提问 / 授权到来时，照常冒泡并响铃）。<br><br>' +
+      '打开下面这个开关后，<b>点角色（鲸鱼）也能收掉提示气泡</b> —— 和「自定义泡泡」里的' +
+      '「点按角色推进泡泡队列」是同一类手感。<br><br>默认关闭。'
+    )
+    // v777b（2026-09-27 追加要求）：? 圈圈放到**文字后面**，并把与文字的间距收紧 ——
+    //   .dshwv-askq 自带 margin-right:5px，加上行的 column-gap 6px，放前面时离文字有 11px；
+    //   v777b 先用行内 margin-left:-3px 压到约 3px；
+    //   v777d（2026-09-27 追加要求「再稍稍右移」）：改成 0 ⇒ 间距回到行的自然列间距 6px（右移 3px）。
+    waitCharAsk.style.marginLeft = '0'
+    waitCharAsk.style.marginRight = '0'
+    waitCharAsk.title = '' // v777c：清掉 dshwvAskDot 自带的「查看说明」原生 tooltip（用户要求本行不要悬浮提示）
+    var waitCharChk = document.createElement('input')
+    waitCharChk.type = 'checkbox'
+    waitCharChk.className = 'dshwv-check'
+    waitCharChk.id = 'dshwv-waitcharclose'
+    waitCharChk.checked = bufWaitCharClose
+    // v777c：复选框也不挂原生 tooltip（原来那句"打开后：点角色也能收起…"已写进问号圈圈的说明里）
+    waitCharChk.title = ''
+    waitCharChk.addEventListener('change', function () { bufWaitCharClose = !!waitCharChk.checked })
+    waitCharRow.appendChild(waitCharChk)
+    var waitCharLab = document.createElement('label')
+    waitCharLab.setAttribute('for', 'dshwv-waitcharclose')
+    waitCharLab.style.cursor = 'pointer'
+    waitCharLab.style.fontSize = '12px'
+    waitCharLab.textContent = '点按角色关闭提示气泡'
+    waitCharRow.appendChild(waitCharLab)
+    waitCharRow.appendChild(waitCharAsk)
+    card.appendChild(waitCharRow)
     var btns = document.createElement('div')
     btns.className = 'dshwv-bubbtns'
     var cancelBtn = document.createElement('button')
@@ -4854,7 +4994,8 @@ function resPlayFragment(fid) {
     if (!fid) return
     if (resAudEl) { try { resAudEl.pause() } catch (err) {} resAudEl = null }
     var a = dshwvSound('/dsh-whale/audio-fragment.wav?id=' + encodeURIComponent(fid))
-    try { a.volume = soundVolClamped(0.9) } catch (err) {}
+    // v778：资源窗口的片段试听也走音量解析器（它是"这一条片段本身的试听"，与按压音量同源）
+    try { a.volume = soundVolumeOf('press') } catch (err) {}
     a.onended = function () { resAudEl = null }
     resAudEl = a
     a.play().catch(function () { resAudEl = null })
@@ -9522,19 +9663,31 @@ var bubbleTapAdvChk = document.createElement('input')
 bubbleTapAdvChk.type = 'checkbox'
 bubbleTapAdvChk.className = 'dshwv-check'
 bubbleTapAdvChk.id = 'dshwv-tapadv'
-bubbleTapAdvChk.title = '开启后：点一下角色=往后推进一项（不再回到首次点击泡泡）；走到最后一项再点=收起泡泡'
+// v777e（2026-09-27 用户要求）：本行复选框**不再挂原生 tooltip**（原来那句"开启后：点一下角色=往后推进一项…"
+// 与问号圈圈里的说明重复）。说明统一收进 ? 圈圈的弹层里（与「提示与音效设置」面板底部那行一致）。
+bubbleTapAdvChk.title = ''
 var bubbleTapAdvLab = document.createElement('label')
 bubbleTapAdvLab.setAttribute('for', 'dshwv-tapadv')
 bubbleTapAdvLab.style.cursor = 'pointer'
 bubbleTapAdvLab.style.fontSize = '12px'
 bubbleTapAdvLab.textContent = '点按角色推进泡泡队列'
-var bubbleTapAdvHint = document.createElement('span')
-bubbleTapAdvHint.className = 'dshwv-bubhint'
-bubbleTapAdvHint.style.margin = '0'
-bubbleTapAdvHint.textContent = '（关闭＝点角色回到第 1 个泡泡；开启＝点一下往后一个）'
+// v777（用户要求）：原来跟在标签后面的那一行说明字（「关闭＝点角色回到第 1 个泡泡；开启＝点一下往后一个」）
+// 收进问号圈圈里 —— 复用 v647 的 dshwvAskDot（悬停即显示、点击固定、触摸端点按开关），与
+// 「提示与音效设置」面板底部那一行同款。说明里顺带把原来 title 里的完整描述也写进去。
+// v777b（2026-09-27 追加要求）：? 圈圈放在**文字后面**，并把与文字的间距收紧（同面板那处）。
+// v777d：「再稍稍右移」⇒ margin-left 由 -3px 改成 0（间距 = 行的自然列间距 6px）。
+var bubbleTapAdvAsk = dshwvAskDot(
+  '关闭（默认）：<b>点角色</b>＝回到第 1 个泡泡（点泡泡才是往后推进）。<br><br>' +
+  '开启：<b>点一下角色 = 往后推进一项</b>（不再回到首次点击泡泡）；走到最后一项再点＝收起泡泡。'
+)
+bubbleTapAdvAsk.style.marginLeft = '0'
+bubbleTapAdvAsk.style.marginRight = '0'
+// v777e：与面板底部那行同款处理 —— 清掉问号圈圈自带的「查看说明」原生 tooltip，
+//        说明只在悬停/点击问号时以自绘弹层出现（本行鼠标悬浮不再出现浏览器小黄条）。
+bubbleTapAdvAsk.title = ''
 bubbleTapAdvRow.appendChild(bubbleTapAdvChk)
 bubbleTapAdvRow.appendChild(bubbleTapAdvLab)
-bubbleTapAdvRow.appendChild(bubbleTapAdvHint)
+bubbleTapAdvRow.appendChild(bubbleTapAdvAsk)
 bubbleCard.appendChild(bubbleTapAdvRow)
 // 按钮行
 var bubbleBtns = document.createElement('div')
@@ -13503,6 +13656,12 @@ function whaleClick() {
       bubbleShowSeqNext()
       return
     }
+    // v777：等待交互提示期间点角色 —— 开关「点按角色关闭提示气泡」打开时，点角色＝收起这条等待提示
+    //（默认关：保持"点角色不动等待提示"，只有点泡泡才关）。收起来后 pollWaitState 不会把它弹回来。
+    if (bubbleScene && bubbleScene.kind === 'wait') {
+      if (waitCharCloseOn()) dismissWaitBubble()
+      return
+    }
     // v727：开启「点按角色推进泡泡队列」→ 点角色＝往后推进一项（不再回到第 1 项）；
     // 已是最后一项时与「点泡泡」一致：收起泡泡，下次点按从第 1 项开始。
     if (bubbleTapAdvance) { bubbleNext(); return }
@@ -13523,9 +13682,12 @@ function bubbleNext() {
     if (!bubbleShown) return
     if (bubbleScene && bubbleScene.kind === 'cost') { hideCostBubble(); return }
     if (bubbleScene && bubbleScene.kind === 'alert') { hideUsageAlertBubble(); return }
-    // v761（#161 C5）：等待交互泡泡必须**常驻到被回答/批准**——点它不关（点击泡泡 = 推进/收起是给
-    // 手动轮的语义）；避免用户误点把「正在等待你的回答」收掉、而后台其实还挂着。
-    if (bubbleScene && bubbleScene.kind === 'wait') return
+    // v777：等待交互泡泡**可以点掉**（用户反馈「无法点击关闭」）。原来的实现在这里是 `return`
+    //（设计意图是"别让误点把'正在等待你回答'收掉"），但真机上用户就是想把它点掉 ⇒ 改成：
+    // 点泡泡 = 收起，并记住"这条挂起已被点掉"，pollWaitState 不再自动弹回（回答/批准或下一次新挂起照常）。
+    if (bubbleScene && bubbleScene.kind === 'wait') { dismissWaitBubble(); return }
+    // v761（#161 C5）曾在此处"等待交互泡泡点它不关"（必须等被回答/批准）——
+    // v777 按用户反馈改成"可点关"，语义与实现见上面的 dismissWaitBubble()；这里不再拦截。
     if (bubbleRoundOn && bubbleSeqIdx < bubbleSeq.length) { bubbleShowSeqNext(); return }
     hideBubble()
   } catch (err) {}
@@ -13552,6 +13714,13 @@ function hideBubble() {
 }
 function showCostBubble(amount) {
   if (!bubbleOn || !turnCostOn) return
+  // v778：②区「冒泡提示」勾选框（events.turnCost.bubbleOn）以前**只写不读** —— 取消勾选照样弹。
+  //   同类问题（"控件有值、没有消费方"）与本次修的音量滑块同源，一并接上：
+  //   缺省（未设置/旧数据）= 照常冒泡，只有**显式**取消勾选才不弹 ⇒ 老用户行为不变。
+  try {
+    var tcCfg = soundEventCfg('turnCost') || {}
+    if (tcCfg.bubbleOn === false) return
+  } catch (err) {}
   // 进入系统泡泡队列(等级3):若同批有预警/预算,则排在它们之后展示
   whaleSysPush({ kind: 'cost', amount: amount, rank: 3 })
 }
@@ -13769,6 +13938,23 @@ function hideWaitBubble() {
     if (whaleSysQueue.length !== beforeLen) whaleSysTick()
   } catch (err) {}
 }
+// v777（用户反馈「授权提示/提问提示无法点击关闭」）：
+//   · 默认：**点泡泡**即可关掉等待气泡（点角色不管，除非打开下面的开关）；
+//   · 开关「点按角色关闭提示气泡」打开后：**点角色**也能关；
+//   · 关掉的是"这条挂起"——宿主每秒还会下发同一条挂起（pollWaitState 是每分钟…不是，是每秒对齐一次），
+//     所以必须记住"用户把这条点掉了、别再自动弹回"，否则关掉后 1 秒内又回来 = 看起来根本关不掉。
+var waitDismissedId = '' // 被用户点掉的挂起 id（'' = 没有）
+var waitPendingId = '' // 宿主最近一次上报的挂起 id（用于"点掉的就是当前这条"）
+function waitCharCloseOn() {
+  try { return !!(((usageSet || {}).wait || {}).charClose) } catch (err) { return false }
+}
+// 用户主动收起等待气泡：记住这条挂起已被点掉，然后收起
+function dismissWaitBubble() {
+  try {
+    if (waitPendingId) waitDismissedId = waitPendingId
+    hideWaitBubble()
+  } catch (err) {}
+}
 function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v) }
 function viewport() {
   return {
@@ -16783,17 +16969,27 @@ function pollWaitState() {
         if (!p || !p.kind) {
           // 挂起已解除：收起泡泡，并允许下一次挂起照常响
           waitSeenId = ''
+          waitPendingId = '' // v777：挂起解除 ⇒ "被点掉"的标记一并作废（下一次挂起照常冒泡）
+          waitDismissedId = ''
           if (typeof hideWaitBubble === 'function') hideWaitBubble()
           return
         }
         var kind = p.kind === 'approval' ? 'approval' : 'question'
         var ev = waitEventCfg(kind)
+        // v777：这条挂起已经被用户点掉了 ⇒ 不再自动弹回（但仍然照常响铃判定与去重；回答/批准后
+        // 上面的 !p 分支会把标记清掉，所以"下一次新的提问/授权"照常冒泡）。
+        waitPendingId = String(p.id || '')
+        if (waitPendingId && waitPendingId === waitDismissedId) {
+          // 什么都不做：既不显示，也不清 waitSeenId（同一挂起不重复响）
+        } else {
+          if (ev.bubbleOn !== false && typeof showWaitBubble === 'function') showWaitBubble(kind, p)
+        }
         // v771：**每秒都把泡泡与宿主的挂起状态对齐一次**（showWaitBubble 幂等：同类直接返回 false，
         // 不会重渲染）。旧实现只在"新 id"时才调显示，于是一旦出现瞬时不同步（换类型 / 泡泡被别的
         // 场景顶掉 / 某次渲染失败），泡泡就会卡在那个状态再也回不来 —— 这正是真机那次卡死的另一半原因。
         // 现在任何不同步都会在 1 秒内自愈：该换内容就换、该收就收（收在下面 !p 分支）。
         // 门控照旧：该事件的「冒泡提示」关掉就不冒泡（与声音各自独立判）。
-        if (ev.bubbleOn !== false && typeof showWaitBubble === 'function') showWaitBubble(kind, p)
+        // v777：显示那一步已上移到"被点掉的挂起"判定里（见上面的 waitDismissedId 分支），这里不再重复调用。
         // 声音：同一个未回答的挂起只响一次（刷新页面也不重复响）
         var key = kind + ':' + String(p.id || '')
         var remembered = ''

package/lib/index.js

@@ -1285,7 +1285,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.16', today: todayData, days7,
+        ok: true, version: '0.3.17', 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),
@@ -1321,7 +1321,10 @@ export default {
         //    （只冒泡）—— 要响就把音效行的 [✓] 勾上。
         // v764：turnCost **刻意不带** autoClose / ttlSec —— 自动关闭的真实来源是 .dshw-size.json 的
         //    turnCostCloseMs，留着这两个键会让同一个设置有两个来源（其中一个永远是假的）。
-        turnCost: { vol: 1, bubbleOn: true },
+        // v778：`volSet` = 用户**显式**调过②区「提示音量」没有（默认 false = 跟随①区按压音量）。
+        //    没有它就无法区分"默认 100%"与"用户设了 100%"，前端 soundVolumeOf() 靠它决定优先级。
+        //    ⚠️ 与前端 soundEventDefaults().turnCost **必须逐字段一致**（探针 §⑥ 跨端一致钉住）。
+        turnCost: { vol: 1, volSet: false, bubbleOn: true },
         question: { on: true, soundOn: false, sel: 'frag:exp_orb', vol: 1, autoClose: true, ttlSec: 180, bubbleOn: true, lines: waitDefaultLines('question') },
         approval: { on: true, soundOn: false, sel: 'frag:exp_orb', vol: 1, autoClose: true, ttlSec: 180, bubbleOn: true, lines: waitDefaultLines('approval') },
       }
@@ -1329,6 +1332,10 @@ export default {
     function usageSettingsDefaults() {
       return {        // 任务结束音：v774 起出厂默认 = **开**（作者当前用法），默认音 = 内置 A（end_a）
         taskEnd: { on: true, sel: 'frag:end_a' },
+        // v777：「等待交互提示」的交互开关（用户 2026-09-26 要求）
+        //   charClose=false（出厂默认）＝ 只有**点泡泡**能收起等待提示；true ＝ **点角色**也能收起。
+        //   两种情况下"点掉的那条挂起"都不会再被每秒轮询自动弹回（前端 waitDismissedId）。
+        wait: { charClose: false },
         // v761：四个事件的音效/自动关闭/冒泡配置（面板「全局音效设置」）
         events: soundEventsDefaults(),
         // 默认固化自开发环境当前 usage.json 设置(全新安装即此体验)
@@ -1411,6 +1418,8 @@ export default {
       if (p.budget && typeof p.budget === 'object') led.settings.budget = Object.assign({}, led.settings.budget || {}, p.budget)
       // 每轮消耗提示内容(自定义提示窗口)
       if (p.turnCost && typeof p.turnCost === 'object') led.settings.turnCost = Object.assign({}, led.settings.turnCost || {}, p.turnCost)
+      // v777：「等待交互提示」的交互开关（点角色是否也能关闭等待提示气泡）
+      if (p.wait && typeof p.wait === 'object') led.settings.wait = Object.assign({}, led.settings.wait || {}, p.wait)
       // v761（全局音效设置）：events 补丁逐事件合并（前端只发改动的那几个字段）
       if (p.events && typeof p.events === 'object') {
         led.settings.events = led.settings.events && typeof led.settings.events === 'object' ? led.settings.events : {}
@@ -1426,6 +1435,8 @@ export default {
       // 「恢复默认」：只重置音效/提示类键（不动外观、位置、账本、角色与泡泡自定义）
       if (p.resetEvents === true) {
         led.settings.events = soundEventsDefaults()
+        // v777：等待提示的交互开关也属于"提示类键" ⇒ 一起恢复出厂默认（charClose=false）
+        led.settings.wait = { charClose: false }
         // 任务结束音也属于「音效类键」：宿主重置与面板显示必须口径一致（否则面板显示与真实状态撕裂）
         // v774：重置目标 = 新的出厂默认（开 + 内置 A）
         led.settings.taskEnd = { on: true, sel: 'frag:end_a' }
@@ -2624,7 +2635,7 @@ export default {
       const summary = daySummary(led, todayKey())
       const nowSec = Math.floor(Date.now() / 1000)
       return {
-        ...visible, version: '0.3.16', isPeak: isPeakTime(nowSec),
+        ...visible, version: '0.3.17', isPeak: isPeakTime(nowSec),
         // 峰谷切换点与节假日清单：前端倒计时要与宿主同源（否则法定节假日会算错切换点）
         peakNextChangeAt: nextPeakChangeAt(nowSec),
         peakHolidays: HOLIDAY_VALLEY_LIST,

package/package.json

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