@bastani/atomic-storage-libsql

中文文档
0.9.71发布于 2026/11/04MITTypeScriptES Module构建来源已验证近 30 天下载 1.2万

libSQL / Turso存储适配器用于原子会话,工作流程日记,和Intercom.

中文使用文档
文档目录4 节
  1. 安装
  2. 配置
  3. 从 SDK 使用
  4. 许可证

@bastani/原子储存-libsql

免费/ 涡轮 存储适配器 原子。它将会话,工作流程日记,以及Intercom多节点路由存储在一个共享的数据库中,因此多台机器可以使用相同的状态. 这是一个单独的软件包: 只在您想要远程存储的地方安装它 .

安装

atomic install npm:@bastani/atomic-storage-libsql

在用户范围内安装( 无) -l; 原子只搜索存储适配器的用户镜包.

配置

选择适配器 ~/.atomic/agent/settings.json数字 :

{
  "storage": {
    "adapter": "@bastani/atomic-storage-libsql",
    "options": { "url": "libsql://<db>.turso.io" },
    "secrets": { "authToken": { "file": "turso-token" } }
  }
}
turso db tokens create <db> > ~/.atomic/turso-token
chmod 600 ~/.atomic/turso-token
选项需求说明
url对A 类 libsql://, (中文(简体) ), https://, (中文(简体) ), wss://,或 file: URL (中文(简体) ).
authToken远程数据库数据库标志 。 通过它 secrets (单位:千美元){ "file": ... } 或者说 { "env": ... })所以它不设置.
namespace没有自动托管的 sqld 命名空间( E)sqld --enable-namespaces页:1 x-namespace 头曰. 需要a libsql:, (中文(简体) ), https:,或 http: URL (中文(简体) ).

A 类 file: 数据库以写-ahead-log模式打开,其中包含一个 5000 ms 繁忙的超时, 原子自身 SQLite 存储的方式, 因此多个进程可以同时读取和写入一个文件 : 声明最多等待 5 秒 以锁定另一个进程, 而不是失败 SQLITE_BUSY,等待会阻挡呼叫线。 第一次打开时将文件更改为 WAL 模式, 它保存在文件中并添加 -wal 财务报告和审定财务报表 -shm 旁边的文件。 一次只通过这个适配器打开一个文件:另一个以WAL模式打开相同文件的SQLite库被看到读取了 stale 数据.

信使由出错消息和诊断编辑. 添加一个 prefix 页:1 storage 块将项目或团队分开在一个数据库中。 见 存储 用于选择优先级,每个进程覆盖,以及其他存储选项.

从 SDK 使用

import { openLibsqlDatabase } from "@bastani/atomic-storage-libsql";

const database = await openLibsqlDatabase({ url: "libsql://<db>.turso.io", authToken });

openLibsqlDatabase 还接受 namespace 财务报告和审定财务报表 headers (外部请求头,因出错而编辑),用于 libsql:, (中文(简体) ), https:,或 http: URLs (英语). 回来的 SqliteDatabase 可以通过 SDK sessionStore: { kind: "database", database } 或工作流程 journal: { database };它在一个请求中向数据库发送了工作流程日记的批次附件.

包船平面ESM JavaScript带有TypeScript声明. 这种导入在支持的节点版本中工作,没有TypeScript加载器.

许可证

麻省理工学院

版本与发布记录

@bastani/atomic-storage-libsql 共发布 70 个版本,首次发布于 2026/10/23;过去 12 个月发布了 70 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.9.71latest2026/11/043 天前
0.9.71-alpha.1next2026/11/043 天前
0.9.702026/11/044 天前
0.9.70-alpha.12026/11/044 天前
0.9.692026/11/034 天前
0.9.69-alpha.12026/11/034 天前

关于 @bastani/atomic-storage-libsql 的常见问题

@bastani/atomic-storage-libsql 是什么?

libSQL / Turso存储适配器用于原子会话,工作流程日记,和Intercom.

如何安装 @bastani/atomic-storage-libsql?

在项目目录运行 npm install @bastani/atomic-storage-libsql,或使用 pnpm add / yarn add / bun add。

@bastani/atomic-storage-libsql 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@bastani/atomic-storage-libsql 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@bastani/atomic-storage-libsql 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.19.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@bastani/atomic-storage-libsql 可以商用吗?

@bastani/atomic-storage-libsql 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@bastani/atomic-storage-libsql 的下载量有多少?

根据 npm 官方下载统计,@bastani/atomic-storage-libsql 在 2026/10/08 – 2026/11/06 这 30 天内被下载 11,664 次,日均约 389 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@bastani/atomic-storage-libsql 还在维护吗?

最新版本 0.9.71 发布于 2026/11/04(3 天前);至今共发布 70 个版本,其中过去 12 个月发布了 70 个;首次发布于 2026/10/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。