1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | upstash-search-js-upstash-skills |
| 作者/维护者 | Upstash(Upstash 官方) |
| 来源链接 | https://github.com/upstash/skills/tree/main/skills/upstash-search-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-search-js |
| 独立数据 | skills.sh 安装量约 1,166;配套 npm 包 @upstash/search 近 30 天下载约 7.2 万(npm API,至 2026-10-16);SDK 仓库 upstash/search-js 22 stars |
2. 功能介绍与亮点
教 AI 编程助手正确使用 @upstash/search(Upstash 托管的全文 + 语义混合搜索服务)TypeScript SDK。SKILL.md 约 2KB,另附 quick-start.md 与 sdk-overview.md 两份文档。
- 完整流程:创建索引、
upsert文档、search查询、fetch/delete/range分页 /reset/info。 - 讲清核心概念:
content可检索、可过滤;metadata不可检索,但可取回、可用@metadata.key过滤。 - 支持关键词、语义、混合三种检索,可选重排序(reranking),过滤支持 SQL 风格字符串与结构化对象两种写法。
- 同时给出 TypeScript 与 Python 示例,并列出常见易错点。
- 无需自建集群,面向 Vercel、Next.js 等无服务器场景。
3. 适用场景
所属分类:工程效率与代码质量。
- 为站点、产品库、文档或知识库加搜索功能的前端 / 全栈开发者。
- 想用托管搜索服务、不想维护 Elasticsearch 集群的小团队。
- 受益人群:用 Claude Code、Codex 等助手写 TypeScript 的初中级开发者,可避免助手凭记忆写错 SDK 调用。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 标准 SKILL.md,skills.sh 列有该 Agent |
| Codex | 需适配 | 采用同一 SKILL.md 格式,但 Codex 不自动发现 ~/.codex/skills,需手动引用 |
| OpenClaw | 原生支持 | skills.sh 列有该 Agent |
| Hermes Agent | 未验证 | 格式为通用 SKILL.md,未实测 |
5. 推荐理由
SDK 厂商亲自维护,内容紧贴当前 API(含重排序、混合检索权重等新参数);体量小、上下文占用低,需要时再按引用文档深入。对“几行代码给应用加语义搜索”这类需求,能直接减少助手幻觉出不存在的方法。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Upstash 官方出品;skills.sh 安装量约 1,166,npm 包月下载约 7.2 万 |
| 可用性 | 8 | 一条命令安装;文档含示例;需先在 Upstash 控制台创建数据库并取得 URL 与 Token;近 3 个月内有维护 |
| 安全性 | 9 | 纯文档型技能,无脚本、无命令执行;仅示例使用环境变量中的 Token;第三方审计平台 Gen Agent Trust Hub、Socket、Snyk 均为通过 |
| 综合 | 8.0 | 三项均值 |
安全检查清单:
- ① 命令权限:不含脚本,仅有
npm install @upstash/search示例。无扣分。 - ② 联网:示例代码调用 Upstash 托管服务,目标明确。无扣分。
- ③ 凭据:通过环境变量
UPSTASH_SEARCH_REST_URL、UPSTASH_SEARCH_REST_TOKEN传入,未要求写入文件。无扣分。 - ④ 可疑指令:通读 SKILL.md 与两份附属文档,未发现。无扣分。
- ⑤ 作者信誉:Upstash 是知名无服务器数据平台厂商。无扣分。
- ⑥ License:MIT。无扣分。
- ⑦ 维护:子目录最近提交 2026-08-31,SDK 仓库 2026-09-25 仍有更新。轻微扣分,因技能文档较短,更新频率偏低。
7. 跟同类 Skills 相比的优势
| 同类 | 定位 | 差异 |
|---|---|---|
| Pinecone 官方 skills | 向量数据库,以向量检索为核心 | 偏纯向量,全文与混合检索需自行组合 |
| Weaviate 官方 skills | 开源向量数据库,需自托管或用其云服务 | 能力更全、配置更多 |
| Elasticsearch 官方 skills | 自建或云上集群的全文搜索 | 功能强大,但运维与上手门槛高 |
| Redis Search 官方 skills | 基于 Redis 的全文索引扩展 | 面向已有 Redis 的场景 |
核心差异:本技能对应的是“托管、无集群、关键词 + 语义混合 + 重排序开箱即用”的轻量方案,接入代码最短,适合不想运维搜索基础设施的初中级用户。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。关于 Upstash 其他产品,有第三方评测称其接入面小,但分块、嵌入模型选择与权限控制仍需应用自行负责(aicoolies.com 对 Upstash Vector 的评测,2026-07,与本技能对象不同,仅供参考)。
10. 安装使用方式
npx skills add https://github.com/upstash/skills --skill upstash-search-js
- 先在 Upstash 控制台创建 Search 数据库,把 URL 与 Token 写入环境变量。
- 安装后新开会话,让助手“用 Upstash Search 给我的站点加搜索”即可触发。
11. 注意事项
- 需 Upstash 账号;免费额度之外的使用按其计费规则。
- 技能正文很短,复杂过滤与分页细节依赖附属文档。
- 同仓库还有 Redis、Vector、QStash 等其他 Upstash SDK 技能,按需另装。