用途：把已构建的 Deck App Runtime Upload Archive（.vdapp.zip）通过局域网上传到运行 VitaDeck 的 PS Vita，用于上传、发布或部署 vdapp。
前提：Vita 上需运行 VitaDeck，并开启 Runtime Upload（Shell → Upload → 确认）。监听端在 8787 端口提供 POST /upload，端口被占用时会顺延。
用法：在任意目录执行脚本上传已构建的归档： /path/to/vitadeck/.cursor/skills/vitadeck-vdapp-upload/scripts/upload-vdapp.sh /path/to/myapp.vdapp.zip 成功返回形如 {"ok":true,"packageName":"myapp.vdapp","version":"0.1.0"}。
构建归档：在 Deck App 项目内执行 vitadeck build，生成 <outDir>/<name>.vdapp/ 与 <outDir>/<name>.vdapp.zip（如 dist/chat.vdapp.zip）。上传应使用 .zip，而非解包后的目录。
Vita IP 指定：可显式覆盖，如 upload-vdapp.sh --ip 192.168.1.50 myapp.vdapp.zip，或 PSVITAIP=192.168.1.50 upload-vdapp.sh myapp.vdapp.zip。默认解析顺序（先命中者优先）：--ip / PSVITAIP；out-vita/CMakeCache.txt 中的 PSVITAIP:STRING=…；out/CMakeCache.txt 中的 PSVITAIP:STRING=…；CMakeLists.txt 中的 set(PSVITAIP "…")（仓库默认值）。
手动上传：curl -X POST "http://${PSVITAIP:-192.168.1.177}:8787/upload" -F archive=@/path/to/myapp.vdapp.zip。
排错：连接被拒通常表示 Vita 未打开 Upload 界面或 IP 错误；409 表示已有上传进行中，需等待后重试；422 表示归档结构错误，zip 必须恰好包含一个顶层 *.vdapp 目录。上传后若未自动激活，可在 Shell 主界面按 Enter 选择该包。
限制：需 VitaDeck 运行且开启 Runtime Upload，依赖局域网连通与正确 IP；归档结构须符合要求。其他平台、收费与价格信息暂未提供。