DeepSeek Monitor

English README | 当前默认 README 为中文说明，英文版请查看 README_EN.MD。

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

需要 macOS 14 或更高版本；支持 M 系列 Mac，也支持仍可升级到 macOS 14+ 的 Intel Mac。

截图

原生 WidgetKit 小组件

菜单栏主面板	模型详情侧页

设置面板

功能

• 菜单栏主面板：展示账户余额、账户可用状态、按 UTC+0 统计的今日/本月消费、V4 Flash / Pro 用量和 7 日 Token 趋势。
• 原生 WidgetKit 桌面小组件：中号 macOS 小组件，使用玻璃风格 UI，展示余额、日/月消费和模型费用入口。
• 模型详情侧页：点击 V4 Flash 或 V4 Pro 后打开与主页等宽等高的侧页，查看每日 Token 和请求次数图表。
• 小组件深链操作：点击小组件内的模型行会直接打开对应模型详情侧页，不会先弹出完整主页。
• 用量导入兜底：当官方用量接口不可用时，可导入 DeepSeek 官方本月、近 7 日或近 30 日 Usage ZIP/CSV；官方 ZIP 会同时读取 amount.csv 和 cost.csv，保留精确费用与币种。
• 自动用量导出：可选 WKWebView 自动化，按 5 分钟、10 分钟或 30 分钟静默导出并导入本月用量；只有登录操作会显示网页窗口。
• 余额刷新设置：支持 30 秒、60 秒、2 分钟、5 分钟自动刷新账户余额。
• 开机自启：可选注册 macOS 登录项，登录后自动启动应用并保持小组件数据更新。
• 本地缓存：应用重启后立即显示上次数据，避免白屏。
• 本地优先：API Key 保存在 macOS 钥匙串，用量缓存和小组件快照只保存在这台 Mac 上。

安装

通过 Homebrew 安装

brew install --cask JayHome137/tap/deepseekmonitor

如果已经添加过 tap，也可以使用：

brew tap JayHome137/tap
brew install --cask deepseekmonitor

通过 DMG 安装

打开生成的 DMG，将 DeepSeekMonitor.app 拖入 /Applications。

安装新版本后，建议从 /Applications 打开一次应用，让 macOS 注册 WidgetKit 扩展并刷新共享的小组件数据。如果多次本地构建后小组件选择界面仍显示旧图标，重启 macOS 可以强制 WidgetKit / IconServices 重新扫描已安装的扩展。

从源码构建

环境要求：

• macOS 14+；支持 M 系列 Mac，也支持可运行 macOS 14+ 的 Intel Mac
• Xcode 或 Xcode Command Line Tools
• 用于原生 WidgetKit 扩展的 Apple Development 签名身份
• 只有在运行 ./build.sh icon 重新生成图标时才需要 librsvg

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

# 可选：从 SVG 重新生成 AppIcon.icns 和 asset catalog 图标图片
./build.sh icon

# 本地开发：构建并打开使用开发证书稳定签名的 Debug App
./build.sh run

# 在项目目录构建签名 release app 和 DMG
./build.sh release

# 构建、打包，并打开生成的 app
./build.sh restart

./build.sh run 需要 Apple Development / Mac Developer 签名身份和本地 Xcode 项目，并使用稳定签名的 Debug App，避免反复重建时触发新的钥匙串授权。./build.sh release 会递增内部 build 号，在可用时通过 Xcode 构建主应用和 WidgetSupport.appex，签名两个 bundle，在项目根目录生成 DeepSeekMonitor.app，并打包 DeepSeekMonitor-v<version>.dmg。

只针对这个项目，release 脚本还会在打包前清理旧的 DeepSeekMonitor 系统注册和 WidgetKit / Chrono 缓存，包括旧的 /Applications/DeepSeekMonitor.app 副本，以避免 WidgetKit 绑定到过期的本地构建。

使用

1. 将 DeepSeekMonitor.app 安装到 /Applications。
2. 打开应用并点击菜单栏 DeepSeek 图标。
3. 进入设置，粘贴 DeepSeek API Key，然后点击 验证并保存。
4. 如需使用 macOS 桌面小组件，开启 原生小组件数据。
5. 在 macOS 小组件选择界面添加 DeepSeek Monitor 小组件。

如果你的账户无法使用 DeepSeek /v1/usage 接口，可以在设置里优先导入官方 Usage ZIP，或启用自动导出辅助功能。用量日期按 DeepSeek 官方的 UTC+0 口径统计，网页数据可能延迟约 5 分钟。

架构

AppDelegate
  -> MenuBarManager
       -> FloatingPanel / ContentView
       -> SettingsWindowController
       -> ModelDetailWindowController
  -> DashboardViewModel
       -> DeepSeekService
            -> APIKeyStore
                 -> macOS Keychain
       -> LocalCache
            -> UserDefaults
            -> App Group snapshot
                 -> WidgetSupport TimelineProvider
                      -> WidgetViews

数据存储

• API Key：macOS 登录钥匙串（service：com.deepseek.monitor，account：deepseek-api-key）；升级时会在钥匙串写入并回读成功后删除旧的 deepseek_api_key
• 主面板缓存：cached_dashboard / cached_usage_history
• 原生小组件 App Group：N5YV5FV235.group.com.deepseek.monitor
• 小组件相关 key：widget_snapshot、native_widget_enabled
• 自动导入目录：~/Library/Application Support/DeepSeekMonitor/usage-sync/

不包含分析、遥测或第三方追踪。

技术栈

• Swift 5.9+
• SwiftUI + AppKit + WidgetKit
• Foundation URLSession
• WKWebView 自动化
• macOS Keychain + UserDefaults + App Group shared defaults
• Shell 构建脚本：图标、签名、release 构建、DMG 打包和内部 build 号更新

许可证

MIT