Imported from llm011/ethan-agent (
ethan/defaults/skills/vercel-deploy/SKILL.md). Install upstream withnpx skills add llm011/ethan-agent --skill vercel-deploy. Copyright stays with the author (MIT).
Vercel 极速部署 (Vercel Deploy)
本技能用于将静态页面或 Web 应用快速部署至 Vercel 环境。
🔑 密钥配置 (Secrets)
凭证文件优先级（按顺序查找，命中即停）：
~/.ethan/.secrets/vercel.env（推荐，独立密钥文件）~/.ethan/.env（统一 env 文件）
需要以下环境变量：
VERCEL_TOKEN—— Vercel API 访问令牌（必填）VERCEL_ORG_ID—— 组织 ID（首次vercel link后由本地.vercel/写入，可选）VERCEL_PROJECT_ID—— 项目 ID（首次vercel link后由本地.vercel/写入，可选）
加载方式（执行部署前必须 source）：
[ -f ~/.ethan/.secrets/vercel.env ] && source ~/.ethan/.secrets/vercel.env \
|| ([ -f ~/.ethan/.env ] && source ~/.ethan/.env)严禁在 SKILL.md 或终端输出中明文写入 Token 值。
🛡️ 核心工作流 (Workflow)
1. 宿主模式 (Host Project)
默认将页面存入 ~/.ethan/web/tools/ 子目录，统一部署 ~/.ethan/web 根项目以减少 Vercel 项目数。
2. 构建与部署 (Build & Deploy)
非交互式部署：
npx vercel --prod --yes --token "$VERCEL_TOKEN" --cwd "$HOME/.ethan/web"部署完成后必须提取并返回 https://...vercel.app 链接。
3. pnpm 项目示例 (pnpm Workflow)
用户偏好 pnpm。对于 pnpm 项目：
# 1. 构建
pnpm install --frozen-lockfile && pnpm build
# 2. 部署构建产物（如 dist/ 或 build/）
npx vercel deploy --prod --yes --token "$VERCEL_TOKEN" --cwd ./dist
# 3. 若需显式传递组织/项目（覆盖 .vercel/ 本地配置）
VERCEL_ORG_ID="$VERCEL_ORG_ID" \
VERCEL_PROJECT_ID="$VERCEL_PROJECT_ID" \
npx vercel --prod --yes --token "$VERCEL_TOKEN"避坑指南 (Gotchas)
- 本地路径: 必须使用绝对路径传递给
--cwd（~不会被 vercel CLI 展开，需用$HOME或实际路径）。 - Link 错误: 若项目未关联，加入
--force参数或提示用户运行vercel link。 - 环境污染: 优先使用
npx vercel而非全局安装的vercel，避免版本污染。 - pnpm 检测: 通过 Vercel 自动构建时，确保
package.json中packageManager字段为pnpm@<version>，以触发 Vercel 的 pnpm 自动检测。