surrealdartb
为Dart/Flutter应用提供嵌入式SurrealDB数据库,支持向量搜索与图查询。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:surrealdartb。 它的用途是:为Dart/Flutter应用提供嵌入式SurrealDB数据库,支持向量搜索与图查询。 完整的 Skill 内容见:https://321skill.com/skills/surrealdartb/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我正在开发一个Flutter离线图片搜索应用,需要将图片特征向量存储在本地并进行相似度匹配,帮我用SurrealDartB设计数据库层。” 它会引导你定义向量字段、创建索引,并编写执行相似性搜索的SurrealQL查询代码。
介绍
SurrealDartB是一个Dart FFI绑定库,允许开发者将功能强大的SurrealDB数据库直接嵌入到Dart或Flutter应用中。它解决了移动端或桌面端应用需要复杂本地数据存储、特别是涉及AI向量搜索和图关系查询的难题。
通过简单的依赖添加和自动化的原生资产构建,开发者无需手动编译Rust代码即可在应用中启动一个完整的SurrealDB实例。它提供了类型安全的异步API,支持从内存存储到持久化RocksDB等多种后端,并允许执行完整的SurrealQL查询。
这个库非常适合需要处理高维向量数据(如AI嵌入)、复杂关系图数据,或希望在同一应用中混合使用SQL与NoSQL特性的全栈开发者、移动应用开发者和智能体开发者。
需要注意的是,虽然该库通过FFI提供了安全的Rust-Dart交互,但引入它意味着项目需要Rust工具链(由构建工具自动管理)。对于仅需简单键值存储或关系型查询的应用,使用更轻量的Hive或SQLite可能是更合适的选择。
核心特点
与Dart生态中其他本地数据库(如Hive、SQLite)相比,其核心区别在于原生支持向量索引和相似性搜索,以及强大的图查询能力,填补了Dart/Flutter应用在本地运行复杂AI/ML工作流的空白。
注意事项
对于仅需简单数据持久化或标准关系型查询的应用场景,引入该库可能过于复杂和重型。
常见问题
需要手动安装Rust吗?
不需要,Rust工具链的安装和编译由`native_toolchain_rs`在`dart pub get`时自动管理。
可以在Flutter Web上使用吗?
不可以,由于依赖原生FFI,目前支持macOS、iOS、Android、Windows、Linux,但不支持Web平台。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/surrealdartb/raw/index.md 读取 surrealdartb 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/surrealdartb/raw/index.md(查看排版版本)