关于 turso-cloud
面向使用 Turso Cloud 的开发者,涵盖多种语言的 SDK、身份验证和 Vercel 数据库管理,并介绍数据库内置功能。
主要功能
- 01JavaScript、Python、Go 和 Rust SDK 指南
- 02远程与本地优先数据库访问
- 03凭据范围和表级权限
- 04Vercel Marketplace 数据库管理
- 05向量搜索、全文搜索和分支
适用场景
- 01将应用连接到 Turso Cloud 数据库
- 02选择本地优先或仅远程访问
- 03限制数据库凭据和权限
- 04为 Vercel 项目配置 Turso 数据库
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ tursodatabase/ agent-skills --skill turso-cloud安装后在 Claude Code 中输入/turso-cloud确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
turso-cloud-auth/overview.mdturso-cloud-go/overview.mdturso-cloud-js/overview.mdturso-cloud-py/overview.mdturso-cloud-rust/overview.mdturso-cloud-vercel/overview.md详细介绍
Turso Cloud 技能
本技能整合了使用 Turso Cloud(完全托管、兼容 SQLite 的数据库平台)的文档。请从下方选择相关子技能。
turso-cloud-js
使用 @tursodatabase/serverless TypeScript/JavaScript SDK 操作远程 Turso Cloud 数据库,包括查询、位置参数/命名参数、批处理和交互式事务;也涵盖本地优先同步系列(@tursodatabase/sync、-wasm、-react-native)。适用于从 Node.js、无服务器/边缘函数、浏览器或 React Native 连接到 Turso Cloud。
turso-cloud-py
从 Python 使用 Turso Cloud:使用 pyturso 操作与云端同步的本地优先数据库,使用 libsql 通过 libsql 协议进行纯远程访问。适用于将 Python 应用连接到 Turso Cloud。
turso-cloud-go
从 Go 使用 Turso Cloud:使用 tursogo 操作与云端同步的本地优先数据库,使用 libsql-client-go 通过 libsql 协议进行纯远程访问。适用于将 Go 应用连接到 Turso Cloud。
turso-cloud-rust
从 Rust 使用 Turso Cloud:使用 turso crate(sync 功能)操作与云端同步的本地优先数据库,使用 libsql crate 通过 libsql 协议进行纯远程访问。适用于将 Rust 应用连接到 Turso Cloud。
turso-cloud-auth
验证并授权对 Turso Cloud 数据库的访问:数据库 URL、通过 Turso CLI 获取的平台令牌、作用范围(组/数据库/只读/限时)、细粒度的逐表权限、通过 JWKS 使用外部身份验证提供商(Clerk、Auth0),以及令牌失效处理。适用于签发凭据、限制客户端可执行的操作,或将现有身份验证提供商接入 Turso。
turso-cloud-vercel
使用和管理通过 Vercel Marketplace 配置的 Turso Cloud 数据库(集成标识 tursocloud):注入的环境变量、使用 Vercel CLI 检查和配置资源、区域选择,以及凭据和破坏性操作的安全规则。适用于已有或需要 Turso 数据库的 Vercel 项目。
Turso Cloud 功能
Turso Cloud 数据库开箱即支持以下功能:
- 向量搜索 — 为 AI/RAG 工作流提供原生相似性搜索,无需扩展。支持余弦、L2 和 L1 距离函数,以及 DiskANN 索引。
- 全文搜索 — 通过内置 FTS 支持进行关键词搜索,并使用 BM25 排名。
- AI 和嵌入 — 原生向量类型,用于存储和查询嵌入。
- 分支 — 创建隔离的写时复制数据库分支,用于测试/预发布。
- 时间点恢复 — 将数据库还原到任意先前的时间点(保留期限取决于套餐)。
- 嵌入式副本 — 与 Turso Cloud 同步的本地副本,支持快速读取和离线使用。
- SQLite 扩展 — JSON、FTS5、R*Tree、SQLean、UUID、regexp。
延伸阅读
Turso 在线文档 — https://docs.turso.tech(Mintlify — 在任意 URL 路径后追加 .md 即可获取原始 Markdown,例如 https://docs.turso.tech/sdk/ts/quickstart.md)。每个子技能都附有自己的文档链接;通用参考资料:
| 主题 | URL |
|---|---|
| AI 和嵌入 | https://docs.turso.tech/features/ai-and-embeddings.md |
| 嵌入式副本 | https://docs.turso.tech/features/embedded-replicas/introduction.md |
| 云端限制 | https://docs.turso.tech/cloud/limitations.md |
| SQLite 扩展 | https://docs.turso.tech/features/sqlite-extensions.md |
| 完整文档索引(适用于大模型) | https://docs.turso.tech/llms.txt |