Skip to content

Latest commit

 

History

56 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ColdHot

ColdHot 是一个轻量的原生 macOS 菜单栏性能监控工具。点击菜单栏仪表图标即可查看实时指标,并可在设置中选择希望显示的内容。

功能

  • 7 个一级指标:CPU、GPU、内存、磁盘、网络、热状态和电池
  • 点击指标卡片展开详情,同一时间只展开一张卡片
  • CPU 分项、系统负载、每核心利用率、高 CPU 与高唤醒进程
  • GPU Renderer/Tiler 利用率、显示器分辨率与刷新率
  • 内存压力、构成、Swap 与高内存进程
  • 磁盘容量、IOPS、累计吞吐与高读写进程
  • 网络接口、数据包、累计流量及可选主动延迟测试
  • 热状态、CPU/GPU/内存/NAND/电池/风道/Wi-Fi/PMU 按需温度
  • 电池健康、循环次数、剩余时间、电气信息与 SMC 实时功率
  • Dock 自动隐藏边缘触发零延迟快捷开关
  • 20 项可配置菜单栏阈值,超限时使用双行读数并每 5 秒轮换
  • 阈值激活摘要、可选系统通知与恢复通知,通知带防打扰冷却
  • 每张卡片展开后显示最近 60 秒轻量趋势
  • 极简、日常和诊断三种指标预设,并可检测本机传感器能力与 ColdHot 自身开销
  • 可选择本地图片、GIF 或视频作为整个菜单面板背景,并独立调节裁切位置、深色遮罩、卡片、主文字、辅助文字和进度条透明度
  • 设置页按菜单面板真实尺寸和当前指标数量实时预览背景裁切与可读性效果
  • 折叠面板至少容纳 4 张卡片,并按当前指标数量增长;7 张卡片会完整展示且不出现滚动条提示
  • 展开卡片时会以动画定位到可视区域顶部,之后的手动滚动不会被抢回
  • 官网版内置签名自动更新,可从 GitHub Release 安全升级,无需自建更新服务器
  • 1 秒、2 秒或 5 秒采样间隔
  • 一级指标与详细项目独立选择并持久化

构建

项目目前仅维护官网 / GitHub 分发版:

  • ColdHot Direct:官网/GitHub 分发版,保留完整传感器、进程排行和 Dock 快捷控制。

仓库中的 ColdHot App Store Scheme 和配置只作为历史内容保留,不再构建或发布。

构建本机可安装的官网版测试包:

./Scripts/build-releases.sh local-test

测试包输出到 dist/local-test/<版本>-<构建号>,使用临时签名,不能公开发布。生产包的证书与公证流程见 DISTRIBUTION.md。

最低系统版本为 macOS 14。应用使用 LSUIElement,因此只显示在菜单栏中,不显示 Dock 图标。

性能设计

采样器直接调用 Mach、libproc、IOKit、CoreGraphics、Network 和 SystemConfiguration,不会周期性启动 top、ps 或 ioreg。收起时只采集摘要;每核心、进程排行等详情只在对应卡片展开时采集。进程排行限制为约每 3 秒更新,磁盘容量限制为约每 30 秒更新。

自定义背景只在导入时处理并保存在 Application Support:静态图片最长边会降采样到 1600 px、移除原始元数据并重新编码为 PNG;GIF 会在本机转换为无声 MP4;视频会验证是否可播放后复制到应用目录。菜单和设置预览使用的静态图或动态封面最长边按需解码到 960 px,指标刷新不会重复读取或缩放原文件。动态内容仅在对应面板可见时播放,关闭后会暂停解码;原文件移动或删除不会影响已经导入的背景。

设置页的外观预览使用固定示例数据,不会启动额外性能采样;预览画布与菜单面板同为 370 px 宽,并按当前启用指标和 Dock 区域展示初始折叠状态的实际背景裁切。

自动更新使用 GitHub Release 托管安装包,并通过仓库中的 appcast 提供版本信息,因此不需要自建服务器。更新包同时经过 Developer ID 签名、Apple 公证和 Sparkle EdDSA 签名校验;性能指标、本地背景媒体与设置不会随更新检查上传。

官网版的电池卡片展开时会尝试通过只读 AppleSMC 键获取系统总功率、直流输入功率和电池功率。SMC 属于未公开接口,机型不支持时会自动回退到电池电压 × 电流的估算值;适配器额定功率不会被当作实时功耗。

官网版的温度项目默认关闭,只在“热状态”卡片展开且对应详细项已勾选,或用户主动启用对应阈值时,通过只读 SMC/HID 传感器采集。阈值后台采样未触发时限制为每 5 秒一次。传感器键和值会按芯片代际过滤,缺失或明显异常的读数不会展示。

网络延迟测试默认关闭;启用后会在网络卡片展开期间约每 10 秒连接一次 1.1.1.1:443。官网版的 Dock 弹出延迟使用 macOS 未公开的偏好键,因此未来系统版本可能不再支持,关闭快捷开关时会恢复修改前的值。

应用的隐私说明见 PRIVACY.md,设置窗口中也可以直接查看。

About

Lightweight native macOS menu bar performance monitor

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages