NetStats

macOS 原生菜单栏系统监控工具，快速查看 CPU、内存、网络速度、公网 IP 和 Clash Verge Dev 状态。

中文 | English

如果 NetStats 对你有帮助，欢迎点一个 Star，让更多 macOS 用户看到它。

目录

• 安装
• 系统要求
• 特性
• 隐私
• 常见问题
• 从源码构建
• 项目资料
• 贡献
• 开源协议

安装

Homebrew

brew tap autumncry/tap
brew install --cask netstats

当前 Homebrew cask 使用同一个公开 GitHub Release DMG。第一版公开构建未签名，macOS 首次打开时可能仍会拦截。

DMG

从 GitHub Releases 下载最新的 NetStats-*.dmg，打开后将 NetStats.app 拖到 /Applications。

第一版公开构建未签名，macOS 首次打开时可能拦截。可以到 系统设置 > 隐私与安全性 中允许打开，或按住 Control 点击 App 后选择 打开。

npm

@autumncry/netstats npm 包已经准备好，发布到 npm 后可使用：

npx @autumncry/netstats install

npm 安装器会下载匹配版本的 GitHub Release DMG 并打开它。它不会在 postinstall 阶段自动安装软件。

系统要求

• macOS 14.0 或更高版本
• Apple Silicon 和 Intel Mac 均可从源码构建
• Clash Verge Dev 状态展示需要本机已安装并运行 Clash Verge Dev

特性

• 菜单栏和详情面板显示 CPU 使用率
• 显示内存负载、已用内存、缓存内存、压缩内存
• 显示硬盘容量、磁盘读写速度、电源状态、网络上传/下载速度和本次会话流量
• 显示 CPU、内存、硬盘、网络等分类的进程排行；无法通过稳定公开 API 获取的分类会显示明确原因
• 显示短历史趋势，帮助判断 CPU、内存、网络和硬盘读写是否只是瞬时峰值
• 显示公网 IPv4、地理位置，并支持复制 IP
• 显示 Clash Verge Dev 状态：运行状态、系统代理状态、TUN 状态、规则/全局/直连模式、订阅已用/总流量、代理组、当前节点
• 可配置哪些指标显示在菜单栏和悬停提示中，也可以开关硬件、硬盘、网络、Clash 等面板模块
• 可关闭公网 IP 与地理位置查询，进入更严格的本地优先模式
• AppKit + SwiftUI 原生 macOS 界面
• 支持中文和英文切换

隐私

NetStats 的系统指标、网络速度、进程排行与 Clash Verge Dev 状态均在本机读取和处理，不会上传到 NetStats 的任何项目服务器。Clash Verge Dev 状态展示只读取本机配置、Mihomo 本地控制接口和 macOS 系统代理状态。公网 IP 与地理位置功能需要请求 ipinfo.io 以解析当前公网出口；如果你不需要该信息，可以在设置中关闭公网 IP 地理位置查询。

更多细节见 Privacy 和 Permissions。

常见问题

为什么 macOS 提示无法验证开发者？

当前公开 DMG 未签名、未 notarize。你可以从 GitHub Release 下载源码自行构建，或在确认来源后通过 macOS 的隐私与安全性设置允许打开。

Clash Verge Dev 信息从哪里读取？

NetStats 会读取本机 Clash Verge Dev 的配置文件、进程状态、系统代理状态，以及本机可访问的 Mihomo 控制接口。它不会把这些信息上传到 NetStats 服务器。

NetStats 会控制或关闭 Clash Verge Dev 吗？

不会。NetStats 只展示 Clash Verge Dev 的运行、系统代理、TUN、模式、订阅流量和节点状态，不会退出、重启或反向控制 Clash Verge Dev。

为什么 npm 命令暂时不能直接安装？

npm 包源码已经在仓库中准备好，但发布到 npm registry 需要完成 npm 登录后再执行 npm publish --access public。在此之前，请优先使用 GitHub Release DMG。

从源码构建

git clone https://github.com/autumncry/netstats.git
cd netstats
swift build -c release

打包菜单栏 App：

scripts/package_app.sh
open build/NetStats.app

生成 DMG：

scripts/package_dmg.sh
open dist

项目资料

• Roadmap：后续功能、分发方式和设计原则
• Website：NetStats 项目落地页
• Changelog：版本更新记录
• Release Notes：当前版本发布说明
• Release Checklist：后续版本发布检查清单
• Privacy：数据读取、外部请求和本地优先边界
• Permissions：当前权限模型和受限指标说明
• Product Growth：产品力改进和 SEO 增长计划
• Contributing：开发环境、PR 要求和隐私注意事项
• Security：安全与隐私问题报告方式
• Launch Kit：项目介绍和传播文案

贡献

Issue 和 Pull Request 都欢迎。适合贡献的方向包括：更多菜单栏指标、签名与 notarization、Homebrew tap 维护、更多代理客户端状态适配。

如果你愿意帮忙传播，可以参考 Launch Kit 里的项目介绍和发帖文案。

如果 NetStats 对你有帮助，欢迎点一个 Star，让更多 macOS 用户看到它。

开源协议

MIT License，详见 LICENSE。