ChatGPTClaudeGrok / X / CursorGemini

DSH plugin 会话引用的预算:最后组装 route、agent options 与 64 KiB 回退

插件开发发布于 2026-11-10作者: DeepSeek Plugin 插件市场
DSH pluginDeepSeek Harness会话引用预算64 KiB
同一段引用在不同会话里被截断的程度不同,因为预算来源不同。本文讲最后组装 route、agent options 与 64 KiB 回退的先后,以及元数据失败为什么不能当空引用处理。

在 DSH plugin(DSH插件) 里,引用被截断多少,不取决于你选了几个会话,而取决于这次 prepare 用的是哪一级预算:最后组装的 route、agent options,还是 64 KiB 回退。 同一段引用在不同会话里表现不同,根因通常在这里。

DSH plugin 同一段引用为什么截断程度不同

先看两边会话的模型与装配状态是否一致。(来源) 现场:

text
会话 A:已装配 route,模型上下文 128k  -> 引用完整
会话 B:尚未装配,使用 agent options   -> 引用被省略

用户看到的是「同样的操作,结果不一样」,实际是两次 prepare 拿到的预算不同。

这类差异不是随机的,它和会话生命周期有关:新会话、刚切换模型的会话、尚未发过消息的会话,都可能走到不同分支。

DSH plugin 的三级预算来源

优先级从高到低,只有前一级不可用时才降级。(来源) 对照:

顺序来源何时使用
1最后组装的 route会话已经装配过
2agent options尚未组装,但有配置
364 KiB缺少模型容量或 adapter

官方的表述是:自动预算使用最后组装的 route,或在任何组装之前使用 agent options。

第三级不是设计给正常会话的,而是给「信息不全」的场景兜底。

DSH plugin 64 KiB 回退何时生效

只在拿不到容量信息时生效,不是全局默认。(来源) 两个触发条件:

  1. 缺少模型容量 — 不知道模型能吃多少上下文;
  2. 缺少 adapter — 没有可用的适配层来报告容量。

满足任一条件,就按 64 KiB 处理。这个值足够完成一次可用的引用,但远小于大上下文模型。

实践中容易误判:把「被截断」直接归因于 64 KiB,但正常会话根本不会走这一级。先确认会话是否装配过,再谈回退。

DSH plugin 元数据失败与取消不是预算问题

它们会让 prepare 直接失败,而不是降级。(来源) 规则:

  • 其他元数据查询失败 → 拒绝准备;
  • 取消 → 拒绝准备,且不发布上下文。

官方特意把这两类和「缺少容量」区分开:后者有回退值,前者没有。

如果实现把它们都当成「按 64 KiB 继续」,用户会得到一份看似正常、实际不完整的上下文,还看不到任何错误。

正确做法是让失败可见,并保留可读的错误码。

DSH plugin 预算与模型容量的关系

预算跟着模型走,不跟着引用数量走。(来源) 三个要点:

  1. 引用越多,单个会话可保留的消息越少;
  2. 模型容量越大,截断点越靠后;
  3. 切换模型后重新 prepare,结果可能变化。

第三点常被忽略:用户在会话中途切换模型,之前准备好的上下文不会自动重算。

如果产品需要「切换后保持一致」,应该在切换时重新触发一次准备,而不是复用旧结果。

还有一类来源容易被误用:把「最大输出」当成上下文预算。两者衡量的是不同容量,混用会让引用被过早截断。

如果产品允许用户手动限制引用规模,这个限制应该映射到 prepare 的预算参数,而不是在宿主侧先裁掉几条消息——后者不会留下任何省略事实。

记录预算来源也很重要:同一份引用在 route 与 options 两种分支下结果不同,日志里不写清楚,事后无法解释差异。

DSH plugin 预算行为的三组验证

三组对照,把三级来源各覆盖一次。 步骤:

  1. 已装配会话引用长内容,记录保留条数;
  2. 新建未装配会话引用同一内容,记录保留条数;
  3. 模拟缺少容量信息,确认按 64 KiB 处理;
  4. 让元数据查询失败,确认 prepare 报错而不是返回空上下文。

第 1、2 组用来确认 route 与 options 的分支;第 3 组确认回退;第 4 组确认失败没有被吞掉。

记录时不要只记「是否截断」,要记 retainedMessages 与 omittedBytes,才能比较不同预算下的实际差异。

预算之后是截断事实。读 DSH plugin 会话引用被截断后的字段;想看源会话压缩带来的缺口,读 DSH plugin 引用已压缩的源会话;想先看全貌,读 DSH plugin 怎么完整实现会话引用。

来源:DeepSeek Harness 官方参考 - 会话引用、session-reference/src/index.ts

ChatGPTClaudeGrok / X / CursorGemini

常见问题

DSH plugin 同一段引用,在 A 会话完整、在 B 会话被截断,是什么原因?

预算来源不同,DSH plugin 会根据会话状态选择不同的一级预算。DSH plugin 优先使用最后组装的 route,尚未组装时使用 agent options,两者对应的模型容量不同,截断点自然不同。

DSH plugin 的 64 KiB 是什么时候用的,固定上限吗?

它是 DSH plugin 的回退值,不是固定上限。DSH plugin 在缺少模型容量或 adapter 时按 64 KiB 处理,正常会话仍按实际模型的预算执行。

DSH plugin 里预算查询失败,能不能当成「没有引用内容」继续?

不能,DSH plugin 对元数据查询失败会直接拒绝 prepare。DSH plugin 对元数据查询失败与取消会拒绝 prepare;当成空引用会静默丢掉用户选择,后续也无法解释为什么上下文缺失。

DSH plugin 的截断与预算超限是同一回事吗,两者结果差在哪?

不是一回事,DSH plugin 的截断与预算超限结果不同。DSH plugin 的截断是预算内的省略行为,会带省略事实;预算超限是错误码 BUDGET_EXCEEDED,属于准备失败,两者处理方式不同。

相关术语

预算(budget)
预算是 prepare 读取被引用会话时允许使用的上下文容量,决定读取多少、省略多少。— DeepSeek Harness 官方参考 - 会话引用
最后组装 route
最后组装 route 是会话最近一次装配使用的模型路由,提供实际可用的上下文容量。— session-reference/src/index.ts
agent options
agent options 是会话在尚未完成装配前使用的配置来源,作为预算的次级依据。— session-reference/src/index.ts
64 KiB 回退
64 KiB 回退是缺少模型容量或 adapter 时采用的默认预算,避免读取无上限。— DeepSeek Harness 官方参考 - 会话引用

来源