ChatGPTClaudeGrok / X / CursorGemini

DSH plugin 引用已压缩的源会话:compacted 与三类消息计数怎么读、怎么验证

插件开发发布于 2026-11-10作者: DeepSeek Plugin 插件市场
DSH pluginDeepSeek Harness会话引用compacted上下文压缩
引用一个压缩过的会话,拿到的内容比预期少。本文讲 compacted 标记、originalMessages/retainedMessages/omittedMessages 三个计数的关系,以及它与本次预算截断的区别与验证方法。

引用一个跑了三天的会话,只拿回十几条消息,问题通常不在预算,而在源会话早就压缩过。 DSH plugin(DSH插件) 把这件事记成一个 compacted 标记加三个消息计数;不读它们,就会把源端的历史缺口误判成本次准备出错。

DSH plugin 引用压缩过的会话会少什么

少的是压缩阶段就已经不在可读历史里的部分,不是这次读取漏掉的。(来源) 典型现场:

text
源会话:累计 400 条消息,中途压缩过一次
引用后:additionalContext 只覆盖最近 18 条
界面:没有报错,也没有省略提示

调用方看到「成功」,就以为拿到了完整历史。实际拿到的是压缩后仍然保留的那一段。

判断的第一步不是调预算,而是问一句:源会话自己还剩多少可读内容?

DSH plugin 的 compacted 标记说明什么

它描述的是捕获时刻源会话的状态,不是本次调用的参数。(来源) 三个要点:

  1. 标记位置在持久 source 的每个 reference 项里,按会话分别记录;
  2. 它由源会话的历史决定,你的宿主传什么参数都改不了;
  3. 它与本次预算无关,预算再大也不会让压缩前的消息回来。

所以 compacted: true 声明的是「读取范围受限」,而不是一次失败;宿主看到这个标记,该调整的是用户预期,而不是重试。

DSH plugin 三个消息计数怎么对上

三个数不是三个独立指标,而是一道减法。(来源) 关系:

text
originalMessages = retainedMessages + omittedMessages

配合 omittedBytes,可以从条数和体积两个方向衡量缺口。

用一个算例看更清楚:

场景originalMessagesretainedMessagesomittedMessages缺口来源
未压缩、未截断40400无
源端压缩40018382压缩
源端压缩 + 本次截断4009391压缩叠加预算

第二行是关键:omittedMessages 已经是 382,但 truncated 是 false。只看省略条数就断定「被截断」,会把责任归错地方。

第三行说明两个缺口可以叠加。这时 omittedMessages 是一个合并后的总量,想看本次预算单独造成多少,得结合 truncated 与预算文章里的字段一起判断。

DSH plugin 压缩缺口与预算截断的区别

区别不在数字大小,而在「谁能改变它」。(来源) 对照:

维度源端压缩本次预算截断
发生时间引用之前本次 prepare 期间
记录字段compactedtruncated
能否靠调参消除不能可以,换模型或缩小范围
用户可采取的动作引用更早的会话或换会话减少引用数量或提高预算

第一列的「不能」很重要:如果宿主把压缩缺口当成预算问题,用户会反复重试,永远得不到更多内容。

第二列也不是万能的:预算调大只能拿回本次被省略的部分,拿不回源端已经压缩掉的历史。

一句话记法:compacted 是历史事实,truncated 是本次决定。

DSH plugin 宿主该怎么把压缩事实说清楚

文案要区分「没读到」和「已经不在」。(来源) 三种处理:

  • 引用卡片上标注「源会话已压缩,仅包含近期内容」;
  • 不要用「引用失败」这类措辞,读取本身是成功的;
  • 需要更早内容时,引导用户去源会话查看,或引用另一个未压缩的会话。

第三条容易被忽略:用户真正想要的是那段早期讨论,而不是更多字节。告诉他去哪找,比让他调预算有用。

如果产品支持展示 originalMessages 与 retainedMessages,可以写成「源会话共 400 条,当前可读 18 条」,比一句「内容可能不完整」具体得多。

DSH plugin 压缩事实与回溯坐标的关系

压缩决定了能读到哪一段,坐标决定了这段落在源会话的哪个位置。 两点:

  1. capturedThroughSeq 记录快照读到的源 generation 位置,它不会因为压缩而变成当前会话的 seq;
  2. 压缩之后可读区间变窄,回溯时要先确认坐标仍然属于源 generation。

这两件事要一起读:只看 compacted 知道「少了」,再看坐标才知道「少的是哪一段」。

坐标的完整读法在另一篇里展开,这里只需要记住不要把两个会话的序号混用。

DSH plugin 三个计数的验证方法

四个断言,把一个已压缩会话的引用记录验完。 步骤:

  1. 选一个明确做过压缩的源会话,发起一次引用;
  2. 断言 compacted 为 true;
  3. 断言 originalMessages = retainedMessages + omittedMessages;
  4. 断言 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

ChatGPTClaudeGrok / X / CursorGemini

常见问题

DSH plugin 引用一个跑了很久的会话,为什么只拿到最近几条消息?

很可能是源会话本身已经做过上下文压缩,DSH plugin 会记录这个状态。DSH plugin 会在持久 source 里用 compacted 标记这种状态,并用 originalMessages 与 retainedMessages 记录压缩前后的差距。

DSH plugin 的 omittedMessages 大于零,一定是本次引用被截断了吗?

不一定,DSH plugin 的 omittedMessages 也包含压缩缺口。DSH plugin 用 compacted 区分源端缺口,用 truncated 区分本次预算缺口,两个字段要分开看。DSH plugin 用 compacted 区分源端缺口,用 truncated 区分本次预算缺口,两个字段要分开看。

DSH plugin 能不能通过调大预算读回被压缩掉的早期消息?

不能,DSH plugin 不会为引用重新展开压缩前的消息。压缩是源会话已经发生的事实,引用只能读到当前可读的历史。DSH plugin 不会为了引用重新展开压缩前的原始消息。

DSH plugin 的 originalMessages 是引用时的消息总数吗?

不是,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 官方参考 - 会话引用

来源