用途：dev-server 用于启动开发服务器，并在启动前处理端口占用问题，避免端口冲突导致启动失败。
主要能力：
- 端口检查：运行 scripts/check_ports.sh 扫描常见开发端口，显示每个端口属于哪个项目。
- 冲突处理：若占用端口的是同一项目，可用 --kill-if-same 直接结束进程；若是不同项目，需先询问用户，或改用其他端口。
- 环境检测：检查是否存在 docker-compose.yml、monorepo 结构或 package.json，据此决定启动方式。
- 启动服务器：使用检测到的包管理器并加 --open 标志；必要时加 --port <n>。
端口脚本用法： scripts/check_ports.sh 扫描端口并显示归属项目； scripts/check_ports.sh 3000 检查指定端口及项目信息； scripts/check_ports.sh --find 3000 查找第一个可用端口； scripts/check_ports.sh --kill-if-same 3000 仅当同一项目时结束进程； scripts/check_ports.sh --kill 3000 强制结束，若为不同项目需先询问用户。 脚本通过比较进程工作目录与当前目录判断项目归属，同一项目指进程从当前目录或其父/子目录启动。
环境检测：若存在带 web/app 服务的 docker-compose.yml，建议改用 docker compose up；monorepo 中若当前目录无 dev 脚本，则查找 apps/web/package.json、packages/app/package.json 或根 package.json 的 workspace dev 脚本；包管理器依据锁文件判断（bun.lockb→bun，pnpm-lock.yaml→pnpm，yarn.lock→yarn，否则 npm）。
框架注意事项：多数框架支持 --open 和 --port。Create React App 默认 3000，需用 PORT=3001 环境变量而非 --port；Gatsby 默认 8000，用 -p 而非 --port；Remix 默认 3000，dev 模式下 --port 可用。若 --open 无效，可在服务器启动后执行 open http://localhost:PORT。
限制：资料未提供安装方式、收费信息及更多平台支持细节。