@morlay/session-branch

Session Branch

Provider 抽象与高层服务，用于处理基于 DeepSeek Harness 的事件溯源会话的回退、重试和分叉。

目标 Profile

插件会安装到这里；不确定时保持 web。

npx -y @deepseek-ai/dsh plugin --profile web add @morlay/session-branch@0.0.11

兼容性与来源证明

Session Branch 以 @morlay/session-branch 发布，当前版本为 0.0.11。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。

DSH 兼容范围: *
运行环境: any
发布来源: npm
Registry 更新时间: 2026/11/4

版本

0.0.8stable

2026/9/14

0.0.7stable

2026/9/13

0.0.6stable

2026/9/11

0.0.11stable

2026/8/27

查看其余 19 个版本收起版本

0.0.10-alpha.8prerelease

2026/9/24

0.0.10-alpha.7prerelease

2026/9/23

0.0.10-alpha.6prerelease

2026/9/22

0.0.10-alpha.5prerelease

2026/9/20

0.0.10-alpha.4prerelease

2026/9/20

0.0.10-alpha.3prerelease

2026/9/18

0.0.10-alpha.2prerelease

2026/9/18

0.0.9-alpha.1prerelease

2026/9/18

0.0.9-alpha.0prerelease

2026/9/18

0.0.5stable

2026/9/10

0.0.4stable

2026/9/10

0.0.4-alpha.4prerelease

2026/9/10

0.0.4-alpha.2prerelease

2026/9/8

0.0.4-alpha.1prerelease

2026/9/8

0.0.4-alpha.0prerelease

2026/9/8

0.0.3stable

2026/9/4

0.0.2stable

2026/9/3

README

@morlay/session-branch

分支式会话编辑的契约层：定义数据层分支原语 SessionBranchProvider （rewind / forkFrom / readBranchPrefix）、高层服务 SessionBranch （ctx.sessionBranch）与共享的版本树投影 buildTimeline。

与上游 `SessionPersistence` 的关系

面	上游 `PersistenceBackend`	本包 `SessionBranchProvider`
覆盖	持久读写 + 崩溃修复（append-only）	显式回退 + 闭合边界派生（分支面）
原语	`loadStored` / `appendBatch` / `commitRepair`	`readBranchPrefix` / `forkFrom` / `rewind`
实现方	JSONL / RDB 等	RDB 等（`@morlay/session-rdb` 同时实现两者，形成闭环）

Provider 抽象

interface SessionBranchProvider {
  readBranchPrefix(id, atSeq?, mode?, signal?): Promise<BranchBoundary>;
  forkFrom(sourceId, options?, signal?): Promise<SessionId>;
  rewind(id, toBoundary, signal?): Promise<SessionPersistenceSnapshot>;
}

readBranchPrefix：定位 atSeq 锚定的闭合 turn/end 边界并返回前缀； mode: "after"（包含目标轮，fork 语义）/ "before"（排除目标轮，编辑 / 重掷 / 重试语义）。
forkFrom：纯 append——新会话（parentSession / seedLength），seed = 边界前缀 + seedSuffix，不触碰源会话。
rewind：唯一改写事件 log 的操作，事务整体提交或回滚；支持 live 会话（内存 log 截断 + 派生缓存复位 + coordinator cursor 同步，见 @morlay/session-rdb 的 SessionBranchRdbProvider）。
syncLiveCursor(sessionId)：编排层把 ignorable 版本效果 push 进 live log 后（不发布、不进 write-behind 缓冲），用其对齐 coordinator cursor，避免后续 append 的 seq 校验错位（默认空实现，rdb 覆写）。

版本树

buildTimeline(snapshots, readOwnEvents, sessionId) 从会话快照（header lineage）+ 每会话自有后缀（seq >= seedLength 的 session-branch/version 事件）投影完整版本树。

版本效果事件携带 ignorable: true（对核心可跳过、不进 canonical log）， live 会话从内存 log 读到效果，cold 会话 timeline 只有 lineage 骨架。

安装

nub install @morlay/session-branch   # peer: @deepseek-ai/cordis, dsh-session, dsh-session-persistence

版本

0.0.8stable

2026/9/14

0.0.7stable

2026/9/13

0.0.6stable

2026/9/11

0.0.11stable

2026/8/27

查看其余 19 个版本收起版本

0.0.10-alpha.8prerelease

2026/9/24

0.0.10-alpha.7prerelease

2026/9/23

0.0.10-alpha.6prerelease

2026/9/22

0.0.10-alpha.5prerelease

2026/9/20

0.0.10-alpha.4prerelease

2026/9/20

0.0.10-alpha.3prerelease

2026/9/18

0.0.10-alpha.2prerelease

2026/9/18

0.0.9-alpha.1prerelease

2026/9/18

0.0.9-alpha.0prerelease

2026/9/18

0.0.5stable

2026/9/10

0.0.4stable

2026/9/10

0.0.4-alpha.4prerelease

2026/9/10

0.0.4-alpha.2prerelease

2026/9/8

0.0.4-alpha.1prerelease

2026/9/8

0.0.4-alpha.0prerelease

2026/9/8

0.0.3stable

2026/9/4

0.0.2stable

2026/9/3

README

@morlay/session-branch

与上游 `SessionPersistence` 的关系

面	上游 `PersistenceBackend`	本包 `SessionBranchProvider`
覆盖	持久读写 + 崩溃修复（append-only）	显式回退 + 闭合边界派生（分支面）
原语	`loadStored` / `appendBatch` / `commitRepair`	`readBranchPrefix` / `forkFrom` / `rewind`
实现方	JSONL / RDB 等	RDB 等（`@morlay/session-rdb` 同时实现两者，形成闭环）

Provider 抽象

interface SessionBranchProvider {
  readBranchPrefix(id, atSeq?, mode?, signal?): Promise<BranchBoundary>;
  forkFrom(sourceId, options?, signal?): Promise<SessionId>;
  rewind(id, toBoundary, signal?): Promise<SessionPersistenceSnapshot>;
}

readBranchPrefix：定位 atSeq 锚定的闭合 turn/end 边界并返回前缀； mode: "after"（包含目标轮，fork 语义）/ "before"（排除目标轮，编辑 / 重掷 / 重试语义）。
forkFrom：纯 append——新会话（parentSession / seedLength），seed = 边界前缀 + seedSuffix，不触碰源会话。
rewind：唯一改写事件 log 的操作，事务整体提交或回滚；支持 live 会话（内存 log 截断 + 派生缓存复位 + coordinator cursor 同步，见 @morlay/session-rdb 的 SessionBranchRdbProvider）。
syncLiveCursor(sessionId)：编排层把 ignorable 版本效果 push 进 live log 后（不发布、不进 write-behind 缓冲），用其对齐 coordinator cursor，避免后续 append 的 seq 校验错位（默认空实现，rdb 覆写）。

版本树

buildTimeline(snapshots, readOwnEvents, sessionId) 从会话快照（header lineage）+ 每会话自有后缀（seq >= seedLength 的 session-branch/version 事件）投影完整版本树。

版本效果事件携带 ignorable: true（对核心可跳过、不进 canonical log）， live 会话从内存 log 读到效果，cold 会话 timeline 只有 lineage 骨架。

安装

nub install @morlay/session-branch   # peer: @deepseek-ai/cordis, dsh-session, dsh-session-persistence

Session Branch

兼容性与来源证明

版本

相关插件

Session Branch

README

@morlay/session-branch

与上游 SessionPersistence 的关系

Provider 抽象

版本树

安装

兼容性与来源证明

版本

相关插件

相关插件

README

@morlay/session-branch

与上游 SessionPersistence 的关系

Provider 抽象

版本树

安装

相关插件

与上游 `SessionPersistence` 的关系

与上游 `SessionPersistence` 的关系