专为火山引擎火山方舟 (Volcengine Ark) 打造的轻量级桌面状态栏配额监控工具
实时监控 Coding Plan (个人版 / 企业版席位) 与 Agent Plan 的配额消耗及重置倒计时
- ⚡ macOS 顶部状态栏常驻指示：在菜单栏图标旁直观显示当前最重要的周度/会话配额百分比（如
⚡ 37%），一眼掌握余量。 - 🖱️ 两种用量唤起方式，按习惯二选一：
- 悬停刘海（默认）：鼠标移到屏幕顶部/右侧贴边刘海即展开，适合常驻在手边盯着看。
- 点击菜单栏图标才显示：不想让刘海常驻屏幕边缘时开启，改为点击菜单栏图标弹出用量卡片，再点一次或点到别处即收起。
- 📊 毛玻璃悬浮卡片 (Popover)：悬停刘海或点击菜单栏图标，即刻滑出 Apple 原生质感卡片，详细展示：
- 会话窗口 (Session)：瞬时限流滑动窗口实时占用率及健康状态。
- 周度配额 (Weekly)：本周已用百分比，进度条自动变色（<60% 绿色安全、60-85% 橙色注意、>85% 红色告警）。
- 月度配额 (Monthly)：本月累计占用率与精确到天/时的下次重置倒计时。
- 席位与账号信息：绑定席位 ID、当前登录子用户名与账号 ID。
- 🚀 极度轻量与低能耗：基于 Tauri 2 + Rust + Vue 3 打造，常驻后台内存仅需 ~25 MB（相较于传统 Electron 应用的 150MB+ 节省逾 80% 内存），安装包仅 ~10 MB。
- 🛠️ 全自动环境检测与新手向导 (Onboarding Doctor)：
- 自动探测系统 Node.js 运行环境（智能解析 macOS GUI 缺失的
PATH，兼容 nvm 与 Homebrew）。 - 自动检测
@volcengine/ark-cli，未安装时支持一键自动安装。 - 自动检测登录态，未登录时一键呼起默认浏览器完成火山 SSO 授权登录 (
arkcli auth login volc-sso)。
- 自动探测系统 Node.js 运行环境（智能解析 macOS GUI 缺失的
- 🔄 应用内一键在线极速更新：内置 GitHub Releases 自动版本比对，发现新版直接在软件内「一键在线更新」，全自动下载、解压覆盖并重启生效（macOS 自动脱离隔离属性，Windows 静默更新），告别繁琐的手动网页下载安装。
- 顶部状态栏：
[🌋] ⚡ 37% - 悬浮面板：
- 会话配额卡片（瞬时占用条）
- 周配额卡片（周期进度条）
- 月配额卡片（重置倒计时）
- 偏好设置（刷新周期、托盘显示模式、环境诊断、退出）
前往 Releases 页面 下载适合您操作系统的最新安装包：
- macOS (Apple Silicon M 系列)：
ArkBar_*_aarch64.dmg - macOS (Intel 系列)：
ArkBar_*_x64.dmg - Windows (64位)：
ArkBar_*_x64-setup.exe(或.msi)
由于未购买苹果昂贵的商业开发者证书，macOS Gatekeeper 会对从浏览器下载的应用自动添加隔离标记。 打开终端（Terminal.app），执行以下一行命令即可永久解除：
xattr -dr com.apple.quarantine /Applications/ArkBar.app# 1. 克隆代码仓库
git clone https://github.com/chzisnull/ark-bar.git
cd ark-bar
# 2. 安装前端依赖
pnpm install
# 3. 启动 Tauri 开发模式 (含菜单栏图标与前端热重载)
pnpm tauri dev# 编译生产环境产物
pnpm tauri build编译产物位于 src-tauri/target/release/bundle/ 目录下。
ark-bar/
├── .github/workflows/ # GitHub Actions 跨平台自动打包构建
├── src/ # 前端视图层 (Vue 3 + Tailwind CSS + Lucide Icons)
│ ├── components/
│ │ ├── OnboardingWizard.vue # 三步环境检测与授权向导
│ │ ├── UsagePanel.vue # 主配额监控悬浮卡片
│ │ └── SettingsModal.vue # 偏好设置与更新检测
│ ├── types/ # 完整的 TypeScript 数据模型
│ ├── App.vue # 顶层状态与自动轮询调度
│ └── main.ts
└── src-tauri/ # 原生层 (Tauri 2 + Rust)
├── src/
│ ├── env_resolver.rs # 智能环境变量注入 (解决 macOS GUI PATH 丢失)
│ ├── ark_cli.rs # arkcli 交互命令封装 (Usage plan / Auth / Install)
│ ├── tray.rs # 状态栏托盘管理与 Popover 定位
│ └── lib.rs # Tauri 运行时生命周期与插件注册
├── tauri.conf.json # 窗口、托盘与打包配置
└── Cargo.toml
- 火山方舟官方 CLI: @volcengine/ark-cli
- 跨平台框架: Tauri v2
- 前端框架: Vue 3 & Tailwind CSS
本项目基于 MIT License 开源。