session-persistence-rdb

@morlay/session-persistence-rdb

RDB（SQLite / PostgreSQL）持久会话后端（ctx.sessionPersistence）：通过 drizzle 实现 PersistenceBackend<number>，复用上游 PersistenceCoordinator 与契约测试套件， 支持配置选择 SQLite 或 PostgreSQL 后端。设计细节（表结构、delta 过滤、并发写、 方言差异、仓库结构）见 docs/design.md。

安装

包发布在 GitHub Packages，按包名安装到 dsh profile（示例：web；dsh plugin add 把参数原样转发给 pnpm，版本号按发布版本调整）。registry 必须限定在 @morlay scope（--config.@morlay:registry=…），不要用全局 --registry， 否则依赖（@deepseek-ai/* 等）也会被指到 GitHub Packages 而解析失败：

dsh plugin --profile=web add "@morlay/session-persistence-rdb@^0.0.1" --config.@morlay:registry=https://npm.pkg.github.com/

GitHub Packages 的 registry 要求认证（公开包也一样）：profile 的 .npmrc 需为 npm.pkg.github.com 配置访问 token（如 //npm.pkg.github.com/:_authToken=<token>），详见 GitHub 文档。

配置

配置写在 ${DSH_HOME}/settings.yaml，settings namespace 为插件短名 session-persistence-rdb（与 cordis 插件 name 一致）：

session-persistence-rdb:
  type: sqlite
  # path 省略时回落 cordis.patch.yml 的默认（$DSH_HOME/sessions/sessions.sqlite，
  # 由 bundle patch 的 !!js 表达式求值）；自定义路径请用绝对路径字符串。
  path: /absolute/path/to/sessions.sqlite
  journalMode: wal
  busyTimeout: 5000

settings.yaml 是纯 YAML（settings-local 用 yaml 库解析），不支持 !!js JS 表达式——!!js dshHomePath(...) 会被当作字面字符串。!!js 只在 cordis.patch.yml（bundle patch 层，loader 求值）有效。

字段即 Config 判别联合（见下）；未写出的字段回落到 bundle patch / cordis.yml 的 config 默认值。PostgreSQL：

session-persistence-rdb:
  type: postgres
  connectionString: postgres://user:pass@localhost:5432/sessions

Config 类型：

type Config =
  | {
      type: "sqlite";
      /** SQLite 数据库文件路径；`:memory:` 用于测试。 */
      path: string;
      /** journal_mode：`wal`（默认）/ `delete` / `truncate` / `persist`。 */
      journalMode?: "wal" | "delete" | "truncate" | "persist";
      /** 写锁竞争等待毫秒数（默认 5000）。 */
      busyTimeout?: number;
    }
  | {
      type: "postgres";
      /** node-postgres 连接串；首次打开自动建表并写入 store 身份。 */
      connectionString: string;
    };