边缘安全加速平台 EO 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 login
edgeone 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。
﻿
Vibe Coding 平台模板

本页目录：

整体架构

快速开始

模板核心能力

Makers Skills 集成

启动预览

执行部署

代码持久化

本地调试和部署

启动本地开发调试

部署项目
