dsh-history-fold

在 DeepSeek Harness 里，每一轮请求都会把整段可见对话历史重新送进模型，上下文越长，计费 token 越多，解码也会因为注意力要扫过整段 KV 缓存而明显变慢。长会话并不等于首 token 更慢，真正拖慢的是后续生成速度。dsh-history-fold 针对的就是这种「历史越积越贵、越积越慢」的日常痛点。

插件在每轮第一步之前检查可见上下文是否超过阈值；若需要折叠，会在工具调用与结果成对平衡的切点上，选取最旧的一段节点归档到本地 JSONL，再用与官方 compactor 相同的表面替换机制，把该区间换成一条带抽取式索引的提示消息。归档失败则放弃折叠，可见历史不会被无声丢掉。索引来自原文行的前缀抽样，不调用模型、不做改写；多层折叠时会把完整索引写在磁盘层级文件里，上下文里只保留可解析的路径指针，避免旧内容被采样抹掉后无法找回。

若常规折叠因保留最近节点、最小折叠门槛或归档失败而没降下来，下一轮在紧急阈值仍会再以更激进的参数重试，并在日志中标记 emergency。适合需要连续数百轮以上的开发或排查会话、希望控制每轮成本与解码体验、又要求历史可恢复、可检索的用户。可用 dryRun 先观察日志，再决定是否真正写入。