1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | upstash-blob-js-upstash-skills |
| 作者/维护者 | Upstash(Upstash 官方) |
| 来源链接 | https://github.com/upstash/skills/tree/main/skills/upstash-blob-js |
| 许可证 | MIT(GitHub API) |
| GitHub Stars / Forks | 31 / 7(所属合集仓库整体,非本技能独立热度;GitHub API) |
| 最新版本 | 无版本号;子目录最近提交 2026-09-15(GitHub API) |
| 安装方式 | npx skills add https://github.com/upstash/skills --skill upstash-blob-js |
| 独立数据 | skills.sh 安装量约 435;配套 npm 包 @upstash/blob 近 30 天下载约 1.1 万(npm API,至 2026-10-12) |
2. 功能介绍与亮点
教 AI 编程助手正确使用 @upstash/blob(Upstash 的 S3 兼容对象存储)TypeScript SDK,SKILL.md 约 11KB,自成一体。
- 服务端
Bucket:put / get / info / list / copy / move / del,含选项表(contentType 白名单、maxSize、etag 条件写入、multipart 阈值)。 - 浏览器直传:
uploadHandler+ ReactuseUpload钩子,文件不经应用服务器,规避平台请求体大小限制;大文件分片、暂停/恢复。 - 公开桶与私有桶:
signedReadUrl生成限时链接,uniquePath防路径碰撞与目录穿越。 - 缓存策略(immutable / revalidate / no-store)与
BlobError错误码清单。 - 提醒易错点:
onUploadComplete可能重复执行、抛错会删除对象、BlobError.is()优于instanceof、尺寸单位为十进制。 - 通过
bucket.s3()取得 AWS SDK 配置,覆盖字节范围、条件 GET 等 SDK 未封装的能力。
3. 适用场景
分类:工程效率与代码质量(SDK 编码指南)。
适合在 Next.js、Vercel、Cloudflare Workers 等无服务器环境里做头像、附件、图片、文档上传与私有文件分发的 TypeScript/JavaScript 开发者。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 标准 SKILL.md,官方提供 /plugin marketplace add upstash/skills 与 npx skills add |
| Codex | 原生支持(插件) | 官方 README 提供 codex plugin marketplace add upstash/skills;单独复制技能目录时需手动引用 |
| OpenClaw | 未验证 | 标准 SKILL.md 格式,未实测 |
| Hermes Agent | 未验证 | 标准 SKILL.md 格式,未实测 |
5. 推荐理由
官方出品,且是同类里少见的把“浏览器直传、私有桶签名读取、幂等回调”完整写成可抄代码的 SDK 指南,并点出几个会静默出错的坑(重复回调、抛错删对象、单位换算)。纯文档,无脚本与外联,引入风险极低。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Upstash 官方出品;skills.sh 安装量约 435,配套 npm 包月下载约 1.1 万 |
| 可用性 | 8 | 一条命令安装,文档自足含示例;需自备 Upstash 账号、桶与 token;2026-09 仍在更新 |
| 安全性 | 9 | 纯文档型技能,官方出品、MIT |
综合 8.0。
安全检查清单:①无 shell 执行 ②无运行时外发(示例代码连接用户自己的 Upstash 桶)③需 UPSTASH_BLOB_TOKEN,文档明确要求仅放服务端、禁止放入 NEXT_PUBLIC_ 变量 ④SKILL.md 无可疑指令 ⑤作者为 Upstash 官方 ⑥MIT ⑦2026-09-15 仍有提交。skills.sh 三项审计(Gen Agent Trust Hub、Socket、Snyk)均为 PASS。
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 差异 |
|---|---|---|
| azure-blob-storage(MicrosoftDocs) | Azure Blob 存储使用指南 | 面向 Azure 账号体系,无浏览器直传与 React 钩子封装 |
| Google Cloud Storage Basics | GCS 基础操作 | 偏云平台操作,非应用层 SDK 编码指南 |
| claude-skill-b2-cloud-storage | Backblaze B2 存储 | 面向 B2 的 S3 接口与管理,不含上传处理器 |
本技能的差异:对应无需选区域、单 token 接入的存储服务,重点覆盖应用层的直传授权与签名读取流程,并保留 S3 兼容出口。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。官方博客发布了 Upstash Blob 的介绍与对比文章(官方来源,非独立评价)。
9. 其他补充
同仓库另有 Redis、QStash、Vector、Workflow 等产品的 SDK 技能,各自独立安装。
10. 安装使用方式
npx skills add https://github.com/upstash/skills --skill upstash-blob-js
在 Upstash 控制台创建 Blob 桶,设置 UPSTASH_BLOB_TOKEN,npm install @upstash/blob。安装后重启会话;提到文件上传、签名链接、对象存储等需求时会被触发。
11. 注意事项
- token 是整个桶的凭据,只能放服务端。
- 桶公开或私有是控制台设置,私有桶没有公开 URL,需存
path并用signedReadUrl读取。 onUploadComplete可能被重试,写库应按uploadId做 upsert。- 对象存储不是可查询存储,需自建表做索引。
- 配套 SDK 版本较新(npm 0.0.x),接口可能变动。