ArkBar v0.7.0

🚀 ArkBar v0.7.0 更新说明

🌟 本次版本更新内容

1. 新增「点击菜单栏图标才显示用量」：

   • 在「外观 → 在系统菜单栏显示图标」打开后，下方会多出一个开关。开启后，用量不再靠鼠标悬停顶部/右侧刘海展开，改为点击菜单栏图标弹出用量卡片，再点一次收起——适合不想让刘海常驻在屏幕边缘、只想要一个干净的菜单栏入口的场景。
   • 弹出的用量卡片与原有刘海气泡同源：厂商 Tab（可拖拽排序）、配额监控 / Token 统计双视图、刷新、设置、未连接时的授权引导都在。
   • 点击别处（失焦）自动收起，和系统原生菜单栏弹窗一致。
   • 关闭该开关即回到原来的悬停刘海模式；把「在系统菜单栏显示图标」关掉时，此开关会自动一并关闭（否则图标和刘海会同时消失，无处可点）。

2. 用量卡片不会再被菜单栏盖住：

   • 弹出位置只借用菜单栏图标的水平位置（居中于图标），竖直方向改用系统工作区顶边（即菜单栏下沿）并留 6px 缝隙。
   • 原先直接用 tauri-plugin-positioner 的 TrayBottomCenter 会把窗口顶边对齐到图标顶边，而菜单栏里图标的顶边实测约为 -2px，窗口会贴到屏幕最顶端、上半截被菜单栏吃掉。现已改为自行计算，并在图标贴屏幕边缘 / 屏幕过矮时把卡片夹回可视区域。

---

🛠️ 实现说明

1. 菜单栏左键语义按模式分流：原先是「显隐屏幕刘海」；开启点击模式后改为「弹出/收起用量卡片」，未开启时行为完全不变（老用户升级后无感）。全局快捷键 ⌘/⇧+A 同样跟随该模式。
2. 悬停彻底关闭：点击模式下刘海窗口不再上报悬停热区并停止渲染，光标巡检随之进入低频档，不额外耗电。
3. 跨窗口状态同步：点击模式的开关以 localStorage 为准（与其它偏好一致），同时由后台在切换时向刘海窗口广播一次，避免窗口藏在后台时漏收事件、出现「刘海空白」。

---

⚠️ macOS 首次打开提示“应用已损坏，无法打开”解决办法

由于开源项目未购买苹果商业开发者证书，从浏览器下载后 macOS Gatekeeper 会自动对应用添加隔离标记。
解决方法：打开系统自带「终端」(Terminal.app)，复制并执行以下命令回车即可：

xattr -dr com.apple.quarantine /Applications/ArkBar.app

---

📦 安装包下载指引

• macOS (Apple Silicon M1/M2/M3/M4 系列): ArkBar_*_aarch64.dmg
• macOS (Intel 处理器): ArkBar_*_x64.dmg
• Windows (64位安装包): ArkBar_*_x64-setup.exe (或 .msi)

ArkBar v0.6.3

🚀 ArkBar v0.6.3 更新说明

🌟 本次版本更新内容

1. 空闲耗电明显下降：

   • 光标巡检改为自适应频率：原先固定 35ms（约每秒 29 次）不停轮询，现在光标远离刘海时降到 200ms、没有可见刘海时降到 250ms，光标靠近刘海瞬间立刻回到高频跟踪。空闲唤醒次数下降约 6 倍，菜单栏常驻时的 CPU 占用与耗电同步降低。
   • 多显示器更省：「所有显示器」模式下，光标位置查询从「每块屏各查一次」改为每轮只查一次。

2. 拖动刘海更顺滑：

   • 拖动过程中不再以约每秒 125 次的频率向所有窗口重复广播并未发生变化的「靠边方向」事件。
   • 拖动时不再反复枚举显示器、也不再每帧写一条日志（改为位置真正变化时才记录）。

3. 配额刷新更快、更省：

   • 请求并发化：TeamoRouter 的 7 个请求、火山方舟的席位与 token 请求改为并发发起，冷取最坏耗时从约 56 秒 / 100 秒降到约 8 秒 / 60 秒。
   • 缓存有效期对齐刷新周期：原缓存有效期（20~180 秒）短于后台刷新周期（5 分钟），导致每一轮都必然冷取；现在后台刷新命中缓存并异步校验。
   • Codex 会话统计只读文件尾部：原先会把每个会话文件整份读入内存，重度使用者单轮可达数百 MB。
   • 令牌读取增加进程内缓存：一次刷新从多次整文件读取降为一次。

4. 启动更轻：

   • 悬浮刘海优先从本地缓存渲染，不再与设置窗口重复拉取同一批厂商用量（暖启动从约 10 次拉取降到 1 次）。
   • 活动状态探测延后 8 秒执行，避开启动时的磁盘 I/O 高峰。

---

🛠️ 修复的问题

1. 更新下载可能永久卡住：

   • 下载用的 curl 只设了连接超时、没有总时长上限，轮询循环也没有兜底超时。遇到服务器中途停止发送数据会一直停在「正在下载…」，既不报错也不结束。现已加上 300 秒总超时与低速保护，超时会明确提示并终止。

2. 外部命令出错时的进程与线程泄漏：

   • 等待外部命令出错时未回收子进程，两个输出读取线程也不会结束。现已补齐终止与回收。

3. 设置窗口反复切换后「检查更新」会重复发请求：

   • 设置窗口的事件监听未在销毁时解绑，来回切换后一次点击会触发多次真实网络请求。现已正确解绑。

4. 跨窗口缓存写入与重渲染放大：

   • 缓存写入改为去抖合并（一轮 5 次写合并为 1 次），接收端只更新真正变化的厂商，不再整体替换并全量重渲染。

5. 日志与看门狗的开销：

   • 日志改为持有写入句柄、流式轮转（不再每条日志重开文件、轮转时不再整份读入内存）。
   • 看门狗巡检不再每轮重复构建窗口列表。

---

⚠️ macOS 首次打开提示“应用已损坏，无法打开”解决办法

由于开源项目未购买苹果商业开发者证书，从浏览器下载后 macOS Gatekeeper 会自动对应用添加隔离标记。
解决方法：打开系统自带「终端」(Terminal.app)，复制并执行以下命令回车即可：

xattr -dr com.apple.quarantine /Applications/ArkBar.app

---

📦 安装包下载指引

• macOS (Apple Silicon M1/M2/M3/M4 系列): ArkBar_*_aarch64.dmg
• macOS (Intel 处理器): ArkBar_*_x64.dmg
• Windows (64位安装包): ArkBar_*_x64-setup.exe (或 .msi)

ArkBar v0.6.2

🚀 ArkBar v0.6.2 更新说明

🌟 本次版本更新内容

1. 有新版本会主动提示，不用再自己去点「检查更新」：
   • 后台自动巡检：启动 15 秒后查一次，之后每 6 小时一次。发现新版本会广播给所有窗口（同一个版本一个会话只提示一次，不反复打扰），并写进 arkbar.log。
   • 刘海上的提示：设置齿轮上亮一个琥珀色小圆点；展开刘海时卡片里直接出现一行「有新版本 vX.Y.Z 可用」+「去更新」按钮，点一下就把设置窗口和更新弹窗一起带出来。
   • 设置窗口：收到广播即记住新版本信息，打开设置就能看到更新入口。
   • 可关闭：设置 → 通用新增「自动检查更新」开关（默认开）。关掉之后后台巡检真的不再发起请求，只在你手动点击时检查——与 Codenotch 的 automatic 偏好同一个语义。
   • 说明：提示只在确实存在更新时出现，所以刚升级到最新版的用户不会看到它；等下一个版本发布时自然就来了。

🔧 一并带上的修复

• 上一版（v0.6.1）的两处修复同样包含在本版：火山方舟凭据失效时如实报「需要重新授权」（不再出现「检测没问题但取不到用量」），以及多屏选「所有显示器」却只有主屏有刘海。

ArkBar v0.6.1

🚀 ArkBar v0.6.1 更新说明

🌟 本次版本更新内容

1. 火山方舟「检测没问题，但就是取不到用量」——修好了：

   • 根因：arkcli auth status 只说明「本地存着凭据」，凭据本身可能已经失效。SSO 的 refresh_token 过期后它照样回 logged_in: true，于是引导页说已就绪、界面说没问题，真去取用量却报 requires Volcengine Ark SSO STS / refresh_token is invalid。
   • 环境检测改成真核实：报「已登录」之后再用一次真实调用确认；核实不过就按未登录处理，并写明「火山方舟登录已失效（SSO 凭据无法续期），请重新授权登录」，引导页的授权步骤随之重新亮起。
   • 授权失效与取数失败分开报：识别 SSO STS / refresh_token / token 交换失败这类错误，直接说「登录已失效，需要重新授权」，按钮也变成「重新授权」，不再只丢一句「获取配额失败」。
   • 不再拿旧读数盖住它：以前凭据失效时缓存会保留上一次「已连接」的数据、只标一句「同步失败」，界面看起来一切正常。现在「没装 CLI / 没登录 / 凭据失效」这类用户能自己解决的问题会当场替换并显示；只有网络/服务端抖动才保留旧数据。
   • 卡片里只展示人话（状态行 + 一行截断的原始报错），整段 JSON 不再把卡片撑成一大块。

2. 外接屏选「所有显示器」却只有主屏有刘海——修好了：

   • 根因：新建的刘海窗口是按 visible: false 建出来的，只有启动和托盘那条路径会把它显示出来。于是在设置里把范围切到「所有显示器」之后，第二块屏上的窗口其实建好了，却一直藏着。
   • 现在对账时会看舰队当前是不是显示态：是就把新窗口一并显示出来；热插拔显示器时同样如此。

3. 新增落盘日志，方便报障：

   • 关键路径（舰队对账、每个刘海的摆放、点穿状态、活动状态变化）都会写进 ~/Library/Application Support/com.chzisnull.arkbar/arkbar.log（Windows 对应 AppData 下同一路径），超过 512 KB 只留尾部。
   • 以前 macOS 从 Finder 启动时 stderr 无处可去，「刘海不在这块屏上」「点了没反应」这类问题只能靠猜。现在把日志发回来即可定位。

ArkBar v0.6.0

🚀 ArkBar v0.6.0 更新说明

🌟 本次版本更新内容

1. 每块屏幕一个刘海（对齐 Codenotch 的 NotchFleet）：
   • 设置 → 外观新增「刘海显示范围」：主显示器（默认，只有带菜单栏那一块，与单面板时代一致）或所有显示器（每块屏各一个刘海）。与上游同样的取舍——默认只留主屏，免得全新安装时把刘海撒到用户没预期的地方。
   • 每块屏的刘海各开各的：悬停哪块屏就只展开哪块（notch_pointer / notch_cursor 改为只发给被指到的那一个窗口），不会再出现「碰一块屏、所有屏都弹开」。
   • 整队共享的仍然是共享的：贴边位置、沿边落点、显示方式、厂商数据都是整队一份——一块屏上的刘海换边或沿边微调，其余屏幕一起跟着走（上游 apply(edge:) / apply(alongOffset:) 的扇出语义）。
   • 显示器插拔自动对账：插上就补一个刘海、拔掉就收掉那一个，位置按「第 i 个窗口 ↔ 第 i 块屏」稳定对应（主屏永远排第一，其余按坐标排序）。
   • 托盘/快捷键的显隐改成整队开关：一块屏一个刘海，一起显、一起隐。
   • 覆盖范围存在 notch.json（与贴边位置、沿边落点同一份状态），重启后照旧。

🔧 一并带上的修复

• 上一版（v0.5.0）里已修的问题同样包含在本版：拖动不再把刘海甩出边缘、抓手=搬运到任意边缘（含四条落区提示）、⌥+拖动=沿边微调、顶部贴边严丝合缝、工作状态真实探测、菜单栏图标能关掉、Windows 上火山方舟能刷出来（含未装 CLI / 未授权时的明确提示与一键授权）。

ArkBar v0.5.0

🚀 ArkBar v0.5.0 更新说明

🌟 本次版本更新内容

1. 贴边摆放与拖动：完全按 Codenotch 重写（修复刘海会跑到屏幕中间）：

   • 拖动不再把刘海甩出边缘：之前按住抓手是按鼠标位移直接挪窗口，实测能把刘海从右边缘甩到屏幕中间（偏出 749pt），还会大幅过冲。现在由 Rust 原生线程跟随系统光标，只沿当前这条边滑动，位置由「沿边比例 + 窗口目标尺寸」算出并夹取，刘海永远焊在边缘上。
   • 抓手 = 搬运到任意边缘：按住抓手会升起四条边的落区（半透明黑底 + 虚线轮廓，瞄准的那条更亮），指针挑一条边、松手即落。搬运期间刘海原地不动——选的是屏幕上的一个地方，不是移动了多远。
   • ⌥ + 拖动刘海本体 = 沿当前边微调：与 Codenotch 一致；不带 ⌥ 的按下只是一次点击，手滑不会再误搬刘海。
   • 顶部贴边终于贴住屏幕顶边：修掉两个真实成因——位置按「目标尺寸」而非实测尺寸计算，以及窗口层级必须是 statusBar（alwaysOnTop 的 floating 层级会被 AppKit 压回菜单栏下方，永远差 30pt）。
   • 每条边各自记住落点：拖动落点按边分别持久化（写进 notch.json，不依赖 webview 存储），切回来原样恢复；「复位居中」只影响当前这条边。

2. 工作状态不再造假：

   • 卡片底部那行状态以前是写死的「工作中 · 刚刚」+ 永远转圈的图标，所以不在工作时也显示在工作。现在按 Codenotch 的 activity 引擎真实探测：Antigravity 解析 transcript.jsonl 尾部的回合状态（含 ask_question → 等待回答、RequestFeedback → 等待确认，回合结束 9s 内显示已完成）；Codex 按 rollout 最后一步的类型决定安静容忍（工具 ≤10 分钟、思考 ≤120s、助手消息 ≤4s）；Grok 看 updates.jsonl 新鲜度并核对回合是否真的还开着。
   • 火山方舟 / Teamo 本地没有回合信号，不显示状态——宁可不报，也不编一个「工作中」。等待输入琥珀色、已完成绿色、工作中白色转圈。

3. 菜单栏图标终于能关掉：

   • 设置里关掉后重启又会冒出来，是因为启动时读的是 v0.2.12 的老键 arkbar_tray_icon_visible，而设置面板写的是 arkbar_show_tray——两个键对不上，启动恒判为「显示」。现在统一到单一键（老键只做一次性迁移），关掉就是关掉。

4. 右键菜单：刘海上右键即可「立即刷新 / 保持展开（勾选）/ 偏好设置 / 退出」，与 Codenotch 一致；菜单打开期间刘海不会在菜单底下收起来。

5. Windows 上火山方舟刷不出来：定位并修复：

   • cmd /C 调 arkcli 时程序路径没有加引号，路径里只要有空格（C:\Users\First Last\AppData\Roaming\npm\arkcli.cmd）就永远执行失败，用量自然一直空着。现在按 cmd 的规则正确加引号（raw_arg，避免 std 二次转义）。
   • ~/.arkcli/config.yaml 的套餐档位在 Windows 上读不到（只认 HOME），补上 USERPROFILE。
   • 没装 CLI / 没授权时把话说清楚：刘海卡片会直接写出原因（「未检测到 arkcli 命令行工具」/「未登录火山方舟或登录已过期」），并给一个「安装 / 授权」按钮，一键跳到引导页完成 npm 安装或 SSO / 授权码登录；未连接的厂商读数用琥珀色标出，不再是看起来像「0%」的灰。

6. 其余对齐与修复：

   • 顶部贴边的窗口高度 480 → 650（上游方形尺寸，480 会把内容多一点的卡片顶出窗口）。
   • 详情卡片消失延迟 180ms → 250ms（上游值）。
   • 圆环悬停不再放大（指针一靠近就「粘」上去），改为按下缩到 .93 给回执；点击圆环立即刷新该厂商。
   • 收起胶囊的唤醒热区与页面自己的唤醒判定统一到同一组常量（此前 65px 与 50px 两套数字对不上）。
   • 换边后页面布局自动翻转（此前 Rust 广播的是 notch_edge，页面却在听 notch_edge_changed，事件名对不上，换边后布局留在原地）。
   • 摆放与点穿状态都有诊断日志（notch placed / click-through），出问题时不必再猜。

ArkBar v0.4.9

🚀 ArkBar v0.4.4 更新说明

🎨 二级悬浮详情卡片 UI 与滚动条全面重塑

1. 告别丑陋默认滚动条，重塑 Apple 极简悬浮微条：
   • 彻底移除卡片内部死板的 max-h-[360px] 嵌套滚动容器，卡片高度根据内容自适应舒展。
   • 重构滚动条交互与样式：默认状态完全透明隐藏，仅在鼠标悬停或滑动时轻柔浮现 4px 极细半透药丸胶囊微条 (rgba(255, 255, 255, 0.2))，轨道 100% 透明，完全贴合 macOS 原生 Overlay Scrollbar 质感。
2. 彻底解决文字折行与文字挤压问题：
   • 卡片宽度适度由 254px 拓宽至 290px，为中文配额名称与倒计时重置提供充足横向排版空间。
   • 增加 nowrap 与 shrink-0 保护，彻底消除「Gemini 5小时限」折行落单「额」、「周三 13:51」折行落单「重置」的不良排版。
3. 修复悬停下方项时卡片被浮窗下边界截断的问题：
   • 浮窗高度由 580px 提升至 680px（对齐 Codenotch 官方 NOTCH_LONG = 650.0 规范），悬停底部厂商项时提供充裕垂直呼吸空间，底部 Token 统计信息完整展现。
4. 气泡卡片与尖尾有机无缝融合：
   • 卡片与弯角尖尾统一采用 #0e0f14 质感黑，优化重合层级与阴影投影，彻底消除割裂分割线。

---

🚀 ArkBar v0.4.3 更新说明

🌟 极致对齐 Codenotch：原生光标监听悬停秒级呼出、离手即收、纯正 Apple 物理动效

1. 原生光标守护进程 (Native Cursor Watchdog)：

   • 彻底解决 macOS 下未激活窗口无法接收 WebKit mousemove/mouseenter 导致“必须点击一下才展开”的问题。
   • Rust 后台以 35ms 超高频实时比对全局屏幕光标位置与屏幕刘海 Hot Zone，光标一碰即开，真正做到悬停秒开，无需任何点击。
   • 智能接管窗口穿透模式 (set_ignore_cursor_events)，未悬停时全透不拦截下层应用点击，触碰时瞬间唤醒并交接交互。
   • 光标移开刘海与详情气泡后，严格倒计时 450ms 优雅折叠收起，彻底杜绝“移开很久都不关闭”的问题。

2. 百分百对齐 Codenotch 视觉动效与部件：

   • 收起形态 (#rest)：闲置时化为 10px × 79px 的极简边缘胶囊，与屏幕右边缘完全贴合。
   • 凹曲面过渡菲林 (Fillets)：采用标准 --fillet: 38.7px 径向渐变算法，无缝将刘海岛与屏幕边缘融为一体。
   • 交互手柄 (Handles)：
     • 顶部 Move Handle：闲置时 quarter-arc 嵌套在凹曲面中，悬停时展开为拖动抓手与携带手形。
     • 底部 Settings Orb：闲置时嵌入底部凹曲面，悬停时轻盈转出齿轮图标，点击直接打开偏好设置。
   • 阶梯延迟展开动画 (Staggered Animation)：展开时各厂商仪表环依序带弹簧动效滑入 (calc(var(--i) * 28ms))。
   • 气泡卡片与有机弯角尖尾 (#card & #tail)：采用 Codenotch 官方曲面 SVG 尖尾路径，尖端精准契入当前环形仪表中心。

---

🚀 ArkBar v0.4.0 更新说明

🌟 本次版本核心更新：参考 Codenotch 全面重构 UI 视觉与交互动效

1. 全新屏幕边缘“灵动刘海”挂件 (Screen Edge Notch)：

   • 贴靠屏幕边缘的 Apple 有机黑透曲面悬浮岛，支持右侧/左侧贴靠与闲置自动半隐。
   • 垂直排列各 AI 厂商项，每项配备环形刻度仪表盘 (Circular Ring Gauge)，SVG 进度弧线采用弹簧阻尼动画，依水位动态三色变色，圆环下方直观显示加粗百分比或余额（如 68%、64%、$4.67）。
   • 鼠标悬停即刻向外飞出气泡卡片 (Speech Bubble Popover)，指针尖角精准对齐当前图标，详细展示模型组配额进度、倒计时与实时工作状态。
   • 配备抓手支持沿屏幕边缘自如上下拖拽定位。

2. 全新 Codenotch 风格“设置与多账号管理中心”：

   • 采用经典 macOS 两栏式窗口设计，左侧提供红绿灯按钮、品牌与分类导航（账号、外观、通知、通用）。
   • 账号面板：支持拖拽抓手任意调整刘海绘制顺序，提供一键直达官方控制台胶囊按钮、iOS 风格纯蓝滑动开关，以及细粒度的「刘海显示」与「模型数据」选择。
   • 外观面板：支持配置刘海屏幕贴靠位置（右侧/左侧/隐藏仅托盘）、闲置自动半隐与一键召唤桌面刘海浮窗。
   • 通用与通知：高水位与重置系统推送、开机自启、多档后台刷新周期与在线自动更新。

3. 全局矢量资产与 Apple 弹簧物理缓动：

   • 新增独立矢量图标组件 ProviderIcon.vue，重塑 Antigravity、Grok、火山方舟、Codex、Teamo 等图标。
   • 菜单栏弹窗与桌面刘海双向无缝联动。

---

🚀 ArkBar v0.3.7 更新说明

🛠 v0.3.7 修复：TeamoRouter 余额与今日费用不再显示 --

• 修复「账户余额」「今日费用」两张卡片始终显示 -- 的问题。
  • 根因：TeamoRouter 现网接口的金额是对象形态 {"value":"4.67380993","currency":"USD"}，而解析逻辑只接受纯字符串，导致金额恒为空值。
  • 现在同时兼容对象 / 字符串 / 数字三种形态，并优先采用接口返回的 currency（缺省 USD）。
• 补强测试：新增对象形态、数字形态与异常载荷用例；带 TEAMO_TEST_TOKEN 的联网用例现在会断言余额与今日费用确实解析成功，防止同类静默回归。

🚀 ArkBar v0.3.6 更新说明

🛠 v0.3.6 优化

• TeamoRouter 页面固定展示「账户余额」和「今日费用」；同步完成前显示 --，避免旧缓存导致两张卡片消失。
• TeamoRouter 缓存命中率统一四舍五入到 1 位小数（例如 69.1%），不再显示冗长小数。

🛠 v0.3.5 修复（保留）

🛠 v0.3.5 修复

• 修复 TeamoRouter 已配置 API Key 后仍显示「请在设置中填入 API Key」的问题。
  • 根因：HTTP 客户端误将 curl 进程退出码 0 判断为非 2xx HTTP 状态，导致成功响应被错误丢弃。
  • 现在 Teamo 成功响应会正常入库并展示余额、当日费用、Token 与缓存命中统计。

🌟 v0.3.4 更新说明（保留）

🌟 本次版本核心更新：接入 TeamoRouter 余额与用量统计

1. TeamoRouter 新服务商接入：
   • 新增 TeamoRouter 标签页，使用官方开放接口实时查询账户余额、今日费用、Token 用量与缓存命中率。
   • 支持近 5 小时 / 今日 / 本周 / 本月多维度 Token 统计，以及月度上下文缓存命中展示。
   • 设置页新增 TeamoRouter API Key 本地保存入口（存储在 ~/.ark-bar/tokens.json）。
   • 主面板直观展示「账户余额」与「今日费用」两张金额卡片。

🌟 0.3.3 更新说明（保留）

1. Grok / 全厂商用量切换秒级静默更新（彻底免手动刷新）：

   • 切换顶部服务商标签或从其他窗口唤醒 ArkBar 菜单栏面板时，前端自动以 force = true 在后台静默获取最新实时数据。
   • 保证 0 延时平滑切 Tab 的同时，最新用量数百毫秒内平滑就绪，再也不需要手动去点「刷新」按钮。
   • 容错兼容 Grok CLI onDemandUsed / onDemandCap 结构化对象提取。

2. 上下文缓存 (Prompt Cache) 命中统计全面重构：

   • 消除误导性的 --：此前 0 命中时会被 JS 判定为 falsy 从而显示为 -- 导致误以为接口报错；现全面区分厂商能力与真实命中。
   • 火山方舟 & Codex 精准呈现：当月累计缓存命中量（如月 2.11M）与缓存命中率（如 68.5%）精准呈现；今日有命中高亮显示，今日未命中但本月有命中展示月度累计。
   • 主面板 Token 胶囊展示真实月度命中率：顶部「本月已消耗 X.XXM Tokens」胶囊右侧准确展示当月整体缓存命中率（如 ⚡ 缓存命中 68.5%）。
   • Grok & Antigravity 诚实标注：官方接口未开放上下文 Prompt Cache 指标的厂商诚实标注为 暂不支持。

---

🌟 0.3.x 核心特性回顾

• 服务商自由调序与显隐自定义：主面板支持拖拽排序，设置中心支持微调与隐藏不需要的服务商。
• 检查更新极致优化：异步非阻塞命令，彻底解决卡顿，解决 WebKit 焦点重置跳回顶部问题，新版本提示置顶。
• 多厂商 Token 详细用量看板：全面支持近 5 小时、今日、本周、本月 Token 消耗统计，Prompt/Completion/Cache 命中拆解。
• 历史明细报表与数据导出：过去 14~30 天历史柱状走势图、按日明细表格及 JSON 一键导出。
• 状态栏托盘增强：支持显示今日 Token（如 🔥 602K）、5小时 Token、配额百分比等多种模式。

---

⚠️ macOS 首次打开提示“应用已损坏，无法打开”解决办法

由于开源项目未购买苹果商业开发者证书，从浏览器下载后 macOS Gatekeeper 会自动对应用添加隔离标记。
解决方法：打开系统自带「终端」(Terminal.app)，复制并执行以下命令回车即可：

xattr -dr com.apple.quarantine /Applications/ArkBar.app

---

📦 安装包下载指引

• macOS (Apple Silicon M1/M2/M3/M4 系列): ArkBar_*_aarch64.dmg
• macOS (Intel 处理器): ArkBar_*_x64.dmg
• Windows (64位安装包): ArkBar_*_x64-setup.exe（或 .msi）

ArkBar v0.4.8

🚀 ArkBar v0.4.4 更新说明

🎨 二级悬浮详情卡片 UI 与滚动条全面重塑

1. 告别丑陋默认滚动条，重塑 Apple 极简悬浮微条：
   • 彻底移除卡片内部死板的 max-h-[360px] 嵌套滚动容器，卡片高度根据内容自适应舒展。
   • 重构滚动条交互与样式：默认状态完全透明隐藏，仅在鼠标悬停或滑动时轻柔浮现 4px 极细半透药丸胶囊微条 (rgba(255, 255, 255, 0.2))，轨道 100% 透明，完全贴合 macOS 原生 Overlay Scrollbar 质感。
2. 彻底解决文字折行与文字挤压问题：
   • 卡片宽度适度由 254px 拓宽至 290px，为中文配额名称与倒计时重置提供充足横向排版空间。
   • 增加 nowrap 与 shrink-0 保护，彻底消除「Gemini 5小时限」折行落单「额」、「周三 13:51」折行落单「重置」的不良排版。
3. 修复悬停下方项时卡片被浮窗下边界截断的问题：
   • 浮窗高度由 580px 提升至 680px（对齐 Codenotch 官方 NOTCH_LONG = 650.0 规范），悬停底部厂商项时提供充裕垂直呼吸空间，底部 Token 统计信息完整展现。
4. 气泡卡片与尖尾有机无缝融合：
   • 卡片与弯角尖尾统一采用 #0e0f14 质感黑，优化重合层级与阴影投影，彻底消除割裂分割线。

---

🚀 ArkBar v0.4.3 更新说明

🌟 极致对齐 Codenotch：原生光标监听悬停秒级呼出、离手即收、纯正 Apple 物理动效

1. 原生光标守护进程 (Native Cursor Watchdog)：

   • 彻底解决 macOS 下未激活窗口无法接收 WebKit mousemove/mouseenter 导致“必须点击一下才展开”的问题。
   • Rust 后台以 35ms 超高频实时比对全局屏幕光标位置与屏幕刘海 Hot Zone，光标一碰即开，真正做到悬停秒开，无需任何点击。
   • 智能接管窗口穿透模式 (set_ignore_cursor_events)，未悬停时全透不拦截下层应用点击，触碰时瞬间唤醒并交接交互。
   • 光标移开刘海与详情气泡后，严格倒计时 450ms 优雅折叠收起，彻底杜绝“移开很久都不关闭”的问题。

2. 百分百对齐 Codenotch 视觉动效与部件：

   • 收起形态 (#rest)：闲置时化为 10px × 79px 的极简边缘胶囊，与屏幕右边缘完全贴合。
   • 凹曲面过渡菲林 (Fillets)：采用标准 --fillet: 38.7px 径向渐变算法，无缝将刘海岛与屏幕边缘融为一体。
   • 交互手柄 (Handles)：
     • 顶部 Move Handle：闲置时 quarter-arc 嵌套在凹曲面中，悬停时展开为拖动抓手与携带手形。
     • 底部 Settings Orb：闲置时嵌入底部凹曲面，悬停时轻盈转出齿轮图标，点击直接打开偏好设置。
   • 阶梯延迟展开动画 (Staggered Animation)：展开时各厂商仪表环依序带弹簧动效滑入 (calc(var(--i) * 28ms))。
   • 气泡卡片与有机弯角尖尾 (#card & #tail)：采用 Codenotch 官方曲面 SVG 尖尾路径，尖端精准契入当前环形仪表中心。

---

🚀 ArkBar v0.4.0 更新说明

🌟 本次版本核心更新：参考 Codenotch 全面重构 UI 视觉与交互动效

1. 全新屏幕边缘“灵动刘海”挂件 (Screen Edge Notch)：

   • 贴靠屏幕边缘的 Apple 有机黑透曲面悬浮岛，支持右侧/左侧贴靠与闲置自动半隐。
   • 垂直排列各 AI 厂商项，每项配备环形刻度仪表盘 (Circular Ring Gauge)，SVG 进度弧线采用弹簧阻尼动画，依水位动态三色变色，圆环下方直观显示加粗百分比或余额（如 68%、64%、$4.67）。
   • 鼠标悬停即刻向外飞出气泡卡片 (Speech Bubble Popover)，指针尖角精准对齐当前图标，详细展示模型组配额进度、倒计时与实时工作状态。
   • 配备抓手支持沿屏幕边缘自如上下拖拽定位。

2. 全新 Codenotch 风格“设置与多账号管理中心”：

   • 采用经典 macOS 两栏式窗口设计，左侧提供红绿灯按钮、品牌与分类导航（账号、外观、通知、通用）。
   • 账号面板：支持拖拽抓手任意调整刘海绘制顺序，提供一键直达官方控制台胶囊按钮、iOS 风格纯蓝滑动开关，以及细粒度的「刘海显示」与「模型数据」选择。
   • 外观面板：支持配置刘海屏幕贴靠位置（右侧/左侧/隐藏仅托盘）、闲置自动半隐与一键召唤桌面刘海浮窗。
   • 通用与通知：高水位与重置系统推送、开机自启、多档后台刷新周期与在线自动更新。

3. 全局矢量资产与 Apple 弹簧物理缓动：

   • 新增独立矢量图标组件 ProviderIcon.vue，重塑 Antigravity、Grok、火山方舟、Codex、Teamo 等图标。
   • 菜单栏弹窗与桌面刘海双向无缝联动。

---

🚀 ArkBar v0.3.7 更新说明

🛠 v0.3.7 修复：TeamoRouter 余额与今日费用不再显示 --

• 修复「账户余额」「今日费用」两张卡片始终显示 -- 的问题。
  • 根因：TeamoRouter 现网接口的金额是对象形态 {"value":"4.67380993","currency":"USD"}，而解析逻辑只接受纯字符串，导致金额恒为空值。
  • 现在同时兼容对象 / 字符串 / 数字三种形态，并优先采用接口返回的 currency（缺省 USD）。
• 补强测试：新增对象形态、数字形态与异常载荷用例；带 TEAMO_TEST_TOKEN 的联网用例现在会断言余额与今日费用确实解析成功，防止同类静默回归。

🚀 ArkBar v0.3.6 更新说明

🛠 v0.3.6 优化

• TeamoRouter 页面固定展示「账户余额」和「今日费用」；同步完成前显示 --，避免旧缓存导致两张卡片消失。
• TeamoRouter 缓存命中率统一四舍五入到 1 位小数（例如 69.1%），不再显示冗长小数。

🛠 v0.3.5 修复（保留）

🛠 v0.3.5 修复

• 修复 TeamoRouter 已配置 API Key 后仍显示「请在设置中填入 API Key」的问题。
  • 根因：HTTP 客户端误将 curl 进程退出码 0 判断为非 2xx HTTP 状态，导致成功响应被错误丢弃。
  • 现在 Teamo 成功响应会正常入库并展示余额、当日费用、Token 与缓存命中统计。

🌟 v0.3.4 更新说明（保留）

🌟 本次版本核心更新：接入 TeamoRouter 余额与用量统计

1. TeamoRouter 新服务商接入：
   • 新增 TeamoRouter 标签页，使用官方开放接口实时查询账户余额、今日费用、Token 用量与缓存命中率。
   • 支持近 5 小时 / 今日 / 本周 / 本月多维度 Token 统计，以及月度上下文缓存命中展示。
   • 设置页新增 TeamoRouter API Key 本地保存入口（存储在 ~/.ark-bar/tokens.json）。
   • 主面板直观展示「账户余额」与「今日费用」两张金额卡片。

🌟 0.3.3 更新说明（保留）

1. Grok / 全厂商用量切换秒级静默更新（彻底免手动刷新）：

   • 切换顶部服务商标签或从其他窗口唤醒 ArkBar 菜单栏面板时，前端自动以 force = true 在后台静默获取最新实时数据。
   • 保证 0 延时平滑切 Tab 的同时，最新用量数百毫秒内平滑就绪，再也不需要手动去点「刷新」按钮。
   • 容错兼容 Grok CLI onDemandUsed / onDemandCap 结构化对象提取。

2. 上下文缓存 (Prompt Cache) 命中统计全面重构：

   • 消除误导性的 --：此前 0 命中时会被 JS 判定为 falsy 从而显示为 -- 导致误以为接口报错；现全面区分厂商能力与真实命中。
   • 火山方舟 & Codex 精准呈现：当月累计缓存命中量（如月 2.11M）与缓存命中率（如 68.5%）精准呈现；今日有命中高亮显示，今日未命中但本月有命中展示月度累计。
   • 主面板 Token 胶囊展示真实月度命中率：顶部「本月已消耗 X.XXM Tokens」胶囊右侧准确展示当月整体缓存命中率（如 ⚡ 缓存命中 68.5%）。
   • Grok & Antigravity 诚实标注：官方接口未开放上下文 Prompt Cache 指标的厂商诚实标注为 暂不支持。

---

🌟 0.3.x 核心特性回顾

• 服务商自由调序与显隐自定义：主面板支持拖拽排序，设置中心支持微调与隐藏不需要的服务商。
• 检查更新极致优化：异步非阻塞命令，彻底解决卡顿，解决 WebKit 焦点重置跳回顶部问题，新版本提示置顶。
• 多厂商 Token 详细用量看板：全面支持近 5 小时、今日、本周、本月 Token 消耗统计，Prompt/Completion/Cache 命中拆解。
• 历史明细报表与数据导出：过去 14~30 天历史柱状走势图、按日明细表格及 JSON 一键导出。
• 状态栏托盘增强：支持显示今日 Token（如 🔥 602K）、5小时 Token、配额百分比等多种模式。

---

⚠️ macOS 首次打开提示“应用已损坏，无法打开”解决办法

由于开源项目未购买苹果商业开发者证书，从浏览器下载后 macOS Gatekeeper 会自动对应用添加隔离标记。
解决方法：打开系统自带「终端」(Terminal.app)，复制并执行以下命令回车即可：

xattr -dr com.apple.quarantine /Applications/ArkBar.app

---

📦 安装包下载指引

• macOS (Apple Silicon M1/M2/M3/M4 系列): ArkBar_*_aarch64.dmg
• macOS (Intel 处理器): ArkBar_*_x64.dmg
• Windows (64位安装包): ArkBar_*_x64-setup.exe（或 .msi）

ArkBar v0.4.7

🚀 ArkBar v0.4.4 更新说明

🎨 二级悬浮详情卡片 UI 与滚动条全面重塑

1. 告别丑陋默认滚动条，重塑 Apple 极简悬浮微条：
   • 彻底移除卡片内部死板的 max-h-[360px] 嵌套滚动容器，卡片高度根据内容自适应舒展。
   • 重构滚动条交互与样式：默认状态完全透明隐藏，仅在鼠标悬停或滑动时轻柔浮现 4px 极细半透药丸胶囊微条 (rgba(255, 255, 255, 0.2))，轨道 100% 透明，完全贴合 macOS 原生 Overlay Scrollbar 质感。
2. 彻底解决文字折行与文字挤压问题：
   • 卡片宽度适度由 254px 拓宽至 290px，为中文配额名称与倒计时重置提供充足横向排版空间。
   • 增加 nowrap 与 shrink-0 保护，彻底消除「Gemini 5小时限」折行落单「额」、「周三 13:51」折行落单「重置」的不良排版。
3. 修复悬停下方项时卡片被浮窗下边界截断的问题：
   • 浮窗高度由 580px 提升至 680px（对齐 Codenotch 官方 NOTCH_LONG = 650.0 规范），悬停底部厂商项时提供充裕垂直呼吸空间，底部 Token 统计信息完整展现。
4. 气泡卡片与尖尾有机无缝融合：
   • 卡片与弯角尖尾统一采用 #0e0f14 质感黑，优化重合层级与阴影投影，彻底消除割裂分割线。

---

🚀 ArkBar v0.4.3 更新说明

🌟 极致对齐 Codenotch：原生光标监听悬停秒级呼出、离手即收、纯正 Apple 物理动效

1. 原生光标守护进程 (Native Cursor Watchdog)：

   • 彻底解决 macOS 下未激活窗口无法接收 WebKit mousemove/mouseenter 导致“必须点击一下才展开”的问题。
   • Rust 后台以 35ms 超高频实时比对全局屏幕光标位置与屏幕刘海 Hot Zone，光标一碰即开，真正做到悬停秒开，无需任何点击。
   • 智能接管窗口穿透模式 (set_ignore_cursor_events)，未悬停时全透不拦截下层应用点击，触碰时瞬间唤醒并交接交互。
   • 光标移开刘海与详情气泡后，严格倒计时 450ms 优雅折叠收起，彻底杜绝“移开很久都不关闭”的问题。

2. 百分百对齐 Codenotch 视觉动效与部件：

   • 收起形态 (#rest)：闲置时化为 10px × 79px 的极简边缘胶囊，与屏幕右边缘完全贴合。
   • 凹曲面过渡菲林 (Fillets)：采用标准 --fillet: 38.7px 径向渐变算法，无缝将刘海岛与屏幕边缘融为一体。
   • 交互手柄 (Handles)：
     • 顶部 Move Handle：闲置时 quarter-arc 嵌套在凹曲面中，悬停时展开为拖动抓手与携带手形。
     • 底部 Settings Orb：闲置时嵌入底部凹曲面，悬停时轻盈转出齿轮图标，点击直接打开偏好设置。
   • 阶梯延迟展开动画 (Staggered Animation)：展开时各厂商仪表环依序带弹簧动效滑入 (calc(var(--i) * 28ms))。
   • 气泡卡片与有机弯角尖尾 (#card & #tail)：采用 Codenotch 官方曲面 SVG 尖尾路径，尖端精准契入当前环形仪表中心。

---

🚀 ArkBar v0.4.0 更新说明

🌟 本次版本核心更新：参考 Codenotch 全面重构 UI 视觉与交互动效

1. 全新屏幕边缘“灵动刘海”挂件 (Screen Edge Notch)：

   • 贴靠屏幕边缘的 Apple 有机黑透曲面悬浮岛，支持右侧/左侧贴靠与闲置自动半隐。
   • 垂直排列各 AI 厂商项，每项配备环形刻度仪表盘 (Circular Ring Gauge)，SVG 进度弧线采用弹簧阻尼动画，依水位动态三色变色，圆环下方直观显示加粗百分比或余额（如 68%、64%、$4.67）。
   • 鼠标悬停即刻向外飞出气泡卡片 (Speech Bubble Popover)，指针尖角精准对齐当前图标，详细展示模型组配额进度、倒计时与实时工作状态。
   • 配备抓手支持沿屏幕边缘自如上下拖拽定位。

2. 全新 Codenotch 风格“设置与多账号管理中心”：

   • 采用经典 macOS 两栏式窗口设计，左侧提供红绿灯按钮、品牌与分类导航（账号、外观、通知、通用）。
   • 账号面板：支持拖拽抓手任意调整刘海绘制顺序，提供一键直达官方控制台胶囊按钮、iOS 风格纯蓝滑动开关，以及细粒度的「刘海显示」与「模型数据」选择。
   • 外观面板：支持配置刘海屏幕贴靠位置（右侧/左侧/隐藏仅托盘）、闲置自动半隐与一键召唤桌面刘海浮窗。
   • 通用与通知：高水位与重置系统推送、开机自启、多档后台刷新周期与在线自动更新。

3. 全局矢量资产与 Apple 弹簧物理缓动：

   • 新增独立矢量图标组件 ProviderIcon.vue，重塑 Antigravity、Grok、火山方舟、Codex、Teamo 等图标。
   • 菜单栏弹窗与桌面刘海双向无缝联动。

---

🚀 ArkBar v0.3.7 更新说明

🛠 v0.3.7 修复：TeamoRouter 余额与今日费用不再显示 --

• 修复「账户余额」「今日费用」两张卡片始终显示 -- 的问题。
  • 根因：TeamoRouter 现网接口的金额是对象形态 {"value":"4.67380993","currency":"USD"}，而解析逻辑只接受纯字符串，导致金额恒为空值。
  • 现在同时兼容对象 / 字符串 / 数字三种形态，并优先采用接口返回的 currency（缺省 USD）。
• 补强测试：新增对象形态、数字形态与异常载荷用例；带 TEAMO_TEST_TOKEN 的联网用例现在会断言余额与今日费用确实解析成功，防止同类静默回归。

🚀 ArkBar v0.3.6 更新说明

🛠 v0.3.6 优化

• TeamoRouter 页面固定展示「账户余额」和「今日费用」；同步完成前显示 --，避免旧缓存导致两张卡片消失。
• TeamoRouter 缓存命中率统一四舍五入到 1 位小数（例如 69.1%），不再显示冗长小数。

🛠 v0.3.5 修复（保留）

🛠 v0.3.5 修复

• 修复 TeamoRouter 已配置 API Key 后仍显示「请在设置中填入 API Key」的问题。
  • 根因：HTTP 客户端误将 curl 进程退出码 0 判断为非 2xx HTTP 状态，导致成功响应被错误丢弃。
  • 现在 Teamo 成功响应会正常入库并展示余额、当日费用、Token 与缓存命中统计。

🌟 v0.3.4 更新说明（保留）

🌟 本次版本核心更新：接入 TeamoRouter 余额与用量统计

1. TeamoRouter 新服务商接入：
   • 新增 TeamoRouter 标签页，使用官方开放接口实时查询账户余额、今日费用、Token 用量与缓存命中率。
   • 支持近 5 小时 / 今日 / 本周 / 本月多维度 Token 统计，以及月度上下文缓存命中展示。
   • 设置页新增 TeamoRouter API Key 本地保存入口（存储在 ~/.ark-bar/tokens.json）。
   • 主面板直观展示「账户余额」与「今日费用」两张金额卡片。

🌟 0.3.3 更新说明（保留）

1. Grok / 全厂商用量切换秒级静默更新（彻底免手动刷新）：

   • 切换顶部服务商标签或从其他窗口唤醒 ArkBar 菜单栏面板时，前端自动以 force = true 在后台静默获取最新实时数据。
   • 保证 0 延时平滑切 Tab 的同时，最新用量数百毫秒内平滑就绪，再也不需要手动去点「刷新」按钮。
   • 容错兼容 Grok CLI onDemandUsed / onDemandCap 结构化对象提取。

2. 上下文缓存 (Prompt Cache) 命中统计全面重构：

   • 消除误导性的 --：此前 0 命中时会被 JS 判定为 falsy 从而显示为 -- 导致误以为接口报错；现全面区分厂商能力与真实命中。
   • 火山方舟 & Codex 精准呈现：当月累计缓存命中量（如月 2.11M）与缓存命中率（如 68.5%）精准呈现；今日有命中高亮显示，今日未命中但本月有命中展示月度累计。
   • 主面板 Token 胶囊展示真实月度命中率：顶部「本月已消耗 X.XXM Tokens」胶囊右侧准确展示当月整体缓存命中率（如 ⚡ 缓存命中 68.5%）。
   • Grok & Antigravity 诚实标注：官方接口未开放上下文 Prompt Cache 指标的厂商诚实标注为 暂不支持。

---

🌟 0.3.x 核心特性回顾

• 服务商自由调序与显隐自定义：主面板支持拖拽排序，设置中心支持微调与隐藏不需要的服务商。
• 检查更新极致优化：异步非阻塞命令，彻底解决卡顿，解决 WebKit 焦点重置跳回顶部问题，新版本提示置顶。
• 多厂商 Token 详细用量看板：全面支持近 5 小时、今日、本周、本月 Token 消耗统计，Prompt/Completion/Cache 命中拆解。
• 历史明细报表与数据导出：过去 14~30 天历史柱状走势图、按日明细表格及 JSON 一键导出。
• 状态栏托盘增强：支持显示今日 Token（如 🔥 602K）、5小时 Token、配额百分比等多种模式。

---

⚠️ macOS 首次打开提示“应用已损坏，无法打开”解决办法

由于开源项目未购买苹果商业开发者证书，从浏览器下载后 macOS Gatekeeper 会自动对应用添加隔离标记。
解决方法：打开系统自带「终端」(Terminal.app)，复制并执行以下命令回车即可：

xattr -dr com.apple.quarantine /Applications/ArkBar.app

---

📦 安装包下载指引

• macOS (Apple Silicon M1/M2/M3/M4 系列): ArkBar_*_aarch64.dmg
• macOS (Intel 处理器): ArkBar_*_x64.dmg
• Windows (64位安装包): ArkBar_*_x64-setup.exe（或 .msi）

ArkBar v0.4.6

🚀 ArkBar v0.4.4 更新说明

🎨 二级悬浮详情卡片 UI 与滚动条全面重塑

1. 告别丑陋默认滚动条，重塑 Apple 极简悬浮微条：
   • 彻底移除卡片内部死板的 max-h-[360px] 嵌套滚动容器，卡片高度根据内容自适应舒展。
   • 重构滚动条交互与样式：默认状态完全透明隐藏，仅在鼠标悬停或滑动时轻柔浮现 4px 极细半透药丸胶囊微条 (rgba(255, 255, 255, 0.2))，轨道 100% 透明，完全贴合 macOS 原生 Overlay Scrollbar 质感。
2. 彻底解决文字折行与文字挤压问题：
   • 卡片宽度适度由 254px 拓宽至 290px，为中文配额名称与倒计时重置提供充足横向排版空间。
   • 增加 nowrap 与 shrink-0 保护，彻底消除「Gemini 5小时限」折行落单「额」、「周三 13:51」折行落单「重置」的不良排版。
3. 修复悬停下方项时卡片被浮窗下边界截断的问题：
   • 浮窗高度由 580px 提升至 680px（对齐 Codenotch 官方 NOTCH_LONG = 650.0 规范），悬停底部厂商项时提供充裕垂直呼吸空间，底部 Token 统计信息完整展现。
4. 气泡卡片与尖尾有机无缝融合：
   • 卡片与弯角尖尾统一采用 #0e0f14 质感黑，优化重合层级与阴影投影，彻底消除割裂分割线。

---

🚀 ArkBar v0.4.3 更新说明

🌟 极致对齐 Codenotch：原生光标监听悬停秒级呼出、离手即收、纯正 Apple 物理动效

1. 原生光标守护进程 (Native Cursor Watchdog)：

   • 彻底解决 macOS 下未激活窗口无法接收 WebKit mousemove/mouseenter 导致“必须点击一下才展开”的问题。
   • Rust 后台以 35ms 超高频实时比对全局屏幕光标位置与屏幕刘海 Hot Zone，光标一碰即开，真正做到悬停秒开，无需任何点击。
   • 智能接管窗口穿透模式 (set_ignore_cursor_events)，未悬停时全透不拦截下层应用点击，触碰时瞬间唤醒并交接交互。
   • 光标移开刘海与详情气泡后，严格倒计时 450ms 优雅折叠收起，彻底杜绝“移开很久都不关闭”的问题。

2. 百分百对齐 Codenotch 视觉动效与部件：

   • 收起形态 (#rest)：闲置时化为 10px × 79px 的极简边缘胶囊，与屏幕右边缘完全贴合。
   • 凹曲面过渡菲林 (Fillets)：采用标准 --fillet: 38.7px 径向渐变算法，无缝将刘海岛与屏幕边缘融为一体。
   • 交互手柄 (Handles)：
     • 顶部 Move Handle：闲置时 quarter-arc 嵌套在凹曲面中，悬停时展开为拖动抓手与携带手形。
     • 底部 Settings Orb：闲置时嵌入底部凹曲面，悬停时轻盈转出齿轮图标，点击直接打开偏好设置。
   • 阶梯延迟展开动画 (Staggered Animation)：展开时各厂商仪表环依序带弹簧动效滑入 (calc(var(--i) * 28ms))。
   • 气泡卡片与有机弯角尖尾 (#card & #tail)：采用 Codenotch 官方曲面 SVG 尖尾路径，尖端精准契入当前环形仪表中心。

---

🚀 ArkBar v0.4.0 更新说明

🌟 本次版本核心更新：参考 Codenotch 全面重构 UI 视觉与交互动效

1. 全新屏幕边缘“灵动刘海”挂件 (Screen Edge Notch)：

   • 贴靠屏幕边缘的 Apple 有机黑透曲面悬浮岛，支持右侧/左侧贴靠与闲置自动半隐。
   • 垂直排列各 AI 厂商项，每项配备环形刻度仪表盘 (Circular Ring Gauge)，SVG 进度弧线采用弹簧阻尼动画，依水位动态三色变色，圆环下方直观显示加粗百分比或余额（如 68%、64%、$4.67）。
   • 鼠标悬停即刻向外飞出气泡卡片 (Speech Bubble Popover)，指针尖角精准对齐当前图标，详细展示模型组配额进度、倒计时与实时工作状态。
   • 配备抓手支持沿屏幕边缘自如上下拖拽定位。

2. 全新 Codenotch 风格“设置与多账号管理中心”：

   • 采用经典 macOS 两栏式窗口设计，左侧提供红绿灯按钮、品牌与分类导航（账号、外观、通知、通用）。
   • 账号面板：支持拖拽抓手任意调整刘海绘制顺序，提供一键直达官方控制台胶囊按钮、iOS 风格纯蓝滑动开关，以及细粒度的「刘海显示」与「模型数据」选择。
   • 外观面板：支持配置刘海屏幕贴靠位置（右侧/左侧/隐藏仅托盘）、闲置自动半隐与一键召唤桌面刘海浮窗。
   • 通用与通知：高水位与重置系统推送、开机自启、多档后台刷新周期与在线自动更新。

3. 全局矢量资产与 Apple 弹簧物理缓动：

   • 新增独立矢量图标组件 ProviderIcon.vue，重塑 Antigravity、Grok、火山方舟、Codex、Teamo 等图标。
   • 菜单栏弹窗与桌面刘海双向无缝联动。

---

🚀 ArkBar v0.3.7 更新说明

🛠 v0.3.7 修复：TeamoRouter 余额与今日费用不再显示 --

• 修复「账户余额」「今日费用」两张卡片始终显示 -- 的问题。
  • 根因：TeamoRouter 现网接口的金额是对象形态 {"value":"4.67380993","currency":"USD"}，而解析逻辑只接受纯字符串，导致金额恒为空值。
  • 现在同时兼容对象 / 字符串 / 数字三种形态，并优先采用接口返回的 currency（缺省 USD）。
• 补强测试：新增对象形态、数字形态与异常载荷用例；带 TEAMO_TEST_TOKEN 的联网用例现在会断言余额与今日费用确实解析成功，防止同类静默回归。

🚀 ArkBar v0.3.6 更新说明

🛠 v0.3.6 优化

• TeamoRouter 页面固定展示「账户余额」和「今日费用」；同步完成前显示 --，避免旧缓存导致两张卡片消失。
• TeamoRouter 缓存命中率统一四舍五入到 1 位小数（例如 69.1%），不再显示冗长小数。

🛠 v0.3.5 修复（保留）

🛠 v0.3.5 修复

• 修复 TeamoRouter 已配置 API Key 后仍显示「请在设置中填入 API Key」的问题。
  • 根因：HTTP 客户端误将 curl 进程退出码 0 判断为非 2xx HTTP 状态，导致成功响应被错误丢弃。
  • 现在 Teamo 成功响应会正常入库并展示余额、当日费用、Token 与缓存命中统计。

🌟 v0.3.4 更新说明（保留）

🌟 本次版本核心更新：接入 TeamoRouter 余额与用量统计

1. TeamoRouter 新服务商接入：
   • 新增 TeamoRouter 标签页，使用官方开放接口实时查询账户余额、今日费用、Token 用量与缓存命中率。
   • 支持近 5 小时 / 今日 / 本周 / 本月多维度 Token 统计，以及月度上下文缓存命中展示。
   • 设置页新增 TeamoRouter API Key 本地保存入口（存储在 ~/.ark-bar/tokens.json）。
   • 主面板直观展示「账户余额」与「今日费用」两张金额卡片。

🌟 0.3.3 更新说明（保留）

1. Grok / 全厂商用量切换秒级静默更新（彻底免手动刷新）：

   • 切换顶部服务商标签或从其他窗口唤醒 ArkBar 菜单栏面板时，前端自动以 force = true 在后台静默获取最新实时数据。
   • 保证 0 延时平滑切 Tab 的同时，最新用量数百毫秒内平滑就绪，再也不需要手动去点「刷新」按钮。
   • 容错兼容 Grok CLI onDemandUsed / onDemandCap 结构化对象提取。

2. 上下文缓存 (Prompt Cache) 命中统计全面重构：

   • 消除误导性的 --：此前 0 命中时会被 JS 判定为 falsy 从而显示为 -- 导致误以为接口报错；现全面区分厂商能力与真实命中。
   • 火山方舟 & Codex 精准呈现：当月累计缓存命中量（如月 2.11M）与缓存命中率（如 68.5%）精准呈现；今日有命中高亮显示，今日未命中但本月有命中展示月度累计。
   • 主面板 Token 胶囊展示真实月度命中率：顶部「本月已消耗 X.XXM Tokens」胶囊右侧准确展示当月整体缓存命中率（如 ⚡ 缓存命中 68.5%）。
   • Grok & Antigravity 诚实标注：官方接口未开放上下文 Prompt Cache 指标的厂商诚实标注为 暂不支持。

---

🌟 0.3.x 核心特性回顾

• 服务商自由调序与显隐自定义：主面板支持拖拽排序，设置中心支持微调与隐藏不需要的服务商。
• 检查更新极致优化：异步非阻塞命令，彻底解决卡顿，解决 WebKit 焦点重置跳回顶部问题，新版本提示置顶。
• 多厂商 Token 详细用量看板：全面支持近 5 小时、今日、本周、本月 Token 消耗统计，Prompt/Completion/Cache 命中拆解。
• 历史明细报表与数据导出：过去 14~30 天历史柱状走势图、按日明细表格及 JSON 一键导出。
• 状态栏托盘增强：支持显示今日 Token（如 🔥 602K）、5小时 Token、配额百分比等多种模式。

---

⚠️ macOS 首次打开提示“应用已损坏，无法打开”解决办法

由于开源项目未购买苹果商业开发者证书，从浏览器下载后 macOS Gatekeeper 会自动对应用添加隔离标记。
解决方法：打开系统自带「终端」(Terminal.app)，复制并执行以下命令回车即可：

xattr -dr com.apple.quarantine /Applications/ArkBar.app

---

📦 安装包下载指引

• macOS (Apple Silicon M1/M2/M3/M4 系列): ArkBar_*_aarch64.dmg
• macOS (Intel 处理器): ArkBar_*_x64.dmg
• Windows (64位安装包): ArkBar_*_x64-setup.exe（或 .msi）