Skip to content

nicetooo/mac_fan_control

Repository files navigation

Mac Fan Control

一个使用 Wails 构建的 macOS 菜单栏应用,用于控制 Mac 风扇速度。

功能特性

  • 📊 实时显示 CPU 温度
  • 🌀 实时显示风扇转速(RPM)
  • 🎛️ 手动控制风扇速度(1000-6500 RPM)
  • 🤖 自动模式切换
  • 🎨 现代化的玻璃态界面设计
  • 🪟 半透明窗口效果

技术栈

  • 后端: Go + SMC (System Management Controller)
  • 前端: React + TypeScript + Vite
  • 框架: Wails v2.9.2
  • 平台: macOS (Intel & Apple Silicon)

系统要求

  • macOS 10.13 或更高版本
  • 需要管理员权限来访问 SMC

安装依赖

开发环境

  1. 安装 Go (1.21+)
  2. 安装 Node.js (16+)
  3. 安装 Wails CLI:
    go install github.com/wailsapp/wails/v2/cmd/wails@latest

项目依赖

# 安装 Go 依赖
go mod download

# 安装前端依赖
cd frontend
npm install
cd ..

开发

运行开发模式:

wails dev

这将启动热重载开发服务器。

构建

构建生产版本:

wails build

构建完成后,应用程序位于 build/bin/fan_control.app

运行

开发模式

wails dev

生产模式

双击 build/bin/fan_control.app 或使用命令行:

open build/bin/fan_control.app

注意: 首次运行时,macOS 可能会要求授予权限。需要以管理员权限运行才能访问 SMC。

使用说明

  1. 查看状态: 应用启动后会显示当前 CPU 温度和风扇转速
  2. 自动模式: 默认情况下,风扇处于自动模式,由系统控制
  3. 手动模式:
    • 点击 "Switch to Auto" 按钮切换到手动模式
    • 使用滑块调整风扇转速(1000-6500 RPM)
  4. 返回自动: 点击 "Auto Mode Active" 按钮返回自动模式

注意事项

⚠️ 重要警告:

  • 手动设置过低的风扇转速可能导致 Mac 过热
  • 建议不要将风扇转速设置低于 2000 RPM
  • 如果 Mac 温度过高,请立即切换回自动模式
  • 使用本应用的风险由用户自行承担

SMC 键说明

应用使用以下 SMC 键:

  • FNum: 风扇数量
  • F0Ac: 风扇 0 实际转速
  • F0Tg: 风扇 0 目标转速
  • FS! : 风扇强制模式
  • TC0P, TC0D, TC0E, TC0F, TC0c: CPU 温度传感器

兼容性

  • ✅ Intel Mac
  • ⚠️ Apple Silicon (M1/M2/M3): SMC 接口可能有所不同,某些功能可能不可用

故障排除

无法读取风扇速度

  • 确保以管理员权限运行
  • 某些 Mac 型号可能使用不同的 SMC 键

温度显示为 0

  • 应用会尝试多个温度传感器键
  • 如果都失败,可能需要为您的 Mac 型号找到正确的温度键

无法设置风扇速度

  • 需要 root 权限
  • 尝试使用 sudo 运行应用

许可证

MIT License

免责声明

本软件按"原样"提供,不提供任何明示或暗示的保证。使用本软件修改风扇速度可能会损坏您的硬件。作者不对因使用本软件而造成的任何损害负责。

About

mac fan control

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors