小鲸鱼挂件

小鲸鱼挂件是以deepseek拟人Q版形象设计的桌宠软件，开启之后小鲸鱼挂件出现在所有软件最上层屏幕，支持拖拽吸附、左吸附翻转、数字滚动动画，松开还会自动贴到屏幕边上。填入API密钥之后，还能直接看DeepSeek的账户余额，不用反复打开网页查看。

小鲸鱼挂件使用教程

♦第一步：开启悬浮权限

首次启动点击「启动悬浮窗」→ 系统弹窗授权「显示在其他应用上层」→ 允许后小鲸鱼即刻浮现。

♦第二步：进入服务设置

轻点挂件左上角「≡」图标→ 进入「服务选项」→ 全面开放桌面定制与API管理入口。

♦第三步：绑定DeepSeek密钥

开启「API功能」→ 点击「设置API」→ 粘贴密钥→ 保存即生效；3秒后余额数值自动刷新并常驻气泡。

小鲸鱼挂件怎么开启API余额

1.开启桌宠之后，点击挂件左上角【≡】，打开功能；

2.点击【服务选项】，开放桌面定制与API管理入口；

3.将主页【API功能】右侧开关打开，点击【设置API key】；

4.之后将复制到的密钥粘贴其中，点击【保存】即可生效；

5.3秒后余额数值自动刷新，并常驻气泡。

小鲸鱼挂件用量模式使用教程

① 小鲸鱼记账（推荐，默认）—— 完全不需要额外配置

鲸鱼娘自己用余额差值记账：每次观测到余额下降就把差值累加到当天用量，跨天自动归零归档（保留 30 天）；观测币种发生变化时只重置基准、不记差值（防止多币种账户切换污染账本）。只要配好了 DEEPSEEK_API_KEY 就能用，开箱即用。

账本文件：$DSH_HOME/.dshw-usage.json（自动生成）

优点：零配置、免令牌

说明：依赖「观测到的余额下降」累计，若 DSH 关闭期间有消耗会漏记；要精确请用令牌模式

② 实时·令牌（可选）—— 需要 DEEPSEEK_PLATFORM_TOKEN

鲸鱼娘直接调用 DeepSeek 平台用量接口，按峰谷定价实时换算今日已用，精确到每小时的 token 用量。

小鲸鱼挂件常见问题

挂件不出现：确认 dsh plugin add 成功；dsh --profile web --dump-config 里能看到 dsh-whale-widget；重启 dsh web 后 F5。

图片不显示：确认 assets/DSniang1.png 在插件包内，且没有把旧文件放在 profile 里占用了同名路由。

余额报「未配置 DEEPSEEK_API_KEY」：去 DSH 配置凭据。

今日已用显示 --：记账模式下需要先跑一次余额观测（60 秒内自动完成）；令牌模式需要配置 DEEPSEEK_PLATFORM_TOKEN。

每轮消耗不显示：确认菜单「每轮对话后自动显示消耗金额」已勾选；一轮对话必须完整结束（turn/end）才会结算。

没有声音：确认 assets/*.mp3 在包内；若不想带音效文件，静默降级为无声音。

本地开发改了代码不生效：使用 link: 安装时，修改源码后重启 dsh web（ESM 模块缓存）；如果用已发布版本，需要 npm publish 新版本后 dsh plugin --profile web update dsh-whale-widget。

自定义图片：气泡由代码绘制（SVG），鲸鱼本体为 cut-out PNG，放在右下角 59.45%；换图需保证透明背景 cut-out，否则按 whale-widget-prompt.md 调整几何参数。