MeteorNOX/DeepSeek-Balance-Whale-Widget

解决的问题

该项目为 DeepSeek Harness (DSH) Web 界面用户提供了一个视觉化的余额追踪器。通过集成一个持久、交互式的「鲸鱼」小部件，实时显示余额和支出统计数据，解决了用户必须手动检查 API 使用情况和成本的问题。

工作原理

该小部件作为 DSH Web 界面的插件运行。它使用 DEEPSEEK_API_KEY 获取当前余额，并通过两种不同方式追踪每日使用情况：一种是基于余额下降计算消费的本地「记账」模式，另一种是使用平台会话令牌从 DeepSeek 平台拉取精确使用数据的「令牌」模式。它还监听本地会话事件，以计算并显示每次对话回合的精确成本。

适用人群

希望在不离开聊天界面的情况下，以便捷、非侵入性的方式监控 API 余额和每日支出的 DeepSeek Harness (DSH) 用户。

主要亮点

• 实时追踪：每 60 秒自动刷新余额，并带有平滑的滚动动画。
• 双模式使用：提供零配置的本地追踪模式和高精度的基于令牌的模式。
• 逐回合计费：在每次对话回合结束后立即显示该回合的精确成本。
• 交互式界面：支持拖拽、边缘吸附的可自定义大小的小部件，配有音效和随机对话气泡。
• 安装简便：标准 DSH 包插件，可通过 dsh plugin 命令安装。