企业官网建设流程全解析

DSH小鲸鱼挂件装完不显示？7个常见问题的完整自检清单

【免费下载链接】DeepSeek-Balance-Whale-WidgetDeepSeek Harness（DSH）一只住在 DSH 界面右下角的小鲸鱼娘，帮你盯着DeepSeek账户余额。QQ弹弹，支持拖拽吸附、左吸附翻转、数字滚动动画，随界面自动启用，建议直接喊来你的dsh安装项目地址: https://gitcode.com/gh_mirrors/de/DeepSeek-Balance-Whale-Widget

DSH 小鲸鱼挂件（DeepSeek Balance Whale Widget）是住在 DeepSeek Harness（DSH）界面右下角的余额守护小助手：常驻自启，60 秒自动刷新 DeepSeek 账户余额、今日已用与每轮对话消耗，还支持拖拽吸附和自定义泡泡。但不少用户装完后发现右下角空空如也。别急，90% 的"不显示"都能靠下面这份自检清单 10 分钟定位。

🐋 先分清三类原因

"装完不显示"通常只有三类：装错了地方（profile 不匹配）、没走完生效步骤（忘了重启/硬刷新）、静默降级（资源缺失，功能悄悄失效但不报错）。下面 7 个问题按出现频率排序，从上往下查即可。

1️⃣ 桌面端用户：装错了 profile（最高发原因）

症状：官方桌面客户端（Electron）右下角什么都没有，连菜单按钮 ☰ 都没有，控制台也不报错。

原因：桌面端读的是desktopprofile，而命令行dsh plugin --profile web add ...装进去的插件落在webprofile 里，桌面窗口根本读不到。--profile desktop会被 CLI 按设计拒绝。

自检：

• 桌面端的正确装法：在客户端的会话里直接说一句"把 dsh-whale-widget 装上"，让它用自己的插件管理器安装（作用域就是当前 profile）；
• 装完先重开一次客户端再观察（有用户实测新装也需要重启才出现）。

Web 端（dsh web）不受此条影响，继续往下看。

2️⃣ 忘了重启 + 硬刷新（第二高发原因）

症状：安装命令明明成功了，刷新页面还是看不到鲸鱼。

自检：

1. 确认插件真的在配置里：dsh --profile web --dump-config，输出里能看到dsh-whale-widget；
2. 重启dsh web，再在浏览器按Ctrl+F5硬刷新（普通 F5 可能拿到旧的assets/whale-widget.js缓存）；
3. 桌面端同理：重开客户端。

改前端不生效 → 硬刷新；改宿主 lib/index.js → 必须重启dsh web。规则记牢即可。

3️⃣ 余额显示"未配置 DEEPSEEK_API_KEY"

症状：鲸鱼出来了，但余额位置报"未配置 DEEPSEEK_API_KEY"。

自检：余额有两种取数方式，API key 优先、两者互不干扰：

• 在 DSH 凭据服务里配置DEEPSEEK_API_KEY（推荐）；
• 或者用「设置 → 账号与余额」登录 DeepSeek 账号——较新 DSH 上没配 key 时会自动走账号态，不需要去 platform 建 key。

所以"没配 key"不一定是故障，先确认你的 DSH 版本是否支持账号态。

4️⃣ 没图、没声音：assets 不完整（静默降级）

症状：挂件在，但鲸鱼图片缺失、按压没音效，页面也不报任何错。

原因：资源包里的assets/文件缺失时，相关功能静默降级（无图/无声），不会弹窗。DSniang1.png 就是小鲸鱼本体图，缺了它就没脸看。

自检：确认插件目录（含package.json的那一层）里下面三个关键文件都在：

• package.json（name 应为dsh-whale-widget，带dsh.bundle.patch字段）
• lib/index.js（宿主侧插件本体）
• assets/whale-widget.js（前端挂件本体）

另外注意：用link:方式安装后不能移动/重命名源目录，移动了要重新add一次，否则资源路径断掉。

5️⃣ 保存设置报 403

症状：界面能看，但改外观/改提醒一保存就 403；或在别的机器上改配置完全不生效。

原因：0.3.15 起的安全策略——写操作只接受运行 DSH 那台机器上的本机地址（127.0.0.1/localhost），局域网或反向代理访问时"读正常、写被拒"。

自检：回到本机、用127.0.0.1:3080打开界面再改；确实需要远端管理时，用环境变量DSHW_ADMIN_HOSTS=192.0.2.10:3080显式授权那台机器。

6️⃣ 每轮消耗泡泡不弹、任务结束音不响

症状：对话结束了，没有消耗泡泡；任务跑完也没有"叮"一声。

自检：

1. 菜单 →「音效与提示」→「全局设置」，确认**「每轮消耗提示」这一行左边的 [✓] 勾上了**（右侧摘要会直接显示"已关闭"）；
2. 一轮对话必须完整结束（turn/end）才结算，别在回复中途等泡泡；
3. 想听任务结束音：展开「每轮消耗提示」区，确认「任务结束音」行左侧 [✓] 已勾选（默认音是内置A，另有 Minecraft·经验球可选，见 assets/task-end-a.wav）。

7️⃣ 装了 IDM/迅雷，每次打开 DSH 都弹"下载确认框"

症状：没动过挂件，每次打开 DSH 都被弹下载确认，目标 URL 是挂件的音效地址。

原因：IDM、迅雷、Motrix 这类下载管理器的浏览器集成，会把页面里的音效请求当成下载任务抢走。关掉挂件音效开关也消除不了——音效元素在页面初始化时就建立了。

自检：把本机地址加进管理器的站点排除列表（IDM：选项 → 文件类型/站点排除，加入127.0.0.1与localhost；其它管理器同理，关键词是"排除本机地址"）。

✅ 两条命令快速自检

按顺序执行，结果对号入座：

dsh --profile web --dump-config | Select-String -Pattern "whale"

curl http://127.0.0.1:3080/dsh-whale/balance.json

• 第一条看不到dsh-whale-widget→ 插件没装上（回到第 1 条）；
• 第二条返回401→ 路由已注册、信任栅栏在正常工作，属预期行为，不是接口坏了（不带会话凭据的裸 curl 就是会 401）；
• 第二条返回 200 JSON 且含totalBalance→ 宿主侧完全健康，问题只在浏览器缓存（Ctrl+F5）。

📁 相关资料

• 完整说明与安装方式：README.md
• 宿主侧插件本体（路由 + 记账 + 服务）：lib/index.js
• 记账内核（定点金额运算 + 余额观测/校正账本）：lib/accounting.mjs
• 前端挂件本体：assets/whale-widget.js
• 插件挂载声明：cordis.patch.yml
• 完整规格与视觉参数（面向二次开发）：whale-widget-prompt.md
• 美术素材来源说明：PROVENANCE.md

照着 7 条从上往下查，绝大多数"装完不显示"都能当场解决。实在卡住了，把dump-config结果和 curl 状态码一起反馈给维护者，效率最高。

【免费下载链接】DeepSeek-Balance-Whale-WidgetDeepSeek Harness（DSH）一只住在 DSH 界面右下角的小鲸鱼娘，帮你盯着DeepSeek账户余额。QQ弹弹，支持拖拽吸附、左吸附翻转、数字滚动动画，随界面自动启用，建议直接喊来你的dsh安装项目地址: https://gitcode.com/gh_mirrors/de/DeepSeek-Balance-Whale-Widget