用途：把本地开发服务器暴露为命名的 HTTPS .localhost URL（如 https://myapp.localhost），替代随机的 localhost:端口，让智能体和浏览器测试有稳定地址。
主要能力：默认 HTTPS 443，有效证书、零配置；多服务命名（api.localhost、web.localhost）；git worktree 自动分支名子域名；通配符子域名；LAN 模式（mDNS .local，手机/平板可访问）；--tailscale/--funnel 与 --ngrok 公网共享；服务注册使 URL 重启后保留；portless doctor 只读诊断；portless alias 把 docker-compose 端口映射为命名 URL；portless prune/clean 清理；自动注入 NODE_EXTRA_CA_CERTS；Expo/React Native 支持。
使用方式： portless run npm run dev portless run --name api npm run dev:api portless proxy start --lan portless service install portless clean 多数框架（Next.js、Vite、Astro、Express、Rails）可自动识别；FastAPI/uvicorn 需 --port $PORT --host $HOST，Django 用 $HOST:$PORT 位置参数。
环境变量：PORTLESS_URL 供智能体提示使用；PORTLESS=0 在 CI 中绕过；PORTLESS_SYNC_HOSTS=0 关闭 hosts 同步；PORTLESS_STATE_DIR 覆盖状态目录。
限制：0.13.1 起需 Node.js 24+；状态目录 0.11 起迁至 ~/.portless 且旧状态不自动迁移；0.10.x 起默认 443 为破坏性变更，可用 --no-tls 回退；CI 中应设置 PORTLESS=0。
适用场景：智能体/浏览器测试目标、本地多服务、git worktree、本地 OAuth 回调、emulate API mock 命名。更多 CLI 与框架细节需查阅其 references 文档，本次资料未提供更完整命令清单。