【免费下载链接】edgeone-makers-tools项目地址https://gitcode.com/gh_mirrors/ed/edgeone-makers-tools点击查看免费下载edgeone-makers-tools 是 EdgeOne Makers 平台官方出品的 AI 开发技能包装进 AI 编程助手后即可帮你写代码、建云函数、一键部署上线。本文面向新手带你一次性搞定 WorkBuddy 沙箱环境下的 7 个高频坑并附赠一套可直接搬到 CI 流水线的适配方案。一、edgeone-makers-tools 是什么为什么沙箱里容易翻车一句话它是一组教 AI 助手如何开发并部署 EdgeOne Makers 项目的技能文档覆盖 AI Agent 开发、云函数、边缘函数、KV 存储、中间件、部署和 CLI 参考等 11 项能力。安装很简单任选其一npx skills add TencentEdgeOne/edgeone-makers-tools # 或克隆仓库到本地技能目录 git clone https://gitcode.com/gh_mirrors/ed/edgeone-makers-tools整个技能包由一个「路由」入口 SKILL.md 负责按任务分发到 references/ 下的具体能力文档其中与本文最相关的两份是沙箱环境适配规则makers-env-adaption/SKILL.md部署与 CI 规范makers-deploy/SKILL.md⚠️ 先记住一个关键事实WorkBuddy 是「桌面 IDE 沙箱」不是无头环境。CLI 的交互式弹窗会卡死但浏览器登录完全可用——很多翻车都源于把这个环境当成纯 headless 来处理。二、WorkBuddy 沙箱的 7 个高频坑坑1CLI 交互提示卡死 → 所有命令必须带非交互参数沙箱里没有真实 TTYedgeone命令一旦弹出「选择项目」「同步环境变量」就会永远挂起。解法是给每条命令带上非交互参数场景必带参数作用本地开发--skip-env-sync跳过「同步环境变量」确认关联/部署项目-n 项目名跳过交互式项目选择器未登录时-t token直接传 token不弹登录部署输出--json输出机器可读的 JSON 单行✅ 正确edgeone makers dev -n my-project --skip-env-sync❌ 错误裸跑edgeone makers dev必然挂起坑2localhost 明明起了服务却 404沙箱里localhost会解析成 IPv6 的::1而 dev server 是双栈监听结果就是「假 404」。 所有地址一律写死127.0.0.1例如本地预览固定用http://127.0.0.1:8088/。坑3curl 验证接口返回 Empty reply状态码 000沙箱会注入http_proxy环境变量curl 默认走代理流式SSE响应会被代理吞掉。 沙箱内自测接口统一加--noproxy *curl --noproxy * http://127.0.0.1:8088/api/...。内置浏览器预览不受代理影响。坑4用 file:// 或自建静态服务器预览 → 接口全挂这是新手最容易踩的深坑❌ 直接把dist/index.html路径丢给预览面板走file://fetch / SSE / Blob / KV 全部失效❌ 用python -m http.server、npx serve自建静态服务缺少 Blob 凭据注入、云函数路由、边缘函数和中间件链本地与线上行为不一致✅ 只用edgeone makers dev启动的 dev server并通过http://127.0.0.1:8088/预览一句话铁律Makers 项目里的任何预览都必须走 HTTP 协议。坑5部署跑到一半被杀exit 137还拿不到 URL沙箱前台命令有约 100 秒的墙钟预算而冷部署构建→上传→处理→上线常态需要 210 分钟。超时会收到 SIGKILLexit 137进程被杀但服务端部署通常仍在继续。正确姿势npm install→ 前台同步执行1030 秒edgeone makers dev/edgeone makers deploy→ 后台异步执行部署命令加--json取输出的最后一行 JSON解析出url等字段中间的心跳日志当噪音处理被杀后不必慌重跑一次deploy同名-n会复用项目并返回 URL坑6写凭证报 EPERM家目录只读沙箱禁止写~/.edgeone/但允许写项目目录。 登录时加--localedgeone login --site china --local凭证会落到项目内的.edgeone/auth.json绕开家目录限制。Token 解析优先级CLI 自动按序查找-t参数 →EDGEONE_PAGES_API_TOKEN环境变量 → 项目内.edgeone/auth.json→~/.edgeone/。另外用edgeone whoami判断登录状态退出码 0 已登录1 未登录新版 CLI 会快速失败不会挂起。坑7页面「删除按钮点了没反应」 别把命令甩给用户两个 WorkBuddy 专属小坑内置预览面板不渲染alert/confirm/prompt原生弹窗调用直接静默返回。确认、输入、提示类交互一律改成页面内自定义弹窗组件。沙箱里的用户没有终端你打印的命令对他来说是死文字。该装的包、该执行的登录都由 AI 助手自己跑只有「在浏览器里点一下登录」这类动作才交给用户。三、附CI / 无头环境适配方案把项目搬到 CI 流水线时思路和 WorkBuddy 略有不同——CI 是真·无浏览器环境登录方式必须换成 Token。1. 认证用 Token不要碰浏览器登录# 从控制台创建 API Token 后二选一 edgeone makers deploy -n my-app -t token --json # 或写入环境变量推荐Token 具有账号级权限切勿提交到仓库 export EDGEONE_PAGES_API_TOKENtoken 小技巧之前浏览器登录成功时CLI 已在~/.edgeone/自动生成过 Token可直接复用其value.Token字段无需再去控制台新建。2. 输出统一--json 解析最后一行CI 中没有 TTY务必加--json成功时最后一行形如{status:success,url:...,projectId:...}失败时是{status:error,error:...}且进程退出码非 0——直接据此驱动流水线分支。3. 环境标记与预览环境所有edgeone命令前建议设置PAGES_SOURCEskills标识部署来自技能上下文。CI 里发版建议先走预览环境验证edgeone makers deploy -n my-app -e preview --json。4. 定时/无人值守任务免登录部署CLI ≥ 1.6.29 支持匿名部署--anonymous --json适合「每日定时生成页面并部署」这类无人值守场景先拿到临时 URL再由流水线或人员后续认领项目。⚠️ 注意依赖 KV / Blob / AI 网关凭据的项目不能走免登录必须走 Token 认证否则「部署成功、运行报错」。5. WorkBuddy vs CI 一页对照表维度WorkBuddy 沙箱CI 无头流水线登录方式浏览器登录可用--local仅 Token-t/EDGEONE_PAGES_API_TOKEN交互提示全部非交互参数全部非交互参数 --json本地验证curl --noproxy * http://127.0.0.1:8088/通常直接-e preview验证长任务后台执行防 100 秒墙钟击杀拉长 step 超时时间匿名部署可选定时任务的默认选择四、版本红线速查组件最低版本原因EdgeOne CLI≥ 1.6.7非交互修复、whoami 快速失败、--jsonEdgeOne CLI免登录部署/认领≥ 1.6.29低版本没有--anonymous和claimNext.js16.x框架适配器跟踪的版本edgeone/pages-blob≥ 0.0.14旧版有已知缺陷五、延伸阅读仓库内路径技能路由总入口skills/edgeone-makers-tools/SKILL.md沙箱/WorkBuddy/CI 适配全规则makers-env-adaption/SKILL.md部署流程与免登录部署makers-deploy/SKILL.md · 匿名部署详解 · 命令与参数参考CLI 命令速查makers-cli/SKILL.md沙箱代码执行能力/tmp 易失、需内存缓存回写capabilities/sandbox.md写入校验钩子实现hooks/hooks.json · hooks/validate-write.mjs仓库体检脚本scripts/doctor.mjs搞定以上 7 个坑再对照 CI 方案配置好 Token 和--json你的 edgeone-makers-tools 项目就能从沙箱一路顺畅跑到生产 赞分享【免费下载链接】edgeone-makers-tools项目地址https://gitcode.com/gh_mirrors/ed/edgeone-makers-tools点击查看免费下载相关推荐如何在EdgeOne Makers开发AI Agentedgeone-makers-tools五大框架选型决策树如何在EdgeOne Makers开发AI Agentedgeone makers tools五大框架选型决策树 edgeone makers tools 是edgeone-makers-tools是什么AI编程助手的EdgeOne全栈开发技能包完全指南edgeone makers tools是什么AI编程助手的EdgeOne全栈开发技能包完全指南 edgeone makers tools 是面向腾讯 Edgedgeone-makers-tools的13条红线AI Agent开发必须避开的致命错误清单edgeone makers tools的13条红线AI Agent开发必须避开的致命错误清单 edgeone makers tools https://li创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考