vinext

在Vite上运行Next.js应用,主要部署到Cloudflare Workers。

前端开发 前端开发全栈开发 搭建开发环境执行自动化部署 claudecursor通用 更新于 2026-07-22

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:vinext。
它的用途是:在Vite上运行Next.js应用,主要部署到Cloudflare Workers。
完整的 Skill 内容见:https://321skill.com/skills/vinext/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我把这个Next.js项目迁移到vinext,以便部署到Cloudflare Workers。” 它会分析你的项目结构,运行 `vinext check` 检查兼容性,并指导你进行必要的配置修改和依赖调整。或者,在项目根目录直接

对AI说:“migrate this project to vinext”,其内置的Skill会启动一个交互式的迁移助手。

介绍

vinext 是一个旨在解决 Next.js 应用在特定平台(尤其是 Cloudflare Workers)上部署和开发体验问题的工具。它并非 Next.js 的官方版本,而是由 Cloudflare 主导开发,在 Vite 构建工具上重新实现了 Next.js 的 API 接口,从而让开发者能够利用 Vite 的快速开发体验,并将应用高效部署到 Cloudflare Workers 等边缘计算平台。

使用 vinext 主要有两种方式:对于新项目,可以使用 pnpm create vinext-app@latest 命令快速创建;对于现有 Next.js 项目,则可以通过 npx vinext init 命令进行迁移。此外,它还提供了一个 AI Agent Skill,可以在支持的 AI 编码工具中,通过对话指令(如“migrate this project to vinext”)来辅助完成迁移过程,自动检查兼容性问题并调整配置。

这个工具非常适合两类开发者:一是希望将现有 Next.js 应用部署到 Cloudflare Workers 以利用其边缘计算能力的团队;二是正在启动新项目,并计划以 Cloudflare Workers 为主要部署目标,同时希望享受 Vite 开发速度的前端工程师。

与直接将 Next.js 应用构建后部署到 Node.js 环境或其他平台的传统方式相比,vinext 的核心区别在于其“重新实现”的架构。它不依赖于 next build 的输出,而是基于 Vite 构建了一套与 Next.js 兼容的运行时,这使得它能更深度、更原生地集成到 Cloudflare Workers 的生态中,例如支持 Workers 的绑定、缓存适配器等特性。

核心特点

核心区别在于它是在 Vite 上重新实现了 Next.js 的 API,而非包装 Next.js 的构建输出,这使得它能与 Cloudflare Workers 进行更深度的原生集成。同时,它提供了专门的 AI Agent Skill,能通过对话指令辅助完成项目迁移。

注意事项

目前尚不支持 Next.js 的所有特性(如完整的缓存组件、构建时图片优化等),不适合对 Next.js 最新 App Router 特性有强依赖或要求 100% 行为一致的生产项目直接迁移。

常见问题

vinext 和 Next.js 官方版本有什么区别?

vinext 在 Vite 上重新实现了 Next.js API,主要目标是深度集成并部署到 Cloudflare Workers,并非官方版本,部分新特性支持可能滞后。

如何将现有的 Next.js 项目迁移到 vinext?

推荐使用 `npx vinext init` 命令,或通过其 AI Agent Skill,在支持的编码工具中对 AI 说“migrate this project to vinext”来获得迁移指导。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/vinext/raw/index.md 读取 vinext 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。