用途:在运行 bun run check、Playwright 或五阶段检查前,清理残留的 dean-stack 开发、预览与 Storybook 服务器进程,释放被占用的端口。
主要能力:按命令行模式结束已知进程,包括 storybook dev、vite preview、vite dev、biome.*watch、stylelint.*watch;等待系统回收处于 TIME_WAIT 的 TCP 套接字;检查 3000(vite preview)、5173(vite dev)、6006(storybook dev)端口是否空闲;若仍有监听,则按端口执行 SIGKILL 升级处理。
使用方式:依次执行 pkill -f "storybook dev" || true、pkill -f "vite preview" || true、pkill -f "vite dev" || true、pkill -f "biome.*watch" || true、pkill -f "stylelint.*watch" || true;随后 sleep 2;再用 lsof -i :3000 -i :5173 -i :6006 2>/dev/null | grep LISTEN || echo "all clear" 验证;必要时执行 lsof -ti :3000,:5173,:6006 2>/dev/null | xargs kill -9 2>/dev/null || true。
适用场景:本地 dean-stack 开发环境在跑检查或 Playwright 前需要确保端口空闲时。
限制:pkill -f 会匹配机器上任意同名进程,可能误杀其他项目;多项目并行时建议改用按端口形式,如 lsof -ti :6006 | xargs kill。该技能不清除缓存(Storybook 预打包、Turbo 任务缓存),也不影响 IDB、Service Worker 或浏览器状态,仅结束服务器进程。输出为一行状态:all clear 或升级后仍被占用的 lsof 行。