📦 Pc Health Check — Pc 健康 检查
v1.0.0Windows PC一键健康体检工具。覆盖CPU/内存/磁盘/网络/进程/驱动/系统事件/启动项/端口/安全更新, 自动生成结构化Markdown报告,标注风险等级与处理建议。 触发词:PC体检、电脑巡检、健康检查、系统检查、PC health check。 支持两种模式: - 快速模式(--quick):5项核实 - 详细模式(--detailed):进行全面系统检查,并通过API、CLI等方式输出报告。托管在GitHub,支持用户自定义报告模板。
运行时依赖
安装命令
点击复制技能文档
PC Health Check — Windows电脑一键体检 功能概览 检查项 快速模式 完整模式 风险判定 操作系统信息 ✅ ✅ - CPU状态 ✅ ✅ >70%警告,>90%错误 内存使用 ✅ ✅ >80%警告,>90%错误 磁盘空间 ✅ ✅ >80%警告,>90%错误 网络连接 ✅ ✅ 断网/高延迟错误 高资源进程 - ✅ - 设备异常 - ✅ 任何Error设备标红 系统事件 - ✅ >5个Error事件标红 启动项 - ✅ - 监听端口 - ✅ 高危端口(445/3389等)警告 安全更新 - ✅ -
使用方式 对AI说以下任意一句即可触发: "帮我做一次PC体检" "电脑健康检查" "PC巡检" "检查一下系统状态" "快速体检"(触发快速模式)
工作流程 用户说"PC体检" → Step 1: 调用 scripts/health_check.cjs 执行扫描 → Step 2: 脚本返回JSON格式检查结果 → Step 3: AI分析结果,标注风险等级 → Step 4: 生成Markdown健康报告 → Step 5: 如有高风险项,主动给出处理建议
报告格式 生成的报告包含以下部分: # 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线程
✅ 内存
- 总计:34.3 GB
- 已用:12.5 GB (36%)
- 可用:21.8 GB
✅ 磁盘
| 分区 | 总容量 | 已用 | 剩余 | 使用率 | |------|--------|------|------|--------| | ✅ C: | 255.7GB | 114.4GB | 141.3GB | 45% | | ... | ... | ... | ... | ... |需要关注的问题
🔴 设备异常
- PS/2 标准键盘 (错误码: 24)
- ...
技术实现 语言:Node.js(零外部依赖) 数据采集:Windows WMI(通过child_process调用PowerShell命令) 输出格式:JSON结构化数据 + Markdown报告 编码处理:强制UTF-8,解决中文乱码问题
脚本参数 node scripts/health_check.cjs [options] Options: --quick 快速模式,只检查5项核心指标 --report 直接输出Markdown格式报告(默认JSON) --json 输出JSON格式(默认) --save 保存报告到指定路径 --silent 静默模式,仅保存文件,不输出到终端 --version,-v 输出版本号
风险等级说明 图标 等级 含义 建议操作 ✅ 正常 指标健康 无需处理 ⚠️ 警告 接近阈值 建议关注,适时优化 🔴 错误 超出阈值或存在异常 建议立即处理
常见问题 Q: 为什么有些设备显示Error? A: 通常是PS/2虚拟设备或已禁用但未卸载的硬件,不影响实际使用。 Q: 445端口开放有风险吗? A: 445是SMB文件共享端口,局域网使用正常。如不需要共享,可在防火墙关闭。 Q: 检查需要管理员权限吗? A: 基础检查不需要,但部分驱动和安全更新信息可能需要。
更新日志 v1.0.1 (2026-04-21) 新增 --save 保存报告到文件(cron友好) 新增 --silent 静默模式(不输出到终端) 新增 --version / -v 输出版本号 修复报告渲染:设备警告与设备异常分类显示 修复报告渲染:系统事件图标根据严重程度区分 v1.0.0 (2026-04-19) 初始版本发布 支持11项全面检查 支持快速/完整两种模式 自动生成Markdown报告 解决PowerShell中文编码问题
许可 MIT License