TokenOwl-v1.2.0

亮点

• 全局快捷键 —— Alt+Shift+T 在任意应用前台时切换悬浮球与仪表盘；Alt+Shift+R 无需打开面板即可刷新全部账户。
• 会点名窗口的通知系统 —— 5 小时、每日、每周、每月额度窗口各自按独立阈值告警，通知会说明是哪个窗口在耗尽，而不是一条账户级数字。
• 预测型耗尽预警 —— 基于最近 24 小时的消耗速度，仅在预计耗尽早于窗口重置时提醒："按当前速度 40 分钟后耗尽，而窗口 3 小时后才重置。"
• 局域网授权确认 —— 首次添加指向私有网络或本机的账户时，会先请你确认，再创建任何内容。

变更内容

通知系统（全面重构）

• 按窗口告警：每个窗口类别（5h / 每日 / 7d / 每月）按自己的阈值独立触发、独立去重；带窗口的指标不再被压缩成一条不分彼此的账户级"额度紧张"。
• 预测型耗尽：仅在预测早于重置时间时触发——健康的滚动窗口永远不会误报。历史数据不足时该规则静默关闭，绝不猜测。
• 恢复通知：从断连或认证失败中恢复的账户会精确播报一次。
• 横幅聚合：同一账户的多个条件合并为一条横幅（继承最严重级别），而通知中心仍逐条完整记录。
• 安静时段（默认 22:00–08:00），紧急级别可穿透——把"你的密钥已被拒绝"静音到第二天早上，等于藏起了唯一值得叫醒你的那条消息。
• 通知中心：每条带类型标签（标题已表达时自动隐藏），筛选下拉只列出实际出现过的类型。
• 系统横幅按账户分组，紧急级别通知带提示音。

桌面体验

• 全局快捷键，带优雅降级：快捷键被其他应用占用时启动时跳过，而不是启动失败。
• 局域网授权确认，Rust 侧数值化的私有网段判定（172.16.0.1 是私有地址，172.32.0.1 是公网地址——前缀匹配会判错）。私有网络目标默认阻止，仅在你确认该地址属于自己的网关或可信网络后放行。
• 渲染失败兜底：未捕获的渲染异常现在会显示可恢复的提示与重新加载按钮，而不是留下一块永久空白的窗口。
• 悬浮球 ↔ 仪表盘无缝切换：两个窗口共享同一条空间路径，中间不再出现空白帧（此前实现是先隐藏一个再显示另一个）。
• 气泡打磨：外环现在紧贴气泡边缘（此前漏出一圈状态色细边），表盘改用深色珠宝底，让数据环承担色彩。

发布规范

• 新增 CHANGELOG.md 与 THIRD_PARTY_NOTICES.md。
• 双语自述文件：简体中文为默认版本，英文版在 README.en.md，徽章下方有语言切换入口。

兼容性

• 无 schema 迁移；v1.0.x 与 v1.1.x 的本地数据原样可读（已对照 v1.1.0 的刷新状态格式实测验证）。
• 新增 IPC 命令均为增量，既有命令无形状变化。

安装

Windows：TokenOwl_1.2.0_x64-setup.exe（NSIS）或 TokenOwl_1.2.0_x64_en-US.msi（MSI）。现有安装通过内置更新器原地升级。

macOS：Apple Silicon 用 TokenOwl_1.2.0_aarch64.dmg，Intel 用 TokenOwl_1.2.0_x64.dmg。

完整更新日志：见 CHANGELOG.md；逐次提交的完整变更对比见 v1.1.0...v1.2.0

TokenOwl-v1.1.0 — New owl, smarter monitoring

亮点

• 全新视觉 —— TokenOwl 换上全新的猫头鹰标识（经 Apple 风格 squircle 圆角处理），覆盖应用、系统托盘、安装程序与 README。
• 网关支持真正可用 —— 自托管的 New API、One API 与 LiteLLM 账户现在会采用你填写的网关地址；原生 Anthropic 与 Gemini 适配器会准确定位各账户自己的端点。
• 设置表单已修复 —— 连接按钮恢复工作（此前点击完全无响应），各输入框在应可编辑处均可正常编辑。

变更内容

供应商与监控

• 29 个内置供应商清单，覆盖三种请求协议（OpenAI 兼容、Anthropic、Google AI），并按 L1-L4 如实标注能力等级 —— 未知的额度就显示未知，绝不补零。
• 原生 Anthropic 与 Gemini 适配器将限流响应头映射为窗口化额度快照，并读取每个账户自身的配置。
• 社区供应商包 —— 将通过校验的 YAML 清单放入 community-providers 目录即可注册新的 OpenAI 兼容供应商；社区包强制 https 基础地址，并拒绝内嵌凭据的 URL。
• OAuth 会话账户（凭据侧）支持过期时间，会话保存在系统钥匙串中。

用量分析

• 供应商专属用量视图，支持 2 小时 / 24 小时 / 30 天窗口切换与 30 天趋势图。
• 燃烧速率（burn rate） 与预计耗尽时间。
• 26 周热力图展示每日 Tokens 与计费消耗，辅以 30 天统计卡。
• 图表悬浮提示，鼠标悬停坐标点即可查看当日明细。

桌面体验

• 悬浮球重设计 —— Apple Watch 风格双环，分别映射最短与最长的重置窗口，支持屏幕边缘吸附；空态呈现满幅猫头鹰标识。
• 设置页全面改版 —— 供应商选择器按请求协议分组，能力矩阵可折叠展开，未支持的协议如实标注。
• 单滚动条布局 —— 仪表盘恰好适配视口，仅内容区滚动。
• 高对比度文本 —— 色彩变量在合成表面上实测达到 WCAG AA，支持强制色彩模式与减弱动态效果。

问题修复

• 修复设置表单渲染为非表单元素导致连接按钮点击完全无响应的问题（已加回归测试）。
• 修复网关配置文件丢弃用户填写的基础地址、反而持久化清单占位符的问题（曾导致所有网关刷新失败）。
• 修复原生适配器读取构造时的占位配置而非账户配置的问题（曾使 Anthropic/Gemini 刷新打向错误主机）。
• 修复创建账户时 models 端点未写入账户配置的问题。
• 提升尚无快照的新建账户的渲染容错性，不再崩溃。
• 修复仪表盘外壳出现双竖向滚动条的问题。

安装程序

• NSIS 安装向导保留选择安装位置页面 —— 可自由指定安装路径；默认按当前用户安装至 %LOCALAPPDATA%\TokenOwl（无需管理员权限）。

安装

Windows（已验证）：下载 TokenOwl_1.1.0_x64-setup.exe（NSIS）或 TokenOwl_1.1.0_x64_en-US.msi（MSI）。现有 v1.0.x 安装可通过内置更新器原地升级。

macOS（CI 构建，未在真机验证）：Apple Silicon 下载 TokenOwl_1.1.0_aarch64.dmg，Intel 下载 TokenOwl_1.1.0_x64.dmg。

所有更新器产物（latest.json 与 .sig 签名文件）均经 Minisign 签名。

说明

• 一如既往的本地优先：密钥存于系统凭据库，数据存于 SQLite，无遥测。
• 完整变更日志：v1.0.0...v1.1.0

TokenOwl v1.0.0

TokenOwl v1.0.0 — 第一个正式发行版

项目简介

TokenOwl 是一款本地优先的 AI 配额监控桌面应用，支持 Windows 和 macOS。它实时追踪多个 AI 提供商的配额、余额和使用情况，帮助用户避免服务中断。

核心价值

• 本地优先 — 数据存储在本地 SQLite 和系统钥匙串，不依赖云端服务
• 隐私保护 — API 密钥存储在 OS 钥匙串（Windows Credential Manager / macOS Keychain），绝不写入日志或数据库
• 多提供商 — 支持 8 个 AI 提供商（OpenAI、Anthropic、Gemini、OpenRouter、DeepSeek、Qwen、Kimi、MiniMax）
• 实时监控 — 后台自动刷新配额数据，支持可配置的刷新间隔和智能退避
• 轻量美观 — 浮动气泡 + 可展开仪表盘，支持毛玻璃效果和流畅动画

主要功能

配额监控

• 实时显示配额使用量、剩余量和限额
• 支持多种配额单位（token、currency、request、credit、point 等）
• 计算配额使用率和压力指数
• 显示配额重置倒计时和历史趋势

多账户管理

• 添加、删除和刷新多个 AI 提供商账户
• 支持 OpenAI 兼容 API 的自定义端点
• 每个账户独立显示状态和健康度

通知系统

• 配额不足警告（可配置阈值）
• 配额即将重置提醒
• 支持静默模式和仅关键通知模式

桌面集成

• 浮动气泡显示整体状态，点击展开仪表盘
• 气泡位置可拖拽并持久化保存
• 系统托盘图标和菜单
• 毛玻璃透明窗口效果（Windows Acrylic / macOS Vibrancy）

数据安全

• 端到端使用 HTTPS 与提供商 API 通信
• 自动重试和指数退避策略
• 响应大小限制防止内存耗尽
• 敏感字段自动脱敏（日志和遥测）

技术特色

• Tauri 2 — 轻量级桌面应用框架，打包体积小（Windows MSI ~5.5MB，NSIS ~4MB）
• Rust 后端 — 高性能、内存安全的系统层逻辑
• React 19 + TypeScript — 现代化前端，严格类型检查
• SQLite 持久化 — 轻量级本地数据库，WAL 模式提升并发性能
• 8 个 Provider 适配器 — 统一的 ProviderAdapter trait，易于扩展新提供商
• 智能调度器 — 基于二叉堆的优先级队列，支持抖动和退避
• 完整 CI/CD — 前端和 Rust 检查并行运行，自动发布签名安装包

系统要求

• Windows — Windows 10 或更高版本
• macOS — macOS 12 (Monterey) 或更高版本

安装

从 Releases 页面下载对应平台的安装包：

• Windows — TokenOwl_1.0.0_x64-setup.nsis.exe（NSIS 安装器）或 TokenOwl_1.0.0_x64_en-US.msi（MSI 安装器）
• macOS — TokenOwl_1.0.0_aarch64.dmg（Apple Silicon）或 TokenOwl_1.0.0_x64.dmg（Intel）

使用指南

1. 安装并启动 TokenOwl
2. 点击浮动气泡展开仪表盘
3. 点击"添加账户"，输入 API Key 和 Base URL
4. 配额数据将自动加载并实时更新
5. 拖动气泡到喜欢的位置，位置会自动保存

版本规划

• v1.0.0 — 当前版本，核心配额监控功能
• v1.1.0 — 多端点数据合并（余额 + 用量 + 配额）
• v1.2.0 — 自定义通知规则和导出功能
• v2.0.0 — 插件系统和第三方 provider 扩展

开源协议

MIT License — 自由使用、修改和分发。详见 LICENSE。