DeepSeek Monitor：macOS 菜单栏查看 DeepSeek API 余额与 Token 消耗

DeepSeek Monitor 是一款 macOS 菜单栏应用，用于监控 DeepSeek V4 Flash / Pro 的账户余额、Token 用量和消费情况。当前最新版本为 v1.4.3。

如果你经常用 DeepSeek API 跑脚本、做自动化任务，或者把它接进自己的工具里，最烦的往往不是调用本身，而是用量不好盯。余额还剩多少、今天烧了多少 Token、最近几天有没有突然变贵，都要回到网页后台里看。偶尔用一次还好，天天调接口的人就会觉得麻烦。

DeepSeek Monitor 就是把这些余额和用量数据搬到 macOS 菜单栏，平时挂在系统菜单栏里，需要时点开看一眼。它还支持原生 WidgetKit 桌面小组件，不用打开应用就能看到关键数据。

简单来说：DeepSeek Monitor 是一个基于 Swift + SwiftUI 开发的 macOS 原生应用。填入 DeepSeek API Key 后，可以查看账户余额、今日消耗、本月消费、V4 Flash / Pro 用量和 7 日 Token 趋势。它更适合高频调用 DeepSeek API、需要关注调用成本的开发者。

功能一览

和每次去官网查账相比，这种常驻菜单栏的小工具最大的好处就是直观。它的核心功能包含以下几个维度：

菜单栏主面板：展示账户余额、账户可用状态、今日消耗、本月消费、V4 Flash / Pro 用量和 7 日 Token 趋势。
原生 WidgetKit 桌面小组件：中号 macOS 小组件，使用玻璃风格 UI，展示余额、日/月消费和模型费用入口。
模型详情侧页：点击 V4 Flash 或 V4 Pro 后打开与主页等宽等高的侧页，查看每日 Token 和请求次数图表。
小组件深链操作：点击小组件内的模型行会直接打开对应模型详情侧页，不会先弹出完整主页。
用量导入兜底：当官方用量接口不可用时，可手动导入 DeepSeek Usage CSV/ZIP，或使用监听目录自动导入。
自动用量导出：可选 WKWebView 自动化，在 DeepSeek Platform 页面触发用量导出。
刷新间隔设置：支持 30 秒、60 秒、2 分钟、5 分钟自动刷新。
开机自启：可选注册 macOS 登录项，登录后自动启动应用并保持小组件数据更新。
本地缓存：应用重启后立即显示上次数据，避免白屏。
本地优先：API Key、用量缓存和小组件快照都保存在这台 Mac 上。

安装方式

通过 DMG 安装

从 GitHub Releases 页面下载最新版 DMG，将 DeepSeekMonitor.app 拖入 /Applications 即可。

安装新版本后，建议从 /Applications 打开一次应用，让 macOS 注册 WidgetKit 扩展并刷新共享的小组件数据。

从源码构建

环境要求：macOS 14+，支持 M 系列 Mac 和可升级到 macOS 14+ 的 Intel Mac，需要 Xcode 或 Xcode Command Line Tools。

bash

git clone https://github.com/JayHome137/DeepSeekMonitor.git
cd DeepSeekMonitor

# 从 SVG 重新生成 AppIcon.icns（可选）
./build.sh icon

# 构建签名 release app 和 DMG
./build.sh release

# 构建、打包并打开
./build.sh restart

使用流程

将 DeepSeekMonitor.app 安装到 /Applications
打开应用并点击菜单栏 DeepSeek 图标
进入设置，粘贴 DeepSeek API Key，点击"验证并保存"
如需使用 macOS 桌面小组件，开启"原生小组件数据"
在 macOS 小组件选择界面添加 DeepSeek Monitor 小组件
如果账户无法使用 DeepSeek /v1/usage 接口，可以在设置里导入 CSV/ZIP 用量文件，或启用自动导出辅助功能

数据存储与隐私

DeepSeek Monitor 的数据全部存储在本地：

API Key：~/Library/Preferences/com.deepseek.monitor.plist
主面板缓存：cached_dashboard / cached_usage_history
原生小组件 App Group：N5YV5FV235.group.com.deepseek.monitor
自动导入目录：~/Library/Application Support/DeepSeekMonitor/usage-sync/

不包含分析、遥测或第三方追踪，所有数据只保存在这台 Mac 上。

技术栈

Swift 5.9+
SwiftUI + AppKit + WidgetKit
Foundation URLSession
WKWebView 自动化
UserDefaults + App Group shared defaults
Shell 构建脚本：图标、签名、release 构建、DMG 打包

适合哪些人

如果你只是偶尔在网页端使用 DeepSeek，或者很少调用 API，就没必要专门安装一个桌面监控工具。

DeepSeek Monitor 更适合已经充值并且高频调用 DeepSeek API 的独立开发者、站长、AI 工具作者，或者需要定期查看调用成本的小团队。对于开放接口给项目或团队使用的人，偶尔看一眼趋势图，也能更早发现异常消耗。

同类工具里，如果你更常用 Claude Code，可以看之前整理过的 Agent Battery：Claude Code 用量监控的 Mac 状态栏小工具。一个偏 macOS 菜单栏，一个偏 Mac 状态栏，本质上都是帮开发者把 AI 工具用量变得更直观。

本文基于项目 README 与 v1.4.3 版本信息整理，实际功能以 GitHub Releases 为准。DeepSeek Monitor 并非 DeepSeek 官方产品，使用前建议先阅读项目说明与免责声明。

项目链接

GitHub 仓库：JayHome137/DeepSeekMonitor — 查看完整开源代码、运行原理以及使用教程。
Releases 下载页：DeepSeek Monitor Releases — 直接下载最新版的 DMG 安装包。