PC Assistant - 系统健康诊断助手
PC Assistant 是一款面向 Linux 及 WSL 环境的综合系统诊断工具，通过自动化脚本采集 15+ 维度的硬件与软件信息，生成结构化健康报告并提供可执行的修复建议。
核心用法
执行单条命令触发全量检测：~/.npm-global/lib/node_modules/openclaw/skills/pc-assistant/scripts/healthcheck.sh。脚本自动生成两份输出：带时间戳的可读文本报告（healthcheck_YYYYMMDD_HHMMSS.txt）与 JSON 摘要（.json），便于人工阅读或接入监控体系。
检测范围涵盖：系统概览（OS、内核、运行时间）、Windows 环境（WSL 版本、挂载点）、存储与磁盘（使用率、分区、I/O）、网络（接口、路由、DNS、防火墙）、进程与服务（Top 资源占用、失败服务）、用户与安全（登录会话、SSH 密钥、失败登录记录）、软件包管理（apt/dpkg、npm、pip 等）、容器与虚拟化（Docker、Podman）、硬件信息（GPU、温度、USB/PCI 设备）、日志与文件系统（大目录扫描）、定时任务及 OpenClaw 自身状态。
显著优点
1. 零侵入只读设计：绝大多数检测无需 root 权限，脚本只读执行，安全可重复运行；
2. 智能建议引擎：针对高磁盘占用、内存不足等常见问题自动生成清理命令与操作步骤（如 Docker 清理、Windows 磁盘清理指南）；
3. 双格式输出：兼顾人工阅读（Markdown 风格文本）与自动化集成（JSON）；
4. 历史追踪：时间戳命名支持趋势对比与故障回溯；
5. 跨平台覆盖：原生支持 Ubuntu、Debian、CentOS、RHEL、Fedora、Arch 及 WSL 环境。
潜在局限
- 平台限定：仅适用于 Linux 及 WSL，Windows 原生与 macOS 不受支持；
- 依赖外部工具：虽使用标准 Linux 工具（
df、free、top、ip等），但部分发行版可能需手动安装lscpu、lshw或nvidia-smi等硬件检测工具； - 诊断非修复：工具本身不提供一键修复功能，用户需手动执行建议命令；
- 权限边界：深度安全审计（如入侵检测日志分析）可能需要额外权限，基础检测无法覆盖。
适合人群
- 开发者/DevOps：快速排查 CI/CD 环境或远程服务器的资源瓶颈；
- WSL 重度用户：监控 Windows 子系统的磁盘膨胀、内存泄漏问题；
- 系统管理员：批量生成基线报告，用于合规审计与容量规划；
- 技术爱好者：学习系统架构、排查性能异常的教学场景。
常规风险
| 风险类别 | 说明 |
|---------|------|
| **隐私暴露** | 报告可能包含用户名、环境变量（含潜在密钥路径）、SSH 公钥指纹、浏览器安装列表等敏感信息，需妥善保管输出文件； |
| **路径硬编码** | 脚本路径含固定 npm 全局安装路径（`~/.npm-global/...`），若安装方式不同需手动调整； |
| **误操作风险** | 建议中的清理命令（如 `docker system prune`）会删除未使用资源，执行前需确认； |
| **数据量膨胀** | 长期运行产生大量 `/tmp/pc-healthcheck/` 历史报告，建议定期清理或配置 retention 策略。 |
使用建议
首次运行建议在非生产环境验证输出格式；对敏感环境可先将报告复制到 Windows 目录（/mnt/c/...）前审查内容；结合 cron 定时执行可实现轻量级监控。