摘要：

OceanBase seekdb JavaScript/TypeScript SDK（seekdb-js）正式开源，支持自动向量化、语义搜索与混合搜索，兼容本地及云端多种 Embedding 服务，提供完整 TypeScript 类型定义，可与 seekdb 和 OceanBase 无缝协作，助力 AI 应用开发者高效实现向量检索与混合查询场景。

 

背景

 

最近尝试用 Cursor 和 Claude Code 配合 seekdb 插件进行了一些 vibe coding。 生成的代码都可以通过 pyseekdb（seekdb 的 Python SDK）连接 seekdb 服务端直接运行，完全不需要调试，效果令人惊喜。

 

vibe coding 中最常用的编程语言，除了 Python，还有 JavaScript / TypeScript。 所以 seekdb 在支持 Python SDK 后，前几天又光速开源了 js 和 ts 的 SDK —— seekdb-js，内置语义搜索功能，可与 seekdb 和 OceanBase 无缝协作。今天就在这篇文章中为大家介绍一下。

 

 

为什么选择 seekdb-js？

 

自动向量化：自动化 embedding 生成，无需手动计算向量

语义搜索：支持为自然语言查询提供向量相似性搜索

混合搜索：同时支持关键词匹配和语义搜索

多种 embedding 服务：同时支持本地和云端的 embedding 服务

原生 TypeScript支持：提供完整的 TypeScript 支持和类型定义

 

Packages

 

seekdb-js 仓库包含以下内容：

 

安装

 

使用SDK之前，需要先部署seekdb。请参考官方部署文档[1]。

 

快速上手

使用指南

 

客户端连接

 

创建 collection

 

添加数据

 

支持自动向量化，无需手动计算向量。

 

查询数据

 

语义搜索

 

混合搜索（关键词 + 语义）

 

Embedding 方式

 

seekdb-js 这个 SDK 支持多种 Embedding 方式，可以选择在本地或云端生成向量。

 

默认的 Embedding 方式

 

默认使用本地模型（Xenova/all-MiniLM-L6-v2），无需 API Key，适合快速开发和测试。

使用默认模型无需任何配置：

 

手动导入内置模型：

 

Qwen Embedding

 

实验性 API：QwenEmbeddingFunction目前为实验性功能，未来版本可能会有所更改。

可以使用 DashScope 的云端 Embedding 服务（Qwen / 通义千问），适用于生产环境。

OpenAI Embedding

 

实验性 API：OpenAIEmbeddingFunction目前为实验性功能，未来版本可能会有所更改。

可以使用 OpenAI 的 Embedding API，适用于与 OpenAI 集成的生产环境。

 

Jina Embedding

 

开发中：JinaEmbeddingFunction正在光速开发中，API 在未来的版本中可能会发生更新。

使用 Jina AI 的 Embedding API，支持多模态嵌入。

自定义 Embedding 方法

 

实验性 API：这些registerEmbeddingFunctionAPIgetEmbeddingFunction目前处于实验阶段，未来版本可能会有所更改。

 

除了上面这些 Embedding 方法以外，也支持使用自定义的 Embedding 函数。

首先，需要实现一个 EmbeddingFunction 接口：

然后注册即可使用：

 

数据库管理

 

支持通过 SeekdbAdminClient 来管理数据库（创建、查询、删除）。

 

使用示例

 

直接去 github 中的 example 目录[2]获取完整的使用示例吧！

基本用法 —— simple-example.ts[3]

所有功能 —— complete-example.ts[4]

混合搜索 —— hybrid-search-example.ts[5]

如果要运行示例，可以参考 Run Examples[6] 部分。

 

参考资料

[1] 

官方部署文档: https://www.oceanbase.ai/docs/deploy-overview/

[2] 

github 中的 example 目录: https://github.com/oceanbase/seekdb-js/tree/main/examples

[3] 

simple-example.ts: https://github.com/oceanbase/seekdb-js/blob/main/examples/simple-example.ts

[4] 

complete-example.ts: https://github.com/oceanbase/seekdb-js/blob/main/examples/complete-example.ts

[5] 

hybrid-search-example.ts: https://github.com/oceanbase/seekdb-js/blob/main/examples/hybrid-search-example.ts

[6] 

Run Examples: https://github.com/oceanbase/seekdb-js/blob/main/DEVELOP.md#run-examples

 

欢迎访问 OceanBase 官网获取更多信息：https://www.oceanbase.com/