dsh-api-dashboard 1.0.2 → 1.1.2

package/README.md

@@ -78,7 +78,15 @@ OpenRouter、Novita AI、xAI Grok
 
 ## 安装
 
-### 推荐方式：下载后一条命令安装
+### ✅ 推荐方式：npm 一行命令
+
+```sh
+dsh plugin --profile web add dsh-api-dashboard
+```
+
+> 从 npm 拉取最新版本，自动安装依赖、注册 bundle 层，无需手动下载或建软链。
+
+### 备选：下载源码后安装（无 npm registry 环境时）
 
 ```sh
 # 1. 下载源码（codeload 地址，github.com 主站不可达时也能用）
@@ -94,18 +102,20 @@ dsh plugin --profile web add file:/root/dsha-api-dashboard
 # 4. 重启 dsh web 生效
 ```
 
-> 第 3 步等价于 `pnpm add file:...`，会自动安装依赖并把插件加入
-> `dsh.profile.bundles` 列表，无需手动建软链或编辑 profile 的 package.json。
->
-> 更新版本：重复执行步骤 1-2 覆盖目录，再执行一次第 3 步即可。
+### 升级到新版本
 
-### ⚠️ 已知不可用的安装姿势（实测踩坑记录）
+1. **推荐**：插件设置面板 →「检查更新」→「一键自更新」（内置更新引擎，下载→校验→备份→原子替换→失败回滚，重启 web 生效）；
+2. 或：`dsh plugin --profile web remove dsh-api-dashboard` 后重新执行上面的推荐/备选安装；
+3. 兜底：重复「下载源码」步骤 1-2 覆盖目录，再执行第 3 步。
+
+### ⚠️ 安装姿势对照（实测）
 
 | 方式 | 结果 |
 |------|------|
-| `dsh plugin add dsh-api-dashboard`（裸包名） | ✅ 推荐！已发布到 npm，一行命令安装 |
-| `pnpm add <远程 tarball URL>` | ❌ pnpm 不剥离 codeload 压缩包的顶层目录，装出来是空壳 |
-| 手动软链 node_modules | ✅ 可用但繁琐，层级写错会被启动校准摘除，不推荐 |
+| `dsh plugin --profile web add dsh-api-dashboard`（npm 裸包名） | ✅ 推荐，一行命令 |
+| `dsh plugin --profile web add file:/root/dsha-api-dashboard`（源码方式） | ✅ 备选 |
+| `pnpm add <远程 tarball URL>` | ❌ pnpm 不剥离 codeload 压缩包顶层目录，装出来是空壳 |
+| 手动软链 node_modules | ⚠️ 可用但繁琐，层级写错会被启动校准摘除，不推荐 |
 
 ## 配置
 
@@ -187,7 +197,15 @@ v0.7.0 — 玻璃 UI 改造（方案 A 第一阶段）：半屏抽屉玻璃拟
 v0.7.1 — 修复负余额显示正常（负数→红）；智谱解析保留百分比（不把限流窗口当余额）；设置面板新增「返回」按钮与 IconBack；新增 AGENTS.md（给维护 AI 的必读须知）+ README 顶部 AI 警告块
 v1.0.0 — 正式版：插件改名「哦鲸鲸」+ 自定义图标（/api-dashboard/icon）；全量 UI 改版（固定色值去主题变量、三段式头部、卡片右栏上下结构、选中模型置顶、分组折叠、详情/设置/版本更新区重排）；若干样式补全与清理
 v1.0.2 — 余额解析稳健性（平台字段存在性校验，缺字段时如实显示「无法解析/未开放」而非误报 0）；智谱配额解析重写（按 `limits.unit` 区分 5 小时窗口、周配额、工具维度，`percentage` 修正为「已用/填充度」，不再把「已用完」误显示为「余额 100%」）；价格表更新（DeepSeek V4 新增 `deepseek-v4-flash-vision-exp`、`deepseek-chat/reasoner/r1` 标记为已退役；通用价格表新增现役主力 OpenAI GPT-5.6 / Claude 4.x / Gemini 3.x / Kimi K3 / StepFun 3.x，旧模型标为历史参考）；自更新下载包增加包名校验
+v1.0.3 — 文档更新：安装与升级指引改为以 npm 一行命令为主、源码方式为备选，并补充升级路径；无功能变更
+v1.1.0 — 🐋 新增「收养大肥鱼」互动挂件：设置 → 基础设置 → 开启后屏幕边缘探出一只大肥鱼（露出约一半），点击弹全身 + 随机台词泡泡（含峰谷时段文案、gif、卖萌吐槽）+ 按压 Q 弹与音效；**可全屏拖拽**，松手自动吸附最近边缘（挂件菜单可关掉「自动靠边」改为自由摆放），左侧吸附时整体镜像翻转；挂件自带汉堡菜单（大小 0.6~2.5 倍 / 探出比例 / 音效开关 / 音效组 / 音量 / 气泡开关 / 峰谷文案 / 自动靠边），位置与全部设置持久化；开关即拨即存（不必点保存）；纯互动不显示任何余额与消耗（那部分照旧在输入框下方）；互动部分移植自 [MeteorNOX/DeepSeek-Balance-Whale-Widget](https://github.com/MeteorNOX/DeepSeek-Balance-Whale-Widget)（MIT License, Copyright (c) 2026 MeteorNOX），许可副本见 `assets/whale/LICENSE-whale-widget.txt`
+v1.1.2 — 大肥鱼交互打磨：设置面板新增独立「大肥鱼」页签，总开关与全部细项（大小 / 探出 / 自动靠边 / 气泡 / 峰谷文案 / 音效 / 音效组 / 音量）集中到这一页，全部即改即存无需点保存，并去掉挂件本体右上角的浮层菜单；开关行图标改用鲸鱼本体缩略图；收回改为**停手 3 秒**自动缩回（连续点击持续续命，不再"点第二下立刻收回"）；台词气泡改为运行时避让，贴边时不再有一半在屏幕外，上方空间不足自动翻到下方；吸附收窄为**只有左右两侧边缘带**触发，停在屏幕中间保持整只显示；贴边时**纵向滑动不再展开**，沿边上下挪位，横向拉开才脱轨；连点节流 420ms，快速点击气泡稳定不闪
 
 ## License
 
-[MIT](./LICENSE)
+[MIT](./LICENSE)
+
+本项目「收养大肥鱼」挂件的互动部分（拖拽吸附、Q 弹按压、台词气泡、音效、菜单）移植自
+[MeteorNOX/DeepSeek-Balance-Whale-Widget](https://github.com/MeteorNOX/DeepSeek-Balance-Whale-Widget)，
+原作者 Copyright (c) 2026 MeteorNOX，MIT License，许可全文见 `assets/whale/LICENSE-whale-widget.txt`。
+鲸鱼形象与音效素材同样来自该项目。

package/assets/whale/LICENSE-whale-widget.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MeteorNOX
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/client/client.js

@@ -239,8 +239,9 @@ window.__ModuleLoader__.load({
 .dshadb_switch_on .dshadb_switch_knob{transform:translateX(17px)}
 
 /* Tab 导航 */
-.dshadb_tabs{display:flex;gap:7px;padding:4px 0 12px;overflow:auto}
-.dshadb_tab{border:0;background:#e9eaf0;border-radius:12px;padding:8px 13px;font-size:11px;color:#686c76;white-space:nowrap;cursor:pointer;font-family:inherit;transition:all .12s ease}
+.dshadb_tabs{display:flex;gap:7px;padding:4px 0 12px;overflow-x:auto;scrollbar-width:none;-ms-overflow-style:none}
+.dshadb_tabs::-webkit-scrollbar{display:none}
+.dshadb_tab{flex:none;border:0;background:#e9eaf0;border-radius:12px;padding:8px 13px;font-size:11px;color:#686c76;white-space:nowrap;cursor:pointer;font-family:inherit;transition:all .12s ease}
 .dshadb_tab_active{background:#4f7cff;color:#fff}
 
 /* 输入框 */
@@ -296,7 +297,60 @@ window.__ModuleLoader__.load({
 .dshadb_icon_btn{display:inline-flex;align-items:center;justify-content:center;min-width:38px;min-height:38px;padding:8px;border-radius:10px;background:transparent;border:none;color:#777b84;cursor:pointer;transition:background .1s ease}
 .dshadb_icon_btn:active{background:#f0f2f8;opacity:0.85}
 .dshadb_refresh_badge{font-size:9.5px;font-weight:600;color:#9ca0aa;background:#f0f2f8;padding:1px 7px;border-radius:999px;line-height:15px;white-space:nowrap}
-.dshadb_title_ic{display:inline-flex;align-items:center;justify-content:center;width:26px;height:26px;border-radius:7px;overflow:hidden;flex:none}`
+.dshadb_title_ic{display:inline-flex;align-items:center;justify-content:center;width:26px;height:26px;border-radius:7px;overflow:hidden;flex:none}
+/* ===== 设置面板 · 开关行 (v1.1.0) ===== */
+.dshadb_settings_row{display:flex;align-items:center;gap:12px;padding:12px 14px;margin:14px 0 4px;border-radius:16px;background:#ffffff;border:1px solid #e7e8ec;box-shadow:0 6px 20px rgba(0,0,0,0.03)}
+.dshadb_settings_row_main{flex:1;min-width:0}
+.dshadb_settings_row_title{display:block;font-size:13px;font-weight:750;color:#17181c;line-height:1.3}
+.dshadb_settings_row_sub{display:block;font-size:10.5px;font-weight:500;color:#9ca0aa;line-height:1.45;margin-top:3px}
+/* ===== 设置面板 · 大肥鱼页 (v1.1.0) ===== */
+.dshadb_wf_row{display:flex;align-items:center;gap:10px;padding:11px 14px;margin-bottom:8px;border-radius:14px;background:#ffffff;border:1px solid #e7e8ec}
+.dshadb_wf_row_col{display:block;padding:11px 14px;margin-bottom:8px;border-radius:14px;background:#ffffff;border:1px solid #e7e8ec}
+.dshadb_wf_name{font-size:12.5px;font-weight:700;color:#17181c;flex:none}
+.dshadb_wf_sub{display:block;font-size:10px;font-weight:500;color:#9ca0aa;line-height:1.4;margin-top:2px}
+.dshadb_wf_head{display:flex;align-items:center;justify-content:space-between;gap:10px;margin-bottom:8px}
+.dshadb_wf_val{font-size:11px;font-weight:800;color:#4f7cff;font-variant-numeric:tabular-nums;flex:none}
+.dshadb_wf_range{width:100%;height:24px;accent-color:#4f7cff;margin:0}
+.dshadb_wf_seg{display:flex;gap:6px;margin-left:auto;flex:none}
+.dshadb_wf_segbtn{font-size:11px;font-weight:700;font-family:inherit;padding:6px 11px;border-radius:10px;border:1px solid #e7e8ec;background:#f5f6f8;color:#9ca0aa;cursor:pointer;-webkit-tap-highlight-color:transparent;transition:background .15s ease,color .15s ease}
+.dshadb_wf_segbtn_on{background:#4f7cff;border-color:#4f7cff;color:#ffffff}
+.dshadb_wf_disabled{opacity:.45;pointer-events:none}
+.dshadb_wf_tip{font-size:10.5px;color:#9ca0aa;line-height:1.5;padding:2px 4px 0}
+.dshadb_wf_avatar{flex:none;width:34px;height:34px;object-fit:contain;object-position:center;display:block;-webkit-user-drag:none;filter:drop-shadow(0 2px 4px rgba(0,0,0,.12))}
+@media (prefers-color-scheme:dark){
+.dshadb_wf_row,.dshadb_wf_row_col{background:#262a33;border-color:#363c48}
+.dshadb_wf_name{color:#f2f4f8}
+.dshadb_wf_segbtn{background:#1e222a;border-color:#363c48;color:#8b91a0}
+.dshadb_wf_segbtn_on{background:#4f7cff;border-color:#4f7cff;color:#fff}}
+/* ===== 大肥鱼互动挂件 (v1.1.0) ===== */
+.dshadb-whale{position:fixed;left:0;top:60vh;z-index:9600;--dshw-scale:1;--dshw-size:clamp(96px,calc(min(150px,min(100vw,100vh) * 0.30) * var(--dshw-scale)),420px);width:var(--dshw-size);height:var(--dshw-size);pointer-events:none;-webkit-user-select:none;user-select:none;touch-action:none;transition:transform .45s cubic-bezier(.34,1.4,.64,1),left .3s ease,top .3s ease}
+.dshadb-whale.dshadb-whale-dragging{transition:none}
+.dshadb-whale.dshadb-whale-flip .dshadb-whale-sprite{transform:scaleX(-1)}
+.dshadb-whale-sprite{position:absolute;left:0;top:0;width:100%;height:100%;transition:transform .3s ease}
+.dshadb-whale-body{position:absolute;left:0;top:0;width:100%;height:100%;transform-origin:50% 92%;transition:transform .2s cubic-bezier(.34,1.56,.64,1);pointer-events:auto;cursor:grab;-webkit-tap-highlight-color:transparent}
+.dshadb-whale-press .dshadb-whale-body{transform:scale(1.1,.88);cursor:grabbing}
+.dshadb-whale-img{width:100%;height:100%;object-fit:contain;display:block;pointer-events:none;-webkit-user-drag:none;filter:drop-shadow(0 6px 14px rgba(0,0,0,.18))}
+.dshadb-whale-bubble{position:absolute;left:50%;bottom:calc(100% - 6px);--dshw-bdx:0px;--dshw-btx:50%;transform:translateX(calc(-50% + var(--dshw-bdx))) translateY(10px) scale(.82);transform-origin:var(--dshw-btx) 100%;opacity:0;pointer-events:none;background:#fff;border-radius:16px;padding:10px 14px;min-width:112px;max-width:min(74vw,248px);box-shadow:0 8px 28px rgba(0,0,0,.16);transition:opacity .2s ease,transform .26s cubic-bezier(.34,1.5,.64,1);z-index:2;text-align:center;box-sizing:border-box}
+.dshadb-whale-bubble::after{content:"";position:absolute;left:var(--dshw-btx);top:100%;transform:translateX(-50%);border:8px solid transparent;border-top-color:#fff}
+.dshadb-whale-bubble-on{opacity:1;transform:translateX(calc(-50% + var(--dshw-bdx))) translateY(0) scale(1)}
+/* 连点时气泡不做淡出淡入的来回, 只跟位置走 —— 避免闪烁 */
+.dshadb-whale-bubble-on.dshadb-whale-bubble-keep{transition:transform .16s ease}
+/* 气泡在上方放不下时改到下方, 尾巴翻到顶边 */
+.dshadb-whale-bubble-below{bottom:auto;top:calc(100% - 6px);transform-origin:var(--dshw-btx) 0}
+.dshadb-whale-bubble-below::after{top:auto;bottom:100%;border-top-color:transparent;border-bottom-color:#fff}
+/* 镜像只作用于鲸鱼本体, 气泡与文字保持正向 */
+.dshadb-whale-flip .dshadb-whale-bubble{transform:translateX(calc(-50% + var(--dshw-bdx))) translateY(10px) scale(.82)}
+.dshadb-whale-flip .dshadb-whale-bubble-on{transform:translateX(calc(-50% + var(--dshw-bdx))) translateY(0) scale(1)}
+.dshadb-whale-btext{display:block}
+.dshadb-whale-gif{display:none;width:100%;max-width:190px;border-radius:10px}
+.dshadb-whale-l-a{font-size:12.5px;font-weight:600;color:#3b4356;letter-spacing:.02em;line-height:1.4;white-space:nowrap}
+.dshadb-whale-l-b{font-size:21px;font-weight:800;color:#17181c;line-height:1.15;white-space:nowrap}
+.dshadb-whale-l-p{font-size:18px;font-weight:800;line-height:1.2;white-space:nowrap}
+.dshadb-whale-l-c{font-size:11px;font-weight:600;color:#9ca0aa;line-height:1.4;white-space:nowrap}
+.dshadb-whale-wrap{white-space:normal;word-break:break-word}
+@media (prefers-color-scheme:dark){
+.dshadb-whale-bubble{background:#262a33}.dshadb-whale-bubble::after{border-top-color:#262a33}
+.dshadb-whale-l-a{color:#d3d7e0}.dshadb-whale-l-b{color:#f2f4f8}.dshadb-whale-l-c{color:#9298a6}}`
 
       document.head.appendChild(tag);
       /* 渐进增强: 高端机 (逻辑核 >= 6) 才启用毛玻璃等特效 */
@@ -331,6 +385,17 @@ window.__ModuleLoader__.load({
       "update.done": "已更新, 重启 Web GUI 生效", "update.fail": "更新失败, 已保持原版本",
       "update.checkfail": "检查失败 (网络异常)",
       "settings.section.basic": "基础设置", "settings.section.relays": "中转站", "settings.section.models": "自定义模型",
+      "settings.section.whale": "大肥鱼",
+      "whale.enable": "收养大肥鱼", "whale.enableHint": "在屏幕边缘养一只会探头的大肥鱼（纯互动，不显示余额）",
+      "whale.scale": "身体大小", "whale.peek": "探出多少",
+      "whale.sound": "按压音效", "whale.soundSet": "音效组", "whale.volume": "音量",
+      "whale.bubble": "台词气泡", "whale.peakMode": "峰谷文案", "whale.snap": "自动靠边",
+      "whale.snapHint": "松手后吸附到最近的屏幕边缘；关掉就停在你放的位置",
+      "whale.on": "开", "whale.off": "关",
+      "whale.duck": "小黄鸭", "whale.fx1": "音效1",
+      "whale.peak.default": "默认", "whale.peak.liangwen": "梁文峰谷", "whale.peak.qiangqiang": "!?强强?!",
+      "whale.tip": "拖着大肥鱼可以在屏幕上随意移动；点一下弹全身和台词，再点一下收回。",
+      "whale.offTip": "先打开上面的「收养大肥鱼」，才能调下面这些。",
       "settings.modelName": "模型名称", "settings.apiUrl": "余额接口 URL", "settings.queryType": "解析方式",
       "settings.totalPath": "总余额字段(可选)", "settings.usedPath": "已用字段(可选)",
       "settings.modelHint": "填你的余额接口(返回 JSON)，可选填 API Key 与字段路径，如 data.balance",
@@ -367,6 +432,17 @@ window.__ModuleLoader__.load({
       "update.done": "Updated. Restart Web GUI to apply", "update.fail": "Update failed, version unchanged",
       "update.checkfail": "Check failed (network)",
       "settings.section.basic": "Basic", "settings.section.relays": "Relays", "settings.section.models": "Custom Models",
+      "settings.section.whale": "Whale",
+      "whale.enable": "Adopt Big Whale", "whale.enableHint": "Keep a peeking whale on the screen edge (interactive only)",
+      "whale.scale": "Body size", "whale.peek": "Peek amount",
+      "whale.sound": "Press sound", "whale.soundSet": "Sound set", "whale.volume": "Volume",
+      "whale.bubble": "Speech bubble", "whale.peakMode": "Peak wording", "whale.snap": "Snap to edge",
+      "whale.snapHint": "Snaps to the nearest edge on release; turn off to keep it where you drop it",
+      "whale.on": "On", "whale.off": "Off",
+      "whale.duck": "Duck", "whale.fx1": "FX 1",
+      "whale.peak.default": "Default", "whale.peak.liangwen": "Liangwen", "whale.peak.qiangqiang": "!?Qiang?!",
+      "whale.tip": "Drag the whale anywhere on screen; tap once for full body and a line, tap again to tuck it back.",
+      "whale.offTip": "Turn on \"Adopt Big Whale\" above to edit these.",
       "settings.modelName": "Model name", "settings.apiUrl": "Balance API URL", "settings.queryType": "Parse type",
       "settings.totalPath": "Total field (opt)", "settings.usedPath": "Used field (opt)",
       "settings.modelHint": "A JSON endpoint for your balance; optional API key & field paths like data.balance",
@@ -407,7 +483,9 @@ window.__ModuleLoader__.load({
           const changed = JSON.stringify(newBalances) !== JSON.stringify(oldBalances) || snapshot.status !== "ok";
           const nextFetchedAt = data.fetchedAt || Date.now();
           if (!changed) {
-            snapshot = { ...snapshot, fetchedAt: nextFetchedAt, isRefreshing: false };
+            // v1.1.0: config 必须始终跟随最新响应 —— 旧写法在余额未变时保留旧 config,
+            // 导致设置里改完开关(如 whaleEnabled)后前端永远读不到新值, 表现为"开了又变回关"
+            snapshot = { ...snapshot, config: data.config || snapshot.config, fetchedAt: nextFetchedAt, isRefreshing: false };
           } else {
             snapshot = { status: "ok", balances: newBalances, config: data.config || snapshot.config, fetchedAt: nextFetchedAt, isRefreshing: false };
           }
@@ -929,6 +1007,12 @@ window.__ModuleLoader__.load({
       const [warn, setWarn] = react.useState(10);
       const [currency, setCurrency] = react.useState("CNY");
       const [refreshSec, setRefreshSec] = react.useState(5);
+      const [whaleOn, setWhaleOn] = react.useState(!!(config && config.whaleEnabled));
+      // v1.1.0: 大肥鱼细项 (独立页签, 走 /api-dashboard/whale/settings, 与看板主配置分开)
+      const [wf, setWf] = react.useState({
+        scale: 1, peekRatio: 0.5, soundOn: true, soundSet: "duck",
+        volume: 0.5, bubbleOn: true, peakMode: "default", snapOn: true,
+      });
       const [form, setForm] = react.useState({ name: "", baseUrl: "", apiKey: "", queryType: "auto" });
       const [mform, setMform] = react.useState({ name: "", apiUrl: "", apiKey: "", queryType: "auto", totalPath: "", usedPath: "", currency: "" });
       const [loading, setLoading] = react.useState(false);
@@ -982,6 +1066,7 @@ window.__ModuleLoader__.load({
         setWarn(config?.warnThreshold ?? 10);
         setCurrency(config?.currency ?? "CNY");
         setRefreshSec(Math.round((config?.clientPollIntervalMs || 5000) / 1000) || 5);
+        setWhaleOn(!!(config && config.whaleEnabled));
         let cancelled = false;
         fetch("/api-dashboard/config", { cache: "no-store" }).then(r => r.json()).then(d => {
           if (cancelled) return;
@@ -989,8 +1074,24 @@ window.__ModuleLoader__.load({
             setRelays(d.customRelays || []);
             setModels(d.customModels || []);
             if (d.refreshIntervalSec) setRefreshSec(d.refreshIntervalSec);
+            if (typeof d.whaleEnabled === "boolean") setWhaleOn(d.whaleEnabled);
           }
         }).finally(() => { if (!cancelled) setLoading(false); });
+        // 大肥鱼细项与主配置并行拉取, 失败保持默认值
+        fetch("/api-dashboard/whale/settings", { cache: "no-store" }).then(r => r.json()).then(d => {
+          if (cancelled || !d || !d.ok || !d.settings) return;
+          const s = d.settings;
+          setWf(prev => ({
+            scale: typeof s.scale === "number" ? s.scale : prev.scale,
+            peekRatio: typeof s.peekRatio === "number" ? s.peekRatio : prev.peekRatio,
+            soundOn: typeof s.soundOn === "boolean" ? s.soundOn : prev.soundOn,
+            soundSet: s.soundSet || prev.soundSet,
+            volume: typeof s.volume === "number" ? s.volume : prev.volume,
+            bubbleOn: typeof s.bubbleOn === "boolean" ? s.bubbleOn : prev.bubbleOn,
+            peakMode: s.peakMode || prev.peakMode,
+            snapOn: typeof s.snapOn === "boolean" ? s.snapOn : prev.snapOn,
+          }));
+        }).catch(() => {});
         return () => { cancelled = true; };
       }, [isOpen]);
       if (!isOpen) return null;
@@ -1001,7 +1102,12 @@ window.__ModuleLoader__.load({
             customRelays: relays, customModels: models,
             safeThreshold: Number(safe), warnThreshold: Number(warn), currency,
             refreshIntervalSec: Math.min(Math.max(Number(refreshSec) || 5, 5), 60),
+            whaleEnabled: !!whaleOn,
           }) });
+          // v1.1.0: 保存后立刻强拉一次, 让开关类设置(大肥鱼)即时生效, 不必等下一轮轮询
+          try { await store.forceRefresh(); } catch (e) { /* 忽略 */ }
+          // 双保险: 快照万一没及时更新, 也按用户刚保存的值直接挂载/卸载 (两处均幂等)
+          if (whaleOn) ensureWhaleWidget(); else removeWhaleWidget();
           onClose();
         } finally { setSaving(false); }
       };
@@ -1017,13 +1123,39 @@ window.__ModuleLoader__.load({
         setMform({ name: "", apiUrl: "", apiKey: "", queryType: "auto", totalPath: "", usedPath: "", currency: "" });
       };
       const removeModel = (id) => setModels(models.filter(m => m.id !== id));
+      // v1.1.0 修复: 开关类设置即时保存 —— 不能要求用户必须点「保存并生效」,
+      // 否则拨完开关直接返回/关闭就丢了, 表现为"开了又变回关"
+      const toggleWhale = async (next) => {
+        setWhaleOn(next);
+        if (next) ensureWhaleWidget(); else removeWhaleWidget();
+        try {
+          await fetch("/api-dashboard/config", {
+            method: "POST", headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ whaleEnabled: !!next }),
+          });
+          await store.forceRefresh();
+        } catch (e) { /* 网络失败: 本地仍生效, 下次保存/刷新会对齐 */ }
+      };
       const qtLabel = (q) => t("qt." + (q || "auto"));
 
+      // v1.1.0: 大肥鱼细项即时生效 + 即时落盘 (滑块/开关都不依赖「保存并生效」按钮)
+      const patchWf = (patch) => {
+        setWf(prev => ({ ...prev, ...patch }));
+        patchWhaleWidget(patch);
+        try {
+          fetch("/api-dashboard/whale/settings", {
+            method: "PUT", headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(patch),
+          }).catch(() => {});
+        } catch (e) { /* 忽略 */ }
+      };
+
       const tab = (id, label) => react.createElement("button", { type: "button", className: "dshadb_tab" + (section === id ? " dshadb_tab_active" : ""), onClick: () => setSection(id), key: id }, label);
       const tabsNode = react.createElement("div", { className: "dshadb_tabs", key: "tabs" }, [
         tab("basic", t("settings.section.basic")),
         tab("relays", t("settings.section.relays")),
         tab("models", t("settings.section.models")),
+        tab("whale", t("settings.section.whale")),
       ]);
 
       // 基础设置: 阈值 / 币种 / 刷新间隔
@@ -1144,6 +1276,71 @@ window.__ModuleLoader__.load({
         ]) : null,
       ]);
 
+      // v1.1.0: 大肥鱼页 —— 总开关 + 全部细项, 全部即改即存, 不依赖底部保存按钮
+      const wfRow = (key, label, control, sub) => react.createElement("div", { className: "dshadb_wf_row", key }, [
+        react.createElement("div", { key: "n", style: { minWidth: 0 } }, [
+          react.createElement("span", { className: "dshadb_wf_name", key: "t" }, label),
+          sub ? react.createElement("span", { className: "dshadb_wf_sub", key: "s" }, sub) : null,
+        ]),
+        control,
+      ]);
+      const wfSlider = (key, label, valText, min, max, step, value, onCommit) =>
+        react.createElement("div", { className: "dshadb_wf_row_col", key }, [
+          react.createElement("div", { className: "dshadb_wf_head", key: "h" }, [
+            react.createElement("span", { className: "dshadb_wf_name", key: "n" }, label),
+            react.createElement("span", { className: "dshadb_wf_val", key: "v" }, valText),
+          ]),
+          react.createElement("input", {
+            className: "dshadb_wf_range", type: "range", min, max, step, value, key: "r",
+            onChange: (e) => onCommit(Number(e.target.value)),
+          }),
+        ]);
+      const wfSeg = (key, label, options, value, onPick) =>
+        wfRow(key, label, react.createElement("div", { className: "dshadb_wf_seg", key: "seg" },
+          options.map(([v, lb]) => react.createElement("button", {
+            type: "button", key: String(v),
+            className: "dshadb_wf_segbtn" + (value === v ? " dshadb_wf_segbtn_on" : ""),
+            onClick: () => onPick(v),
+          }, lb))));
+
+      const whaleSection = react.createElement("div", { className: "dshadb_settings_section", key: "s_whale" }, [
+        // 总开关 (从基础设置迁移过来); 图标用鲸鱼本体缩略图, 不用 emoji
+        react.createElement("div", { className: "dshadb_settings_row", key: "en", style: { margin: "2px 0 10px" } }, [
+          react.createElement("img", {
+            className: "dshadb_wf_avatar", src: "/api-dashboard/whale/image.png",
+            alt: "", draggable: false, key: "av",
+          }),
+          react.createElement("div", { className: "dshadb_settings_row_main", key: "m" }, [
+            react.createElement("span", { className: "dshadb_settings_row_title", key: "t" }, t("whale.enable")),
+            react.createElement("span", { className: "dshadb_settings_row_sub", key: "s" }, t("whale.enableHint")),
+          ]),
+          react.createElement(Switch, { checked: whaleOn, onChange: toggleWhale, key: "sw" }),
+        ]),
+        // 细项: 未开启时置灰不可点
+        react.createElement("div", { className: whaleOn ? "" : "dshadb_wf_disabled", key: "detail" }, [
+          !whaleOn ? react.createElement("div", { className: "dshadb_wf_tip", key: "offtip", style: { marginBottom: "8px" } }, t("whale.offTip")) : null,
+          wfSlider("scale", t("whale.scale"), Math.round(wf.scale * 100) + "%", 0.6, 2.5, 0.05, wf.scale,
+            (v) => patchWf({ scale: v })),
+          wfSlider("peek", t("whale.peek"), Math.round(wf.peekRatio * 100) + "%", 0.15, 0.9, 0.05, wf.peekRatio,
+            (v) => patchWf({ peekRatio: v })),
+          wfSeg("snap", t("whale.snap"), [[true, t("whale.on")], [false, t("whale.off")]], wf.snapOn,
+            (v) => patchWf({ snapOn: v })),
+          react.createElement("div", { className: "dshadb_wf_tip", key: "snaphint", style: { margin: "-2px 0 8px" } }, t("whale.snapHint")),
+          wfSeg("bubble", t("whale.bubble"), [[true, t("whale.on")], [false, t("whale.off")]], wf.bubbleOn,
+            (v) => patchWf({ bubbleOn: v })),
+          wfSeg("peak", t("whale.peakMode"), [
+            ["default", t("whale.peak.default")], ["liangwen", t("whale.peak.liangwen")], ["qiangqiang", t("whale.peak.qiangqiang")],
+          ], wf.peakMode, (v) => patchWf({ peakMode: v })),
+          wfSeg("sound", t("whale.sound"), [[true, t("whale.on")], [false, t("whale.off")]], wf.soundOn,
+            (v) => patchWf({ soundOn: v })),
+          wfSeg("soundset", t("whale.soundSet"), [["duck", t("whale.duck")], ["fx1", t("whale.fx1")]], wf.soundSet,
+            (v) => patchWf({ soundSet: v })),
+          wfSlider("vol", t("whale.volume"), Math.round(wf.volume * 100) + "%", 0, 1, 0.05, wf.volume,
+            (v) => patchWf({ volume: v })),
+          react.createElement("div", { className: "dshadb_wf_tip", key: "tip" }, t("whale.tip")),
+        ]),
+      ]);
+
       const output = react.createElement("div", { className: "dshadb_drawer", style: { maxHeight: "86vh" }, onClick: (e) => e.stopPropagation(), key: "drawer" }, [
         react.createElement("div", { className: "dshadb_handle", key: "handle" }, react.createElement("div", { className: "dshadb_handle_bar" })),
         react.createElement("div", { className: "dshadb_header", key: "header" }, [
@@ -1157,8 +1354,9 @@ window.__ModuleLoader__.load({
         ]),
         react.createElement("div", { className: "dshadb_body", key: "body" }, [
           tabsNode,
-          section === "basic" ? basicSection : section === "relays" ? relaySection : modelSection,
-          react.createElement("button", { type: "button", className: "dshadb_add_btn", onClick: save, disabled: saving, key: "save", style: { width: "100%", borderStyle: "solid", background: "#17181c", color: "#fff", borderColor: "#17181c" } }, saving ? t("refreshing") : t("settings.save")),
+          section === "basic" ? basicSection : section === "relays" ? relaySection : section === "whale" ? whaleSection : modelSection,
+          // 大肥鱼页全部即改即存, 不需要保存按钮
+          section === "whale" ? null : react.createElement("button", { type: "button", className: "dshadb_add_btn", onClick: save, disabled: saving, key: "save", style: { width: "100%", borderStyle: "solid", background: "#17181c", color: "#fff", borderColor: "#17181c" } }, saving ? t("refreshing") : t("settings.save")),
           // v0.6.0: 版本与更新区块
           react.createElement("div", { key: "upd", style: { marginTop: "12px", paddingTop: "10px", borderTop: "1px solid #e7e8ec" } }, [
             react.createElement("div", { style: { fontSize: "11px", fontWeight: "700", color: "#777b84", marginBottom: "8px" }, key: "upd_t" }, t("update.title")),
@@ -1182,6 +1380,472 @@ window.__ModuleLoader__.load({
     }
     //#endregion
 
+    //#region 大肥鱼互动挂件 (v1.1.0)
+    // 移植自 MeteorNOX/DeepSeek-Balance-Whale-Widget (MIT License, Copyright (c) 2026 MeteorNOX)
+    // 保留原版全部互动能力: 拖拽 / 四边吸附 / 左吸附镜像 / 按压Q弹 / 音效 / 随机台词 / 汉堡菜单;
+    // 去掉的只有余额与消耗显示 (那部分由输入框下方的看板负责)。
+    function Switch({ checked, onChange }) {
+      return react.createElement("button", {
+        type: "button", role: "switch", "aria-checked": !!checked,
+        className: "dshadb_switch" + (checked ? " dshadb_switch_on" : ""),
+        onClick: () => onChange(!checked), style: { marginLeft: "auto" },
+      }, react.createElement("span", { className: "dshadb_switch_knob" }));
+    }
+
+    var WHALE_DEFAULTS = {
+      scale: 1, soundOn: true, soundSet: "duck", volume: 0.5, bubbleOn: true,
+      peakMode: "default", snapOn: true, peekRatio: 0.5, left: null, top: null, side: "right",
+    };
+    var whaleCtxInfo = { isPeak: false };
+    function updateWhaleContext(info) {
+      whaleCtxInfo = { isPeak: !!(info && info.isPeak) };
+      if (whaleWidget && whaleWidget.onContext) whaleWidget.onContext();
+    }
+    function whalePeakWords(peakMode, isPeak) {
+      if (peakMode === "liangwen") return isPeak ? "梁文峰" : "梁文谷";
+      if (peakMode === "qiangqiang") return isPeak ? "!?峰峰?!" : "!?谷谷?!";
+      return isPeak ? "高峰时段" : "空闲时段";
+    }
+    function whalePickOne(arr) { return arr[Math.floor(Math.random() * arr.length)]; }
+    // 台词组: [权重, 生成函数] —— 生成 {gif:true} 或 [{t,s,c}] 三行 (s: A小字 / B大字 / P峰谷 / C灰注)
+    var WHALE_GROUPS = [
+      [40, function (st) {
+        var isPeak = !!whaleCtxInfo.isPeak;
+        return [
+          { t: "当前时间段为:", s: "A" },
+          { t: whalePeakWords(st.peakMode, isPeak), s: "P", c: isPeak ? "#e0433f" : "#2fa24c" },
+          { t: isPeak ? "09:00~12:00 / 14:00~18:00" : "其余时段 / 周末全天", s: "C" },
+        ];
+      }],
+      [10, function () { return { gif: true }; }],
+      [8, function () { return [null, { t: whalePickOne(["好模型... ↓", "好女孩...↓"]), s: "B" }, null]; }],
+      [8, function () {
+        return [null, { t: whalePickOne([
+          "不知道用户有什么用，先赶走吧~", "我...我...我也要挣钱吗？", "我去吃饭啦，测完叫我",
+          "压力一只蓝色大肥鱼？！", "DeepSleep...", "坏了...用户彻底怒了！",
+          "摸头摸头~ 再摸摸嘛", "尾巴被你拖到墙角啦", "偷看你打代码半天啦",
+        ]), s: "A", w: true }, null]; }],
+      [4, function () {
+        return [null, { t: whalePickOne([
+          "你目录里的dsh是什么...大烧货吗...?", "恭喜你实现token自由！token全跑了！", "真当我是便宜货啊...",
+        ]), s: "A", w: true }, null]; }],
+      [2, function () { return [{ t: "这个", s: "A" }, { t: "凶", s: "B" }, { t: "是什么意思呀...", s: "A" }]; }],
+      [1, function () { return [null, { t: "哦鲸鲸... ", s: "B" }, null]; }],
+    ];
+    function whalePickLines(st) {
+      var total = 0, i;
+      for (i = 0; i < WHALE_GROUPS.length; i++) total += WHALE_GROUPS[i][0];
+      var r = Math.random() * total;
+      for (i = 0; i < WHALE_GROUPS.length; i++) { r -= WHALE_GROUPS[i][0]; if (r < 0) return WHALE_GROUPS[i][1](st); }
+      return WHALE_GROUPS[0][1](st);
+    }
+
+    var whaleWidget = null;
+    // 停止互动后多久缩回 / 气泡存活时长 (用户要求: 3 秒)
+    var WHALE_IDLE_MS = 3000;
+    // 左右「边缘带」占屏宽比例: 松手时中心落在带内才吸附缩回, 中间区域原地不动
+    var WHALE_EDGE_ZONE = 0.22;
+    // 贴边时横向要拉开多少 (占鲸鱼宽比例) 才脱离边轨、转为自由拖拽并展开
+    var WHALE_RAIL_BREAK = 0.42;
+    // 连点节流: 间隔小于此值只续命不换台词 (换词会重建气泡, 连点时会闪没)
+    var WHALE_LINE_MIN_MS = 420;
+    function ensureWhaleWidget() {
+      if (whaleWidget) return;
+      if (typeof document === "undefined") return;
+      var st = {};
+      for (var k in WHALE_DEFAULTS) st[k] = WHALE_DEFAULTS[k];
+
+      // ---------- DOM ----------
+      var root = document.createElement("div");
+      root.className = "dshadb-whale";
+      var sprite = document.createElement("div");
+      sprite.className = "dshadb-whale-sprite";
+      var body = document.createElement("div");
+      body.className = "dshadb-whale-body";
+      var img = document.createElement("img");
+      img.className = "dshadb-whale-img";
+      img.src = "/api-dashboard/whale/image.png";
+      img.alt = "大肥鱼"; img.draggable = false;
+      body.appendChild(img);
+      sprite.appendChild(body);
+      var bubble = document.createElement("div");
+      bubble.className = "dshadb-whale-bubble";
+      var bText = document.createElement("div");
+      bText.className = "dshadb-whale-btext";
+      var gif = document.createElement("img");
+      gif.className = "dshadb-whale-gif";
+      gif.src = "/api-dashboard/whale/rua.gif";
+      gif.alt = ""; gif.draggable = false;
+      var gifBroken = false;
+      gif.addEventListener("error", function () { gifBroken = true; });
+      bubble.appendChild(gif);
+      bubble.appendChild(bText);
+      root.appendChild(bubble);
+      root.appendChild(sprite);
+      document.body.appendChild(root);
+
+      // ---------- 音效 ----------
+      var audio = { press: null, release: null };
+      function reloadAudio() {
+        audio.press = new Audio("/api-dashboard/whale/sound/press.mp3?set=" + st.soundSet);
+        audio.release = new Audio("/api-dashboard/whale/sound/release.mp3?set=" + st.soundSet);
+        audio.press.volume = st.volume; audio.release.volume = st.volume;
+      }
+      reloadAudio();
+      function playSound(which) {
+        if (!st.soundOn || st.volume <= 0) return;
+        var a = audio[which]; if (!a) return;
+        try { a.volume = st.volume; a.currentTime = 0; var p = a.play(); if (p && p.catch) p.catch(function () {}); } catch (e) {}
+      }
+
+      // ---------- 状态 ----------
+      var full = false;          // 是否整只露出
+      var bubbleOpen = false;
+      var hideTimer = null, bubbleTimer = null, saveTimer = null;
+      var drag = null;
+      var lastLineAt = 0;        // 上次换台词的时刻 (连点节流用)
+
+      function sizePx() { return root.getBoundingClientRect().width || 120; }
+      function vw() { return window.innerWidth || document.documentElement.clientWidth; }
+      function vh() { return window.innerHeight || document.documentElement.clientHeight; }
+
+      function applyScale() { root.style.setProperty("--dshw-scale", String(st.scale)); }
+
+      /** 把 state 的位置写进 left/top; 探头位移交给 transform, 所以这里一律夹在屏幕内 */
+      function applyPos() {
+        var s = sizePx();
+        if (st.left === null || st.top === null) {
+          st.left = Math.max(0, vw() - s);
+          st.top = Math.round(vh() * 0.62);
+        }
+        st.left = Math.min(Math.max(st.left, 0), Math.max(0, vw() - s));
+        st.top = Math.min(Math.max(st.top, 0), Math.max(0, vh() - s));
+        root.style.left = st.left + "px";
+        root.style.top = st.top + "px";
+      }
+
+      /** 探头位移: 只有吸在左右两侧时才把身子推出屏幕; 中间自由摆放时整只显示 */
+      function applyPeek() {
+        if (full || !st.side) { root.style.transform = "translate(0px, 0px)"; return; }
+        var s = sizePx();
+        var out = Math.round(s * (1 - st.peekRatio));
+        var dx = st.side === "left" ? -out : st.side === "right" ? out : 0;
+        root.style.transform = "translate(" + dx + "px, 0px)";
+      }
+      function applyFlip() {
+        if (st.side === "left") root.classList.add("dshadb-whale-flip");
+        else root.classList.remove("dshadb-whale-flip");
+      }
+      function applyAll() { applyScale(); applyPos(); applyFlip(); applyPeek(); }
+
+      // ---------- 持久化 ----------
+      function saveSoon() {
+        if (saveTimer) clearTimeout(saveTimer);
+        saveTimer = setTimeout(function () {
+          saveTimer = null;
+          try {
+            fetch("/api-dashboard/whale/settings", {
+              method: "PUT", headers: { "Content-Type": "application/json" },
+              body: JSON.stringify({
+                scale: st.scale, soundOn: st.soundOn, soundSet: st.soundSet, volume: st.volume,
+                bubbleOn: st.bubbleOn, peakMode: st.peakMode, snapOn: st.snapOn,
+                peekRatio: st.peekRatio, left: st.left, top: st.top, side: st.side,
+              }),
+            }).catch(function () {});
+          } catch (e) {}
+        }, 400);
+      }
+
+      // ---------- 气泡 ----------
+      var STYLE_CLASS = { A: "dshadb-whale-l-a", B: "dshadb-whale-l-b", P: "dshadb-whale-l-p", C: "dshadb-whale-l-c" };
+      function renderLines(lines) {
+        bText.textContent = "";
+        if (lines && lines.gif && !gifBroken) { gif.style.display = "block"; bText.style.display = "none"; return; }
+        gif.style.display = "none"; bText.style.display = "block";
+        var arr = (lines && lines.gif) ? [null, { t: "动图跑掉了...", s: "A", w: true }, null] : lines;
+        for (var i = 0; i < arr.length; i++) {
+          var ln = arr[i]; if (!ln) continue;
+          var el = document.createElement("div");
+          el.className = STYLE_CLASS[ln.s] || STYLE_CLASS.A;
+          if (ln.w) el.className += " dshadb-whale-wrap";
+          if (ln.c) el.style.color = ln.c;
+          el.textContent = ln.t;
+          bText.appendChild(el);
+        }
+      }
+      /**
+       * 鲸鱼的「目标」位置 —— 不用 getBoundingClientRect。
+       * 探头/展开是 0.45s transform 过渡, 点击瞬间读实时 rect 拿到的是过渡中的中间态,
+       * 气泡会按旧位置算避让, 连点时越算越偏, 最后整个飘到屏幕外 = 看着"不显示"。
+       */
+      function targetRect() {
+        var s = sizePx();
+        var dx = 0;
+        if (!full && st.side) {
+          var out = Math.round(s * (1 - st.peekRatio));
+          dx = st.side === "left" ? -out : st.side === "right" ? out : 0;
+        }
+        return { left: st.left + dx, top: st.top, size: s };
+      }
+      /**
+       * 把气泡摆到不出屏的位置:
+       * 1) 水平方向整体平移, 保证左右都留 8px 边距 (贴边时不会有一半在屏幕外)
+       * 2) 尾巴单独定位, 仍然指向鲸鱼中心
+       * 3) 上方空间不够时翻到鲸鱼下方
+       */
+      function placeBubble() {
+        var margin = 8;
+        bubble.classList.remove("dshadb-whale-bubble-below");
+        bubble.style.setProperty("--dshw-bdx", "0px");
+        bubble.style.setProperty("--dshw-btx", "50%");
+        var r = targetRect();
+        var bw = bubble.offsetWidth, bh = bubble.offsetHeight;
+        if (!bw) return;
+        var cx = r.left + r.size / 2;
+        var want = cx - bw / 2;
+        var shift = 0;
+        if (want < margin) shift = margin - want;
+        else if (want + bw > vw() - margin) shift = (vw() - margin) - (want + bw);
+        bubble.style.setProperty("--dshw-bdx", Math.round(shift) + "px");
+        var tail = bw / 2 - shift;
+        tail = Math.min(Math.max(tail, 18), bw - 18);
+        bubble.style.setProperty("--dshw-btx", Math.round(tail) + "px");
+        if (r.top - bh - 6 < margin) bubble.classList.add("dshadb-whale-bubble-below");
+      }
+      function openBubble() {
+        if (!st.bubbleOn) return;
+        renderLines(whalePickLines(st));
+        bubble.classList.remove("dshadb-whale-bubble-keep");
+        bubble.classList.add("dshadb-whale-bubble-on");
+        bubbleOpen = true;
+        placeBubble();
+        if (bubbleTimer) clearTimeout(bubbleTimer);
+        bubbleTimer = setTimeout(closeBubble, WHALE_IDLE_MS);
+      }
+      /**
+       * 连点续命: 保持当前台词不变, 只把气泡留住并重新计时。
+       * 连点时不重建内容 —— 重建会让气泡宽度反复跳变、重新测量, 视觉上就是闪一下没了。
+       */
+      function keepBubble() {
+        if (!st.bubbleOn) return;
+        if (!bubbleOpen) { openBubble(); return; }
+        bubble.classList.add("dshadb-whale-bubble-on");
+        bubble.classList.add("dshadb-whale-bubble-keep");
+        placeBubble();
+        if (bubbleTimer) clearTimeout(bubbleTimer);
+        bubbleTimer = setTimeout(closeBubble, WHALE_IDLE_MS);
+      }
+      function closeBubble() {
+        bubble.classList.remove("dshadb-whale-bubble-on");
+        bubble.classList.remove("dshadb-whale-bubble-keep");
+        bubbleOpen = false;
+        if (bubbleTimer) { clearTimeout(bubbleTimer); bubbleTimer = null; }
+      }
+
+      // ---------- 探头 / 全身 ----------
+      function toFull() {
+        full = true; applyPeek();
+        lastLineAt = Date.now();
+        openBubble();
+        playSound("press");
+        armHide();
+      }
+      function toPeek() {
+        full = false; applyPeek();
+        closeBubble();
+        // 只在真的会缩回边缘时才播收回音 (停在屏幕中间时不缩, 也就不该有动静)
+        if (st.side) playSound("release");
+        if (hideTimer) { clearTimeout(hideTimer); hideTimer = null; }
+      }
+      /** 停手 WHALE_IDLE_MS 后自动缩回; 每次互动都重新计时 */
+      function armHide() {
+        if (hideTimer) clearTimeout(hideTimer);
+        hideTimer = setTimeout(function () { hideTimer = null; if (full) toPeek(); }, WHALE_IDLE_MS);
+      }
+
+      // ---------- 吸附 ----------
+      /**
+       * 松手后的落位: 只有拖到左右两侧的「边缘带」里才吸附 + 探头,
+       * 停在屏幕中间就整只留在原地 (side="" → applyPeek 不做位移)。
+       */
+      function settle() {
+        var s = sizePx();
+        var W = vw(), H = vh();
+        if (!st.snapOn) {
+          st.side = "";
+          applyPos(); applyFlip(); applyPeek(); saveSoon();
+          return;
+        }
+        var cx = st.left + s / 2;
+        var zone = Math.max(s * 0.75, W * WHALE_EDGE_ZONE);   // 边缘带宽度
+        if (cx <= zone) { st.side = "left"; st.left = 0; }
+        else if (cx >= W - zone) { st.side = "right"; st.left = W - s; }
+        else { st.side = ""; }                                 // 屏幕中间: 不缩
+        // 纵向永远不缩, 只是别跑出屏幕
+        st.top = Math.min(Math.max(st.top, 0), Math.max(0, H - s));
+        applyPos(); applyFlip(); applyPeek(); saveSoon();
+      }
+
+      // ---------- 拖拽 ----------
+      function onDown(e) {
+        if (hideTimer) { clearTimeout(hideTimer); hideTimer = null; }
+        drag = {
+          id: e.pointerId, sx: e.clientX, sy: e.clientY,
+          ox: st.left, oy: st.top, moved: false,
+          // 起手时贴着哪一侧: 贴边状态下的纵向滑动算「沿边轨道滑」, 不展开
+          rail: full ? "" : st.side, freed: false,
+        };
+        root.classList.add("dshadb-whale-dragging");
+        root.classList.add("dshadb-whale-press");
+        try { body.setPointerCapture(e.pointerId); } catch (err) {}
+        playSound("press");
+      }
+      function onMove(e) {
+        if (!drag || e.pointerId !== drag.id) return;
+        var dx = e.clientX - drag.sx, dy = e.clientY - drag.sy;
+        if (!drag.moved && dx * dx + dy * dy < 9) return;
+        drag.moved = true;
+        // 沿边纵向滑动: 横向没拉开就保持探头姿态, 只上下移动
+        if (drag.rail && !drag.freed) {
+          var breakOut = Math.abs(dx) > Math.max(28, sizePx() * WHALE_RAIL_BREAK);
+          if (!breakOut) {
+            st.top = drag.oy + dy;
+            applyPos();          // 夹在屏幕内并写回 top
+            applyPeek();         // 维持探头位移, 不展开
+            e.preventDefault();
+            return;
+          }
+          drag.freed = true;     // 横向拉开了 → 转为自由拖拽
+        }
+        if (!full) {
+          full = true;                    // 拖动时整只跟手, 不再半隐
+          root.style.transform = "translate(0px, 0px)";
+          closeBubble();
+        }
+        st.left = drag.ox + dx; st.top = drag.oy + dy;
+        root.style.left = st.left + "px";
+        root.style.top = st.top + "px";
+        e.preventDefault();
+      }
+      function onUp(e) {
+        if (!drag || e.pointerId !== drag.id) return;
+        var moved = drag.moved;
+        var railed = !!drag.rail && !drag.freed;
+        drag = null;
+        root.classList.remove("dshadb-whale-dragging");
+        root.classList.remove("dshadb-whale-press");
+        try { body.releasePointerCapture(e.pointerId); } catch (err) {}
+        if (moved) {
+          // 沿边滑完仍是探头状态: 只记住新高度, 不吸附动画也不展开
+          if (railed) { saveSoon(); return; }
+          settle(); armHide(); return;
+        }
+        // 没移动 = 点击: 弹全身 / 换台词, 但绝不立刻收回 —— 一律等停手 3 秒
+        playSound("release");
+        if (!full) { toFull(); return; }
+        // 连点节流: 间隔太短只续命不换词, 避免气泡反复重建导致"看不到"
+        var now = Date.now();
+        if (now - lastLineAt < WHALE_LINE_MIN_MS) { keepBubble(); armHide(); return; }
+        lastLineAt = now;
+        openBubble();
+        armHide();
+      }
+      body.addEventListener("pointerdown", onDown);
+      body.addEventListener("pointermove", onMove);
+      body.addEventListener("pointerup", onUp);
+      body.addEventListener("pointercancel", onUp);
+
+      // ---------- 外部设置接口 ----------
+      // 设置面板「大肥鱼」页改动后调用: 立刻应用到当前挂件并落盘
+      function applyPatch(patch) {
+        var soundTouched = false;
+        for (var key in patch) {
+          if (!Object.prototype.hasOwnProperty.call(patch, key)) continue;
+          if (patch[key] === undefined) continue;
+          st[key] = patch[key];
+          if (key === "soundSet") soundTouched = true;
+          if (key === "volume" || key === "soundOn") soundTouched = true;
+        }
+        if (soundTouched) {
+          if (patch.soundSet !== undefined) reloadAudio();
+          if (audio.press) audio.press.volume = st.volume;
+          if (audio.release) audio.release.volume = st.volume;
+        }
+        if (patch.bubbleOn === false) closeBubble();
+        if (patch.snapOn !== undefined) {
+          if (st.snapOn) { settle(); return; }
+          st.side = "";
+        }
+        applyAll();
+        if (bubbleOpen) placeBubble();
+        saveSoon();
+      }
+
+      // ---------- 全局监听 ----------
+      var onDocDown = function (e) {
+        if (root.contains(e.target)) return;
+        if (full && !drag) toPeek();
+      };
+      document.addEventListener("pointerdown", onDocDown);
+      var onResize = function () {
+        applyPos();
+        if (st.snapOn && st.side) settle(); else applyPeek();
+        if (bubbleOpen) placeBubble();
+      };
+      window.addEventListener("resize", onResize);
+      var onVis = function () {
+        if (document.hidden) { if (hideTimer) { clearTimeout(hideTimer); hideTimer = null; } }
+        else if (full) armHide();
+      };
+      document.addEventListener("visibilitychange", onVis);
+
+      whaleWidget = {
+        root: root,
+        applyPatch: applyPatch,
+        getState: function () {
+          var out = {};
+          for (var k in st) out[k] = st[k];
+          return out;
+        },
+        onContext: function () { /* 峰谷变化下次开泡时自动取用 */ },
+        dispose: function () {
+          body.removeEventListener("pointerdown", onDown);
+          body.removeEventListener("pointermove", onMove);
+          body.removeEventListener("pointerup", onUp);
+          body.removeEventListener("pointercancel", onUp);
+          document.removeEventListener("pointerdown", onDocDown);
+          document.removeEventListener("visibilitychange", onVis);
+          window.removeEventListener("resize", onResize);
+          if (hideTimer) clearTimeout(hideTimer);
+          if (bubbleTimer) clearTimeout(bubbleTimer);
+          if (saveTimer) clearTimeout(saveTimer);
+          if (root.parentNode) root.parentNode.removeChild(root);
+          whaleWidget = null;
+        },
+      };
+
+      // ---------- 拉取已存设置 ----------
+      applyAll();
+      fetch("/api-dashboard/whale/settings", { cache: "no-store" })
+        .then(function (r) { return r.json(); })
+        .then(function (d) {
+          if (!d || !d.ok || !d.settings) return;
+          for (var key in WHALE_DEFAULTS) {
+            if (d.settings[key] !== undefined && d.settings[key] !== null) st[key] = d.settings[key];
+          }
+          if (d.settings.left !== undefined) st.left = d.settings.left;
+          if (d.settings.top !== undefined) st.top = d.settings.top;
+          applyAll();
+        })
+        .catch(function () {});
+    }
+    function removeWhaleWidget() { if (whaleWidget) whaleWidget.dispose(); }
+    /** 设置面板改动后推给活着的挂件 (未挂载时静默忽略, 值已由端点落盘) */
+    function patchWhaleWidget(patch) {
+      if (whaleWidget && whaleWidget.applyPatch) whaleWidget.applyPatch(patch);
+    }
+    //#endregion
+
     //#region plugin
     const inject = ["slots", "locale", "modelDirectories"];
     function apply(ctx) {
@@ -1220,6 +1884,18 @@ window.__ModuleLoader__.load({
           const dashData = react.useSyncExternalStore(store.subscribe, store.getSnapshot, store.getSnapshot);
           const config = dashData.config;
 
+          // v1.1.0: 大肥鱼互动挂件 — 设置里开启「收养大肥鱼」后挂载/卸载 (纯互动, 不含余额)
+          const whaleOn = !!(config && config.whaleEnabled);
+          react.useEffect(() => {
+            if (!whaleOn) { removeWhaleWidget(); return; }
+            ensureWhaleWidget();
+            return removeWhaleWidget;
+          }, [whaleOn]);
+          // 峰谷时段变化同步给挂件 (台词里的「当前时间段」用它, 不涉及任何金额)
+          react.useEffect(() => {
+            updateWhaleContext({ isPeak: !!(config && config.isPeak) });
+          }, [config && config.isPeak]);
+
           const handleSelect = (id) => { setSelected(id); setSelectedId(id); };
 
           // v0.5.15: 按模型名切到对应平台的核心逻辑 (两条信号共用)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-api-dashboard",
-  "version": "1.0.2",
+  "version": "1.1.2",
   "description": "多平台 API 余额/用量看板插件：官方真实品牌图标，三层 UI 直接在输入框下方显示当前选中平台余额与估算消耗，点开底部抽屉切换所有平台；支持国内外平台与自定义中转站自动探测余额（查不到标未开放）；自定义安全/预警阈值，余额告警提醒；进入页面自动刷新",
   "keywords": [
     "dsh",

package/src/index.js

@@ -441,6 +441,19 @@ export const Config = Schema.object({
     cacheMiss: Schema.number().min(0).default(1),
     output: Schema.number().min(0).default(2),
   }).default({}),
+  /** 收养大肥鱼: 屏幕侧边互动宠物挂件 (v1.1.0, 纯互动不含余额, 移植自 MeteorNOX/DeepSeek-Balance-Whale-Widget, MIT) */
+  whaleEnabled: Schema.boolean().default(false),
+  /** 大肥鱼挂件设置: 大小/音效/音量/气泡/峰谷文案/吸附/位置记忆 */
+  whaleSettings: Schema.object({
+    scale: Schema.number().min(0.6).max(2.5).default(1),
+    soundOn: Schema.boolean().default(true),
+    soundSet: Schema.string().default('duck'),
+    volume: Schema.number().min(0).max(1).default(0.5),
+    bubbleOn: Schema.boolean().default(true),
+    peakMode: Schema.string().default('default'),
+    snapOn: Schema.boolean().default(true),
+    peekRatio: Schema.number().min(0.15).max(0.9).default(0.5),
+  }).default({}),
 })
 
 // ============================================================
@@ -953,6 +966,13 @@ export function apply(ctx, config) {
     currency: persisted.currency ?? config.currency ?? 'CNY',
     safeThreshold: persisted.safeThreshold ?? config.safeThreshold ?? 50,
     warnThreshold: persisted.warnThreshold ?? config.warnThreshold ?? 10,
+    whaleEnabled: persisted.whaleEnabled ?? config.whaleEnabled ?? false,
+    whaleSettings: {
+      scale: 1, soundOn: true, soundSet: 'duck', volume: 0.5, bubbleOn: true,
+      peakMode: 'default', snapOn: true, peekRatio: 0.5, left: null, top: null, side: 'right',
+      ...(config.whaleSettings ?? {}),
+      ...(persisted.whaleSettings ?? {}),
+    },
   }
 
   const getConfig = () => runtimeConfig
@@ -1036,6 +1056,7 @@ export function apply(ctx, config) {
           currency: runtimeConfig.currency,
           isPeak: isPeakTime(),
           isWeekend: isWeekend(),
+          whaleEnabled: !!runtimeConfig.whaleEnabled,
         },
       }
       // A3: 告警检测
@@ -1178,6 +1199,110 @@ export function apply(ctx, config) {
       },
     }), 'dsh-api-dashboard: icon route')
 
+    // v1.1.0: 大肥鱼互动挂件资产 (移植自 MeteorNOX/DeepSeek-Balance-Whale-Widget, MIT License)
+    const WHALE_ASSET_ROOT = join(SELF_ROOT, 'assets', 'whale')
+    const whaleAsset = (name) => join(WHALE_ASSET_ROOT, name)
+    let whaleImgCache = null
+    webCtx.effect(() => webCtx.webServer.register({
+      kind: 'exact', path: '/api-dashboard/whale/image.png',
+      async handler(req, res) {
+        if (req.method !== 'GET') { res.writeHead(405, { Allow: 'GET' }); res.end(); return }
+        try {
+          if (!whaleImgCache) whaleImgCache = readFileSync(whaleAsset('DSniang1.png'))
+          res.writeHead(200, {
+            'Content-Type': 'image/png',
+            'Cache-Control': 'public, max-age=86400',
+            'Content-Length': whaleImgCache.length,
+          })
+          res.end(whaleImgCache)
+        } catch { res.writeHead(404); res.end() }
+      },
+    }), 'dsh-api-dashboard: whale image route')
+    // rua.gif (随机台词动图)
+    let whaleGifCache = null
+    webCtx.effect(() => webCtx.webServer.register({
+      kind: 'exact', path: '/api-dashboard/whale/rua.gif',
+      async handler(req, res) {
+        if (req.method !== 'GET') { res.writeHead(405, { Allow: 'GET' }); res.end(); return }
+        try {
+          if (!whaleGifCache) whaleGifCache = readFileSync(whaleAsset('rua.gif'))
+          res.writeHead(200, {
+            'Content-Type': 'image/gif',
+            'Cache-Control': 'public, max-age=86400',
+            'Content-Length': whaleGifCache.length,
+          })
+          res.end(whaleGifCache)
+        } catch { res.writeHead(404); res.end() }
+      },
+    }), 'dsh-api-dashboard: whale gif route')
+    // 音效 (每请求读盘 + no-store, 更换音频即生效; ?set=duck|fx1 选音效组)
+    for (const kind of ['press', 'release']) {
+      webCtx.effect(() => webCtx.webServer.register({
+        kind: 'exact', path: `/api-dashboard/whale/sound/${kind}.mp3`,
+        async handler(req, res) {
+          if (req.method !== 'GET') { res.writeHead(405, { Allow: 'GET' }); res.end(); return }
+          try {
+            const set = new URL(req.url ?? '/', 'http://127.0.0.1').searchParams.get('set') === 'fx1' ? 'fx1' : 'duck'
+            const table = { duck: { press: 'Ya1.mp3', release: 'Ya2.mp3' }, fx1: { press: 'D1.mp3', release: 'D2.mp3' } }
+            const data = readFileSync(whaleAsset(table[set][kind]))
+            res.writeHead(200, {
+              'Content-Type': 'audio/mpeg',
+              'Cache-Control': 'no-store',
+              'Content-Length': data.length,
+            })
+            res.end(data)
+          } catch { res.writeHead(404); res.end() }
+        },
+      }), `dsh-api-dashboard: whale sound ${kind} route`)
+    }
+
+    // v1.1.0: 大肥鱼挂件设置 (大小/音效/音量/气泡/峰谷文案/吸附/位置) —— 独立轻量端点,
+    // 与看板主配置分开, 滑块拖动等高频写入不触发余额刷新
+    webCtx.effect(() => webCtx.webServer.register({
+      kind: 'exact', path: '/api-dashboard/whale/settings',
+      async handler(req, res) {
+        if (req.method === 'GET') { sendJson(res, 200, { ok: true, settings: runtimeConfig.whaleSettings }); return }
+        if (req.method === 'PUT' || req.method === 'POST') {
+          try {
+            let raw = ''
+            for await (const chunk of req) { raw += chunk }
+            const body = raw ? JSON.parse(raw) : {}
+            const cur = runtimeConfig.whaleSettings
+            const num = (v, lo, hi, dflt) => (typeof v === 'number' && Number.isFinite(v) ? Math.min(Math.max(v, lo), hi) : dflt)
+            runtimeConfig.whaleSettings = {
+              scale: num(body.scale, 0.6, 2.5, cur.scale),
+              soundOn: typeof body.soundOn === 'boolean' ? body.soundOn : cur.soundOn,
+              soundSet: body.soundSet === 'fx1' ? 'fx1' : (body.soundSet === 'duck' ? 'duck' : cur.soundSet),
+              volume: num(body.volume, 0, 1, cur.volume),
+              bubbleOn: typeof body.bubbleOn === 'boolean' ? body.bubbleOn : cur.bubbleOn,
+              peakMode: ['default', 'liangwen', 'qiangqiang'].includes(body.peakMode) ? body.peakMode : cur.peakMode,
+              snapOn: typeof body.snapOn === 'boolean' ? body.snapOn : cur.snapOn,
+              peekRatio: num(body.peekRatio, 0.15, 0.9, cur.peekRatio),
+              left: typeof body.left === 'number' && Number.isFinite(body.left) ? body.left : cur.left,
+              top: typeof body.top === 'number' && Number.isFinite(body.top) ? body.top : cur.top,
+              // v1.1.0: 只保留左右吸附 (上下不再缩回); '' = 停在屏幕中间不缩
+              side: ['left', 'right', ''].includes(body.side) ? body.side : cur.side,
+            }
+            savePersistedState({
+              refreshIntervalMs: runtimeConfig.refreshIntervalMs,
+              clientPollIntervalMs: runtimeConfig.clientPollIntervalMs,
+              timeoutMs: runtimeConfig.timeoutMs,
+              customRelays: runtimeConfig.customRelays,
+              customModels: runtimeConfig.customModels,
+              currency: runtimeConfig.currency,
+              safeThreshold: runtimeConfig.safeThreshold,
+              warnThreshold: runtimeConfig.warnThreshold,
+              whaleEnabled: runtimeConfig.whaleEnabled,
+              whaleSettings: runtimeConfig.whaleSettings,
+            })
+            sendJson(res, 200, { ok: true, settings: runtimeConfig.whaleSettings })
+          } catch (err) { sendJson(res, 400, { ok: false, error: err instanceof Error ? err.message : String(err) }) }
+          return
+        }
+        res.writeHead(405, { Allow: 'GET, PUT, POST' }); res.end()
+      },
+    }), 'dsh-api-dashboard: whale settings route')
+
     webCtx.effect(() => webCtx.webServer.register({
       kind: 'exact', path: '/api-dashboard/config',
       async handler(req, res) {
@@ -1188,6 +1313,7 @@ export function apply(ctx, config) {
             customModels: runtimeConfig.customModels.map(m => ({ ...m, apiKey: m.apiKey ? '***' : '' })),
             presets: runtimeConfig.presets,
             refreshIntervalSec: Math.round(runtimeConfig.refreshIntervalMs / 1000),
+            whaleEnabled: !!runtimeConfig.whaleEnabled,
           })
           return
         }
@@ -1226,6 +1352,8 @@ export function apply(ctx, config) {
             if (typeof body.safeThreshold === 'number' && body.safeThreshold >= 0) runtimeConfig.safeThreshold = body.safeThreshold
             if (typeof body.warnThreshold === 'number' && body.warnThreshold >= 0) runtimeConfig.warnThreshold = body.warnThreshold
             if (typeof body.currency === 'string' && body.currency.trim()) runtimeConfig.currency = body.currency.trim().toUpperCase()
+            // v1.1.0: 收养大肥鱼开关
+            if (typeof body.whaleEnabled === 'boolean') runtimeConfig.whaleEnabled = body.whaleEnabled
             // 持久化: 写入状态文件, 重启后恢复 (用户配置优先)
             savePersistedState({
               refreshIntervalMs: runtimeConfig.refreshIntervalMs,
@@ -1236,6 +1364,7 @@ export function apply(ctx, config) {
               currency: runtimeConfig.currency,
               safeThreshold: runtimeConfig.safeThreshold,
               warnThreshold: runtimeConfig.warnThreshold,
+              whaleEnabled: runtimeConfig.whaleEnabled,
             })
             resetLoop(); await refreshAll()
             sendJson(res, 200, {
@@ -1243,6 +1372,7 @@ export function apply(ctx, config) {
               customRelays: runtimeConfig.customRelays.map(r => ({ ...r, apiKey: r.apiKey ? '***' : '' })),
               customModels: runtimeConfig.customModels.map(m => ({ ...m, apiKey: m.apiKey ? '***' : '' })),
               refreshIntervalSec: Math.round(runtimeConfig.refreshIntervalMs / 1000),
+              whaleEnabled: !!runtimeConfig.whaleEnabled,
             })
           } catch (err) { sendJson(res, 400, { ok: false, error: err instanceof Error ? err.message : String(err) }) }
           return