Skip to content
BranchesTags

Repository files navigation

MiniMax Status Bar

MiniMax Status Bar for macOS | MiniMax Token Plan Monitor | Menu Bar Quota Tracker
MiniMax 菜单栏状态栏工具（macOS）| Token Plan 用量监控 | 配额追踪

Keywords: MiniMax, MiniMax Token Plan, Status Bar, Menu Bar, macOS, OpenClaw, SwiftUI
关键词: MiniMax、Token Plan、状态栏、菜单栏、macOS、OpenClaw、SwiftUI

English | 中文
Release macOS Swift License

Light Mode Collage

Dark Mode Horizontal v1.1

v1.3.1 Release Notes / 正式版更新

English

  • Extended API key detection: openclaw.json MCP server env sections (mcp.servers.*.env.MINIMAX_API_KEY) are now scanned for Token Plan keys
  • Added ~/.openclaw/.env file support for users who store API key there
  • Added regression tests for MCP server env key resolution path

中文

  • 扩展 API Key 检测路径：支持从 openclaw.json 的 mcp.servers.*.env.MINIMAX_API_KEY 读取密钥
  • 补充 ~/.openclaw/.env 文件支持
  • 新增 MCP server 环境变量场景的回归测试

v1.3 Release Notes / 正式版更新

English

  • Migrated model display names to Chinese product labels for clarity (e.g., MiniMax-M2.7 → 文本生成, hailuo-2.3 → 视频生成 · 标准版)
  • Fixed production-level thread safety issues: NumberFormatter/DateFormatter locked, blocking shell calls moved off @MainActor
  • Fixed menu bar tooltip accumulation bug and added deduplication check
  • Eliminated duplicate API service creation logic in StatusBarController
  • Removed redundant #available checks (deployment target macOS 13.0)
  • Cleaned up dead code in APIConfigService
  • Added comprehensive regression test for all 13 display name mappings
  • All 93 unit tests pass with 0 failures

中文

  • 模型展示名称迁移为中文业务标签（如 MiniMax-M2.7 → 文本生成、hailuo-2.3 → 视频生成 · 标准版）
  • 修复多线程安全问题：NumberFormatter/DateFormer 加锁保护、阻塞 shell 调用移出 @MainActor
  • 修复菜单栏 tooltip 累积 bug，增加重复检测
  • 消除 StatusBarController 中重复的 API Service 创建逻辑
  • 删除冗余 #available 检查（部署目标已为 macOS 13.0）
  • 清理 APIConfigService 死代码
  • 补充全量 13 条 display name 映射回归测试
  • 全部 93 个单元测试通过，0 失败

English

What It Is

MiniMax Status Bar is a menu bar first utility for developers who rely on MiniMax Token Plan daily. It keeps quota status visible at a glance, without opening browser tabs or dashboards.

Why It Stands Out

  • Glanceable: menu bar percent + compact popover details.
  • Reliable semantics: remaining/consumed display matches Token Plan expectations.
  • Resilient behavior: cache fallback + retry strategy when API is unstable.
  • High interaction precision: consistent hit targets and one-click interactions.
  • Low distraction: LSUIElement app, no Dock icon, transient popover.

Feature Highlights

  • Auto API key resolution (MINIMAX_API_KEY, .env, OpenClaw config)
  • Quota grouping by modality (Text / Speech / Video / Music / Image)
  • Low-quota notification with recovery threshold reset
  • Usage history analytics (7 / 14 / 30 days)
  • In-app update check flow
  • Setup guidance for invalid/missing key states

Architecture

graph TB
    subgraph App["App Layer"]
        main["main.swift\nSingle instance guard"]
        AppDelegate["AppDelegate\nLifecycle & window entry"]
    end

    subgraph State["State Layer (single source of truth)"]
        QuotaState["QuotaState\nObservableObject\n· models\n· cachedModels\n· lastError\n· isLoading"]
        UpdateState["UpdateState\nRelease download/install state"]
    end

    subgraph Services["Service Layer"]
        APIKeyService["APIKeyResolver\nenv → .env → openclaw.json → keychain"]
        MiniMaxAPI["MiniMaxAPIService\nfetchQuota()\nrequest timeout + error mapping"]
        UpdateService["UpdateService\nGitHub Releases polling"]
        NotificationService["NotificationService\nlow-quota one-shot notify/reset"]
        LaunchAtLogin["LaunchAtLoginService\nSMAppService wrapper"]
    end

    subgraph UI["UI Layer"]
        StatusBarController["StatusBarController\n· polling timers\n· retry/backoff\n· popover lifecycle"]
        MenuContentView["MenuContentView\nNSPopover host"]
        DetailView["DetailView\n· model grouping\n· setup guidance\n· settings in-popover route"]
        SetupGuidanceView["SetupGuidanceView\nfirst-run key guidance"]
    end

    main --> AppDelegate
    AppDelegate --> StatusBarController
    StatusBarController --> APIKeyService
    StatusBarController --> MiniMaxAPI
    StatusBarController --> UpdateService
    StatusBarController --> QuotaState
    StatusBarController --> UpdateState
    StatusBarController --> NotificationService
    StatusBarController --> LaunchAtLogin
    MiniMaxAPI -->|"models[]"| QuotaState
    QuotaState -->|"@Published"| DetailView
    UpdateState -->|"@Published"| DetailView
    MenuContentView --> DetailView
    DetailView --> SetupGuidanceView

    style App fill:#f0f0f0,stroke:#999
    style State fill:#e8f4fd,stroke:#4a9eff
    style Services fill:#fff3e0,stroke:#ff9800
    style UI fill:#f3e5f5,stroke:#9c27b0
Loading

Install

  1. Download latest .dmg from Releases
  2. Drag MiniMax Status Bar.app into Applications
  3. If Gatekeeper blocks first launch:
xattr -cr "/Applications/MiniMax Status Bar.app"

Build From Source

git clone https://github.com/victor0602/minimax-status-bar.git
cd minimax-status-bar
brew install xcodegen
xcodegen generate

xcodebuild \
  -project minimax-status-bar.xcodeproj \
  -scheme minimax-status-bar \
  -configuration Debug \
  -destination 'platform=macOS' \
  build

Test

xcodebuild \
  -project minimax-status-bar.xcodeproj \
  -scheme minimax-status-bar \
  -configuration Debug \
  -destination 'platform=macOS' \
  test

License

Licensed under the MIT License.

中文

项目定位

MiniMax Status Bar 是一个面向高频 MiniMax 用户的菜单栏工具。
目标是让你在开发过程中“瞟一眼就知道配额状态”，而不是频繁打开控制台页面。

核心亮点

  • 信息高密但不干扰：菜单栏显示关键百分比，下拉面板展示细节。
  • 语义可信：剩余/已用显示与 Token Plan 语义保持一致。
  • 稳定容错：接口波动时可回退缓存并重试，避免空白状态。
  • 交互精准：统一点击热区与按钮行为，降低误触和多次点击。
  • 轻量存在感：纯菜单栏形态，无 Dock 图标，按需弹出。

主要功能

  • 自动解析 API Key（环境变量 / .env / OpenClaw 配置）
  • 按模型类型分组展示配额（文本、语音、视频、音乐、图像）
  • 低配额提醒与恢复阈值机制
  • 用量历史统计（7 / 14 / 30 天）
  • 应用内更新检测
  • 首次配置与异常状态引导

架构图

graph TB
    subgraph App["应用层"]
        main["main.swift\n单实例守卫"]
        AppDelegate["AppDelegate\n生命周期与窗口入口"]
    end

    subgraph State["状态层（单一数据源）"]
        QuotaState["QuotaState\nObservableObject\n· models\n· cachedModels\n· lastError\n· isLoading"]
        UpdateState["UpdateState\n更新下载/安装状态"]
    end

    subgraph Services["服务层"]
        APIKeyService["APIKeyResolver\nenv → .env → openclaw.json → keychain"]
        MiniMaxAPI["MiniMaxAPIService\nfetchQuota()\n请求超时与错误映射"]
        UpdateService["UpdateService\nGitHub Releases 轮询"]
        NotificationService["NotificationService\n低配额单次提醒与恢复重置"]
        LaunchAtLogin["LaunchAtLoginService\nSMAppService 封装"]
    end

    subgraph UI["界面层"]
        StatusBarController["StatusBarController\n· 轮询计时器\n· 重试/退避\n· 弹层生命周期"]
        MenuContentView["MenuContentView\nNSPopover 容器"]
        DetailView["DetailView\n· 模型分组\n· 首次引导\n· 内嵌设置路由"]
        SetupGuidanceView["SetupGuidanceView\n首次密钥引导"]
    end

    main --> AppDelegate
    AppDelegate --> StatusBarController
    StatusBarController --> APIKeyService
    StatusBarController --> MiniMaxAPI
    StatusBarController --> UpdateService
    StatusBarController --> QuotaState
    StatusBarController --> UpdateState
    StatusBarController --> NotificationService
    StatusBarController --> LaunchAtLogin
    MiniMaxAPI -->|"models[]"| QuotaState
    QuotaState -->|"@Published"| DetailView
    UpdateState -->|"@Published"| DetailView
    MenuContentView --> DetailView
    DetailView --> SetupGuidanceView

    style App fill:#f0f0f0,stroke:#999
    style State fill:#e8f4fd,stroke:#4a9eff
    style Services fill:#fff3e0,stroke:#ff9800
    style UI fill:#f3e5f5,stroke:#9c27b0
Loading

安装方式

  1. 从 Releases 下载最新 .dmg
  2. 将 MiniMax Status Bar.app 拖入“应用程序”目录
  3. 若首次启动被系统拦截，可执行：
xattr -cr "/Applications/MiniMax Status Bar.app"

本地构建

git clone https://github.com/victor0602/minimax-status-bar.git
cd minimax-status-bar
brew install xcodegen
xcodegen generate

xcodebuild \
  -project minimax-status-bar.xcodeproj \
  -scheme minimax-status-bar \
  -configuration Debug \
  -destination 'platform=macOS' \
  build

测试

xcodebuild \
  -project minimax-status-bar.xcodeproj \
  -scheme minimax-status-bar \
  -configuration Debug \
  -destination 'platform=macOS' \
  test

许可证

本项目采用 MIT License。

About

MiniMax Status Bar for macOS: menu bar token plan monitor with remaining quota, reset ETA, and OpenClaw zero-config setup.

Topics

macosmenu-barminimaxminimax-token-planopenclawstatus-barswiftui

Resources

Readme
MIT license
Activity

Stars

2 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages