用途：帮助用户为 GoDaddy Node.js Hosting（PaaS）构建或修复 Node.js 应用，适配“上传→安装→运行 build→运行 start”的部署流程。包管理器支持 npm、pnpm、yarn，由 lockfile 决定平台选择。
主要能力：按用户意图分流——新应用脚手架、改造已有仓库或部署失败的应用、AI 导出（Lovable、Replit、Bolt 等）快速修复、托管 MySQL、邮件发送。提供框架检测与配方（Next.js、Next.js 静态导出、Nuxt、Remix、NestJS、Fastify、Vite SPA、Create React App、Express/Koa/Hono 等），并给出部署契约摘要与错误对照表（E001–E010、W001/W002/W004、C14）。
必要用法：根目录 package.json 需含 name、version、main（文件存在）、scripts.build、scripts.start；监听 process.env.PORT，必要时用 0.0.0.0；运行时依赖放 dependencies，不上传 node_modules；密钥走 process.env，zip 中不含 .env，zip 小于 100 MB；一次上传一个应用。数据库使用平台 MySQL 注入的 DB_HOST、DB_PORT、DB_NAME、DB_USER、DB_PASSWORD，配合 mysql2 与参数化查询。邮件通过平台内置网关 http://127.0.0.1:2525/api/email/send 的 sendEmail() 助手发送，不使用 nodemailer 或外部 SMTP。完成前必须运行校验：node scripts/validate-paas.mjs /path/to/project，退出码为 0。
适用场景：新建应用、改造已有项目、AI 导出修复、迁移自其他主机、前端纯静态或 SPA 加 Express 静态服务等。
限制：仅做托管兼容性改造，不新增功能、不重构无关代码、不更换框架；发布方式默认用中性表述（Git 同步或 UI 中 zip 上传），不根据 .git 或 lockfile 推断部署方式；邮件 from 默认省略，固定收件人须来自 process.env 且未设置时失败关闭，不向终端用户回显原始网关错误。具体配方、错误细节与迁移步骤见 contract.md、examples.md、troubleshooting.md、email.md。