SuperAPI AI 工具集

port-whisperer

通用与其它

查看项目

更新于 10-15 20:11

技能介绍

用途:Port Whisperer 用于开发环境中的端口与进程管理,帮助查看端口占用、检查进程、清理孤儿进程以及终止顽固的开发服务器。

主要能力:提供 list(显示过滤后的开发服务器端口)、list-all(显示所有监听端口)、ps(显示运行中的开发进程)、inspect(查看指定端口详情)、kill(按端口或 PID 终止进程,支持端口范围如 3000-3010,-f 使用 SIGKILL)、clean(查找并终止孤儿/僵尸进程)、logs(跟踪进程日志)、help(显示用法)。支持识别 Next.js、Vite、Express、Django、Rails、FastAPI 等框架,Docker 容器会在 ps 输出中被识别并折叠,输出会去除 ANSI 颜色码。

使用方式:通过自然语言触发,例如“端口 3000 上运行着什么”“显示所有监听端口”“终止 8080 上的进程”“清理孤儿开发服务器”“显示端口 3000 的日志”。命令形式为 ./scripts/ports.sh 加子命令。诊断端口冲突时先 list,再 inspect 指定端口,最后按需 kill。清理孤儿进程时先 list 展示状态,向用户确认后再执行 clean。

安全规则:只读命令(list、list-all、ps、inspect、logs)可直接运行;kill 指定端口在用户明确要求时可执行,请求含糊时需先确认;clean 属于批量操作,必须先展示 list 或 ps 结果并征得用户明确确认后才能运行。

前提与限制:需要 Node.js 18+(用于 npx),无需全局安装,脚本会以 npx 作为回退;若 ports 已通过 npm i -g port-whisperer 或 mise 加入 PATH,则直接使用以提升速度。其他限制暂未提供。