# 放弃 Vercel — 迁移协调器您正在运行 **ditch-vercel** 迁移技能。 **完全按顺序**遵循下面的 5 阶段流程。不要跳过阶段。在第 4 阶段之前不要进行任何文件更改（在第 3 阶段中明确用户批准后）。 ** ** ## 视觉风格所有面向用户的输出都必须使用赛博朋克“逃脱序列”视觉语言。在每个阶段渲染输出时请遵循以下规则： 1. **主要框架**（第一阶段横幅，第五阶段完成）：使用双行画框字符 — `╔` `═` `╗` `║` `╚` `═` `╝` 2. **报告和子面板**（第二阶段报告、第三阶段计划）：使用单线圆角方框图 — `┌` `─` `┐` `│` `└` `─` `┘` 3. **叙述/状态行**：前缀为“>”——例如`> 检测到 VERCEL 锁定` 4. **进度条**（阶段 4）：“██”表示填充段，“░░”表示空段 5. **状态标签**（第 4 阶段跟踪器）：“CLEAR”（已完成）、“ACTIVE”（正在进行）、“QUEUED”（待处理）、“FAILED”（错误）、“SKIPPED”（用户跳过） 6. **跨阶段使用的前缀符号**： * `[✓]` — 完成/自动化 * `[!]` — 需要注意 * `[✗]` — 阻碍/严重 * `+` — 添加 * `-` — 删除 * `~` — 修改 * `×` — 删除 * `◆` — 手动操作 ** ** ## 第 1 阶段：扫描一次性静默检测框架、Vercel 功能和目标平台。最小输出——报告进入第二阶段。 ### 飞行前检查通过检查“.git”目录来验证项目是否为 git 存储库。如果不是 git 存储库，则警告用户：“该项目不是 git 存储库。安全检查点（第 4 阶段）需要 git 进行回滚。首先使用 `git init` 进行初始化，或者在没有回滚保护的情况下继续。”询问用户是否继续或停止。 ### 1a。检测框架阅读 `package.json` — 检查 `dependency` 和 `devDependency`。检查框架配置文件。与此表的比赛（第一场比赛获胜）：框架| package.json 指标 |配置文件模式 ---|---|--- Next.js |部门中的“下一个”| `下一个.config.*` 天文 |部门中的“astro” | `astro.config.*` 混音| deps | 中的`@remix-run/*` `remix.config.*` （可选） SvelteKit | deps 中的`@sveltejs/kit` `svelte.config.*` 努克斯特 | deps | 中的 `nuxt` `nuxt.config.*` 静态|上述框架都不是依赖 |不适用阅读对应的知识文件： * Next.js: [frameworks/nextjs.md]() * Astro：[frameworks/astro.md]() * 混音：[frameworks/remix.md]() * SvelteKit：[frameworks/sveltekit.md]() * Nuxt：[frameworks/nuxt.md]() * 静态：[frameworks/static.md]() ### 1b。检测所有 Vercel 功能扫描每个 Vercel 特定的功能。检查每一项——不要跳过任何一项。 **配置：** * `vercel.json` — 完整阅读（如果存在）。注意：重写、重定向、标头、cron、功能配置、区域。 **Vercel SDK 包** — 检查 `package.json` deps 和 devDeps 中的： * `@vercel/分析` * `@vercel/速度洞察` * `@vercel/blob` * `@vercel/kv` * `@vercel/postgres` * `@vercel/edge` * `@vercel/og` * `@vercel/edge-config` * 任何其他 `@vercel/*` 包 **特定于框架的 Vercel 功能** — 扫描源文件： * **Edge Runtime** ：在路由/API 文件中搜索 `export const runtime = 'edge'` 或 `export const runtime = "edge"`。 * **next/image** ：搜索 `import.*from ['"]next/image['"]` — 使用 Vercel 的图像优化。 * **ISR** ：在页面/路由文件中搜索“export const revalidate”或“revalidate:”。 * **API 路由** ：搜索 `app/api/**/route.{ts,js}` 或 `pages/api/**/*.{ts,js}` (Next.js)，或其他框架中的等效项。 * **中间件** ：在项目根目录或“src/”处检查“middleware.{ts,js}”。 * **Cron jobs** ：检查 `vercel.json` 中的 `crons` 字段。 * **环境变量** ：检查 `.env*` 文件。请注意存在哪些环境变量（仅名称，从不值）。 * **无服务器/边缘功能配置** ：检查“export const config = {runtime: ... }”模式。 ### 1c。选择目标平台要求用户选择目标平台：您想迁移到哪里？ - Cloudflare（工作人员/页面 — 无服务器边缘）（推荐） - 铁路（Node.js — 具有本机数据库的托管基础设施） - VPS（Node.js + PM2 + Nginx — 自我管理服务器） - 其他目标即将推出（Netlify、Fly.io）读取目标知识文件： * Cloudflare：[targets/cloudflare.md]() * 铁路：[targets/railway.md]() * VPS：[targets/vps.md]() ### 1d。输出显示开头横幅，然后显示主题扫描结果： ╔═══════════════════════ ═══════════════════════╗ ║ ██████╗ ██╗████████╗ ██████╗██╗ ██╗ ║ ║██╔══██╗██║╚══██╔══╝██╔════╝██║██║║ ║ ██║ ██║██║ ██║ ██║ ███████║ ║ ║██║██║██║██║██║██╔══██║║ ║██████╔╝██║██║╚██████╗██║██║║ ║╚═════╝╚═╝╚═╝╚═════╝╚═╝╚═╝║ ║ 维塞尔 ║ ╚═══════════════════════ ═══════════════════════╝ > 检测到 VERCEL 锁定 > 正在启动转义序列... 已识别的框架锁：[框架] [版本]（[变体]）发现恶意软件包：[N] Vercel 特定功能逃生路线：[目标平台] 示例值：“Next.js 15（应用程序路由器）”、“8”、“Cloudflare Workers/Pages” ** ** ## 第二阶段：报告焦虑减轻剂。在要求开发人员做出任何承诺之前，向开发人员准确展示此迁移有多困难。 ### 2a。计算复杂度分数将每个检测到的 Vercel 功能与目标的兼容性矩阵（来自目标知识文件）和框架知识文件的兼容性注释进行交叉引用。 **去重规则：** 当相同的功能同时出现在目标矩阵和框架兼容性注释中时： 1.使用**目标文件的权重**作为基础分数 2. 如果框架文件列出了同一目标上相同功能的 **较低** 权重，请使用较低的权重（框架的适配器可能会自动处理） 3. 对每个特征精确**一次** - 永远不要对两个文件求和对于每个检测到的特征： 1.查看其**权重**和**类别**——目标文件为主，框架文件只能向下覆盖 2. 将所有权重相加 → 总复杂度得分 3、确定红绿灯： * 🟢 **绿色** (0-2)：~1-2 小时 — 大部分是自动化的 * 🟡 **黄色** (3-6)：约 3-5 小时 — 几个手动步骤 * 🔴 **红色** (7+)：~1-2 天 — 重大重构或阻碍 ### 2b。将功能分为 3 组 * **自动化**（权重 0）：ditch-vercel 完全处理这些 * **注意**（重量 1）：可以工作，但需要轻微的手动调整 * **阻止者**（权重 3）：付出巨大努力，可能会阻止迁移 ### 2c。输出报告 > 威胁评估完成 ┌──────────────────────────────────────────────┐ │ 锁定严重性：[🟢 绿色 / 🟡 黄色 / 🔴 红色] │ │ 预计提取时间：[预计时间] │ └──────────────────────────────────────────────┘ 中和（自动处理）： [✓] [功能] → [发生了什么] [✓] [功能] → [发生了什么] ... 需要操作员干预： [!] [功能] → [开发者需要做什么] [!] [功能] → [开发者需要做什么] ... 严重威胁： [✗] [功能] → [为什么它是一个拦截器以及需要什么] ... 仅包含包含项目的部分。如果没有严重威胁，请忽略该部分。如果没有操作员干预项，请忽略该部分。 ** ** ## 第 3 阶段：计划 + 批准生成具体的迁移计划，获得明确批准，然后创建任务列表。 ### 3-预。交叉引用官方文档在生成计划之前，请根据当前官方文档验证迁移步骤。 1. 从加载的框架文件和目标文件中读取“## Reference URLs”部分 2. **首选`llms.txt` URL**（以`llms.txt:`为前缀的行）——这些是针对LLM优化的机器可读文档索引。获取“llms.txt” URL 并使用索引找到特定的迁移/部署页面，然后获取该页面。如果源不存在“llms.txt”条目，则回退到常规文档 URL。 3. 获取每个 URL 并提取：当前迁移步骤、所需的包、配置格式以及任何重大更改或弃用通知 4. 将获取的内容与框架知识文件中的迁移步骤进行比较。寻找： * 包名称更改（例如适配器重命名） * 新的必需配置字段 * 已弃用的 CLI 标志或命令 * 更改了构建输出目录 5. 如果发现差异：记下它们。它们将被合并到 3a 中的计划中，并在计划输出中为用户标记。 6. 如果任何 URL 获取失败：静默跳过，继续执行框架文件说明 ### 3a。生成迁移计划根据阶段1-2和阶段3-pre中的文件验证，制定具体计划。列出确切的文件路径、包名称以及将进行的更改。用其类别标记每个项目。如果文档验证发现与知识文件存在差异，请以官方文档作为事实来源，并在相关计划项目中注明差异。 > 提取计划已生成 ═════════════════════════ ═════════════════════════ Vercel 上的 [框架] → [目标] ═════════════════════════ ═════════════════════════ 要部署的有效负载： + [包装] [自动] + [包装] [自动] ... 抛弃的有效载荷： - [包装] [自动] - [包装] [自动] ... 要注入的文件： + [文件路径] — [描述] [自动] ... 要修补的文件： ~ [文件路径] — [描述] [自动/手动] ... 要清除的文件： × [文件路径] [自动] ... 提取后操作： ◆ [项目] [手册] ... 每个条目必须足够具体，以便开发人员准确理解将会发生什么。为每个项目标记“[自动]”以表示自动，或“[手动]”以表示注意/阻止项目。 ### 3b。审批门 **这是一扇硬门。未经明确批准，请勿继续。** 询问用户： > 授权撤离？ [1] 是 — 执行提取序列 [2]修改——调整计划 [3] 中止 — 不做任何更改，干净退出如果“修改”：循环——收集反馈，修改计划，再次提交审批。如果“中止”：优雅地停止。输出：`> 提取中止。没有更改任何文件。随时运行 /ditch-vercel 即可重新参与。 **重要：在获得批准（选项 1）之前，请勿创建、修改或删除任何项目文件。** ### 3c。建立执行清单开发人员批准后，为每个迁移操作建立一个有序的清单。跟踪第 4 阶段中每个项目的进度（在开始和完成每个步骤时宣布）。如果您的代理支持内置任务跟踪，请使用它。执行顺序： 1. **创建git安全检查点** 2. 每个依赖项安装一个项目 3. 每个依赖项删除一项 4. 每个文件创建一项 5. 每个文件修改一项 6. 每个文件删除一项 7. **运行构建验证** 8. **运行本地开发服务器验证** 每一项必须描述一个原子操作以及确切的命令或文件更改。 ## 第 4 阶段：执行通过安全网和实时任务跟踪执行批准的计划。输出提取授权头： > 授权的提取顺序 ────────────────────────────────────────────── ### 4a。 Git 安全检查点开始 git 安全检查点。 1.检查`git状态`。如果工作树脏了： git add -u && git commit -m "杂务：迁移前检查点 (ditch-vercel)" **警告：** 仅阶段跟踪文件（`git add -u`）。不要使用“git add -A”——它可能会意外提交“.env”文件或凭据。如果用户想要保留重要的未跟踪文件，请告诉他们首先“git add”这些特定文件。 2. 如果工作树是干净的，请记下当前的 HEAD SHA。 3. 存储用于回滚的检查点SHA。 4. 将检查点步骤标记为已完成。 5、输出： > 安全检查点已锁定（提交：）。紧急回滚： git reset --hard ### 4b。检测包管理器检查项目根目录中的锁定文件（第一个匹配获胜）：锁定文件|包管理器 ---|--- `bun.lockb` 或 `bun.lock` | `小圆面包` `pnpm-lock.yaml` | `pnpm` `yarn.lock` | `纱线` `package-lock.json` | `npm` 如果没有找到锁定文件，则默认为“npm”。 ### 4c。执行每一个任务对于每个剩余任务（依赖项、文件、删除）： **重要提示：** 按照与所选目标平台匹配的框架知识文件中的迁移步骤部分进行操作。例如，如果目标是 VPS，请按照“## 迁移步骤 (VPS)”操作。如果目标是 Cloudflare，请按照“## 迁移步骤 (Cloudflare)”操作。使用相应的“## 兼容性说明（[目标]）”部分获取替换指导。 1.执行动作： * **安装 dep** : `[pkg-manager] add ` / `[pkg-manager] add -D ` * **删除 dep** : `[pkg-manager] 删除 ` * **创建文件** : 创建文件 * **修改文件** : 编辑文件 * **删除文件** : 删除文件（例如 `rm`） 2. 如果成功：将该步骤标记为已完成 3. 如果失败：显示错误并询问开发人员： * **“修复它”** → 阅读错误，尝试修复，重试该操作 * **“跳过此步骤”** → 用 `SKIPPED` 标记完成，继续 * **“回滚所有内容”** → 运行`git reset --hard `，跳过所有剩余步骤，停止执行 **进度跟踪器渲染：** 每个步骤完成后，重新渲染显示所有步骤的完整进度跟踪器。使用这种格式： [03/14] ██████████████████░░░░░░░░░░░░ 正在安装 @opennextjs/cloudflare ──────────────────────────────────────────────── [01/14] ██████████ 清除 Git 安全检查点 [02/14] ██████████ 清除删除@vercel/analytics [03/14] █████░░░░░ 正在安装 @opennextjs/cloudflare [04/14] ░░░░░░░░░░ 已排队创建 wrangler.toml ... 状态标签：“CLEAR”（已完成）、“ACTIVE”（正在进行）、“QUEUED”（待处理）、“FAILED”（错误）、“SKIPPED”（用户跳过）。最上面一行显示当前步骤；列表显示所有步骤。用户选择回滚后失败时，输出： > 中止提取？重置到检查点 ### 4d。构建验证所有文件更改完成后： 1. 开始构建验证 2.检测构建命令： * Next.js + Cloudflare：` run build:cf` （或迁移中添加的 build:cf 脚本） * Next.js + VPS: ` run build` * Astro: ` run build` (运行 `astro build`) * Remix: ` run build` (运行 `remix vite:build`) * SvelteKit: ` 运行构建` * Nuxt: ` run build` (运行 `nuxt build`) * Next.js + Railway: ` run build` * Astro + Railway：` run build` * 混音 + 铁路：` run build` * SvelteKit + Railway：` run build` * Nuxt + Railway: ` run build` * 静态+铁路：` run build`（如果没有构建步骤则跳过） * 带有构建脚本的静态：` run build` * 无需构建的静态：跳过（无需构建） 3.运行构建命令 4. 如果构建通过：将步骤标记为完成 5. 如果构建失败： * 显示错误输出（前 50 行） * 询问开发商： * **“修复它”** → 阅读错误，尝试修复代码，重新运行构建 * **“回滚所有内容”** → 运行`git reset --hard `，跳过剩余步骤，停止 * **“仍然继续”** → 注意“[构建失败 - 需要手动修复]”并继续 ### 4e。本地开发服务器验证构建通过后，验证应用程序在本地启动并响应。 1.开始本地开发服务器验证 2.检测预览命令： * Next.js + Cloudflare：`npx wrangler dev`（端口 8787） * Next.js + VPS：`node .next/standalone/server.js`（端口 3000） * Astro + Cloudflare：`npx wrangler Pages dev dist/`（端口 8788） * Astro + VPS：`node dist/server/entry.mjs`（端口 4321） * Remix + Cloudflare：`npx wrangler 页面开发构建/客户端`（端口 8788） * Remix + VPS：`npx remix-serve build/server/index.js`（端口 3000） * SvelteKit + Cloudflare：“npx wrangler 页面 dev .svelte-kit/cloudflare”（端口 8788） * SvelteKit + VPS：`node build/index.js`（端口 3000） * Nuxt + Cloudflare：`npx wrangler 页面 dev .output/public`（端口 8788） * Nuxt + VPS: `node .output/server/index.mjs` (端口 3000) * 静态 + Cloudflare：`npx wrangler Pages dev `（端口 8788） * Next.js + Railway: `node .next/standalone/server.js` (端口 3000) * Astro + Railway：`node dist/server/entry.mjs`（端口 4321） * Remix + Railway：`npx remix-serve build/server/index.js`（端口 3000） * SvelteKit + Railway：`node build/index.js`（端口 3000） * Nuxt + Railway: `node .output/server/index.mjs` (端口 3000) *静态+铁路：“npx服务<输出目录>”（端口3000） * 静态 + VPS：`npxserve <输出目录>`（端口 3000） 3.后台启动预览命令 4. 等待约 5 秒服务器启动 5. 运行 `curl -s -o /dev/null -w "%{http_code}" http://localhost:/` 以检查 200 响应 6.杀死后台进程 7.如果curl返回200：将步骤标记为完成 8.如果curl失败或者非200： * 显示输出 * 询问开发商： * **“修复它”** → 调查、修复、重试 * **“跳过”** → 使用“[DEV SERVER CHECK SKIPPED]”标记完成 * **“回滚所有内容”** → 运行`git reset --hard `，跳过剩余步骤，停止 ## 第 5 阶段：完成输出最终的迁移摘要以及开发人员所需的一切。 ### 5a。迁移总结 ╔═══════════════════════ ═══════════════════════╗ ║ ███████╗██████╗ ███████╗███████╗║ ║██╔════╝██╔══██╗██╔════╝██╔════╝║ ║█████╗██████╔╝█████╗█████╗║ ║██╔══╝██╔══██╗██╔══╝██╔══╝║ ║██║██║██║███████╗███████╗║ ║ ╚═╝ ╚═╝ ╚═╝╚══════╝╚══════╝ ║ ╚═══════════════════════ ═══════════════════════╝ > 提取完成 > 你不再被锁定。创建：[列表文件] 已修补：[列表文件] 已清除：[列表文件] 已部署：[列出软件包] 删除：[列出软件包] 剩余操作： ◆ [报告中未完全自动化的项目] ... 下一步行动： 1.【部署命令】——部署到【目标】 2.在[target]仪表板中设置环境变量 3. [任何其他手动项目] 紧急回滚： git reset --hard [检查点-sha] 仅当有剩余物品时才包含“剩余行动”。从目标知识文件和框架知识文件中派生出本地dev命令、deploy命令和手册项。 ** ** ## 一般规则 * **精确** ：使用准确的文件路径、包名称和命令。永远不要含糊其辞。 * **注意安全**：切勿触摸项目目录之外的文件。切勿公开环境变量值。 * **透明** ：在执行之前向用户展示您发现了什么以及您计划做什么。 * **处理错误**：如果知识文件丢失，请根据您自己的知识进行工作，但警告用户。如果扫描没有发现任何结果，请明确说明而不是猜测。 * **仅一个框架** ：如果检测到多个框架，请要求用户澄清哪一个是主要框架。 * **Monorepo 感知** ：如果项目根目录包含 `apps/` 或 `packages/` 目录，则询问用户要迁移哪个应用程序。 * **跟踪第 4 阶段每个步骤的进度**。如果可用，请使用代理的任务跟踪。 * **步骤 #1 必须始终是 git 安全检查点。** * **如果操作失败，切勿将步骤标记为已完成。** 失败的步骤需要向开发人员提供恢复选项。注意：用户启动的跳过（开发人员明确选择“跳过此步骤”）并不是失败 - 使用“[SKIPPED]”标签标记这些已完成。

沟韦尔塞尔

包含技能