MeteorNOX/DeepSeek-Balance-Whale-Widget
DeepSeek Harness（DSH）一只住在 DSH 界面右下角的小鲸鱼娘，帮你盯着DeepSeek账户余额。QQ弹弹，支持拖拽吸附、左吸附翻转、数字滚动动画，随界面自动启用，建议直接喊来你的dsh安装
DeepSeek 余额鲸鱼挂件（DSH 小鲸鱼记账挂件）
一个 DeepSeek Harness (DSH) 的插件，位于 DSH Web 界面的右下角（也适用于官方 Electron 桌面客户端）。它显示您的 DeepSeek 账户余额、今日支出、每轮成本，并让您自定义显示信息的小“鲸鱼”气泡。
功能
- 实时余额显示 – 每 60 秒（或点击时）使用
DEEPSEEK_API_KEY或已登录的 DSH 账户拉取当前 DeepSeek 余额。 - “小鲸鱼记账” – 跟踪余额变化以计算 今日使用量，无需额外 token。充值/赠送等增加项单独记录，并可手动核对。
- 每轮成本气泡 – 每次模型回合后，挂件显示一个气泡，包含根据精确 token 使用量（输入、缓存、输出、推理）计算出的货币成本。气泡文本完全可自定义。
- 峰谷定价 – 自动应用 DeepSeek 工作日的峰值费率（9-12 和 14-18 CST）和低谷费率（自 2026-08-23 起周末均为低谷）。
- 使用历史窗口 – 查看今日支出、最近 7 天或完整记录，支持按模型细分和可搜索条目。
- 丰富的 UI 交互 – 拖放定位、边缘吸附、左侧吸附时镜像翻转、长按“玩具”动画以及全屏设置菜单。
- 模块化气泡系统 – 气泡由模块行（文本、链接、随机句子、图片/GIF、余额占位符、模型名称等）构建。模块可保存到库中并重复使用。
- 自定义提醒 – 低余额警告和每日预算提醒，内容可编辑（包括图片/随机句子）。
- 音频反馈 – 按下/释放声音、任务结束提示音、问题/授权提示音，每个都有独立的音量控制和自定义音频片段库。
- 多供应商 API 支持 – 除 DeepSeek 外，您还可以添加其他提供商（OpenRouter、Kimi、StepFun、兼容 OpenAI 的网关等），并跟踪其余额、配额和每 token 定价。UI 自动为每个模型创建余额和配额占位符。
重要性
对于重度 LLM 用户，关注基于 token 的支出对于避免意外费用至关重要。此挂件将原本隐藏的 API 密钥驱动的记账转化为一个可视化、交互式的仪表板，直接嵌入 DSH 界面，无需额外 token 或外部服务。它还允许高级用户编写自定义气泡消息并集成数十个其他 AI 提供商。
安装（Web 配置文件）
# 推荐：安装已发布的 npm 包
dsh plugin --profile web add dsh-whale-widget
# 或直接从 GitHub 安装
# dsh plugin --profile web add github:MeteorNOX/DeepSeek-Balance-Whale-Widget
如果您已有本地副本或 zip 文件，请使用 README 中描述的 link: 或 file: 语法。
桌面（Electron）客户端 – 挂件是同一个包，但必须从正在运行的 DSH 桌面会话中使用内置的 plugin_manager 安装（CLI 的 --profile web 标志不适用于桌面配置文件）。
基本用法
- 安装后，重启 DSH 主机（或退出并重启桌面客户端）并刷新浏览器。
- 鲸鱼图标出现在右下角。点击它可：
- 手动刷新余额。
- 打开 主菜单，您可以在其中调整大小、位置、音频组，并启用/禁用各个提醒。
- 打开 音效与提示 → 全局设置 下的 “每轮消耗提示” 以编辑每轮成本气泡模板（使用
{cost}占位符）。 - 使用 “自定义泡泡” 窗口构建自定义气泡序列，添加随机句子、图片或余额占位符。
- 从菜单访问 使用窗口 以查看每日/每周总计并按模型名称筛选。
可扩展性
- 气泡模块 – 创建可重复使用的行（文本、随机句子、图片/GIF、余额占位符）并存储在模块库中。
- 自定义提供商 – 在 小鲸鱼记账 → 模型 中添加新模型，并选择 34 个内置供应商模板之一，或选择 自定义 HTTP 指向任何端点。您还可以为自托管网关启用“允许向自定义地址发送凭据”标志。
- 音频库 – 导入您自己的
.wav/.mp3剪辑，在应用内裁剪，并将其分配给四个事件组（按下、回合成本、提问、授权）中的任意一个。 - 定位 – 配置边缘吸附值（百分比或像素），并开启/关闭左侧吸附的镜像。
为什么重要
对于重度 LLM 用户，密切关注基于 token 的支出对于避免意外费用至关重要。此挂件将原本隐藏的 API 密钥驱动的记账转化为一个可视化、交互式的仪表板，直接位于 DSH 界面内，无需额外 token 或外部服务。它还让高级用户能够编写自定义气泡消息并集成数十种其他 AI 提供商。
安装（Web 配置文件）
# 推荐：安装已发布的 npm 包
dsh plugin --profile web add dsh-whale-widget
# 或直接从 GitHub 安装
# dsh plugin --profile web add github:MeteorNOX/DeepSeek-Balance-Whale-Widget
如果您已有本地副本或 zip 文件，请使用 README 中描述的 link: 或 file: 语法。
桌面（Electron）客户端 – 挂件是同一个包，但必须从正在运行的 DSH 桌面会话中使用内置的 plugin_manager 安装（CLI 的 --profile web 标志不适用于桌面配置文件）。
基本用法
- 安装后，重启 DSH 主机（或退出并重启桌面客户端）并刷新浏览器。
- 鲸鱼图标出现在右下角。点击它可：
- 手动刷新余额。
- 打开 主菜单，您可以在其中调整大小、位置、音频组，并启用/禁用单个提醒。
- 打开 音效与提示 → 全局设置 下的 “每轮消耗提示” 以编辑每轮成本气泡模板（使用
{cost}占位符）。 - 使用 “自定义泡泡” 窗口构建自定义气泡序列，添加随机句子、图片或余额占位符。
- 从菜单访问 使用窗口 以查看每日/每周总计并按模型名称筛选。
可扩展性
- 气泡模块 – 创建可重复使用的行（文本、随机句子、图片/GIF、余额占位符）并存储在模块库中。
- 自定义提供商 – 在 小鲸鱼记账 → 模型 中添加新模型，并选择 34 个内置供应商模板之一，或选择 自定义 HTTP 指向任何端点。您还可以为自托管网关启用“允许向自定义地址发送凭据”标志。
- 音频库 – 导入您自己的
.wav/.mp3剪辑，在应用内裁剪，并将其分配给四个事件组（按下、回合成本、提问、授权）中的任意一个。 - 定位 – 配置边缘吸附值（百分比或像素），并开启/关闭左侧吸附的镜像。
安全说明
- API 密钥从不以明文存储；插件仅将凭据名称写入其配置，实际密钥保存在 DSH 的凭据服务中。
- 凭据仅发送到供应商模板中定义的端点。发送到自定义 URL 需要每个模型的明确用户同意。
- 所有写操作仅限于 localhost；远程主机收到
403，除非通过DSHW_ADMIN_HOSTS列入白名单。
更多信息
- 完整规范和开发者提示：
whale-widget-prompt.md - 源代码布局在 README 的 目录结构 部分描述。
- 问题、功能请求和发布在此仓库中处理（或单独的 Codex-Whale 仓库用于仅 Codex 版本）。
相关
- 项目
- 项目
- 项目
- 项目
- 项目