DeepSeek-Balance-Whale-Widget 使用指南

DSH Web 界面右下角的小鲸鱼余额挂件：实时显示 DeepSeek API 余额、今日已用（差额记账或按峰谷定价），可拖拽吸附与个性化。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

— 源: plugin_wiki.wiki_content

dsh plugin --profile web add dsh-whale-widget

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

🐋 常驻自启：随 DSH Web 界面每次打开自动出现（标准 DSH bundle 插件）
💰 余额：60 秒自动刷新 + 点击鲸鱼手动刷新；余额变化时数字滚动动画；瞬时网络抖动自动沿用最近余额不报错
📊 今日已用：两种模式任选（见下），显示今日消耗金额
- 小鲸鱼记账（推荐，免令牌）：不需要任何会话令牌，鲸鱼娘每次观测余额后用余额差值自动记账（.dshw-usage.json，跨天自动归零归档）
- 实时·令牌：填入平台会话令牌后直接调用平台用量接口，按峰谷定价（空闲 9:00–12:00 与 14:00–18:00 之外 / 高峰 9–12 与 14–18 点）实时换算今日已用

— 源: plugin_wiki.readme_zh (fallback readme_raw)

需要先配置什么才能看到余额？

必须先在 DSH 凭据服务中配置 DEEPSEEK_API_KEY（DeepSeek 官方 API Key），否则余额区域会显示「未配置 DEEPSEEK_API_KEY」。

「今日已用」默认显示的是什么模式？

默认是「小鲸鱼记账」模式，不需要任何平台令牌——挂件每次观测到余额下降就把差值累加到当天用量，跨天自动归零并归档；想要精确数字可在汉堡菜单切换「实时·令牌」模式并填入 DEEPSEEK_PLATFORM_TOKEN。

拖动后挂件跑到屏幕中间怎么办？

把鲸鱼拖到屏幕左/右/上/下四边任一中点附近，松手后会自动吸附到对应边；中间区域则停留在你松手的位置。吸附到左边时整体水平翻转（文字同步反向）。

没声音怎么办？

检查 assets/Ya1.mp3、Ya2.mp3、D1.mp3、D2.mp3 是否随包发布。音频文件缺失时插件会静默降级为无声音，不会报错。

本地改了源码不生效？

ESM 模块有缓存，改完源码后需要重启 dsh web。如果用的是已发布的 npm 版本，改完需要 npm publish 升版本再 dsh plugin --profile web update dsh-whale-widget。

余额会保留多久的历史？

「小鲸鱼记账」模式下，.dshw-usage.json 最多保留最近 30 天的每日消费历史，超出后自动清理最早的记录。

网络抖动时挂件会报错吗？

不会。余额接口对网络错误和 5xx 做了 1 次重试，瞬时抖动时会沿用最近一次成功获取的余额，并把响应标记为 stale=true。

这个插件会保存我的 API Key 吗？

不会。Key 始终只从 DSH 凭据服务（ctx.credentials.resolve）读取，插件内部既不缓存也不落盘。

— 源: plugin_wiki.faq_json

— 源: plugin_wiki.compatibility_json

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则