核心用法
PC Assistant 是一款跨平台系统健康诊断技能,通过执行平台原生脚本(PowerShell/Bash)自动采集系统信息并生成可读报告。用户可通过主命令触发单次检查,或使用 schedule.sh 配置定时任务(cron)实现自动化监控。
执行方式:
- 直接运行:调用
run.sh自动检测 OS 并执行对应脚本 - 定时任务:配置
~/.config/pc-assistant.conf后运行schedule.sh - 输出双格式:人类可读的
.txt报告 + 机器解析的.json摘要
采集维度:系统概览、CPU/内存/存储使用率、网络配置、进程与服务状态、安全设置(防火墙/杀毒)、已安装软件包、硬件信息(GPU/温度/USB)。
显著优点
1. 真跨平台:原生支持 Windows(WMI)、macOS(system_profiler)、Linux(/proc + sys),WSL 亦兼容
2. 零侵入采集:脚本以只读模式运行,不修改系统配置
3. 智能建议:对高磁盘占用、内存不足等常见问题自动生成清理命令
4. 可编排性:JSON 输出便于接入 Prometheus/Grafana 等监控体系
5. 历史追踪:时间戳命名 + 自动清理策略,方便长期趋势分析
潜在缺点与局限
- 权限边界:部分信息(如 SMART 状态、失败登录日志)需 root/Administrator 权限,普通用户采集可能不完整
- 环境依赖:脚本硬编码路径
~/.npm-global/lib/node_modules/openclaw/...,若 OpenClaw 安装路径非标准会导致执行失败 - 非实时性:基于快照采集,非持续监控,无法捕获瞬时峰值
- 平台差异:功能集在三大平台并非完全对齐(如 macOS 电池状态、Windows Defender 状态)
适合人群
- 开发者/DevOps:快速排查 CI/CD runner 或远程服务器环境
- 技术运维:批量巡检资产健康状态
- 进阶用户:定期自检个人工作站,预防存储/内存瓶颈
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 信息泄露 | 报告包含 IP、用户名、软件列表等敏感信息 | 输出目录设权限 0700,定时清理旧报告 |
| 路径注入 | 配置文件中 `PC_ASSISTANT_OUTPUT_DIR` 若被篡改可导致文件写入任意位置 | 校验路径合法性,避免以 root 执行 |
| 误删数据 | `CLEANUP=true` 时旧报告自动删除,可能误删用户重命名后的文件 | 保留策略设置合理阈值(建议≥7天) |