deepseekplugins

DeepSeek Harness plugin

dsh-session-repacker

会话日志 zstd 帧重打包：把逐批写入的成千上万个独立 zstd 帧合并为官方标准形态（头部帧 + 单事件帧），大幅降低旧会话打开时的解压开销；后台自动维护 + 独立 CLI 一键执行。

Memory
Jump to install

Source facts

Repository
kkishapppy/dsh-session-repacker
Latest update
Aug 14, 2026
Category
Memory
GitHub stars
1
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/kkishapppy/dsh-session-repacker
Plugin: dsh-session-repacker
Author: kkishapppy

Check the source files

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

File explorer3 files
README.mdSource · read only

dsh-session-repacker

把 DSH 会话日志中成千上万个独立 zstd 帧重打包为官方原生两帧形态，大幅加快旧会话打开速度。

背景：为什么会话打开慢

DSH 的 JSONL 会话后端（dsh-session-persistence-jsonl）每次写入批处理都单独压缩成一个 zstd 帧再追加到 session.jsonl.zstd 尾部。流式输出期间每 ~200ms 一批，一个长会话动辄上万帧；而读取时必须逐帧解压（且后端没有 seek 式后缀读取，无论只要尾部还是全部都要解码整个文件）。

实测（2026-08-14）：本机最大会话 5.49MB 压缩 = 14,467 帧 / 19,310 事件，纯解压 ~660ms，真实读取路径约 1.5~3s。

会话重打包前重打包后
最大会话14,467 帧 / 5.49MB / ~661ms2 帧 / 2.09MB / ~126ms（6 倍）
全量 24 个旧会话39,911 帧 / 20.08MB48 帧 / 10.67MB

重打包同时把压缩体积减半（单大帧压缩率远好于万个小帧）。

原理

把"万帧"日志重打包成官方写入时的原生形态——头部帧（恰好一行 header）+ 单个事件帧（其余全部明文拼接后重压一帧）。明文逐字节不变，dsh 读取路径完全兼容（assertZstdHeaderFrame 只要求第一帧恰为一行 header）。

覆盖一切从磁盘读旧会话的路径：GUI 打开、新对话接续/分支（fork 前需全量解码父会话）、子会话继承。

安装

# 作为 DSH 插件（推荐）：
dsh plugin --profile web add dsh-session-repacker
# 或克隆到 plugins/ 目录 + link 进 profile（见 DSH 插件开发手册）

配置（profiles/<profile>/cordis.patch.yml）：

- id: session-repacker
  config:
    root: 'E:\DeepSeekHarness\sessions'   # 会话根目录（必填）
    minFrames: 200        # 帧数低于此值不处理（默认 200）
    minAgeMs: 600000      # mtime 距今不足此值不处理，避开活跃写入（默认 10 分钟）
    intervalMs: 3600000   # 周期维护间隔毫秒（默认 1 小时）

重启服务器后生效：启动时全量扫描一次，之后按 intervalMs 周期维护。

独立 CLI（无需 DSH 服务）

node tools/repack.mjs <root>                  # 扫描并重打包
node tools/repack.mjs <root> --dry-run        # 只统计不落盘
node tools/repack.mjs <root> --file <path>    # 只处理指定文件（可多次）
node tools/repack.mjs <root> --min-frames 64 --min-age-ms 60000

安全设计

1. 只处理 .jsonl.zstd；跳过 mtime 距今 < minAgeMs 的文件（避开活跃写入） 2. 跳过当前 live 会话（注入 sessions 服务时用 ctx.sessions.list()） 3. 替换前做字节级等价校验（新文件解压明文 == 原始明文） 4. 替换前再次 stat 比对 size/mtime，文件被并发追加则放弃本次 5. torn tail（未完成帧）跳过，交给 dsh 自身的修复路径 6. 临时文件 + fsync + 原子 rename（Windows 下与官方后端同构）

服务器对重打包后的文件追加新帧（session/end-seed 等）实测兼容，后续可被再次重打包（幂等）。

构建

npm i
npx -y tsdown@0.22.2 --config ./tsdown.config.ts   # 产物 lib/index.mjs

注意事项

  • 已产生的旧文件帧数定形后无法回溯压缩，只能靠本插件/CLI 重打包；writeBatchMaxDelayMs 调大可减少未来日志的帧数（默认 200ms，属耐久性权衡）
  • 插件只做维护，不改变任何读取 API 与数据语义

License

MIT

Back to searchOpen GitHub repository

More related plugins

View category