核心功能
pi-admin 是一款专为 Raspberry Pi 设计的综合系统管理技能，提供从基础信息查询到深度系统维护的全套工具。
核心用法
信息监控： 通过 overview、network、resources、storage、services、hardware 等子命令，快速获取系统网络配置（IP、Tailscale VPN 状态）、CPU/内存/温度资源、磁盘使用率、运行服务状态及硬件信息。all 命令可导出完整系统快照，便于故障排查。
系统维护： 支持 update（系统包更新）、clean（清理无用包/日志/Docker 缓存）、reboot（带倒计时安全重启）、restart-gateway（重启 Clawdis 网关服务）等关键运维操作。
性能优化： optimize 命令可安全禁用蓝牙、ModemManager、Avahi 等服务，调整 swappiness 至 10，预计节省约 100MB RAM，且支持 --undo 完全回滚。
显著优点
- 安全性设计： 所有维护命令内置
--dry-run干运行模式，用户可预览变更效果；关键操作需二次确认，降低误操作风险。 - Tailscale 原生支持： 深度集成 Tailscale 网络状态查询，适合边缘设备远程管理场景。
- 轻量优化可逆： 优化操作明确标注资源节省量与回滚能力，对资源受限的 Pi 设备友好。
局限性与风险
- 平台锁定： 专为 Raspberry Pi 设计，部分硬件信息命令（如温度读取）可能不兼容其他 ARM 或 x86 设备。
- 权限要求： 维护命令需 sudo 权限，在受限环境中可能无法使用。
- 网关耦合：
restart-gateway命令与 Clawdis 生态深度绑定，独立使用价值有限。 - 优化副作用： 禁用蓝牙/Avahi 可能影响特定物联网场景的功能，需用户自行评估。
适合人群
- Raspberry Pi 服务器/边缘设备管理员
- 使用 Tailscale 构建私有网络的 homelab 用户
- 需要远程诊断和资源监控的 IoT 开发者
风险提示
维护类命令直接操作系统级配置，虽有干运行保护，但生产环境仍建议配合备份使用。optimize 的服务禁用可能影响依赖蓝牙或 mDNS 发现的应用。