DeepSeek Harness 上下文压缩什么时候触发:自动、手动与压力阈值的先后怎么排
压缩不是「上下文满了才突然发生」,而是「在请求组装前后按条件判断」。 官方把压缩放在上下文管理链路里:接近压力阈值时自动触发,也提供手动入口(来源)。理解触发顺序,才能解释「为什么这次请求突然变短」「为什么压缩后细节没了」。
DeepSeek Harness 压缩在轮次中的位置
压缩发生在请求组装阶段,不在任意后台时刻。 一次请求要先确定模型历史、组装提示词与工具 schema,再发给模型;压缩影响的是「模型历史」这一段。(来源)
这个位置带来两个结论:
- 压缩只影响后续请求 — 已经发出的请求不会因为压缩而改变;
- 压缩不会改会话日志 — 日志仍记录原始事件,压缩改变的是模型可见投影。
因此,「压缩后上下文变小」和「历史被删了」是两件事。前者是投影变化,后者才是数据丢失;DeepSeek Harness 做的是前者。
压缩也不等于截断。截断是直接丢掉超出部分,压缩是用摘要替换较早内容;两者的信息损失方式不同。
DeepSeek Harness 自动触发条件
自动压缩由压力阈值触发,阈值与模型窗口、配置上限相关。 官方描述的是「上下文压力」达到条件时压缩,而不是固定每 N 轮压缩一次(来源)。
三个影响因素:
- 模型窗口 — 窗口越小,越早触发;
- 当前历史大小 — 工具结果、附件、长消息都会增加压力;
- 配置上限 — 部署可以设置更保守的阈值,提前压缩。
自动压缩的检查通常在请求组装时进行,所以你会看到「某次请求前后,历史突然从很长变成摘要」。不是丢失,而是压缩在那次请求前生效。
如果压缩频繁发生,先看是什么撑大了上下文:工具结果、图片、长日志或重复引用。只调阈值不解决根因。
DeepSeek Harness 手动入口能做什么
手动压缩适合「在自动阈值之前主动释放空间」,不适合替代排查。 它能让下一次请求更轻,但不改变已经发生的日志。(来源)
三个适用场景:
- 准备发一个长任务 — 提前压缩,避免任务中途触发;
- 上下文里塞了无用的大结果 — 手动压缩把早期内容摘要掉;
- 调试压缩行为 — 主动触发一次,观察保留与摘要的边界。
手动压缩不能做三件事:不能恢复已摘要的细节、不能改变已发请求、不能替代会话清理。需要恢复细节时,回看会话日志,而不是反复压缩。
手动压缩也不是越频繁越好。每次压缩都可能损失细节,频繁压缩会让模型对早期决策失去记忆。
DeepSeek Harness 保留与摘要
压缩保留「结构」与「要点」,丢失「原文细节」。 哪些保留、哪些摘要,取决于压缩策略与实现(来源)。
通常保留:
- 最近的用户消息与助手回复;
- 关键决策与未完成事项;
- 工具调用的结果摘要或定位符。
通常摘要:
- 较早的往返对话;
- 已完成任务的中间步骤;
- 大段工具输出。
通常不进入压缩范围:
- 系统提示词与关键约束;
- 当前轮次的输入;
- 仍在引用的工具结果(可能以定位符保留)。
理解保留边界,才能判断「压缩后模型为什么忘了某个细节」。不是模型变笨,而是那个细节已经变成摘要。
如果某个细节必须保留,应该在压缩前把它写进显式上下文,例如一条总结消息或一个文件,而不是指望它留在历史里。
DeepSeek Harness 代价与失败
压缩的代价是细节损失与一次额外模型请求;失败时可能继续用原上下文或报超限。 三种常见情况(来源):
- 压缩成功 — 下一次请求变小,细节变成摘要;
- 压缩失败但可降级 — 继续使用原上下文,可能接近窗口上限;
- 压缩失败且不可降级 — 请求报上下文超限,需要手动压缩或清理。
第一种是正常路径。第二种容易被忽略:你以为什么都没发生,其实压缩失败了,下一次请求可能超限。
第三种通常伴随明确错误。先看错误信息与当前上下文大小,再决定手动压缩、清理会话还是换更大窗口的模型。
压缩失败的原因可能包括:摘要请求本身超限、模型不可用、工具结果无法摘要。排查时先看压缩请求,而不是先看主请求。
DeepSeek Harness 压缩行为的四个观察点
验证压缩行为,用四个观察点。 四步(来源):
- 触发 — 构造一个接近阈值的会话,确认下一次请求前发生压缩;
- 保留 — 检查最近消息与关键约束是否仍在;
- 摘要 — 检查较早历史是否变成摘要,原文是否仍在日志;
- 失败 — 模拟摘要请求失败,确认降级或报错行为可解释。
四步都过,说明触发、保留、摘要与失败路径一致。只过第一步,常见问题是细节丢失不可预期;只过前三步,常见问题是失败后没有降级。
旧文 dsh-compaction-explained 讲机制,develop-compaction-results 讲结果,fix-compaction-and-context-window 讲故障;本篇补的是触发顺序与代价。先看压力从哪来,再谈压缩。
常见问题
DeepSeek Harness 会在上下文压力达到条件时自动压缩,也提供手动入口。自动压缩通常在请求组装前检查,不在任意时刻后台执行。
DeepSeek Harness 的自动压缩由压力阈值触发,手动压缩由用户主动发起;两者都改变后续请求的上下文,但触发时机与可控性不同。
DeepSeek Harness 不会这样。DeepSeek Harness 的压缩改变模型可见上下文,会话日志仍保留已发生的事件;需要回放时仍可从日志重建。
DeepSeek Harness 里不一定,具体取决于配置。DeepSeek Harness 的压缩失败可能导致请求继续使用原上下文、报上下文超限或走降级路径;先看错误与后续请求大小,再决定是否手动处理。
相关术语
- 上下文压缩
- 上下文压缩是 DeepSeek Harness 用摘要替换较早历史、降低下一次请求输入大小的过程,不删除原始会话日志。— DeepSeek Harness 官方文档 - 上下文压缩
- 压力阈值
- 压力阈值是 DeepSeek Harness 判断是否需要压缩的上下文大小条件,接近模型窗口或配置上限时触发。— DeepSeek Harness 官方文档 - 上下文压缩
- 摘要
- 摘要是压缩后替代较早历史的内容,保留要点但丢失原文细节;原文仍在会话日志中。— DeepSeek Harness 官方文档 - 上下文压缩
- 手动压缩
- 手动压缩是用户主动触发的压缩入口,用于在自动阈值之前释放上下文空间。— DeepSeek Harness 官方文档 - 上下文压缩
来源
- DeepSeek Harness 官方文档 - 上下文压缩· deepseek-harness
- DeepSeek Harness 官方文档 - 会话· deepseek-harness