用途:在 ShipGuard 评审会话结束后,关闭 sg-visual-review 评审页面 HTTP 服务器。
主要能力:执行 node visual-tests/build-review.mjs --stop 即可停止服务器。--stop 为短路模式,只读取 visual-tests/_results/.server.pid,杀掉该进程并删除 PID 文件,不进行重新构建,也不解析配置。若 PID 文件不存在,则报告“No server running.”。
等价命令:node visual-tests/shipguard.mjs stop --all 可一条命令同时停止被测应用服务器(由 shipguard serve/run 启动)和评审服务器。
回退方式:若 --stop 以非零码退出,可按端口终止进程。PID 文件包含两行,第一行为 pid,第二行为 port。示例:port=$(sed -n '2p' visual-tests/_results/.server.pid 2>/dev/null);[ -z "$port" ] && port=8888;lsof -ti:"$port" | xargs -r kill。若使用了回退,需打印警告:“Warning: --stop failed, used lsof fallback to kill process on port {port}.”
适用场景:ShipGuard 可视化评审流程结束后的清理环节。
限制:资料未提供其他配置项、平台支持范围或权限要求。