Tranquillitatis-Lab/dsh-live-compact

项目介绍

长对话里工具输出、日志和命令结果会不断堆积，最后把上下文窗口占满。Live Compact 是 DSH 的插件，在每轮结束时检查能否安全收短长输出，这一步在本机完成，不需要再请求模型。它只替换选中的一段，切点前面的内容保持原样。整理前会先备份原文，备份失败就保留原内容。默认上下文到 2 万 token 才开始找可压的内容。

它面向用 DeepSeek、GLM 等云端 API 跑 DSH 的人，也适用于本机或内网模型。云端和本地按配置里这一家的地址区分：配置中的 baseURL 优先，其次看官方 DeepSeek 和内置目录；公网地址按云端处理，回环和内网按本地处理。也可以用 SPINE_ENGINE=cloud|local 强制指定。

快速使用

按使用的 profile 分别安装，headless 和网页各装一次：

dsh plugin --profile headless add dsh-live-compact@1.1.4
dsh plugin --profile web add dsh-live-compact@1.1.4

想先确认包版本：

npm install -g dsh-live-compact
dsh-live-compact --version

npm 不可用时，README 还给出镜像包安装方式，包括对同一个 1.1.4 tgz 执行 npm install -g --force 安装段。安装后跑一个长任务，日志里出现 spine cut …ms 才说明这一刀生效。累计数据可用 dsh-live-compact stats 查看。

配置

小切参数可以在 DSH 插件设置里改，也支持环境变量。优先级是显式配置 > 有效环境变量 > 默认值。常用项包括 SPINE_MIN_TOKENS（默认 20000，开始检查的阈值）、SPINE_KEEP_ROUNDS（默认 3，最近已结束工具轮保留原文）、SPINE_CHUNK_MIN（1000）、SPINE_POINTER_TOKENS（默认取 SPINE_CHUNK_MAX，32000）、SPINE_SHADOW_DIR（默认 ~/.dsh/compaction-spine/shadow，设了 DSH_HOME 则在其下）。官方大压缩参数 SPINE_THRESHOLD_RATIO 0.8、SPINE_HEADROOM_TOKENS 65536、SPINE_RETAIN_TOKENS 8192 是另一套，构造引擎或加载预设时读取，改动后需要重建引擎或会话 环境变量。

SPINE_THUNDER 是实验性的模型摘要模式，默认关闭，端侧模型建议不要开。

cordis.patch.yml 是静态整块替换，不读这三个环境变量，改 headroomTokens 要直接改配置块。

使用约束

需要 DSH >=0.2.0-rc.2 <0.3.0 安装说明。DSH-TUI 换不掉预设里的原版压缩，暂不支持。桌面端是另一个 profile，dsh plugin --profile desktop 会被拒绝。

被切掉的原文写到本机备份，默认上限 256MB（可用 SPINE_SHADOW_MAX_BYTES / SPINE_SHADOW_MAX_MB 调整）；快满时先删最老的，删不出空间就不切。Unix 下目录 0700、文件 0600。Windows 上用 DACL 只允许当前用户、SYSTEM、Administrators 访问，写入通过固定 System32 的 powershell.exe 完成，失败时本进程停止后续备份，不回退到 chmod。单进程估算快捷方式要求专用 SPINE_SHADOW_DIR 并设 SPINE_SHADOW_SINGLE_PROCESS=1；默认目录和共享目录每次轮转仍完整扫描。

没有合格摘要时整段保留，不为此调用模型。卡片用 spine-checkpoint，遇到已有卡片就停止往前扩，避免改写已进缓存的前缀。单个超过 3.2 万 token 的工具结果只留指针。许可证为 MIT。

HotRepo 点评

该仓库在 2026-11-10 进入 JavaScript 新项目榜，约 24 小时新增 49 Star、3 Fork，总 Star 为 200。2026-11-06 15:45 UTC 至 2026-11-10 09:45 UTC 的小时采样显示，前期长期在 112–135 附近，最后几小时从 161 快速升到 200。这条榜单记录只能说明当天新增，不足以判断更长的趋势。

README 大量篇幅是逐版本工程记录和可复现的测评说明，包括 31 轮长日志、150 道短题和 20 题长链路对比 测评说明。读者应把其中的节省和缓存数字视为作者测试条件下的结果，可自行运行 npm run test:gate 或 live-fill 套件复现，而不是直接假定相同表现。