DSH界面住进一只记账鲸鱼：DeepSeek余额挂件深度解析

这是一个为DeepSeek Harness（DSH）Web界面打造的常驻桌面宠物式挂件，在界面右下角养一只QQ弹弹的小鲸鱼，实时盯盘DeepSeek账户余额、今日消费与每轮对话开销。它支持拖拽吸附、左吸附镜像翻转、数字滚动动画，泡泡内容完全可自定义，且作为标准DSH bundle插件可一键安装，无需任何会话令牌。项目同时提供Codex桌面端分支，两条产品线独立维护，是开发者工具中少见的兼具实用性与趣味性的记账伴侣。

适用人群：1. 高频使用DeepSeek API进行开发的个人开发者与小型团队，需要实时掌握账户余额与消费节奏；2. 使用DSH Web界面或Codex桌面应用的重度用户，希望在不打断工作流的前提下监控API开销；3. 对桌面宠物、悬浮挂件类趣味工具感兴趣，同时有记账需求的技术爱好者。

适用场景：1. 日常开发中长时间挂着DSH界面，通过小鲸鱼随时查看余额是否充足，避免因余额耗尽导致API调用中断；2. 调试或批量跑任务时，通过每轮对话消耗泡泡和今日已用统计，快速定位token消耗异常，优化提示词与调用策略；3. 峰谷定价时段（工作日高峰与空闲、周末全天谷价）进行成本敏感型任务调度，借助峰谷模块倒计时选择更划算的调用窗口。

推荐理由：它把枯燥的API余额查询变成了一只住在界面角落的鲸鱼娘，实用与趣味兼得。60秒自动刷新、数字滚动动画、每轮真实usage换算、峰谷定价提示、90天明细归档，功能密度远超普通挂件。标准DSH插件一键安装、无需令牌，两条分支覆盖Web与Codex桌面端，值得每一位DeepSeek开发者尝试。

项目定位与背景

DeepSeek Harness（DSH）是DeepSeek官方推出的开发工作台，开发者在其Web界面中进行模型调用、会话管理与调试。但官方界面并未提供直观的余额监控与消费统计入口，用户往往需要跳转到platform页面手动查询，既打断心流，也难以感知每轮对话的真实成本。DeepSeek-Balance-Whale-Widget正是在这一背景下诞生：它把自己定位为DSH界面右下角的常驻挂件，用一只小鲸鱼气泡图承载余额、今日已用、每轮消耗三类核心数据，让记账这件事从被动查询变成主动陪伴。项目目前获得3269颗星、121次fork，说明开发者对这类轻量级、高频率使用的工具存在真实需求。

核心功能与技术架构

项目以JavaScript编写，作为标准DSH bundle插件发布，可通过dsh plugin --profile web add dsh-whale-widget一键安装，无需任何会话令牌。核心能力分为记账与交互两大块。记账侧，余额支持60秒自动刷新与点击手动刷新，余额变化时数字滚动动画，网络抖动时沿用最近余额不报错；取数方式有两种，优先使用DSH凭据中的DEEPSEEK_API_KEY，若用户通过设置中的账号与余额登录了DeepSeek账号且未配置API key，则自动使用登录态，省去去platform建key的步骤。今日已用采用小鲸鱼记账机制，余额下降按观测累计为消费，余额上升单独记录不冲掉已有消费，并支持余额校正；逐轮明细保留90天或最多2万条，逐日归档保留365天，金额按8位小数记账、显示保留两位。每轮对话消耗则监听DSH本机会话事件，按模型真实usage（input、cache、output、reasoning tokens）换算金额并弹出消耗泡泡，泡泡内容模块化可自定义，金额用{cost}引用。峰谷定价模块覆盖工作日高峰9:00-12:00、14:00-18:00，其余空闲，2026-08-23起周末全天谷价，支持状态文字、倒计时与多种样式。用量记录窗口提供今日、近7天、全部记录、模型占比条、按日期展开明细、按日期或模型名搜索，模型名带友好标注。交互侧，拖拽与四边吸附区可自定义，贴左吸附时整体水平镜像翻转且文字同步反向，按压有Q弹玩偶效果，主菜单涵盖角色、大小滑块、音效与提示、气泡开关、避让滚动条、资源管理等，音效与提示设置分按压音效、每轮消耗提示、提问提示、授权提示四个入口行，入口行上直接显示总开关与当前值摘要。

创新点与亮点

第一，双取数方式与零令牌设计降低了使用门槛，API key与账号登录态二选一，用户不必为了看余额而额外创建key。第二，每轮对话消耗基于真实usage换算，而非估算，配合泡泡自定义与自动关闭秒数，把成本反馈嵌入到每一次模型调用之后，形成即时闭环。第三，峰谷定价模块把DeepSeek的时段计费规则可视化，倒计时与状态文字帮助用户选择更划算的调用窗口，这是同类挂件中少见的成本优化视角。第四，交互细节丰富，左吸附镜像翻转、按压Q弹、数字滚动、避让滚动条，让工具具备桌面宠物般的陪伴感，而非冷冰冰的仪表盘。第五，分支策略清晰，main分支服务DSH Web，For-Codex分支服务Codex桌面应用，两条产品线独立维护、互不兼容，README中用表格明确指引用户按场景选择，避免了安装混淆。

与同类项目对比

常见的API余额监控工具多为独立网页、浏览器扩展或CLI脚本，需要用户主动打开或定时运行，缺乏与开发界面的融合。部分桌面挂件类项目虽然常驻，但功能单一，只显示余额数字，不提供消费明细、峰谷提示与每轮成本反馈。DeepSeek-Balance-Whale-Widget的差异在于三点：一是深度绑定DSH插件体系，随界面自动启用，安装与卸载走标准dsh plugin命令；二是记账粒度细，从余额、今日已用到每轮对话，覆盖宏观与微观；三是把趣味交互当作一等公民，鲸鱼角色、音效、泡泡自定义让监控行为具备可持续性。相比通用型系统监控工具，它专注DeepSeek账户口径，数据来源与计价规则更贴合实际。

上手指南或快速开始

若使用DSH Web界面，推荐执行dsh plugin --profile web add dsh-whale-widget安装npm已发布版；也可从仓库安装，但那样装的是main当前状态、不跟随已发布版本。两种方式二选一，别混用，若已用github方式安装想换npm名，先执行dsh plugin --profile web remove dsh-whale-widget。若使用官方桌面客户端（Electron），不能用--profile web，CLI也拒绝--profile desktop，需在桌面端会话里让DSH自己安装。若使用Codex桌面应用，则切换到For-Codex分支，解压api-balance-whale到%USERPROFILE%\plugins\api-balance-whale，再按分支内安装说明注册计划任务。安装后，点击鲸鱼可手动刷新余额，通过主菜单调整角色、大小、音效与提示、吸附设置，并在小鲸鱼记账中配置余额预警、今日预算与余额校正。

总结与展望

DeepSeek-Balance-Whale-Widget用一只小鲸鱼把API记账这件小事做出了温度与深度。它在功能上覆盖余额、消费、峰谷、明细四个维度，在交互上兼顾吸附、翻转、音效与自定义，在工程上以标准DSH插件形态交付，安装门槛低。客观来看，其局限在于强绑定DSH与Codex生态，无法脱离这两个宿主独立运行；两条分支互不兼容也意味着用户需要先明确自己的使用场景。未来若能在更多IDE或编辑器宿主中提供适配，或增加团队共享账本、消费告警推送等能力，其价值边界将进一步扩大。对于DeepSeek开发者而言，这是一个值得放进工具箱的小而美项目。

查看 GitHub 项目 →