Pc Health Check

Windows PC一键健康体检工具。覆盖CPU/内存/磁盘/网络/进程/驱动/系统事件/启动项/端口/安全更新， 自动生成结构化Markdown报告，标注风险等级与处理建议。 触发词：PC体检、电脑巡检、健康检查、系统检查、PC health check。 支持两种模式： - 快速模式（--quick）：5项核心检查，10秒内完成 - 完整模式（默认）：11项全面体检，约30秒 新增 v1.0.1：--save / --silent / --version 支持

PC Health Check — Windows电脑一键体检

功能概览

检查项	快速模式	完整模式	风险判定
操作系统信息	✅	✅	-
CPU状态	✅	✅	>70%警告，>90%错误
内存使用	✅	✅	>80%警告，>90%错误
磁盘空间	✅	✅	>80%警告，>90%错误
网络连接	✅	✅	断网/高延迟错误
高资源进程	-	✅	-
设备异常	-	✅	任何Error设备标红
系统事件	-	✅	>5个Error事件标红
启动项	-	✅	-
监听端口	-	✅	高危端口(445/3389等)警告
安全更新	-	✅	-

使用方式

对AI说以下任意一句即可触发：

• "帮我做一次PC体检"
• "电脑健康检查"
• "PC巡检"
• "检查一下系统状态"
• "快速体检"（触发快速模式）

工作流程

text

用户说"PC体检"
  → Step 1: 调用 scripts/health_check.cjs 执行扫描
  → Step 2: 脚本返回JSON格式检查结果
  → Step 3: AI分析结果，标注风险等级
  → Step 4: 生成Markdown健康报告
  → Step 5: 如有高风险项，主动给出处理建议

报告格式

生成的报告包含以下部分：

markdown

# PC健康体检报告

**检查时间**：2026/4/19 18:38:15

## ✅ 总评：良好

| 检查项 | 正常 | 警告 | 错误 |
|--------|------|------|------|
| 总计 | 5 | 0 | 0 |

## 系统概况
- **操作系统**：Microsoft Windows 10 企业版 64位
- **版本**：10.0.19045 (Build 19045)
- **运行时间**：0d 6h 26m

### ✅ CPU
- Intel(R) Core(TM) i5-10400F CPU @ 2.90GHz
- 6核/12线程 | 负载 17%

### ✅ 内存
- 总计：34.3 GB
- 已用：12.5 GB (36%)
- 可用：21.8 GB

### ✅ 磁盘
| 分区 | 总容量 | 已用 | 剩余 | 使用率 |
|------|--------|------|------|--------|
| ✅ C: | 255.7GB | 114.4GB | 141.3GB | 45% |
| ... | ... | ... | ... | ... |

## 需要关注的问题
### 🔴 设备异常
- PS/2 标准键盘 (错误码: 24)
- ...

---
*由 PC Health Check Skill 生成*

技术实现

• 语言：Node.js（零外部依赖）
• 数据采集：Windows WMI（通过child_process调用PowerShell命令）
• 输出格式：JSON结构化数据 + Markdown报告
• 编码处理：强制UTF-8，解决中文乱码问题

脚本参数

bash

node scripts/health_check.cjs [options]

Options:
  --quick     快速模式，只检查5项核心指标
  --report    直接输出Markdown格式报告（默认JSON）
  --json      输出JSON格式（默认）
  --save <path>   保存报告到指定路径
  --silent    静默模式，仅保存文件，不输出到终端
  --version,-v  输出版本号

风险等级说明

图标	等级	含义	建议操作
✅	正常	指标健康	无需处理
⚠️	警告	接近阈值	建议关注，适时优化
🔴	错误	超出阈值或存在异常	建议立即处理

常见问题

Q: 为什么有些设备显示Error？ A: 通常是PS/2虚拟设备或已禁用但未卸载的硬件，不影响实际使用。

Q: 445端口开放有风险吗？ A: 445是SMB文件共享端口，局域网使用正常。如不需要共享，可在防火墙关闭。

Q: 检查需要管理员权限吗？ A: 基础检查不需要，但部分驱动和安全更新信息可能需要。

更新日志

v1.0.1 (2026-04-21)

• 新增 --save <path> 保存报告到文件（cron友好）
• 新增 --silent 静默模式（不输出到终端）
• 新增 --version / -v 输出版本号
• 修复报告渲染：设备警告与设备异常分类显示
• 修复报告渲染：系统事件图标根据严重程度区分

v1.0.0 (2026-04-19)

• 初始版本发布
• 支持11项全面检查
• 支持快速/完整两种模式
• 自动生成Markdown报告
• 解决PowerShell中文编码问题

许可

MIT License