🐱 RunCatNeo - macOS 状态栏动态性能猫咪监视器 (二次开发增强版)

A High-Performance, Ultra-Smooth & Customizable macOS Menu Bar Performance Runner

基于开源项目 Kyome22/RunCat_for_macOS 深度二次开发与性能调优

简体中文说明 · English Docs · 报告问题 · 贡献代码

---

🙏 开源致敬与二次开发说明

本项目基于原作者 Kyome (Takuto Nakamura) 开源的杰出项目 RunCat for macOS 进行深度二次开发与性能调优。在此由衷致敬并感谢原作者创造出如此优雅、有趣的 macOS 状态栏经典应用！

🌟 我们的二次开发核心增强点：

1. 非线性动态变速算法与插值平滑 (Non-linear Load Smoothing)：
   • 彻底重构了 CPU / GPU 负载与动画帧率之间的映射算法。
   • 引入动态指数平滑插值（Exponential Smoothing），消除短时间突发高负载造成的奔跑帧率突兀跳变，跑动过渡更加丝滑自然。
2. RunnerBar 状态管理架构重构 (State Machine Refactoring)：
   • 将动画帧管理与系统指标采集彻底解耦，扩展了统一的 RunnerBar 状态管理仓库。
   • 支持多角色、多动作预设的独立配置持久化存储。
3. 极致能耗优化 (Ultra-Low Energy Impact)：
   • 深度优化后台定时采样线程（基于 Grand Central Dispatch 智能降频）；
   • 在 Mac 处于电池供电或屏幕睡眠时自动进入低功耗休眠，常规状态下 CPU 占用率稳定保持在 0.1% 以下。
4. 悬浮信息气泡与硬件指标直观展示 (Hardware Insight Popover)：
   • 鼠标悬停或点击即可即时展开硬件监视气泡：多核 CPU 使用率分布、内存压力等级、电池续航状态与网络上下行实时速率。

---

📖 产品功能全景展示

1. 🏃 随心所欲的动态奔跑者

• 生动直观的负载反馈：当你的 Mac 闲置时，猫咪迈着悠闲的小碎步；当你在编译大型工程、渲染 3D 或运行大模型时，猫咪会开启“光速狂奔模式”！
• 丰富的预设角色库：内置经典猫咪、柴犬、金鱼、水獭、像素史莱姆、火箭推进器等多种奔跑者。

2. 📊 全维度轻量硬件监视面板

• 多核 CPU 监视：精确展示每个核心的 User / System / Idle 占比；
• 内存使用追踪：直观展示已用内存、联动内存 (Wired) 与压缩内存 (Compressed)；
• 磁盘与存储状态：实时读取读写 IOPS 与剩余磁盘空间；
• 网络上下行流量：菜单栏实时显示当前上传/下载带宽占用。

---

🏗️ 架构设计与工程目录

RunCatNeo/
├── RunCatNeo/                 # 主程序入口、菜单栏控制器与 UI 视图
│   ├── AppDelegate.swift      # 生命周期与状态栏初始化
│   ├── Views/                 # SwiftUI 悬浮气泡与偏好设置面板
│   └── Assets.xcassets/       # 奔跑者高分辨率序列帧资源
├── LocalPackage/              # 解耦的底层服务与状态仓库
│   ├── Sources/DataSource/    # Mach Kernel API 硬件指标底层采集器
│   └── Sources/Model/         # RunnerBar 状态机与非线性变速算法
├── RunCatNeo.xcodeproj/       # Xcode 主工程配置
├── ARCHITECTURE.md            # 深度技术架构设计说明
└── LICENSE                    # MIT 开源许可证

---

🚀 编译与本地运行

# 1. 克隆本仓库
git clone https://github.com/9499758-wq/RunCatNeo.git
cd RunCatNeo

# 2. 使用 Xcode 打开主工程
open RunCatNeo.xcodeproj

# 3. 选择 My Mac 作为构建目标，按 Cmd + R 即可一键编译运行！

---

📄 开源许可证与致谢

本项目遵循 MIT License 开源协议。