关于 upstash-search-js
upstash-search-js 为使用 Upstash Search TypeScript SDK 的开发者提供文档指导,涵盖索引、文档更新、搜索和过滤,并提供 SDK 命令及端到端设置流程参考。
主要功能
- 01TypeScript SDK 设置指引
- 02文档写入与删除
- 03搜索和范围查询
- 04元数据与内容处理
- 05类 SQL 和结构化过滤器
适用场景
- 01建立文档搜索索引
- 02搜索文档并选择性重排结果
- 03按元数据过滤结果
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ upstash/ skills --skill upstash-search-js安装后在 Claude Code 中输入/upstash-search-js确认已加载。
附带文件quick-start.mdsdk-overview.md
详细介绍
Upstash Search 文档
内置文档和源代码
在编写或调试 SDK 代码之前,请检查 node_modules/@upstash/search/docs/ 中的内置文档,以及 node_modules/@upstash/search/src/ 中易于阅读的 TypeScript 源代码。如果相关文件存在,请阅读并搜索这些文件;否则,请使用本技能中的参考资料。
快速入门
安装 TS SDK:
npm install @upstash/search
创建客户端并执行简单的 upsert + search:
import { Search } from "@upstash/search";
const client = new Search({ url: process.env.UPSTASH_SEARCH_REST_URL, token: process.env.UPSTASH_SEARCH_REST_TOKEN });
const index = client.index("my-index");
await index.upsert({ id: "1", content: { text: "hello world" } });
const results = await index.search({ query: "hello" });
基本步骤:
- 创建索引
- 插入或更新文档
- 执行搜索或筛选查询
其他技能文件
sdk-overview
提供所有 TypeScript SDK 命令的详细文档。包括:
- delete:删除文档
- fetch:获取文档
- info:索引信息
- range:范围查询
- reset:清空索引
- search:搜索查询
- upsert:添加或更新文档
- getting-started:SDK 设置步骤
quick-start
提供端到端快速工作流,用于创建 Search 数据库、添加文档并查询。涵盖以下基本概念:
- 创建数据库并保存凭据
- 添加包含内容和元数据的文档
- 了解内容与元数据(可搜索性和可筛选性)
- 执行搜索,并可选择重新排序
- 使用类似 SQL 或结构化筛选器的筛选语法
- 常见陷阱和最佳实践
评论
支持 Markdown