System Doctor

这是Linux服务器的系统诊断工具，核心功能包括检查磁盘、内存、CPU、网络接口、运行服务及系统信息，支持单独检查指定项，可输出可视化终端报告、HTML健康报告或JSON数据。适用于服务器健康巡检、性能问题诊断、监控报告生成等场景，无需外部API，完全离线运行，macOS有部分兼容支持。

ericlooi504

热度 28.46

最近更新 2026-05-11 17:48:12

分类：数据依赖：代码执行 / 读写文件应用场景：数据处理 / 报告撰写

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add sys-doctor

Metadata

name: sys-doctor
description: Comprehensive system diagnostics and health check for Linux servers. Check disk usage, memory, CPU load, network interfaces, running services, and system info. Generate HTML health reports or JSON output. Use when the user wants to: (1) Check server health and resource usage, (2) Diagnose performance issues, (3) Generate system health reports for monitoring, (4) Check disk space on all mounted volumes, (5) Inspect memory and swap usage, (6) Troubleshoot network connectivity, (7) Audit running services.

System Doctor (sys-doctor)

Run comprehensive system diagnostics with a single command.

Quick start

python3 skills/sys-doctor/scripts/sys_doctor.py

Output example:

◆ System Health Report: myserver
2026-05-10 13:30:00
============================================================
========================== DISK ==========================
  🟢 /              60%  (30G/50G, avail: 20G)
  🟡 /var/log       85%  (4.3G/5G, avail: 0.7G)
  🟢 /home          45%  (90G/200G, avail: 110G)
========================== MEMORY ========================
  RAM:    4.2G / 16G  (26%)
  Swap:   0.1G / 2G  (5%)
========================== CPU ============================
  Load:     0.45 / 0.32 / 0.28
  Cores:    4 (8 logical)
========================== NETWORK ========================
  🟢 eth0       UP    192.168.1.100/24
  🟢 docker0    UP    172.17.0.1/16
========================== SERVICES ======================
  • systemd-journald  • cron  • sshd  • docker
  • nginx  • postgresql  • redis-server

Commands

Command	Action
`--check disk`	Check only disk usage
`--check memory`	Check only memory/swap
`--check cpu`	Check only CPU load
`--check network`	Check only network interfaces
`--check services`	List running services
`--report`	Generate HTML health report
`--json`	Output as JSON
`--output file.html`	Save to specific file

HTML Reports

Generate a styled HTML report for sharing or monitoring:

python3 skills/sys-doctor/scripts/sys_doctor.py --report
# Creates: sys-doctor-report-20260510-133000.html

JSON Output

For programmatic consumption (API, monitoring, dashboards):

python3 skills/sys-doctor/scripts/sys_doctor.py --json

Health Status Logic

Disk ≥ 90% → critical (exit code 2)
Disk ≥ 80% → warning
Disk < 80% → ok

The report's color-coded badges reflect overall health status.

Requirements

Linux (primary) — uses /proc/, df, free, ip, systemctl
macOS — partial support via psutil fallback (install: pip install psutil)
No external API calls — fully offline