SuperAPI AI 工具集

edgeone-pages-dev

编程与开发

查看项目

更新于 10-16 05:07

技能介绍

用途:指导在 EdgeOne Pages 上开发全栈应用,包括创建 API、无服务器函数和后端逻辑,添加请求拦截、重定向、鉴权守卫、A/B 测试等中间件,以及构建“静态前端 + 服务端函数”的应用。

主要能力:按决策树选择运行时——请求拦截/重定向/重写/鉴权/AB 测试用 Middleware;轻量低延迟 API 用 Edge Functions;KV 持久化用 Edge Functions + KV Storage;需要 npm 包/数据库/WebSocket 的复杂后端用 Cloud Functions(Node.js,支持 Express、Koa);高性能 Go API 用 Gin、Echo、Chi、Fiber;Python API 用 Flask、FastAPI、Django、Sanic。

使用方式:初始化 edgeone pages init;本地开发 edgeone pages dev(统一走 http://localhost:8088/);关联项目 edgeone pages link;环境变量 edgeone pages env pull。函数通过 context.env.KEY(Node.js)、os.Getenv("KEY")(Go)、os.environ.get("KEY")(Python)读取环境变量。Cloud Functions 文件放 cloud-functions/ 目录,按扩展名识别语言。

关键限制:Edge Functions 运行于 V8,不可用 Node 内置模块或 npm 包;Cloud Functions 请求体上限 6MB、执行 120 秒,Edge 为 1MB、200ms CPU。Middleware 仅做轻量拦截。Node.js 函数默认返回 Web Response(Express/Koa 用 [[default]].js)。KV 需先在控制台启用。必须用 edgeone pages dev 而非自建函数 dev server,也不要把该命令配置为 devCommand 或 package.json dev 脚本。框架项目(Next.js、Nuxt)应使用框架自身中间件。部署请用 edgeone-pages-deploy 技能。

适用场景:EdgeOne Pages 函数调试、KV 问题排查、WebSocket 端点搭建、多语言框架集成等。更多细节见 references/ 下对应文件。