XStats/CHANGELOG.md

更新日志

按版本概述用户可感知的新增、改进、修复与移除；不逐条罗列提交，也不记录仅影响构建和发布流程的改动。

0.14.5 · 2026-10-03

新增

• AI 用量支持自选刷新间隔、已用或剩余额度，以及中文万/亿或 K/M/B 数字单位。
• 新增美元/人民币费用估算，按公开 API 基础单价计算，不含阶梯加价，非订阅账单。
• Codex 额度新增套餐标签、有效期进度、可用重置卡和最早到期时间，仅作只读展示。

改进

• AI 用量新增小时与每日柱状图，支持今天、最近 7 天、最近 30 天和累计；菜单栏弹窗保留三个短周期，主窗口提供年度热力图。
• 改善按钮与分段选项的按压、键盘反馈和文字对比度，优化紧凑布局并适配减少动态效果。
• 在线更新改用新的区域入口，连接失败时自动切换备用线路。
• 为支持小时图，升级后的首次刷新会重新统计本地日志，后续仍采用增量读取。

修复

• 修复累计摘要与图表统计范围不一致的问题，摘要、费用与模型排行统一跟随所选时间范围。
• 修复英文界面的累计选项仍显示中文的问题，补齐 AI 用量译文并改善长文案和从右到左布局。

0.14.4 · 2026-10-01

修复

• 修复点击菜单栏图标后弹窗偶发不显示或变为透明的问题，改善快速关闭、重开和连续点击的响应。

0.14.3 · 2026-10-01

改进

• 日历日期与星期按应用语言显示，周起始日采用系统默认并支持手动选择。
• 新安装按使用地区设置日历默认选项，保留已有日历用户的显示偏好。
• 合并“节气与时令”设置，星期固定显示，简化农历与假期相关选项。
• 减少菜单栏实时预览与磁盘应用排行的重复计算，保持原有数据和采样频率。

修复

• 修复关闭农历后菜单栏仍显示农历的问题，重新开启时恢复原显示方式。
• 修复日历弹窗首次展开时详情和假期概览未完整计入高度的问题。
• 修复菜单栏预览在 Retina 屏幕上的位图缩放问题。
• 修复未覆盖年份沿用假期概览的问题，明日安排小组件区分功能关闭与数据缺失。

移除

• 移除月历中的日干支显示及独立开关，黄历详情仍保留干支信息。

0.14.2 · 2026-09-30

改进

• 统一菜单栏弹窗的标题图标与紧凑间距，网络改用与主窗口一致的图标。

修复

• 修复确认更新后更新源发生变化时提示不明确的问题，改为提示重新检查后再安装。
• 修复跳过已撤回版本后，仍显示有更新的问题。
• 修复部分应用卸载成功后仍显示失败、列表未更新或程序坞图标未移除的问题。

0.14.1 · 2026-09-30

改进

• 在线更新接入 Sparkle，保留检查策略、跳过版本和系统通知；仅在点击安装后下载，旧版仍可通过原有更新入口升级。
• 更新摘要支持中英文，跟随应用语言显示；GitHub Release 同时提供中英文说明。
• 卸载列表就绪后即可操作，应用大小在后台计算；关闭页面或刷新时取消旧扫描。

修复

• 修复取消在线更新后仍可能继续安装的问题，并在安装前协调桌面小组件退出。
• 修复卸载时可能退出 XStats 自身、删除期间改变选择，以及仅清理残留时误移除 Dock 图标的问题。
• 修复跳过版本时误提示“已是最新版本”，以及已发现的新版本被后续检查失败隐藏的问题。
• 修复关闭公网 IP 查询或暂停监控后，旧请求仍可能回写结果与缓存的问题。

0.14.0 · 2026-09-29

新增

• 菜单栏网速旁可选显示公网 IP 归属地的国旗或地区文字，复用网络详情的查询结果，不增加网络请求。
• 进程页新增系统活动监视器入口；关闭内置进程功能时，进程快捷键改为打开活动监视器。

改进

• 进程管理改为默认关闭的可选功能，可在通用设置中按需开启；其他监控页的应用用量展示保持可用。
• “AI 用量与额度”统一简化为“AI 用量”，同步多语言名称与说明。
• 优化卸载确认弹窗的按钮、文案和长应用名排版，明确所选项目与废纸篓恢复方式。

修复

• 修复在线更新安装后可能无法自动启动的问题；从旧版首次升级后若未自动启动，可手动打开一次。
• 修复卸载前退出菜单栏应用后，“正在运行”提示及卸载按钮未及时刷新的问题。

0.13.1 · 2026-09-29

新增

• 通知设置新增默认开启的版本更新提醒；后台发现新版本时发送系统通知，点击即可查看更新内容，同一版本只提醒一次。
• 主窗口新增 GitHub 和赞助入口。

改进

• 降低月历、菜单栏图标与本机 AI 用量统计的资源占用；关闭窗口时停止设置预览的实时刷新。
• 月历从单日详情返回后恢复当前日期的选中状态，并优化月历布局。
• 没有风扇或尚未读取到风扇数据的 Mac 隐藏风扇入口。

修复

• 修复夏令时切换时日历标记可能遗漏，以及取消清理扫描时可能继续处理部分目录的问题。

0.13.0 · 2026-09-28

新增

• 菜单栏日历新增日期与农历显示方式、悬停展开、黄历详情、假期倒计时与请假建议；可在明确授权后只读显示系统日程和到期提醒，并选择来源列表。
• 全局快捷键新增“打开日历”，隐藏菜单栏日历入口时仍可使用。
• 本机信息页可复制更新安装标识，不直接展示标识内容。

改进

• 新安装使用设备序列号的散列值去重更新检查，旧安装沿用原有标识；原始序列号不会上传。
• 月历弹窗按屏幕空间调整尺寸，单日详情将日程放在黄历下方；跨天日程在后续日期显示“续”。

修复

• 日历授权或内容变化后会重新读取日程与提醒，刷新时保留上次结果，避免列表短暂消失。
• 修复清理及 Codex 额度查询结束子进程时可能卡住的问题；取消清理时安全结束输出读取。

0.12.1 · 2026-09-28

改进

• 在线更新安装完成后，应用退出不再等待屏幕使用时间写入。

移除

• 移除屏幕使用时间统计、历史页图表与今日桌面小组件；不再为此读取键鼠空闲时间或系统电源日志。

0.12.0 · 2026-09-28

新增

• 清理工具新增 Homebrew 旧版本与缓存预览，实际清理交由 Homebrew 执行，不自动移除依赖。
• 新增项目产物清理：可配置扫描目录，逐项选择构建产物移到废纸篓；Git 跟踪或无法确认的内容会保留。

改进

• 清理功能改为默认关闭的可选模块；清理时显示当前项目与处理进度，并可取消剩余步骤。停止后会说明已清理的部分无法恢复。
• 清理前按所选项目的实际删除方式提示是否不可恢复；Homebrew 清理中断后不再把无法确认的释放量显示为确定值。

修复

• 蓝牙设备列表不再把 Mac 内置电池显示为蓝牙配件。

0.11.0 · 2026-09-27

新增

• 番茄钟新增“工作番茄”：手动开始工作后自动交替专注与休息，每完成四轮专注进入长休，下班时可明确结束。
• 历史页新增按天统计的屏幕使用时间，并在桌面小组件显示今日摘要；运行时会扣除当前连续空闲超过五分钟的部分，电源日志补录的数据标注为估算。
• 主窗口新增问题反馈入口，可打开 GitHub 错误报告模板或撰写邮件；邮件自动填入应用版本、构建号和 macOS 版本。

改进

• 蓝牙配件充电时在电量指示中显示闪电标志，并按剩余电量使用不同颜色。
• Codex 订阅额度优先通过本机 CLI App Server 查询；直接查询被网页拦截时不再误报登录失效，保留上次成功的额度。

修复

• 启动时自动检查更新若因网络暂不可用而失败，后续会继续重试；停止测速后，延迟回调不再把界面恢复为“测试中”。
• 旧版备份恢复番茄钟设置时，单次模式不再被错误地改成循环模式。

0.10.0 · 2026-09-26

新增

• 新增可选的番茄钟与护眼休息：支持专注、短休、长休及单次或循环计时；休息时显示多屏幕布，可按 Esc 或长按跳过，并提供 Mini HUD、桌面小组件和本地合成的休息声音。
• 菜单栏新增“双行居中”风格，标签比数值宽时数值仍居中显示；可设为整体风格，也可单独用于某个指标。

改进

• 自动检查更新可选运行时静默、启动时、每日、每周、每月或从不；旧设置会保留原有开关意图，手动检查始终可用。
• 检测到 VPN 或代理时，网络测速可选直连或经代理；经代理的延迟改按目标响应测量，国内三网延迟改用运营商标志标识。

修复

• 番茄钟在睡眠、合盖和锁屏后按真实截止时间结算，不把无人值守期间完成的专注计入每日目标；休息声音在输出设备变化或暂时启动失败后可恢复。
• 修正系统日历不是公历时，日历小组件可能找不到日期或放假信息；应用更新后也会重算内置日历数据。
• 移除 Sub2API 备用额度配置后，尚未完成的查询不再写回旧额度；卸载器也能正确找到应用的 Application Scripts 目录。

0.9.3 · 2026-09-25

新增

• 新增大尺寸整月日历小组件，显示农历、节假日和休班标记。

改进

• 日历将三伏、梅雨、数九合并为一个开关；月历只标阶段起点，单日日历保留具体天数。
• 本机 AI Token 统计可单独关闭，订阅额度仍可自动查询。
• 非实时主窗口页面不再强制每秒采样；小组件仅在展示数据变化时刷新。

修复

• “明天上班吗”在节日期间优先显示节日名称，不再只显示“周末”。
• 额度页面区分最近成功获取与最近刷新时间，方便识别暂时失联的数据。

0.9.2 · 2026-09-24

新增

• 新增桌面小组件：日历与黄历、明天上班吗、AI 订阅额度、今日消耗的 Token、IP 纯净度及公网 IP。

改进

• “明天上班吗”区分工作日、周末、法定节假日和调休安排；节假日直接显示名称，暂无可靠数据时不推断是否上班。
• IP 小组件补充归属地、AS 和风险标记；AI 与 IP 小组件仅读取主应用共享的展示数据，不自行查询账号或网络。

修复

• 应用内更新时先退出旧版小组件扩展，避免升级后继续显示旧版组件清单。

0.9.1 · 2026-09-24

改进

• AI 用量弹窗将订阅额度与“本地用量”分开标示，并调整刷新、数据来源与主窗口入口的图标和顺序。
• 额度重置进度条改为表示剩余时间，百分比与重置时间同行显示。

修复

• 没有可用订阅额度的来源不再占用菜单栏位置；本机 Token 统计仍独立显示。

0.9.0 · 2026-09-24

新增

• “AI 用量与额度”显示 Codex、Claude Code 的订阅剩余额度与重置进度；本机账号查询失败时，可为各来源配置 Sub2API 备用查询。
• 保留最近一次成功获取的额度；临时查询失败时显示数据获取时间，方便判断信息是否仍然有效。

改进

• 菜单栏新增多种额度显示样式，支持同时查看两个来源；AI 额度配置改用独立窗口。
• 优化主窗口导航、菜单栏预览和更新提示的排版。

修复

• 区分凭据失效和临时服务故障，避免误清额度；过期的额度窗口不再显示在菜单栏。

0.8.1 · 2026-09-23

新增

• 在“设置 → 关于”提供服务条款和隐私政策，说明本机数据、更新检查及用户自行配置的 WebDAV 同步。

改进

• 卸载应用前增加二次确认，并说明移入废纸篓的项目可恢复。
• 调整法律文档的关闭入口和正文排版，提高可读性。

0.8.0 · 2026-09-23

新增

• 新增本机 Codex、Claude Code Token 使用统计，支持模型排行、趋势与活动热力图。
• 新增可单独启用的菜单栏日历，支持农历、节假日、节气等内容。

改进

• AI 统计与日历改为独立开关；日历设置集中在启用后的配置窗口。
• 优化日历年份选择与本机 Apple 智能可用状态的提示。

修复

• 检查更新不再因读取安装标识而弹出钥匙串授权窗口。

移除

• 进程解释不再使用 CLI 备用服务，仅在本机 Apple 智能可用时提供解释。

0.7.1 · 2026-09-22

新增

• 清理页支持 npm、Yarn、pnpm、Bun、Go、Rust 与 uv 缓存。

改进

• 开发工具缓存默认不勾选并记住选择；清理结果显示实际释放空间，失败时保留原缓存并说明原因。
• 辅助工具设置仅提示签名状态，不展示签名团队标识。

0.7.0 · 2026-09-22

新增

• 新增多语言选择与搜索，支持繁体中文、日语、韩语、德语、西班牙语、法语和阿拉伯语。
• 支持用户自行配置 WebDAV，手动备份或恢复设置；备份不包含监控数据、历史记录和连接凭据。

移除

• 移除 GitHub、Google、Apple 账号登录及后台自动同步。