一、快速开始
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。