Files

8.6 KiB
Raw Permalink Blame History

XStats

XStats

把系统状态与常用工具,放进 Mac 菜单栏。

一眼查看 CPU、内存、网络与温度,展开了解趋势和应用占用。 需要时,再开启 AI 用量、日历、风扇控制与清理工具。

Release CI macOS License

下载最新版 · 界面预览 · 功能亮点 · 安装 · 更新日志

简体中文 · English · 日本語 · 한국어

XStats 菜单栏读数

界面预览

主窗口集中查看系统状态,浅色与深色界面跟随你的偏好。

XStats 深色仪表盘 XStats 浅色仪表盘

功能亮点

XStats 使用 Swift、AppKit 与 SwiftUI 原生开发,免费开源,无需注册 XStats 账号。显示哪些指标、使用哪些工具,都由你决定。

菜单栏显示,你来决定

  • 独立显示:为常看的指标保留各自的菜单栏入口。
  • 合并显示:将多个读数放在一组,点开查看状态总览。
  • 仅图标:只保留一个 XStats 图标,展开后查看所选项目。

显示项目、排列顺序和样式都能调整。指标按支持的样式提供文字、图标、圆环、进度条或历史图;不用的项目可以关闭。

系统监控,展开查看详情

模块 可以查看什么
CPU 用户 / 系统 / 空闲占用、逐核负载圆环、核心组占用、负载平均,以及可读取的频率与温度;热压力来自 macOS,异常时突出提示
GPU 图形负载、图形核心等硬件信息,以及可读取的温度与功耗
内存 内存压力、应用与压缩内存、缓存、交换空间与换入换出速率
磁盘 容量、读写速率、应用读写排行,以及可读取的 SMART 健康信息
网络 上传 / 下载速率、网络接口与连接概况
电池与蓝牙 电池电量、供电状态、健康度与循环次数;支持的蓝牙设备电量,无电池的 Mac 也可在菜单栏查看
温度与风扇 多组温度传感器、风扇转速与可用的功耗信息
显示器 型号、分辨率、缩放分辨率、刷新率;支持的外接屏可调节亮度、对比度与音量

CPU 核心类型由系统报告,按实际的超级核、性能核和能效核分组,不按机型固定两组或三组。“本机信息”还提供机型、系统版本和运行时间。

CPU 占用与核心详情 内存构成与压力详情

外接显示器控制依赖显示器、线材和连接方式的 DDC/CI 支持,各控制项独立检测。不支持或暂时无法读取时会显示状态,支持的项目才提供滑杆。

AI 用量与订阅额度

在菜单栏看 Codex / Claude Code 用量,展开后查看统计与额度:

  • Token 统计:今天按小时、最近 7 天 / 30 天按天展示;主窗口还提供年度活动热力图。
  • 订阅额度:可切换已用 / 剩余百分比,查看重置时间,以及来源提供的套餐、有效期和可用重置次数等信息。
  • 费用估算:按模型公开 API 基础单价估算,支持美元 / 人民币;不含阶梯加价,也不代表订阅账单。
  • 显示偏好:自选刷新间隔,数字单位支持中文万 / 亿与 K / M / B。

AI 用量默认关闭。本机统计读取 Codex / Claude Code 会话日志;查询订阅额度需要相应 CLI 已登录,也可手动配置 Sub2API 作为备用来源。

常用工具,按需开启

  • 风扇控制:查看运行状态,在支持的设备上切换自动或手动控制。
  • 防休眠:保持系统或屏幕唤醒,需要时配置合盖运行。
  • 清理与卸载:清理缓存、项目产物与应用相关文件;先预览再确认,也可选择移到废纸篓。
  • 启动项管理:查看和管理登录项目及后台启动项。
  • 网络诊断:按需测速、查询 DNS、检测出口、公网 IP 归属地与纯净度,并探测目标连通情况。
  • 菜单栏日历:农历、节假日与调休、黄历;授权后可查看系统日程和提醒事项。
  • 番茄钟与护眼休息:专注与休息计时、多屏休息幕布,可暂停、跳过或收起到迷你 HUD。
  • 进程管理:启用后查看全部进程,支持搜索、排序、按应用分组与结束进程。

清理、进程、日历、番茄钟与 AI 用量默认关闭,需要时再启用。风扇控制、合盖防休眠等特权操作需要在应用内安装并授权辅助工具。

查看更多工具截图

温度与风扇控制 防休眠设置

清理预览 公网 IP 与纯净度检测

桌面小组件与多语言

小组件包括系统概览、番茄钟、AI 额度、日历与整月日历、明天上班吗、IP 纯净度和公网 IP。

界面支持 9 种语言:简体中文、繁體中文、English、日本語、한국어、Deutsch、Español、Français、العربية。

安装

需要 Apple Silicon Mac、macOS 14 或更新版本。

Homebrew:

brew tap ysicing/tap
brew trust ysicing/tap
brew install --cask xstats

之后可运行 brew upgrade --cask xstats 更新。

直接下载:从 GitHub Releases 下载 DMG,打开后将 XStats 拖入“应用程序”并启动。

应用内置更新检查,发现新版本后,由你决定是否下载安装。源码构建方式见开发指南。

数据与隐私

监控数据、本机历史与 AI Token 统计在本机处理,不上传到 XStats 更新服务。以下功能会连接外部服务,可关闭或按需使用:

  • 检查更新:发送当前版本与安装标识的哈希,获取更新清单。
  • 查询 AI 额度:使用本机 CLI 登录查询对应服务;手动配置备用来源后,查询你指定的服务器。
  • 费用估算:按需获取公开模型单价与参考汇率,不发送会话日志或 Token 统计。
  • 网络诊断:公网 IP、归属地、测速、DNS、连接探测与全球探针会请求相应服务;全球探针的测量目标与结果可能被他人查询。

完整说明见隐私政策和服务条款。

构建与贡献

需要 Xcode 26+、Go 1.25+、Go Task 和 XcodeGen。常用命令:

task test
task build BUMP=0 INSTALL=0

欢迎提交 Issue 和 Pull Request。开发环境与发布流程见 DEVELOPMENT.md,模块边界与实现约束见 ARCHITECTURE.md。

版本记录

最新版本 0.14.5(2026-10-03) · 完整更新日志

致谢与许可

XStats 基于 OpenStats 开发。感谢原项目及其他开源项目的贡献;来源、许可和版权信息见 ThirdPartyNotices.md。XStats 是独立的第三方应用,与 Apple 及其他提及的公司没有隶属关系。

XStats 新增代码与修改采用 AGPL-3.0-or-later,见 LICENSE 和 LICENSING.md。OpenStats 上游代码保留原 MIT 许可。