中文版

Main Dashboard	Settings Panel	History & Chart

DS-Fathom

DeepSeek Balance Monitor — Real-time DeepSeek API balance in your menu bar

A lightweight macOS menu bar app that displays your DeepSeek API account balance in real-time.

---

Features

• Real-time Balance — Shows total, topped-up, and granted balance directly in the menu bar
• Change Indicator — Green ↑ for increase, Red ↓ for decrease; auto-fades after 15 seconds
• Low Balance Notification — Native macOS notification fires when balance drops below a configurable threshold
• Balance History — Auto-records snapshots on every change; viewable as a line chart with adjustable time filters (1h / 5h / 1d / 1w / 1m / All)
• Custom Refresh Interval — Choose from 10s, 1min, 5min, 15min, 30min, or 1h
• Launch at Login — Starts automatically when you log in
• Keychain Security — API key is stored in macOS Keychain, never in plaintext

Requirements

• macOS 14.0+ (Sonoma)
• Apple Silicon or Intel
• A DeepSeek API key from platform.deepseek.com

Installation

Download

Download the latest DeepSeekBalance-x.x.x.dmg from the Releases page, open it, and drag DS-Fathom.app into Applications.

Build from Source

git clone https://github.com/pj-workspace/DS-Fathom.git
cd DeepSeekBalance
./build.sh
cp -r DS-Fathom.app /Applications/

Requires Xcode Command Line Tools:

xcode-select --install

First Run

1. Launch DS-Fathom.app
2. Click the menu bar icon → Settings
3. Enter your DeepSeek API key (get one at platform.deepseek.com/api_keys)
4. Click Save
5. The balance appears in your menu bar immediately

For Launch at Login to work, place the app in /Applications.

Configuration

Setting	Options / Description
API Key	Stored in macOS Keychain
Launch at Login	On / Off
Refresh Interval	10s / 1min / 5min / 15min / 30min / 1h
Low Balance Alert	Threshold (CNY) + native macOS notification

Project Structure

DS-Fathom/
├── Sources/DS-Fathom/
│   ├── DSFathomApp.swift    # @main, MenuBarExtra, dropdown views
│   ├── DeepSeekAPIService.swift    # Balance API client
│   ├── BalanceViewModel.swift      # State management & business logic
│   ├── SettingsView.swift          # Settings panel UI
│   ├── HistoryView.swift           # History chart & filterable list
│   └── KeychainHelper.swift        # macOS Keychain CRUD
├── assets/                         # README screenshots
├── build.sh                        # Build & sign script
├── Package.swift                   # SPM manifest (reference)
├── README.md
└── LICENSE

Tech Stack

• Swift 6 + SwiftUI
• MenuBarExtra — native macOS menu bar integration
• Charts framework — interactive line chart for balance history
• Security framework — Keychain access for API key storage
• ServiceManagement — Launch at login support
• UserNotifications — Low balance alerts

License

MIT License — see LICENSE.

---

Made by Jay Pan (pj-workspace)