pi-health

Pi Health 是一款专为 Raspberry Pi 设计的轻量级系统健康监控 Skill，通过调用系统原生命令和 vcgencmd 工具，为用户提供全面的硬件状态诊断能力。

核心用法
用户只需执行 bash scripts/health.sh 即可启动检测。脚本会自动采集 CPU 温度、电压水平、内存与磁盘使用率、CPU 频率、系统负载、风扇转速等关键指标，同时检测热节流、欠压、超频等硬件状态。通过分析 /sys/、/proc/ 和 vcgencmd 接口的数据，脚本以结构化表格形式输出结果，并通过退出码（0=健康/1=警告/2=严重）支持自动化集成。

显著优点
该 Skill 的最大优势在于极致的轻量和透明。零外部依赖、零网络通信的设计理念确保了隐私安全和运行效率，所有数据采集均在本地完成。脚本采用纯 Bash 编写，代码完全开源可审计，用户可清晰了解每一个检查项的实现逻辑。此外，合理的阈值设计（温度>70°C警告/>80°C严重，内存/磁盘>75%警告/>90%严重）和标准化的退出码机制，使其能无缝集成到 cron 定时任务或 systemd 服务中，实现自动化监控。

潜在缺点与局限性
作为专用工具，其首要局限是平台依赖性。虽然部分功能可在通用 Linux 环境运行，但核心特性（如电压检测、节流状态）依赖 Raspberry Pi 特有的 vcgencmd 命令，在非 Pi 设备上功能受限。其次，脚本采用一次性检查模式，不提供持续监控或历史数据记录功能，需配合外部定时器实现长期跟踪。此外，作为个人开发者项目（T3 来源），缺乏企业级背书，虽代码透明但用户需自行承担审计责任。

适合的目标群体
该 Skill 特别适合 Raspberry Pi 重度用户、IoT 开发者、家庭服务器运维人员以及教育场景下的硬件教学。对于需要确保 Pi 设备稳定运行 7×24 小时的场景（如家庭自动化中枢、边缘计算节点、复古游戏机等），此工具能有效预防因过热、欠压导致的硬件损伤或性能衰减。

使用风险
主要风险在于权限和环境差异。虽然脚本本身为只读操作，但 dmesg 和某些硬件传感器可能需要特定用户组权限（如 video 组）或 root 访问，权限不足可能导致检测盲区。在非标准 Pi OS 环境（如 Ubuntu ARM）中，vcgencmd 可能缺失或路径不同，导致误报或功能缺失。此外，温度阈值基于通用标准设定，对于极端环境（如工业级无风扇机箱）可能需要手动调整脚本参数。