SeekBalance

English · 简体中文

一眼看到 DeepSeek 的余额与用量。

SeekBalance 是一款 macOS 菜单栏小工具：余额、今日用量、花费估算，实时可见；还能提醒你避开高峰时段、更省钱地用 API。

下载最新版 · 功能亮点 · 截图 · 安装 · 使用前提 · 数据安全 · 卸载

截图

自动适配浅色 / 深色模式（点击图片可看大图）：

浅色模式	暗色模式

功能亮点

菜单栏一眼可见

菜单栏常驻显示余额（如 ¥7.85），不占 Dock、不弹窗打扰；余额文字可随时开关。左键弹出完整面板，右键弹出快捷菜单（刷新 / 检查更新 / 关于 / GitHub / 退出）。

时段状态与省钱提醒

• 当前时段一目了然：面板显示现在是高峰还是空闲（含时间段），并倒计时距当前时段结束还有多久；空闲剩 ≤30 分钟时倒计时变红提醒你"抓紧用"
• 高峰前提醒：可设置提前 0–60 分钟发系统通知——"高峰快到了，价格将上调"
• 花费精确计价：完全适配 DeepSeek 最新峰谷价格梯度（高峰 9:00–12:00、14:00–18:00 / 空闲价），按每次请求的实际时间精确估算

用量与花费统计

• 今日用量：请求次数、输入（未命中 + 缓存）、输出，并分开统计高峰 / 空闲时段的用量
• 累计用量与花费：输入 / 输出 / 精确花费估算
• 自动刷新：频率可选（3 / 5 / 10 分钟，默认 5），打开面板立即刷新

首次使用很简单

打开软件，在面板里直接粘贴 DeepSeek API 密钥即可——自动存入 Mac 钥匙串（系统加密），无需任何配置文件（dsh 用户可直接用现有配置）。

检查更新

面板或右键菜单点"检查更新"：自动对比 GitHub 最新版本，有新版则自动下载、安装并重启；已是最新版会弹窗提示（含上次检查时间）。

安装

1. 从 Releases 下载最新版 SeekBalance-1.1.4-arm64.dmg
2. 打开 DMG，把 SeekBalance.app 拖入"应用程序"
3. 首次打开若提示"无法验证开发者"：右键 → 打开 → 再点"打开"
4. DMG 内附带"卸载SeekBalance"一键卸载程序

源码编译

需要 macOS 13+ 和 Swift 5.9+：

cd SeekBalance
SWIFTPM_CACHE_DIR=/tmp/swiftpm-cache swift build -c release
# 自检（打印一次报告后退出）：
./.build/release/SeekBalance --once

系统要求

• macOS 13+
• Apple 芯片（M1 / M2 / M3 / M4，arm64）
• zstd（brew install zstd，用于解压 dsh 会话日志，自动识别安装位置）

使用前提

依赖	说明
API 密钥	两种方式任选：① 打开软件，在面板里直接粘贴密钥（自动存入 Mac 钥匙串，系统加密）；② 或创建配置文件 ~/.dsh/.credentials.yaml，写入一行 DEEPSEEK_API_KEY: 你的密钥（dsh 用户已有此文件，直接用）。密钥只用于请求 DeepSeek 官方接口
dsh 会话记录（可选）	有 dsh 则显示今日/累计用量统计；没有则用量为空，仅余额可用

数据来源与安全说明

数据	来源	范围
余额	GET https://api.deepseek.com/user/balance（Bearer 认证）	全账户，实时准确
今日用量	本机 ~/.dsh/sessions/*/*/session.jsonl.zstd 会话日志	仅本机
累计用量	本机 ~/.dsh/storages/session_projcache.json	仅本机
花费	按每次请求的实际时间精确计价，适配最新峰谷价格	仅本机，非官方账单

• 你的 API 密钥只用于请求 DeepSeek 官方接口（api.deepseek.com），不会发送到任何第三方
• 本工具不联网上传任何统计数据，所有用量数据都来自你本地的 dsh 文件
• DeepSeek 未提供公开的用量查询接口（实测 /user/usage 等均返回 404），因此用量统计只能读取本机记录

卸载

• 用安装包内附的"卸载SeekBalance"一键卸载，或手动删除 /Applications/SeekBalance.app
• 手动卸载残留：~/Library/Preferences/local.seekbalance.plist、~/Library/Caches/local.seekbalance/ 等
• 卸载不会删除 ~/.dsh/ 数据（与 dsh 共用，请放心）

构建

• 编译：swift build -c release
• 打 DMG：hdiutil create -volname "SeekBalance" -srcfolder dmg-build -ov -format UDZO -fs HFS+ "SeekBalance-1.1.4-arm64.dmg"（dmg-build/ 内放入 .app、Applications 快捷方式、卸载程序与安装说明）

License

MIT

免责声明

本项目与 DeepSeek 官方无任何关联，为第三方社区工具。花费估算仅供参考，实际扣费请以 DeepSeek 官方账单为准。