DeepSeek Harness plugin

session-persistence-rdb

RDB durable session persistence backend for the DeepSeek Harness

Jump to install

Source facts

Repository
morlay/session-persistence-rdb
Latest update
Aug 14, 2026
Category
Memory
GitHub stars
4
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/morlay/session-persistence-rdb
Plugin: session-persistence-rdb
Author: morlay

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

@morlay/session-persistence-rdb

RDB(SQLite / PostgreSQL)持久会话后端(ctx.sessionPersistence):通过 drizzle 实现 PersistenceBackend<number>,复用上游 PersistenceCoordinator 与契约测试套件, 支持配置选择 SQLite 或 PostgreSQL 后端。设计细节(表结构、delta 过滤、并发写、 方言差异、仓库结构)见 [docs/design.md](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;
    };