目录:ACP 协议API 网关与控制器附件启动与插件管理客户端运行时客户端 UI 包上下文压缩上下文注入核心运行时凭据与授权交付物文档处理实验特性宿主扩展反馈通道文件系统目标与计划工具守卫Hooks 扩展宿主服务交互命令作业调度LLM 适配LSP 集成MCP 协议规划模式Agent 预设代码执行运行时运行时诊断沙箱定时调度SDK 与协议会话核心会话检索设置Shell 执行技能溢出存储SSH 远程执行存储子代理子进程终端待办类型契约框架 vendorWeb 访问Webhook工作流工作区
依赖链 · 上游（该插件依赖的前驱）：
依赖链 · 下游（依赖该插件的节点）：
无下游（叶子/被消费端）
同一拓扑层（Layer 3，层次遍历层序）：
dsh-api-gatewaydsh-commandsdsh-config-editordsh-deepseek-account-platformdsh-experimental-webworker-runtimedsh-hook-protocoldsh-host-frontend-staticdsh-host-open-in-appdsh-llm-pi-aidsh-personadsh-session-log-deepseekdsh-session-persistence-jsonldsh-session-projectiondsh-session-query-sqlitedsh-session-telemetry-oteldsh-skill-badgedsh-skill-filesystemdsh-skill-officedsh-user-approvaldsh-web-fetch-httpdsh-web-search-exadsh-web-search-perplexitydsh-webhook-githubdsh-workspace
插件信息
| 包名 | @deepseek-ai/dsh-session-persistence-jsonl |
|---|---|
| 分组 | G33 · 会话核心 |
| 拓扑层 | Layer 3（层次遍历：被依赖方先于依赖方） |
| 源码路径 | packages/session/session-persistence-jsonl |
① 实现逻辑
JsonlSessionPersistence 继承 SessionPersistence（注册 ctx.sessionPersistence），以每会话目录下的不可变 generation 文件存 header 与连续事件：create/open 返回带 per-handle 变更链的句柄，读取统一做 fail-closed 校验（src/index.ts:245-577）。写入经 format.ts 编码（默认带校验和的 zstd 帧）、lease.ts 用内核 flock（Windows 具名 semaphore）保证跨进程单写者（src/lease.ts:58-134），storage.ts 负责 live 事件路由与 flush 屏障（src/storage.ts:534-566）。历史 generation 经 format catalog 与 v3→v4 迁移在显式写打开时发布（src/index.ts:579-714），worker 校验由 migration-verifier.ts 承担（src/index.ts:47）。
内部结构动态 DAG（深色主题：橙色=上游依赖 · 绿色=下游依赖 · 棕色=外部seam · 蓝=本插件）
本插件
上游依赖
下游依赖
外部 seam
② 注册/提供（provides）
- ctx.sessionPersistence (JSONL 会话持久化后端：不可变 generation 文件、内核写锁与迁移)
③ 依赖（depends_on · 上游前驱）
dsh-sessionE1
复用 SESSION_FORMAT_VERSION、SessionId/SessionLogOffset 与 Session 类型
src/index.ts:36 import + src/lease.ts:36 import + src/catalog-migration.ts:9 import
④ 被依赖（dependents · 下游消费者）
无下游（叶子/被消费端）