用途:为项目生成稳定唯一的开发端口号,范围 3000-8999,同一项目名永远返回相同端口,并帮助更新项目配置或启动开发服务器。
主要能力:
- 查询项目端口:用户询问端口时直接计算并告知。
- 更新项目配置:检测并更新端口配置文件,包括 .env / .env.local 中的 PORT=<port>、package.json 的 scripts 中 --port <port>、vite.config.ts 的 server.port,next.config.js 通常使用 .env。更新时优先使用 .env 方式,最小侵入性。
- 启动开发服务器。
使用方式:端口生成算法为 hash_value = sum(ord(c) * (i + 1) for i, c in enumerate(project_name)),返回 3000 + (hash_value % 6000)。可运行脚本 scripts/hashport.sh [project-name] 生成端口:使用当前目录名时执行 ./scripts/hashport.sh;指定项目名时执行 ./scripts/hashport.sh my-project。启动开发服务器命令为 PORT=$(scripts/hashport.sh) pnpm dev。
限制:资料未提供关于收费、价格、平台支持范围及更多配置细节的信息。端口冲突处理:若端口被占用,提示用户哪个进程占用了端口,建议使用 lsof -i :<port> 查看,并可追加后缀生成备用端口,如 generate_port("project-dev")。