【免费下载链接】edgeone-makers-tools项目地址https://gitcode.com/gh_mirrors/ed/edgeone-makers-tools点击查看免费下载edgeone-makers-tools是 EdgeOne Makers腾讯 EdgeOne平台的官方 AI 技能包其中的makers-migration迁移技能专门帮助老项目Express / Next.js / Flask / FastAPI 服务以及 LangGraph、CrewAI 等 AI Agent 项目平滑迁移到 EdgeOne 并完成改造。本文给出一份面向新手的迁移路线 完整改造清单照着做即可把老项目搬上 EdgeOne 边缘平台。 把这个技能包加入你的 AI 编程助手Claude Code、Cursor 等AI 会自动识别迁移、部署类任务并加载对应技能。仓库 clone 地址https://gitcode.com/gh_mirrors/ed/edgeone-makers-tools一、迁移决策先判断你的项目属于哪一类改造前先对号入座不同的老项目走不同的迁移路径决策树详见 makers-migration/SKILL.md你的老项目对应迁移路径详细参考文档Next.js API 路由 / Express 服务无 Agent 框架标准 API 路由 → Makers 处理器api-route-to-makers.mdLangGraph / DeepAgentsNode 或 Python换网关 持久化 checkpointerlanggraph-to-makers.mdOpenAI Agents SDK换网关 平台工具openai-agents-to-makers.mdClaude Agent SDK网关映射 MCP 工具转换claude-agent-sdk-to-makers.mdCrewAI仅 Python关内存 线程包装 SSE 桥接crewai-to-makers.md二、通用改造清单所有框架都适用无论用哪个框架以下 8 项改造缺一不可建议直接当 checklist 逐项打勾 ✅创建edgeone.json写对agents.framework和buildCommand/outputDirectory后端代码从 API 路由文件搬进agents/目录agents/名字/index.ts或.pyprocess.env/os.environ全部替换为context.envNode/ctx.envPythonawait req.json()换成context.request.body平台已自动解析模型调用改走AI_GATEWAY_*环境变量API Key、Base URL、模型名不再直连各家模型 APIAI 接口改为 SSE 流式输出替代一次性返回 JSON前端请求带上makers-conversation-id头实现会话持久化对话历史改用context.store工具改用context.tools不再自造内存态 / 自定义数据库 迁移时技能包会自动校验代码一旦检测到残留的process.env、os.environ就会提醒替换可以放心交给 AI 助手执行。三、核心改造从 API 路由到 agents/ 目录这是最常见的一种迁移把你的/chat、/summarize等接口函数改成 Makers 处理器。规则其实很直白——目录即路由改造点老写法EdgeOne Makers 新写法文件位置app/api/chat/route.ts、server/routes/chat.tsagents/chat/index.ts入口签名export async function POST(req)export async function onRequest(context)解析请求体await req.json()context.request.body已解析读取请求头req.headers.get(x-foo)context.request.headers[x-foo]环境变量process.env.OPENAI_API_KEYcontext.env.AI_GATEWAY_*返回响应res.json()SSE 流createSSEResponsePython 项目Flask / FastAPI同理路由函数改为async def handler(ctx)用ctx.request.body、ctx.env取值即可详细前后对照见 api-route-to-makers.md。⚠️ 特别提醒平台没有托管数据库无 SQL、无 MongoDB。留言板、投票、上传文件这类动态数据请用 makers-storage 中的 KV Blob 方案——把数据表建模成 Blob 的 key 前缀即可。四、分框架改造速查表框架关键改造项 LangGraph / DeepAgentsMemorySaver→context.store.langgraphCheckpointer持久化thread_id直接用context.conversation_id自定义工具 →context.tools.toLangChainTools(tool) OpenAI Agents SDK客户端用context.env里的AI_GATEWAY_*初始化工具用context.tools.all()已是 OpenAI function 格式会话用context.store.openaiSession(convId) Claude Agent SDKAI_GATEWAY_*映射为ANTHROPIC_*再注入MCP 工具用context.tools.toClaudeMcpServer()会话用context.store.claudeSessionStore()配置目录指向/tmp CrewAILLM(provideropenai, base_urlctx.env[AI_GATEWAY_BASE_URL])绕开 LiteLLMmemoryFalse用ctx.store代替、verboseFalsecrew.kickoff()用asyncio.to_thread包装避免阻塞SSE 用ctx.utils.stream_sse(gen())每个框架的完整改造前 / 改造后代码对照都在 makers-migration 参考目录 里AI 助手会按需加载无需手动阅读。五、前端别忘了加一个会话 ID 头老项目前端迁移只有一处必改所有 AI 接口的 fetch 请求加上makers-conversation-id请求头可用crypto.randomUUID()生成并存在 localStorage。这样平台才能通过context.conversation_id自动关联上下文、持久化对话历史/stop取消接口也要在 body 里带上conversation_id。六、本地验证与一键部署上线改造完成后用 CLI 完成本地预览 → 部署闭环命令速查见 makers-cli/SKILL.mdnpm install -g edgeonelatest # 要求版本 ≥ 1.6.0 edgeone makers dev # 本地预览agent 运行时 前端 edgeone makers deploy -n 我的项目 # 构建并部署首次会自动生成 edgeone.json部署前跑一遍官方验证清单edgeone makers dev无错误启动/chat返回的是 SSE 流而不是 JSON全项目搜索process.env/os.environ确认零残留对话历史跨请求可持久化context.store生效前端确实发出了makers-conversation-id头 部署成功后 CLI 会输出带参数的访问地址.edgeone.cool域名完整 URL 包含鉴权参数请勿截断。部署流程、免登录发布匿名部署 60 分钟认领等细节详见 makers-deploy/SKILL.md。七、常见坑位 FAQQ本地预览正常为什么部署后是坏的如果你用的是 Astro、SvelteKit、React Router 等框架必须加装平台适配器如edgeone/astro否则预览完美、部署必坏。适配器与构建输出对照见 makers-frameworks/SKILL.md。Q老项目用 Next.js / Nuxt需要额外配置吗这两个框架由构建器直接支持、无需适配器但redirects/rewrites不生效需改写在edgeone.json中声明。Q不想登录账号能先发布看看吗可以。CLI ≥ 1.6.29 支持免登录发布edgeone makers deploy --anonymous60 分钟内登录认领即可绑定到你的账号。注意依赖环境变量、AI 网关或存储绑定的项目免登录发布后相关功能会失效建议登录后部署。Q项目里还有老平台的插件如别的云厂商的 Astro / SvelteKit 适配器必须移除并换成 EdgeOne 官方适配器否则构建产物平台无法托管且不会报错、只能靠线上发现问题。八、参考资料汇总资料说明makers-migration/SKILL.md迁移决策树 通用改造清单本文核心依据makers-deploy/SKILL.md登录、部署、免登录发布完整流程makers-cli/SKILL.mdCLI 命令与环境变量速查makers-frameworks/SKILL.md9 大前端框架适配器对照表makers-storage/SKILL.mdKV Blob 存储方案无数据库场景makers-env-adaption/SKILL.md沙箱 / CI 环境适配照着决策树定位路径、按清单逐项改造、用 CLI 验证并部署——老项目上 EdgeOne 就这三步剩下的交给你的 AI 编程助手吧 赞分享【免费下载链接】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项目模板清单全栈应用、静态站与AI Agent脚手架速览edgeone makers tools项目模板清单全栈应用、静态站与AI Agent脚手架速览 edgeone makers tools 是腾讯 EdgeO创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考