DSH小鲸鱼挂件装完不显示7个常见问题的完整自检清单【免费下载链接】DeepSeek-Balance-Whale-WidgetDeepSeek HarnessDSH一只住在 DSH 界面右下角的小鲸鱼娘帮你盯着DeepSeek账户余额。QQ弹弹支持拖拽吸附、左吸附翻转、数字滚动动画随界面自动启用建议直接喊来你的dsh安装项目地址: https://gitcode.com/gh_mirrors/de/DeepSeek-Balance-Whale-WidgetDSH 小鲸鱼挂件DeepSeek Balance Whale Widget是住在 DeepSeek HarnessDSH界面右下角的余额守护小助手常驻自启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️⃣ 忘了重启 硬刷新第二高发原因症状安装命令明明成功了刷新页面还是看不到鲸鱼。自检确认插件真的在配置里dsh --profile web --dump-config输出里能看到dsh-whale-widget重启dsh web再在浏览器按CtrlF5硬刷新普通 F5 可能拿到旧的assets/whale-widget.js缓存桌面端同理重开客户端。改前端不生效 → 硬刷新改宿主 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.jsonname 应为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_HOSTS192.0.2.10:3080显式授权那台机器。6️⃣ 每轮消耗泡泡不弹、任务结束音不响症状对话结束了没有消耗泡泡任务跑完也没有叮一声。自检菜单 →「音效与提示」→「全局设置」确认**「每轮消耗提示」这一行左边的 [✓] 勾上了**右侧摘要会直接显示已关闭一轮对话必须完整结束turn/end才结算别在回复中途等泡泡想听任务结束音展开「每轮消耗提示」区确认「任务结束音」行左侧 [✓] 已勾选默认音是内置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 whalecurl http://127.0.0.1:3080/dsh-whale/balance.json第一条看不到dsh-whale-widget→ 插件没装上回到第 1 条第二条返回401→ 路由已注册、信任栅栏在正常工作属预期行为不是接口坏了不带会话凭据的裸 curl 就是会 401第二条返回 200 JSON 且含totalBalance→ 宿主侧完全健康问题只在浏览器缓存CtrlF5。 相关资料完整说明与安装方式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 HarnessDSH一只住在 DSH 界面右下角的小鲸鱼娘帮你盯着DeepSeek账户余额。QQ弹弹支持拖拽吸附、左吸附翻转、数字滚动动画随界面自动启用建议直接喊来你的dsh安装项目地址: https://gitcode.com/gh_mirrors/de/DeepSeek-Balance-Whale-Widget创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考