小紫进程监控插件

v1.0.0 · 运维协作 · 官方

进程 CPU 内存运维监控小紫

简介

小紫进程监控插件 v1.0，跨平台进程查看工具，支持 Windows、macOS、Ubuntu/Linux（run.bat / run.sh）：

list 列出进程，可按 CPU/内存排序
top CPU 或内存占用 Top N
find 按进程名/命令行关键词搜索
info 查看指定 PID 详情
无需 pip，Python 标准库 + 系统命令

平台说明：

Windows：PowerShell Get-Process（无 PS 时 fallback tasklist）
macOS / Linux：ps aux / ps -p

重要：v1.0 只读监控，不杀进程（任何系统均如此）。不会执行 taskkill、kill 等终止操作；需结束进程请用系统基础插件或手动操作。

典型流程：top 看 CPU/内存大户 → find 定位目标程序 → info 确认 PID 与路径

操作说明

action	功能
`list`	列出进程，默认按内存排序
`top`	CPU 或内存 Top N，默认 CPU Top 10
`find`	按 `--name` 关键词搜索进程
`info`	查看 `--pid` 进程详情

参数要点：

sort：cpu 或 memory
limit：返回条数（top 默认 10，list 默认 30）
name：find 必填，支持部分匹配（如 chrome、nginx、python）
pid：info 必填

Windows 说明： CPU 值为进程累计 CPU 时间（秒），可用于排序；内存为 MB。

Linux/mac 说明： CPU/内存为 ps 报告的百分比。

安装

解压到 D:\xiaozi-plugins\运维协作\进程监控插件\
复制 python/ 到本目录
测试：run.bat --action top --limit 5

文件	说明
`process_plugin.py`	主程序
`run.bat` / `run.sh`	启动脚本
`进程监控插件.md`	用户文档
`config/process_config.example.json`	配置示例
`上架文案/`	商店详情（本文件，不打 zip）

无需 pip，标准库即可。

命令行

REM CPU Top 10
run.bat --action top --limit 10 --sort cpu

REM 内存 Top 10
run.bat --action top --limit 10 --sort memory

REM 搜索进程
run.bat --action find --name chrome

REM 列出进程
run.bat --action list --limit 30 --sort memory

REM PID 详情
run.bat --action info --pid 1234

# Linux / macOS
./run.sh --action top --sort cpu --limit 10
./run.sh --action find --name nginx
./run.sh --action info --pid 1234

注册技能 process_monitor

名称： process_monitor

描述： 进程监控 v1.0，跨平台Win/macOS/Linux。list/top/find/info查进程列表、CPU内存Top、按名搜索、PID详情。用户看占用、找进程、查PID时使用。find需name，info需pid。只读不杀进程。

脚本： D:\xiaozi-plugins\运维协作\进程监控插件\run.bat

参数 JSON：

{
  "type": "object",
  "properties": {
    "action": {"type": "string", "enum": ["list", "top", "find", "info"], "description": "操作类型"},
    "name": {"type": "string", "description": "find 进程名关键词"},
    "pid": {"type": "string", "description": "info 进程 PID"},
    "sort": {"type": "string", "description": "cpu/memory"},
    "limit": {"type": "string", "description": "返回条数"}
  },
  "required": ["action"]
}

对话示例

场景	说法
CPU Top	CPU 占用最高的 10 个进程是什么？
内存 Top	哪些进程最占内存？
找进程	找一下 nginx 相关进程
查 PID	PID 1234 是什么进程？
排查	有没有 python 进程在跑？

小紫 AI 会根据描述选 action 并传 name、pid、sort、limit 等参数。

常见错误

现象	处理
未找到 PID	进程已退出，重新 top/list 获取
find 无结果	换关键词如 exe 名
Windows 无 CPU 数据	PowerShell 不可用时会 fallback tasklist，仅内存
权限不足	部分系统进程需管理员
python folder missing	复制 python 到插件目录

能力边界

支持	不支持
Win/macOS/Linux 进程列表	杀进程 kill（任何系统）
CPU/内存 Top	实时持续监控/stream
按名搜索、PID 详情	远程 SSH 服务器监控

与其他插件配合

服务巡检插件：服务不可用时查对应进程是否在跑
日志分析插件：进程异常后查日志
系统基础插件：确认 PID 后 exec_cmd 管理进程
磁盘清理插件：定位占用后再查进程是否锁定文件

详见包内 进程监控插件.md。

小紫 进程监控插件

简介