dsh-compactor

在 DeepSeek Harness 的长会话中，工具调用返回的搜索结果、文件内容和命令输出往往占据上下文的绝大部分，而其中对后续推理真正有价值的细节却非常有限。重复的工具调用和冗余的助手回复不断膨胀 token 用量，严重时甚至诱发死循环，让会话陷入反复调用的怪圈。dsh-compactor 正是为这一痛点而生：它在不破坏 dsh append-only 会话日志的前提下，对上下文做系统性压缩，让长会话既能跑得多，又不丢关键信息。

核心能力分为三层协同工作。实时层在工具结果进入事件流时即按策略剪枝——搜索只留标题与短摘要，文件只留预览，命令输出只留退出码与关键行。批处理层在每轮回复完成后估算 token 量，超过阈值时将可压缩片段替换为一条结构化摘要，且自动对齐 tool-call 与 tool-result 配对点，最近 N 轮永不触碰。归档层将所有被替换的原文写入 append-only JSONL 文件，执行 /restore 即可完整还原。摘要引擎提供两种选择：有 DEEPSEEK_API_KEY 时走 API 调用做骨架化摘要，无 Key 时自动降级为本地抽取式兜底；也可以通过 /local-compact 执行零网络、零新增依赖的纯规则压缩。此外，插件内置死循环护栏——同一工具以相同参数被调用三次即注入 anti-loop 提醒，五次则记入取消判定，供宿主 toolRuntime 消费。每次压缩完成后都会输出结构化报告，逐条列出压缩范围、压缩比、前后 token 变化及关键信息保留率。

适合在 DeepSeek Harness 中频繁进行工具调用、长链路推理的开发者和研究团队；也适合希望在不依赖外部 API 的情况下离线控制上下文长度的场景——本地规则压缩引擎零网络、零新增依赖，修改规则文件后无需重启会话即可生效。