Skip to content
BranchesTags

Repository files navigation

DeepSeek Platform Widget 📊

English | 中文

Real-time DeepSeek API balance, usage, and cache hit rate — on your Android home screen

screenshot

English

Features

  • ✅ Account login — email + password → Bearer Token, no manual API key
  • ✅ Balance · Today Cost · Month Cost — three-panel summary at a glance
  • ✅ Per-model breakdown — Flash / Flash Vision Exp / Pro toggle with Token, cache rate, cost, requests
  • ✅ Cache hit rate with color coding — 🟢 ≥90% · 🟡 ≥80% · 🔴 <80%
  • ✅ Timezone-aware stats — configurable usage timezone (device / Beijing / UTC)
  • ✅ Cached display — no flicker when switching apps or refreshing
  • ✅ Auto re-login — 401 triggers silent token refresh
  • ✅ Auto-refresh every 30 min — or tap to refresh instantly
  • ✅ Encrypted storage — credentials in AES-256-GCM EncryptedSharedPreferences
  • ✅ GitHub Actions — CI builds APK on every push

Widget Areas & Interaction

Area Location Action
Summary (Balance · Today · Month) Upper half Tap → Refresh
Model Detail (Token · Cache · Cost · Requests) Lower half Tap → Toggle Flash / Flash Vision Exp / Pro

The two areas are separated by a horizontal divider. Tap the top to pull fresh data from DeepSeek; tap the bottom to cycle through Flash → Flash Vision Exp → Pro model stats.

Quick Start

  1. Download APK from GitHub Actions → latest run → Artifacts
  2. Install on Android 8.0+
  3. Long press home → Add widget → DeepSeek Dashboard
  4. Login with your DeepSeek platform email + password
  5. Tap the widget and it's ready to go

Data Sources

DeepSeek Platform API endpoints, all authenticated via account login Bearer Token:

API Returns
POST /auth-api/v0/users/login Login → Bearer Token (email + password)
GET /api/v0/users/get_user_summary Balance + available token estimation
GET /api/v0/usage/by_api_key/amount?start=&end=&tz= Per-model token breakdown (epoch range + timezone)
GET /api/v0/usage/by_api_key/cost?start=&end=&tz= Per-model cost breakdown (epoch range + timezone)

Cache hit rate = cache_hit / (cache_hit + cache_miss) × 100%

📌 2026-08 platform update: usage endpoints migrated to by_api_key with start/end/tz params; summary.monthly_costs is deprecated — monthly cost/tokens are now computed from the new endpoints. API Keys are no longer accepted as Bearer on platform web APIs (use account login token). Pricing moved to peak/valley (Beijing 9:00-12:00, 14:00-18:00 peak; off-peak at half price) effective 2026-08-17.

Tech Stack

  • Language: Kotlin · Min SDK: 26 · Target SDK: 34
  • Widget: AppWidgetProvider + WorkManager
  • HTTP: OkHttp 4.12 · JSON: Gson
  • Auth: Login → Bearer Token, auto-refresh on 401
  • Encryption: AndroidX EncryptedSharedPreferences (AES-256-GCM)
  • Build: Gradle 8.2 + AGP 8.2.0 · CI: GitHub Actions

Build from Source

git clone https://github.com/MCwasd/deepseek-platform-widget.git
cd deepseek-platform-widget
./gradlew assembleDebug
# APK: app/build/outputs/apk/debug/

Debug keystore included (debug.keystore, alias debug, password android).

For release builds, add keystore.properties at project root:

storeFile=/path/to/release.keystore
storePassword=***
keyAlias=release
keyPassword=***

Project Structure

├── app/
│   └── src/main/
│       ├── java/com/tiramisu/deepseekwidget/
│       │   ├── DeepSeekWidget.kt          # AppWidgetProvider + render
│       │   ├── DeepSeekApiClient.kt       # All Platform API calls (by_api_key endpoints)
│       │   ├── DeepSeekPricing.kt         # Official pricing parser (reserved, not enabled)
│       │   ├── DeepSeekData.kt            # WidgetDisplayData + ModelData
│       │   ├── DeepSeekAccountManager.kt  # Login + token lifecycle
│       │   ├── DeepSeekWidgetConfig.kt    # Config activity (email+password + timezone)
│       │   └── WidgetUpdateWorker.kt      # WorkManager periodic update
│       └── res/
│           ├── layout/widget_layout.xml   # RemoteViews layout
│           ├── layout/config_layout.xml   # Login config UI
│           └── xml/widget_info.xml        # Widget metadata
├── build.gradle.kts
├── settings.gradle.kts
└── .github/workflows/build-apk.yml        # CI (GitHub Actions)

Privacy

  • Credentials stored locally (EncryptedSharedPreferences, AES-256-GCM)
  • All API calls go directly to platform.deepseek.com
  • No analytics, telemetry, or third-party servers

License

MIT — see LICENSE

中文

功能介绍

  • ✅ 账号登录 — 邮箱 + 密码获取 Bearer Token，无需手动填写 API Key
  • ✅ 三栏总览 — 余额 / 今日花费 / 本月累计
  • ✅ 模型详析 — Flash / Flash Vision Exp / Pro 三态切换，显示 Token 量、缓存命中率、花费、请求数
  • ✅ 缓存命中率颜色 — ≥90% 绿 · ≥80% 黄 · <80% 红
  • ✅ 时区设置 — 配置页可选设备/北京/UTC，影响今日/本月统计边界
  • ✅ 缓存显示 — 切应用不闪，刷新失败保留上次数据
  • ✅ 自动重登 — 401 过期自动用缓存密码重新登录
  • ✅ 每 30 分钟自动刷新 — 也可点击手动刷新
  • ✅ AES-256-GCM 加密存储 — 账号密码仅存手机本地
  • ✅ CI 自动构建 — 推送即自动编译 APK

交互区域说明

区域 位置 操作
上半区 — 余额 / 今日 / 本月 分割线以上 点击 → 刷新数据
下半区 — Token / 缓存率 / 开销 / 请求 分割线以下 点击 → Flash / Flash Vision Exp / Pro 循环切换

快速开始

  1. 从 GitHub Actions 下载最新 Artifact APK
  2. 安装到 Android 8.0+ 手机
  3. 长按桌面 → 小组件 → DeepSeek 仪表盘
  4. 输入 DeepSeek 平台邮箱 + 密码登录
  5. 点击小组件即可使用

数据来源

DeepSeek 平台接口，均通过账号登录 Bearer Token 认证：

接口 获取数据
auth-api/v0/users/login 登录获取 Bearer Token（邮箱+密码）
api/v0/users/get_user_summary 余额、可用 Token 估算
api/v0/usage/by_api_key/amount?start=&end=&tz= 按模型拆分 Token 明细（时间范围+时区）
api/v0/usage/by_api_key/cost?start=&end=&tz= 按模型拆分费用（时间范围+时区）

📌 2026-08 平台更新：用量接口迁移到 by_api_key（start/end/tz 参数），summary.monthly_costs 已弃用——本月费用/Token 由新接口自行汇总；平台 web 接口不再接受 API Key 作 Bearer（需账号登录 Token）。2026-08-17 起实施峰谷定价（北京时间周一至周五 9:00-12:00、14:00-18:00 高峰，其余为闲时，闲时半价）。2026-08 平台新增多模态模型 deepseek-v4-flash-vision-exp（价格与 Flash 一致），小组件下半区支持其切换与统计。

自行编译

git clone https://github.com/MCwasd/deepseek-platform-widget.git
cd deepseek-platform-widget
./gradlew assembleDebug
# APK: app/build/outputs/apk/debug/

隐私说明

密码加密存手机，请求直连 DeepSeek 服务器，无任何第三方中转。

许可证

MIT

About

Real-time DeepSeek API balance on your Android home screen

Topics

androidbalancedeepseekkotlinwidget

Resources

Readme
MIT license
Activity

Stars

2 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages