Vibe Coding 平台模板
Vibe Coding 平台模板 深度集成平台 SKills 能力，适用于快速生成基于 Next.js、Nuxt 等主流框架的全栈 Web 应用及 AI Agent，支持 SSR、ISR 等多种渲染模式。开发者可基于该模板快速构建支持多租户隔离、多框架适配和边缘一键部署的 Vibe Coding 平台。
整体架构
快速开始
1. 创建并获取 API Token。
2. 使用下方示例模板，即可快速体验并一键部署。
3. 在部署配置页面，填写
API_TOKEN环境变量。4. 点击部署，等待 Makers 完成构建并生成访问地址。
模板核心能力
Makers Skills 集成
模板在
.claude/skills/ 内置 Makers Skills，为 Agent 提供框架约定、平台 API、目录规范和部署要求。Agent 根据任务使用对应 Skill，生成项目先通过 Makers 兼容性检查，框架适配器是否就位、平台声明文件是否完整、目录结构是否合规；失败时自动尝试一轮修复。
可通过执行
npm run sync:skills 更新平台最新 Skills，会替换 .claude/skills/目录。启动预览
Agent 运行时拼出启动预览的命令字符串，再通过沙箱的 commands 工具调用 EdgeOne CLI 启动项目预览。
export function buildMakersDevLaunchCommand(port: number, projectName: string) {return `edgeone makers dev --port ${port} --skip-env-sync --name ${shellQuote(projectName)}`;}
执行部署
Agent 运行时拼出部署的命令字符串，再通过沙箱的 commands 工具调用 EdgeOne CLI 执行部署。
function makersDeployLaunch(projectName: string, requestedCommand: string, area = 'global') {const previewEnvironment = /(?:^|\s)(?:-e|--environment)(?:\s+|=)preview(?:\s|$)/i.test(requestedCommand);return ['edgeone makers deploy',`-n ${shellQuote(projectName)}`,'--json',`--area ${area}`,previewEnvironment ? '-e preview' : '',].filter(Boolean).join(' ');}
代码持久化
保存工作区代码
在每轮代码修改完成后调用
persist()：try {const persist = await context.sandbox.persist({path: projectPath});//path 为项目目录} catch (error) {// 保存失败不影响当前沙箱继续工作，可记录日志并稍后重试console.warn('Failed to save workspace:', error);}
恢复工作区代码
新沙箱创建后，Agent 开始读写项目文件前调用
restore()：const result = await context.sandbox.restore({path: projectPath});
注意：如果
restore() 返回 failed，本轮不要再调用 persist()，否则可能用不完整的工作区覆盖上一次可用快照。本地调试和部署
启动本地开发调试
1. 进入项目根目录，安装 EdgeOne CLI：
npm install -g edgeone
2. 执行登录，并关联前面使用模板部署的 Makers 项目：
edgeone loginedgeone makers link
关联项目后会把控制台配置的
API_TOKEN 和调用 Models 所需的 API Key 自动同步到本地。3. 启动 Makers 本地开发环境：
edgeone makers dev
启动成功后，访问 http://localhost:8088/ 即可打开应用；访问 http://localhost:8088/agent-metrics 可查看 Agent 调用的详细链路信息。
部署项目
如果项目已关联 Git 仓库，推送代码即可触发 Makers 的 CI 构建与部署。也可以通过 CLI 直接部署：
# 部署至生产环境edgeone makers deploy -n <项目名>
部署成功后点击 Console 的链接可以访问具体构建信息和部署后的 URL。