← 返回列表
⚠ 装前注意
为每个 DeepSeek Harness 会话滚动保留校验过的备份——任何损坏最多只损失当前这一回合。
基本兼容但装前注意：未发布到 npm registry，仅可从源码安装 · 最近上游提交 2026/9/10 · 已提供中文文档
在每个回合边界对每个 dsh 会话进行滚动、完整性校验的备份——损坏最多只会影响正在进行的回合。属于会话完整性套件的一部分。
综合分
28.8
GitHub 分
28.8
用户评分
—
★ Stars
0
周下载量
—
兼容 / 相关生态插件（非 dsh 原生，请按其对应运行时安装）
git clone https://github.com/po-et/dsh-session-snapshot.git信任档位：仅索引本站尚未对其实装验证，仅收录元数据
- 是什么
- 生态插件（可安装，未声明 dsh 能力）
- 装得上吗
- 静态安装检查有提示项，装前建议看一眼 README
- 安全吗
- 本站尚未对该插件做风险分级（暂未覆盖，不等同于无风险）
- 还在维护吗
- 活跃：最近一次提交在 15 天前
档位由下列信号合成：本站实装验证（真实安装，当前最高到 L4）· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →
数据截至 2026/9/21（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
安装兼容性检查⚠ 装前注意
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✗npm 包dsh-session-snapshot（未发布到 npm，仅可源码安装）
✓Node 引擎要求 >=22.15 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明
未发布到 npm registry，仅可从源码安装
验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/24 11:38:22
依赖的 DSH / Cordis 模块
@deepseek-ai/cordis用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
由 DeepSeek 最新模型翻译生成dsh-session-snapshot 为每个 DeepSeek Harness 会话滚动保留校验过的备份——任何损坏最多只损失当前这一回合。 English 会话完整性三件套之一： | 阶段 | 插件 | 职责 | |---|---|---| | 预防 | dsh-session-guard | 阻止两个 dsh 进程写坏同一会话 | | 快照 | dsh-session-snapshot（本项目） | 在每个回合边界留一份校验过的好副本 | | 修复 | dsh-session-rescue | 修复或抢救已经损坏的日志 | 为什么需要它 dsh-session-guard 能挡住常见的并发写损坏，但有两类损坏是任何插件都拦不住的：写入过程中崩溃，以及 dsh 自身在任何 agent step 之前运行的冷加载修复路径。本插件从另一侧堵住这个残留缺口：每个回合结束后，校验当前日志是否仍可加载，是则提升为一份快照；若回合结束时日志已损坏，则绝不覆盖上一份好快照，并提示如何恢复——最多只损失进行中的那一回合。 安装 暂未发布到 npm，请直接从 GitHub 安装。pnpm 会要求你放行一次这个包的构建脚本（dsh 会打印要加的那一行），那是 prepare 在编译 TypeScript。 dsh plugin --profile web add github:po-et/dsh-session-snapshot 装完即自动在回合边界打快照。在用 AI agent？直接说："装上 dsh-session-snapshot 插件。" 恢复损坏的会话 CLI 在 dsh 自身启动不了时照样能用： npx github:po-et/dsh-session-snapshot # 列出所有会话的快照与实时健康状态 npx github:po-et/dsh-session-snapshot list 37374e34 # 查看单个会话的快照（id 片段） npx github:po-et/dsh-session-snapshot restore 37374e34 # 恢复最新的、校验通过的快照 npx github:po-et/dsh-session-snapshot snapshot 37374e34 # 立即打一份快照 restore 总是先把当前文件保留为 .pre-restore-，并拒绝任何自身校验不通过的快照。用 --at （在 list 中显示）可恢复指定快照而非最新的。 配置 - id: session-snapshot name: dsh-session-snapshot config: keep: 5 # 每个会话保留的快照数，超出时淘汰最旧的 minIntervalMs: 0 # 同一会话两次快照的最小间隔毫秒（0 = 每个有变化的回合都打） home: /custom # 默认 $DSH_HOME（~/.dsh） 快照存放在 $DSH_HOME/session-snapshots//，且只在日志增长且仍校验通过时才打——未变化或已损坏的会话既不浪费 I/O 也不会覆盖好副本。 成本与诚实边界 - 每次快照 = 一次文件复制 + 一次日志校验扫描。回合间隔是秒到分钟级，实际很轻量；超大会话可调高 minIntervalMs 进一步限流。 - 快照是仅会话日志的时间点副本，不包含工作区文件。要对话+文件一起回退是另一类工具。 - 支持会话格式 version 0（当前 dsh developer preview），.jsonl 与 .jsonl.zstd，JSONL 后端。压缩按内容嗅探，重命名/备份副本也能正确校验。dsh 处于 pre-1.0、无格式兼容承诺；遇到未知版本明确拒绝而非乱猜。 零运行时依赖（zstd 用 Node 内置 zlib）。MIT。