MACOS / APPLE SILICON

看懂 Mac 的温度。
让风扇有序地工作。

原生菜单栏应用，把温度监测、限时控扇和结构化 CLI 放在一起。你可以自己查看，也可以让 coding agent 按明确边界操作。

交给 Agent 安装阅读安装指南 ↗

本地温控 · Agent 接口　/　源码公开

AgenticFan

温度与风扇

自动模式

74°CPU · 示例

CPU74 °C

GPU62 °C

SSD39 °C

FAN 0 · 示例转速1,800 RPM

$ agenticfan snapshot
→ 温度 · 状态 · 来源 · 时间戳

功能示意 · 温度与转速均为演示数据，不是实时读数

Apple Silicon面向搭载风扇的 Mac

macOS 15+当前构建目标

JSON / NDJSON可组合的 Agent 接口

限时会话明确时长，检查恢复回执

MADE FOR EVERYDAY USE

看得清，也控得住。

从一个温度读数，到一段有结束时间的控扇会话，每一步都有可检查的状态。

温度，带着来源一起读。

查看 SMC 与 IOHID 测点、状态和时间。异常数据保留为异常，不用一个看似正常的数字掩盖读取失败。

调速，有开始也有结束。

每次手动控扇必须指定持续时间，并检查设备支持的转速范围。会话提供目标写入、实际转速与恢复自动的回执。

同一个核心，两种用法。

SwiftUI 菜单栏界面与 CLI 共用采集和控制核心。Agent 可先读取 schema、capabilities 和 doctor，再决定下一步。

从这里，建立自己的工作流。

LOCAL TOOL · CLEAR BOUNDARIES

01 / DISCOVER

先了解这台 Mac

检查硬件、测点状态和可用能力。

02 / OBSERVE

持续读取变化

用界面或 watch 获取带状态的读数。

03 / CONTROL

在明确边界内操作

需要控扇时，指定目标、时长并检查恢复。

GET STARTED

把这件小事，
交给合适的工具。

安装指南会检查当前 DMG 构建、校验和、App、CLI 与 skill。安装本身不调节真实风扇。获取 Actions 构建产物可能需要 GitHub 登录。

阅读完整指南 ↗

给 CODING AGENT 的提示词

请阅读 https://github.com/timmyagentic/agentic-fan 的 INSTALL.md，帮我安装 AgenticFan App、CLI 和 Codex skill，最后只读检查温度和风扇接口。

手动操作 / 只读检查示例

agenticfan doctor
agenticfan snapshot
agenticfan watch --interval 1 --count 10

当前源码为 0.4.2 开发候选，尚未正式发布。历史发行版 v0.4.1 仍使用 MacFan 名称；新的 AgenticFan 构建以安装指南为准。开发包尚未经过 Apple 公证。

KNOW BEFORE YOU START

把边界，
也说清楚。

使用前了解版本、兼容范围与数据含义。
有具体问题，欢迎在 GitHub 提交反馈。

支持所有 Mac 吗？

当前面向 Apple Silicon、macOS 15+ 的构建。真实控扇只在有限机型上验收；没有风扇的 Mac 不具备控扇能力。请以 doctor、capabilities 和仓库硬件验收记录为准。

需要模型、API Key 或远程服务吗？

应用和 CLI 本身不需要模型或 API Key。coding agent 是可选的操作入口，不影响本地监测。

到期一定能恢复自动吗？

应用使用独立守护与读回，尽力在到期、中断和退出时恢复自动模式。仍需检查恢复回执；睡眠、未验收机型和实验路径不能当作已保证的行为。

系统权限如何处理？

读取通常不需要管理员权限。首次安装受限控扇 Helper 需要系统授权。开发包可能被 Gatekeeper 提示，按系统界面确认，不关闭系统安全保护。

看懂 Mac 的温度。让风扇有序地工作。