PC Health Report — 系统健康分析报告
对用户电脑进行只读扫描，收集系统信息、磁盘占用、大文件、垃圾文件预估、启动项和进程数据，计算综合健康评分，生成一份自包含的 HTML 可视化报告。
核心原则：全程只读，不修改用户系统任何设置或文件。 本 Skill 只做诊断和报告，清理执行由用户自行决定。
工作流程
第零步：判断运行环境
你可能运行在用户本地电脑（命令直接作用于用户机器）或云端沙箱（与用户电脑无关的临时容器）。
- 本地模式：直接执行扫描脚本 → 生成报告 → 交付 HTML。
- 云端模式（不确定时按此处理）：
- 告诉用户"当前运行在云端环境，无法直接扫描你的电脑"。
- 将对应平台的扫描脚本（
win_scan.ps1或mac_scan.sh）复制到用户可见目录，指导用户在自己电脑上运行并把输出的 JSON 贴回来。 - 收到 JSON 后，用
generate_report.py生成 HTML 报告并交付。 - 绝不在沙箱里执行扫描命令并把结果当作用户电脑的情况汇报。
第一步：识别平台并执行扫描
根据用户操作系统选择扫描脚本，脚本输出统一 JSON 到 stdout。
Windows（PowerShell 5.1+）：
powershell -NoProfile -ExecutionPolicy Bypass -File scripts/win_scan.ps1 > scan_result.json
- 脚本必须以 UTF-8 BOM 编码保存（Windows PowerShell 5.1 兼容性要求）。
- 扫描内容：系统版本、CPU/内存/显卡、各分区占用、用户目录 Top20 大文件（>100MB，跳过 AppData/node_modules/.git）、临时文件/更新缓存/浏览器缓存/缩略图/回收站预估、启动项、内存 Top15 进程。
macOS（bash）：
bash scripts/mac_scan.sh > scan_result.json
- 扫描内容：系统版本、CPU/内存、各挂载卷占用、Home 目录 Top20 大文件、缓存/日志/iOS备份/Xcode派生数据/废纸篓预估、LaunchAgents/Daemons、内存 Top15 进程。
扫描注意事项：
- 大文件扫描可能耗时较长（取决于文件数量），提前告知用户"正在扫描，可能需要 1-3 分钟"。
- 扫描全程只读，不需要管理员权限（macOS 上部分系统目录可能因 SIP 跳过，属正常现象）。
- 如果脚本执行失败，读取报错信息，检查编码（Windows）或权限（macOS），修复后重试。
第二步：生成 HTML 报告
python3 scripts/generate_report.py scan_result.json system_health_report.html
报告包含以下模块：
1. 综合健康评分仪表盘（0-100，红/黄/绿三色分级）
2. 系统概览卡片（OS、CPU、内存、显卡）
3. 磁盘空间分析（分区堆叠柱状图 + 垃圾文件分布饼图 + 各分区进度条卡片）
4. 健康评分维度（四维雷达图 + 各维度横向条形图）
5. 垃圾文件预估（分类卡片，合计可释放空间）
6. 大文件清单（Top15，按类型标注图标）
7. 开机启动项（列表 + 影响等级）
8. 内存占用 Top 进程（横向条形图）
9. 改进建议（按严重/中等/轻微分级，含具体操作建议）
报告通过 CDN 加载 ECharts 5.5，用户用浏览器打开即可查看全部图表，无需安装任何依赖。
第三步：交付报告
- 将生成的 HTML 文件通过
present_files交付给用户。 - 简要汇报：健康评分、最突出的 1-2 个问题、可释放空间预估。
- 提醒用户：报告中的清理建议需要用户手动执行，本 Skill 不会自动删除任何文件。
健康评分算法
综合评分 = 磁盘 35% + 性能 25% + 维护 25% + 启动 15%
| 维度 | 计算方式 |
|---|---|
| 磁盘 | 各分区 (100 - 使用率%) 加权平均，系统盘权重 x2 |
| 性能 | 基于内存使用率：≤40% 得 95 分，≥90% 得 30 分，区间线性递减 |
| 启动 | 100 - 启动项数量 x5，最低 30 分 |
| 维护 | 基于垃圾文件总量：<1GB 得 90 分，>10GB 得 30 分，区间分级 |
评分等级：≥90 优秀 / ≥80 良好 / ≥60 一般 / ≥40 较差 / <40 危险
安全边界
- 只读扫描：所有扫描脚本不删除、不修改、不移动任何文件。
- 不碰个人文件：大文件只报告路径和大小，不做任何操作。
- 不执行清理：清理操作完全由用户根据报告建议手动执行。
- 不建议关闭安全功能：不主动建议关闭杀毒、防火墙、SIP 等安全机制。
- 回收站/废纸篓默认不清：仅在报告中列出占用量，由用户决定。
文件结构
pc-health-report/
├── SKILL.md # 本文件
└── scripts/
├── win_scan.ps1 # Windows 扫描脚本（输出 JSON）
├── mac_scan.sh # macOS 扫描脚本（输出 JSON）
└── generate_report.py # JSON → HTML 报告生成器
与 doubao-pc-optimizer 的区别
doubao-pc-optimizer：侧重执行清理和性能优化，会修改系统设置、删除文件、调整注册表。pc-health-report（本 Skill）：侧重诊断分析和可视化报告，全程只读，不做任何修改。适合用户想先了解电脑状况、获取一份直观报告再决定如何操作的场景。- 两者可配合使用：先用本 Skill 生成报告定位问题，再用 doubao-pc-optimizer 执行具体清理优化。
