SuperAPI AI 工具集

edgeone-makers-storage

智能体与模型

查看项目

更新于 10-15 22:11

技能介绍

EdgeOne Makers 提供两种存储服务,需按运行时与数据类型选择。KV 仅用于 Edge Functions,存放不超过 25 MB 的小型键值对,通过全局变量使用,无需 npm,适合计数器、配置、会话令牌和简单 CRUD。Blob 用于 Cloud Functions(Makers Functions),存放文件与对象(图片、文档、上传内容),使用 npm 包 @edgeone/pages-blob,适合用户上传、AI 生成内容和文件管理。

该平台没有托管数据库,不支持 SQL、MongoDB、Prisma 或 ORM,也不应使用 sqlite、pg、mysql、mongodb 或内存数组(冷启动或重新部署会重置)。Blob 即数据库:需要持久化的动态数据(留言、上传画作、投票、排行榜、用户存档、表单提交)都以 Blob 键建模,把“表”建模为键前缀,如 messages/<id>.json、users/<uid>.json。

本地开发并非总需登录:纯静态预览可直接运行 edgeone makers dev。仅当需要读写 Blob 等需凭据的后端时,才需先 edgeone login(浏览器)或传 -t <token>,再链接项目。项目使用 Blob/KV 时,务必给 edgeone makers dev 传 -n <project-name>,否则会进入交互式选择器并在非交互环境挂起;带 -n 时若项目名不存在会自动创建。每个 Blob 存储都应使用 getStore({ name, consistency: "strong" }),不要用字符串形式 getStore("name"),后者默认最终一致性,会导致写入后读到旧值或空值。

选择路径:需要持久化时,Edge Function(V8 运行时、无 npm)用 KV;Cloud Function(Node.js、有 npm,真实后端默认选择)中,文件或大对象用 Blob,结构化数据用 Blob 的 setJSON 与键前缀。详细规则见 references/kv.md 与 references/blob.md。