DSH plugin 引用已压缩的源会话:compacted 与三类消息计数怎么读、怎么验证
引用一个跑了三天的会话,只拿回十几条消息,问题通常不在预算,而在源会话早就压缩过。 DSH plugin(DSH插件) 把这件事记成一个 compacted 标记加三个消息计数;不读它们,就会把源端的历史缺口误判成本次准备出错。
DSH plugin 引用压缩过的会话会少什么
少的是压缩阶段就已经不在可读历史里的部分,不是这次读取漏掉的。(来源) 典型现场:
源会话:累计 400 条消息,中途压缩过一次
引用后:additionalContext 只覆盖最近 18 条
界面:没有报错,也没有省略提示
调用方看到「成功」,就以为拿到了完整历史。实际拿到的是压缩后仍然保留的那一段。
判断的第一步不是调预算,而是问一句:源会话自己还剩多少可读内容?
DSH plugin 的 compacted 标记说明什么
它描述的是捕获时刻源会话的状态,不是本次调用的参数。(来源) 三个要点:
- 标记位置在持久 source 的每个 reference 项里,按会话分别记录;
- 它由源会话的历史决定,你的宿主传什么参数都改不了;
- 它与本次预算无关,预算再大也不会让压缩前的消息回来。
所以 compacted: true 声明的是「读取范围受限」,而不是一次失败;宿主看到这个标记,该调整的是用户预期,而不是重试。
DSH plugin 三个消息计数怎么对上
三个数不是三个独立指标,而是一道减法。(来源) 关系:
originalMessages = retainedMessages + omittedMessages
配合 omittedBytes,可以从条数和体积两个方向衡量缺口。
用一个算例看更清楚:
| 场景 | originalMessages | retainedMessages | omittedMessages | 缺口来源 |
|---|---|---|---|---|
| 未压缩、未截断 | 40 | 40 | 0 | 无 |
| 源端压缩 | 400 | 18 | 382 | 压缩 |
| 源端压缩 + 本次截断 | 400 | 9 | 391 | 压缩叠加预算 |
第二行是关键:omittedMessages 已经是 382,但 truncated 是 false。只看省略条数就断定「被截断」,会把责任归错地方。
第三行说明两个缺口可以叠加。这时 omittedMessages 是一个合并后的总量,想看本次预算单独造成多少,得结合 truncated 与预算文章里的字段一起判断。
DSH plugin 压缩缺口与预算截断的区别
区别不在数字大小,而在「谁能改变它」。(来源) 对照:
| 维度 | 源端压缩 | 本次预算截断 |
|---|---|---|
| 发生时间 | 引用之前 | 本次 prepare 期间 |
| 记录字段 | compacted | truncated |
| 能否靠调参消除 | 不能 | 可以,换模型或缩小范围 |
| 用户可采取的动作 | 引用更早的会话或换会话 | 减少引用数量或提高预算 |
第一列的「不能」很重要:如果宿主把压缩缺口当成预算问题,用户会反复重试,永远得不到更多内容。
第二列也不是万能的:预算调大只能拿回本次被省略的部分,拿不回源端已经压缩掉的历史。
一句话记法:compacted 是历史事实,truncated 是本次决定。
DSH plugin 宿主该怎么把压缩事实说清楚
文案要区分「没读到」和「已经不在」。(来源) 三种处理:
- 引用卡片上标注「源会话已压缩,仅包含近期内容」;
- 不要用「引用失败」这类措辞,读取本身是成功的;
- 需要更早内容时,引导用户去源会话查看,或引用另一个未压缩的会话。
第三条容易被忽略:用户真正想要的是那段早期讨论,而不是更多字节。告诉他去哪找,比让他调预算有用。
如果产品支持展示 originalMessages 与 retainedMessages,可以写成「源会话共 400 条,当前可读 18 条」,比一句「内容可能不完整」具体得多。
DSH plugin 压缩事实与回溯坐标的关系
压缩决定了能读到哪一段,坐标决定了这段落在源会话的哪个位置。 两点:
capturedThroughSeq记录快照读到的源 generation 位置,它不会因为压缩而变成当前会话的 seq;- 压缩之后可读区间变窄,回溯时要先确认坐标仍然属于源 generation。
这两件事要一起读:只看 compacted 知道「少了」,再看坐标才知道「少的是哪一段」。
坐标的完整读法在另一篇里展开,这里只需要记住不要把两个会话的序号混用。
DSH plugin 三个计数的验证方法
四个断言,把一个已压缩会话的引用记录验完。 步骤:
- 选一个明确做过压缩的源会话,发起一次引用;
- 断言
compacted为 true; - 断言
originalMessages = retainedMessages + omittedMessages; - 断言
omittedBytes与缺口规模相称,且truncated与预算设置一致。
第 3 步是最有价值的断言:三个数对不上,说明记录本身有问题,后面所有判断都不可信。
第 4 步用来分离两种缺口。如果预算充足却仍然 truncated: true,说明宿主给的预算没有按预期生效,应该回到预算那一篇排查。
再补一个反向用例:找一个从未压缩的短会话,确认 compacted 为 false、omittedMessages 为 0。只有正向和反向都过,才说明字段不是「永远为真」的摆设。
读完源端压缩,下一步看坐标。读 DSH plugin 的 capturedThroughSeq 属于源 generation;想回顾本次预算截断的字段,读 DSH plugin 引用被截断后的五个事实字段;想先看持久记录整体结构,读 DSH plugin 的 recall 记录怎么读。
来源:DeepSeek Harness 官方参考 - 会话引用、session-reference/src/types.ts
常见问题
很可能是源会话本身已经做过上下文压缩,DSH plugin 会记录这个状态。DSH plugin 会在持久 source 里用 compacted 标记这种状态,并用 originalMessages 与 retainedMessages 记录压缩前后的差距。
不一定,DSH plugin 的 omittedMessages 也包含压缩缺口。DSH plugin 用 compacted 区分源端缺口,用 truncated 区分本次预算缺口,两个字段要分开看。DSH plugin 用 compacted 区分源端缺口,用 truncated 区分本次预算缺口,两个字段要分开看。
不能,DSH plugin 不会为引用重新展开压缩前的消息。压缩是源会话已经发生的事实,引用只能读到当前可读的历史。DSH plugin 不会为了引用重新展开压缩前的原始消息。
不是,DSH plugin 的 originalMessages 是压缩前的总数。它是压缩前的总数。压缩之后当前可读的数量看 retainedMessages,两者之差就是 omittedMessages,所以不要把 originalMessages 当成引用时的实际条数。
相关术语
- compacted
- compacted 是持久 source 中的布尔字段,表示被引用的源会话在捕获前已经做过上下文压缩。— DeepSeek Harness 官方参考 - 会话引用
- originalMessages
- originalMessages 是源会话压缩前的消息总数,用来衡量压缩前的原始规模。— session-reference/src/types.ts
- retainedMessages
- retainedMessages 是引用捕获时源会话当前可读的消息数量,压缩后通常明显小于原始总数。— session-reference/src/types.ts
- 源端缺口(source-side gap)
- 源端缺口是压缩在捕获之前就已造成的内容缺失,与本次预算是否充足无关。— DeepSeek Harness 官方参考 - 会话引用
来源
- DeepSeek Harness 官方参考 - 会话引用· deepseek-ai
- session-reference/src/types.ts· deepseek-ai