核心功能
local-system-info 是一款基于 Python psutil 库构建的本地系统监控技能，提供标准化的系统资源查询接口。核心功能覆盖四大维度：
1. CPU 监控：实时利用率、逻辑核心数、1/5/15分钟负载平均值（Linux/macOS）
2. 内存分析：物理内存总量/可用量、使用率百分比、交换分区占用
3. 磁盘检测：根文件系统总容量、已用/剩余空间及使用率
4. 进程管理：按 CPU 占用排序的 Top N 进程列表（含 PID、进程名、用户名、CPU/内存占用）
显著优点
- 跨平台兼容：原生支持 Linux、macOS、Windows 及 WSL，自动适配平台特性差异
- 零配置部署：依赖单一（仅需
psutil），通过uv run --with实现临时环境隔离，无需全局安装 - 标准化输出：JSON 结构化数据，便于脚本集成与自动化处理
- 资源轻量：运行时内存占用极低，适合高频轮询或后台监控场景
- 权限友好：读取级操作无需 root，进程信息受限于当前用户可见范围
潜在局限
- 功能边界：纯监控类工具，无告警触发、历史存储或可视化能力
- Windows 限制：
load_avg指标不可用，进程信息深度低于 Unix 系 - 瞬时快照：单次调用返回即时值，无法反映趋势变化，需外部实现持续采集
- WSL 特殊性：部分磁盘指标可能映射至 Windows 宿主机，需留意路径语义
适用人群
- 开发者：本地调试时快速排查资源瓶颈
- DevOps/SRE：CI/CD 流水线中集成基础健康检查
- 技术用户：轻量级 CLI 替代复杂监控套件（如 htop+自定义脚本）
常规风险
- 信息泄露：进程列表暴露运行中的敏感应用名称，共享环境需注意
- 依赖供应链：
psutil为第三方 PyPI 包，建议锁定版本并通过可信源安装 - 权限误判：非特权用户可能无法获取全量进程信息，导致监控盲区
技术规格
| 属性 | 说明 |
|:---|:---|
| 运行环境 | Python 3.6+ |
| 核心依赖 | psutil ≥ 5.x |
| 执行模式 | 本地子进程调用 |
| 数据格式 | JSON |
| 更新策略 | 实时采样（无缓存）|