DSH plugin 会话引用的预算:最后组装 route、agent options 与 64 KiB 回退
在 DSH plugin(DSH插件) 里,引用被截断多少,不取决于你选了几个会话,而取决于这次 prepare 用的是哪一级预算:最后组装的 route、agent options,还是 64 KiB 回退。 同一段引用在不同会话里表现不同,根因通常在这里。
DSH plugin 同一段引用为什么截断程度不同
先看两边会话的模型与装配状态是否一致。(来源) 现场:
会话 A:已装配 route,模型上下文 128k -> 引用完整
会话 B:尚未装配,使用 agent options -> 引用被省略
用户看到的是「同样的操作,结果不一样」,实际是两次 prepare 拿到的预算不同。
这类差异不是随机的,它和会话生命周期有关:新会话、刚切换模型的会话、尚未发过消息的会话,都可能走到不同分支。
DSH plugin 的三级预算来源
优先级从高到低,只有前一级不可用时才降级。(来源) 对照:
| 顺序 | 来源 | 何时使用 |
|---|---|---|
| 1 | 最后组装的 route | 会话已经装配过 |
| 2 | agent options | 尚未组装,但有配置 |
| 3 | 64 KiB | 缺少模型容量或 adapter |
官方的表述是:自动预算使用最后组装的 route,或在任何组装之前使用 agent options。
第三级不是设计给正常会话的,而是给「信息不全」的场景兜底。
DSH plugin 64 KiB 回退何时生效
只在拿不到容量信息时生效,不是全局默认。(来源) 两个触发条件:
- 缺少模型容量 — 不知道模型能吃多少上下文;
- 缺少 adapter — 没有可用的适配层来报告容量。
满足任一条件,就按 64 KiB 处理。这个值足够完成一次可用的引用,但远小于大上下文模型。
实践中容易误判:把「被截断」直接归因于 64 KiB,但正常会话根本不会走这一级。先确认会话是否装配过,再谈回退。
DSH plugin 元数据失败与取消不是预算问题
它们会让 prepare 直接失败,而不是降级。(来源) 规则:
- 其他元数据查询失败 → 拒绝准备;
- 取消 → 拒绝准备,且不发布上下文。
官方特意把这两类和「缺少容量」区分开:后者有回退值,前者没有。
如果实现把它们都当成「按 64 KiB 继续」,用户会得到一份看似正常、实际不完整的上下文,还看不到任何错误。
正确做法是让失败可见,并保留可读的错误码。
DSH plugin 预算与模型容量的关系
预算跟着模型走,不跟着引用数量走。(来源) 三个要点:
- 引用越多,单个会话可保留的消息越少;
- 模型容量越大,截断点越靠后;
- 切换模型后重新 prepare,结果可能变化。
第三点常被忽略:用户在会话中途切换模型,之前准备好的上下文不会自动重算。
如果产品需要「切换后保持一致」,应该在切换时重新触发一次准备,而不是复用旧结果。
还有一类来源容易被误用:把「最大输出」当成上下文预算。两者衡量的是不同容量,混用会让引用被过早截断。
如果产品允许用户手动限制引用规模,这个限制应该映射到 prepare 的预算参数,而不是在宿主侧先裁掉几条消息——后者不会留下任何省略事实。
记录预算来源也很重要:同一份引用在 route 与 options 两种分支下结果不同,日志里不写清楚,事后无法解释差异。
DSH plugin 预算行为的三组验证
三组对照,把三级来源各覆盖一次。 步骤:
- 已装配会话引用长内容,记录保留条数;
- 新建未装配会话引用同一内容,记录保留条数;
- 模拟缺少容量信息,确认按 64 KiB 处理;
- 让元数据查询失败,确认 prepare 报错而不是返回空上下文。
第 1、2 组用来确认 route 与 options 的分支;第 3 组确认回退;第 4 组确认失败没有被吞掉。
记录时不要只记「是否截断」,要记 retainedMessages 与 omittedBytes,才能比较不同预算下的实际差异。
预算之后是截断事实。读 DSH plugin 会话引用被截断后的字段;想看源会话压缩带来的缺口,读 DSH plugin 引用已压缩的源会话;想先看全貌,读 DSH plugin 怎么完整实现会话引用。
来源:DeepSeek Harness 官方参考 - 会话引用、session-reference/src/index.ts
常见问题
预算来源不同,DSH plugin 会根据会话状态选择不同的一级预算。DSH plugin 优先使用最后组装的 route,尚未组装时使用 agent options,两者对应的模型容量不同,截断点自然不同。
它是 DSH plugin 的回退值,不是固定上限。DSH plugin 在缺少模型容量或 adapter 时按 64 KiB 处理,正常会话仍按实际模型的预算执行。
不能,DSH plugin 对元数据查询失败会直接拒绝 prepare。DSH plugin 对元数据查询失败与取消会拒绝 prepare;当成空引用会静默丢掉用户选择,后续也无法解释为什么上下文缺失。
不是一回事,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 官方参考 - 会话引用
来源
- DeepSeek Harness 官方参考 - 会话引用· deepseek-ai
- session-reference/src/index.ts· deepseek-ai