用途：为项目生成稳定唯一的端口号，范围 3000-8999，同一项目名永远返回相同端口，用于设置端口、启动开发服务器、解决端口冲突或初始化新项目配置。
主要能力：提供端口生成算法 generate_port(project_name)，按字符位置加权求和后取模映射到 3000-8999；可查询项目端口，例如项目 lovstudio 的端口号为 7965；可检测并更新项目中的端口配置文件，包括 .env/.env.local 的 PORT=<port>、package.json scripts 中的 --port <port>、vite.config.ts 的 server.port，next.config.js 通常使用 .env；更新时优先使用 .env 方式，最小侵入性。
使用方式：运行 scripts/hashport.sh [project-name] 生成端口，不传参数时使用当前目录名，例如 ./scripts/hashport.sh 输出 7965，./scripts/hashport.sh my-project 输出 5123；启动开发服务器可用 PORT=$(scripts/hashport.sh) pnpm dev。
端口冲突处理：若端口被占用，提示用户哪个进程占用端口，建议使用 lsof -i :<port> 查看，并可追加后缀生成备用端口，如 generate_port("project-dev")。
限制：资料未提供其他平台支持、收费、价格或效果信息。