# XStats **把系统状态与常用工具，放进 Mac 菜单栏。** 一眼查看 CPU、内存、网络与温度，展开了解趋势和应用占用。需要时，再开启 AI 用量、日历、风扇控制与清理工具。 [![Release](https://img.shields.io/badge/%E7%89%88%E6%9C%AC-0.14.5-6ee02b)](https://github.com/ysicing/xstats/releases) [![CI](https://github.com/ysicing/xstats/actions/workflows/ci.yml/badge.svg)](https://github.com/ysicing/xstats/actions/workflows/ci.yml) [![macOS](https://img.shields.io/badge/macOS-14%2B%20%C2%B7%20Apple%20%E8%8A%AF%E7%89%87-black)](https://github.com/ysicing/xstats/releases) [![License](https://img.shields.io/badge/license-AGPL--3.0--or--later-blue)](LICENSE) [下载最新版](https://github.com/ysicing/xstats/releases) · [界面预览](#界面预览) · [功能亮点](#功能亮点) · [安装](#安装) · [更新日志](CHANGELOG.md) **简体中文** · [English](README.en.md) · [日本語](README.ja.md) · [한국어](README.ko.md) 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**： ```bash brew tap ysicing/tap brew trust ysicing/tap brew install --cask xstats ``` 之后可运行 `brew upgrade --cask xstats` 更新。 **直接下载**：从 [GitHub Releases](https://github.com/ysicing/xstats/releases) 下载 DMG，打开后将 XStats 拖入“应用程序”并启动。应用内置更新检查，发现新版本后，由你决定是否下载安装。源码构建方式见[开发指南](DEVELOPMENT.md)。 ## 数据与隐私监控数据、本机历史与 AI Token 统计在本机处理，不上传到 XStats 更新服务。以下功能会连接外部服务，可关闭或按需使用： - **检查更新**：发送当前版本与安装标识的哈希，获取更新清单。 - **查询 AI 额度**：使用本机 CLI 登录查询对应服务；手动配置备用来源后，查询你指定的服务器。 - **费用估算**：按需获取公开模型单价与参考汇率，不发送会话日志或 Token 统计。 - **网络诊断**：公网 IP、归属地、测速、DNS、连接探测与全球探针会请求相应服务；全球探针的测量目标与结果可能被他人查询。完整说明见[隐私政策](Packages/XStatsKit/Sources/XStatsUI/Resources/Legal/Privacy.zh-Hans.md)和[服务条款](Packages/XStatsKit/Sources/XStatsUI/Resources/Legal/Terms.zh-Hans.md)。 ## 构建与贡献需要 Xcode 26+、Go 1.25+、[Go Task](https://taskfile.dev/) 和 [XcodeGen](https://github.com/yonaskolb/XcodeGen)。常用命令： ```bash task test task build BUMP=0 INSTALL=0 ``` 欢迎提交 Issue 和 Pull Request。开发环境与发布流程见 [DEVELOPMENT.md](DEVELOPMENT.md)，模块边界与实现约束见 [ARCHITECTURE.md](ARCHITECTURE.md)。 ## 版本记录最新版本 **0.14.5**（2026-10-03） · [完整更新日志](CHANGELOG.md) ## 致谢与许可 XStats 基于 [OpenStats](https://github.com/gentpan/OpenStats) 开发。感谢原项目及其他开源项目的贡献；来源、许可和版权信息见 [ThirdPartyNotices.md](ThirdPartyNotices.md)。XStats 是独立的第三方应用，与 Apple 及其他提及的公司没有隶属关系。 XStats 新增代码与修改采用 **AGPL-3.0-or-later**，见 [LICENSE](LICENSE) 和 [LICENSING.md](LICENSING.md)。OpenStats 上游代码保留原 [MIT 许可](LICENSES/OpenStats-MIT.txt)。