目录:ACP 协议API 网关与控制器附件启动与插件管理客户端运行时客户端 UI 包上下文压缩上下文注入核心运行时凭据与授权交付物文档处理实验特性宿主扩展反馈通道文件系统目标与计划工具守卫Hooks 扩展宿主服务交互命令作业调度LLM 适配LSP 集成MCP 协议规划模式Agent 预设代码执行运行时运行时诊断沙箱定时调度SDK 与协议会话核心会话检索设置Shell 执行技能溢出存储SSH 远程执行存储子代理子进程终端待办类型契约框架 vendorWeb 访问Webhook工作流工作区
依赖链 · 上游（该插件依赖的前驱）：
依赖链 · 下游（依赖该插件的节点）：
同一拓扑层（Layer 4，层次遍历层序）：
插件信息
| 包名 | @deepseek-ai/dsh-session-projection-cache |
|---|---|
| 分组 | G33 · 会话核心 |
| 拓扑层 | Layer 4（层次遍历：被依赖方先于依赖方） |
| 源码路径 | packages/session/session-projection-cache |
① 实现逻辑
SessionProjectionCache（ctx.sessionProjectionCache）在 session_projcache 域持久化每个投影单元的状态检查点：init 打开域并装写回路径（src/index.ts:104-122），在 session/created、turn/end、session/disposed 三个强制点以及计数/间隔节流触发下做 fail-soft 写（src/index.ts:311-375）。读面提供 cachedSnapshot/cachedPredecessorTitle/hydratePrepared/coldSnapshot，只有 (header 生命周期身份 + 继承 cut + 行 ver) 全部匹配才采信缓存行（src/index.ts:136-306）。spec.ts 定义 per-record 布局的域与 (identity, rows) 记录 schema（src/spec.ts:101-108）。
内部结构动态 DAG（深色主题：橙色=上游依赖 · 绿色=下游依赖 · 棕色=外部seam · 蓝=本插件）
本插件
上游依赖
下游依赖
外部 seam
② 注册/提供（provides）
- ctx.sessionProjectionCache (投影单元状态的持久化检查点与冷/热读加速)
③ 依赖（depends_on · 上游前驱）
dsh-sessionE1+E2
以会话身份/日志水位作为缓存行匹配依据并做持久化屏障
src/index.ts:22 import + src/spec.ts:16 import + src/index.ts:266 ctx.sessions.flush
dsh-session-projectionE1+E2
对注册单元做 checkpoint/restore/hydrate 并查看缓存行
src/index.ts:33 type import + src/index.ts:105 static inject + src/index.ts:204 ctx.sessionProjections.viewCheckpoint
dsh-storage-domainE1+E2
以域表承载每会话一条检查点记录
src/index.ts:34 type import + src/spec.ts:18 import + src/index.ts:118 ctx.storageDomain.open
④ 被依赖（dependents · 下游消费者）
dsh-session-reference
对冷会话从持久投影缓存回答标题，无需打开其日志
src/index.ts:18 type-only import + src/index.ts:251 this.ctx.get('sessionProjectionCache')?.cachedSnapshot