SuperAPI AI 工具集

background-process

办公与效率

查看项目

更新于 10-15 22:17

技能介绍

用途:这是后台进程工具的清理与使用规范技能,建议在启动后台进程前加载,以避免残留进程、端口冲突等问题。

主要能力与建议:保持进程列表干净,完成后终止进程,不要留下闲置服务器;定期使用 background_process_cleanup 清理已退出进程;启动前先用 background_process_list 检查,避免重复;终止时使用 remove: true 一步完成清理。

验证启动:启动后需要等待再读取输出,服务器需要时间启动。流程为:启动进程,至少等待 30 秒(使用 bash sleep 或等待后再操作),再用 background_process_read 确认启动。若输出为空或不完整,继续等待后重读。留意 “listening on”“ready”“started” 等信息,或端口冲突等错误。

标识符:运行多个进程时,建议设置自定义 id 以便区分,例如用 id: "frontend" 与 id: "backend",避免 vite-1、node-2 之类命名,使终止和读取命令更明确。

信号选择:SIGTERM(默认)用于正常关闭,给进程清理时间;SIGINT 模拟 Ctrl+C,部分进程处理方式不同;SIGKILL 用于 SIGTERM 无法终止时的强制终止。

限制:进程在会话期间持续存在,会话结束后不会自动清理;输出缓冲区有限(默认 500 行),冗长构建可增大 maxOutputLines;输出中的 stderr 会以 [stderr] 前缀标注,便于区分错误。