Agent Skills
› fanfan-de/anybox
› netlify-blobs
netlify-blobs
GitHub指导使用 Netlify Blobs 进行对象存储。涵盖安装、获取存储实例（含强一致性）、CRUD 操作（支持字符串/二进制/JSON及元数据）、列表查询、部署范围区分、限制说明及本地开发配置，适用于无需数据库的文件或键值存储场景。
Trigger Scenarios
需要存储文件、图片或文档到 Netlify
实现简单的键值对数据存储
在 Netlify 函数或边缘函数中读写对象
Install
npx skills add fanfan-de/anybox --skill netlify-blobs -g -y
SKILL.md
Frontmatter
{
"name": "netlify-blobs",
"description": "Guide for using Netlify Blobs object storage. Use when storing files, images, documents, or simple key-value data without a full database. Covers getStore(), CRUD operations, metadata, listing, deploy-scoped vs site-scoped stores, and local development."
}
Netlify Blobs
Netlify Blobs is zero-config object storage available from any Netlify compute (functions, edge functions, framework server routes). No provisioning required.
npm install @netlify/blobs
Getting a Store
import { getStore } from "@netlify/blobs";
const store = getStore({ name: "my-store" });
// Use "strong" consistency when you need immediate reads after writes
const store = getStore({ name: "my-store", consistency: "strong" });
CRUD Operations
These are the only store methods. Do not invent others.
Create / Update
// String or binary data
await store.set("key", "value");
await store.set("key", fileBuffer);
// With metadata
await store.set("key", data, {
metadata: { contentType: "image/png", uploadedAt: new Date().toISOString() },
});
// JSON data
await store.setJSON("key", { name: "Example", count: 42 });
Read
// Text (default)
const text = await store.get("key"); // string | null
// Typed retrieval
const json = await store.get("key", { type: "json" }); // object | null
const stream = await store.get("key", { type: "stream" });
const blob = await store.get("key", { type: "blob" });
const buffer = await store.get("key", { type: "arrayBuffer" });
// With metadata
const result = await store.getWithMetadata("key");
// { data: any, etag: string, metadata: object } | null
// Metadata only (no data download)
const meta = await store.getMetadata("key");
// { etag: string, metadata: object } | null
Delete
await store.delete("key");
List
const { blobs } = await store.list();
// blobs: [{ etag: string, key: string }, ...]
// Filter by prefix
const { blobs } = await store.list({ prefix: "uploads/" });
Store Types
- Site-scoped (
getStore()): Persist across all deploys. Use for most cases. - Deploy-scoped (
getDeployStore()): Tied to a specific deploy lifecycle.
Limits
| Limit | Value |
|---|---|
| Max object size | 5 GB |
| Store name max length | 64 bytes |
| Key max length | 600 bytes |
Local Development
Local dev uses a sandboxed store (separate from production). For Vite-based projects, install @netlify/vite-plugin to enable local Blobs access. Otherwise, use netlify dev.
Common error: "The environment has not been configured to use Netlify Blobs" — install @netlify/vite-plugin or run via netlify dev.
Version History
- 08dc189 Current 2026-07-05 19:03
