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

报告包含以下模块：

综合健康评分仪表盘（0-100，红/黄/绿三色分级）
系统概览卡片（OS、CPU、内存、显卡）
磁盘空间分析（分区堆叠柱状图 + 垃圾文件分布饼图 + 各分区进度条卡片）
健康评分维度（四维雷达图 + 各维度横向条形图）
垃圾文件预估（分类卡片，合计可释放空间）
大文件清单（Top15，按类型标注图标）
开机启动项（列表 + 影响等级）
内存占用 Top 进程（横向条形图）
改进建议（按严重/中等/轻微分级，含具体操作建议）

报告通过 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 执行具体清理优化。