1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | upstash-vector-js-upstash-skills |
| 作者/维护者 | Upstash(Upstash 官方) |
| 来源链接 | https://github.com/upstash/skills/tree/main/skills/upstash-vector-js |
| 许可证 | MIT(GitHub API) |
| GitHub Stars / Forks | 31 / 7(所属合集仓库整体,非本技能独立热度;GitHub API) |
| 最新版本 | 无版本号;子目录最近提交 2026-08-31(GitHub API) |
| 安装方式 | npx skills add https://github.com/upstash/skills --skill upstash-vector-js |
| 独立数据 | skills.sh 安装量约 1.2K;其配套 npm 包 @upstash/vector 周下载约 12.8 万(npm API,2026-10-06 至 10-12) |
2. 功能介绍与亮点
教 AI 编程助手正确使用 @upstash/vector(Upstash 托管的无服务器向量数据库)TypeScript SDK。
- SDK 方法速查:upsert、query、fetch、delete、range、resumableQuery、info、reset,每个方法带“常见坑”(维度必须匹配、
vector与data不能同传、reset({all:true})须显式)。 - 索引结构:稠密、稀疏、混合索引;RRF / DBSF 融合;自定义重排写法。
- 元数据过滤:类 SQL 语法,支持嵌套、数组下标、GLOB。
- 命名空间隔离。
- 提示助手先用
index.info()判断索引是否带内置嵌入模型,再决定能否直接传文本data。
3. 适用场景
分类:工程效率与代码质量(SDK 编码指南)。
适合用 TypeScript/JavaScript 在 Next.js、Vercel、Cloudflare Workers 等无服务器环境里做语义搜索、RAG、相似推荐的开发者。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 标准 SKILL.md,npx skills add 可装 |
| Codex | 需适配 | 需手动引用技能目录 |
| OpenClaw | 未验证 | — |
| Hermes Agent | 未验证 | 标准 SKILL.md 格式,未实测 |
5. 推荐理由
官方出品,内容紧贴 SDK 实际行为,把“维度对不上、混合索引缺一半向量、过滤会返回少于 topK”这类易错点提前写明,能减少助手生成出看似正确却跑不通的代码。篇幅短、无外联与脚本,几乎没有引入风险。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 官方出品;skills.sh 安装量约 1.2K,配套 npm 包周下载十余万 |
| 可用性 | 8 | 一条命令安装,文档含示例与易错点;需自备 Upstash 账号与索引凭据,文档偏精简 |
| 安全性 | 9 | 纯文档型技能 |
综合 8.0。
安全检查清单:①无 shell 执行 ②无运行时外发(示例代码连接用户自己的 Upstash 索引)③需 REST URL 与 token,示例用环境变量读取 ④SKILL.md 与引用文档无可疑指令 ⑤作者为 Upstash 官方 ⑥MIT ⑦2026-08 仍有提交。skills.sh 三项审计(Gen Agent Trust Hub、Socket、Snyk)均为 PASS。
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 差异 |
|---|---|---|
| Qdrant 官方 qdrant-clients-sdk | Qdrant 多语言客户端指南 | 面向 Qdrant,需自建或使用 Qdrant Cloud |
| Pinecone pinecone-quickstart | Pinecone 上手流程 | 侧重创建索引与入门,非 SDK 方法逐项指南 |
| Chroma chroma-local / chroma-cloud | Chroma 本地与云端用法 | 偏本地嵌入式与 Python 生态 |
| Weaviate weaviate | Weaviate 官方技能 | 面向 Weaviate 及其模块体系 |
本技能的差异:对应无连接 HTTP 的无服务器向量库,不需要常驻连接,适合边缘与无服务器函数;稀疏/混合索引与内置嵌入模型都有专门说明。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。关于其配套产品,Upstash 官方博客与 Vercel 提供了 Next.js + Upstash Vector 的 RAG 教程和启动模板(官方来源,非独立评价)。
9. 其他补充
同仓库另有 Redis、QStash、Workflow 等产品的 SDK 技能,各自独立安装。
10. 安装使用方式
npx skills add https://github.com/upstash/skills --skill upstash-vector-js
在 Upstash 控制台创建 Vector 索引,设置 UPSTASH_VECTOR_REST_URL 与 UPSTASH_VECTOR_REST_TOKEN,npm install @upstash/vector。安装后重启会话;提到向量检索、upsert、query 等需求时会被触发。
11. 注意事项
- 索引未配置内置嵌入模型时不能直接用文本
data。 - 带
filter的删除会触发全量扫描。 - 高选择性过滤可能返回少于 topK 的结果。
- REST token 属敏感凭据,勿放进前端公开变量。