前言

随着大语言模型对话长度的不断增长，上下文窗口成为限制长对话质量的关键瓶颈。当历史对话累积到一定程度，模型不仅会遗忘早期信息，还会因为 Token 占用过高而影响生成效果。DeepSeek Harees 结合 billion-context-dsh 插件，通过上下文自动压缩与提炼机制，在压力达到阈值时把较早的历史对话归纳为摘要，从而在有限窗口内保留更多有效信息。

本文面向已经配置了 DeepSeek Harees 和 billion-context-dsh 插件的用户，目标是帮助你理解上下文压缩的背景，掌握在 settings.yaml 中启用自动压缩的完整步骤，并了解如何验证配置是否生效、针对自定义 Provider 需要注意哪些细节。

1. 为什么需要上下文自动压缩

在使用 DeepSeek Harees 进行长对话时，上下文窗口会被逐渐占满。当 Token 用量接近窗口上限时，模型会遗忘早期对话内容，导致回答质量明显下降。DSH 的上下文自动压缩机制可以在压力达到阈值时，将较早的历史对话提炼为摘要，保留最近的关键内容，从而延长有效对话长度。

不过，默认的 DSH 环境并不会自动启用官方上下文压缩。如果你的配置文件中没有 dsh-compaction-basic 相关配置，说明该功能尚未开启，需要手动添加配置才能生效。

2. 在配置中启用自动压缩

在 settings.yaml 文件中添加以下配置块（可以放在文件末尾）：

# 上下文压缩配置
dsh-compaction-basic:
  # 是否启用自动压缩
  enabled: true
  # 触发压缩的上下文压力阈值（0-1），建议设为 0.6 让压缩更早触发
  thresholdRatio: 0.6
  # 压缩后保留的上下文比例，建议 0.2（保留最近20%）
  retainRatio: 0.2
  # 压缩发生在对话轮次之间，由系统自动判断执行
  autoCompact: true
  # 压缩时保留的提示词前缀（如系统指令不会被压缩掉）
  preservePrefix: true

3. 配置后的效果

添加上述配置后，DSH 会自动执行以下操作：

• 监控上下文压力：实时计算当前对话使用的 Token 占窗口的比例。
• 自动触发压缩：当比例达到 60%（你设置的阈值）时，自动执行压缩。
• 智能保留关键内容：保留最近 20% 的对话和系统提示词，将较早的历史压缩为摘要。
• 无需手动干预：整个流程在后台自动完成。

4. 验证是否生效

配置保存后重启 DSH，可以通过以下方式确认压缩是否生效：

• 观察日志：启动时应该能看到 [Compaction] plugin registered 类似日志。
• 对话测试：进行长对话，当上下文压力达到阈值时，终端会输出压缩日志。
• 安装监控面板（可选）：执行 dsh plugin add dsh-context@0.11.2 可以可视化看到压缩是否发生。

下面用一张流程图梳理从配置保存到验证成功的完整步骤：

flowchart TD
    subgraph 配置阶段
        A[保存 settings.yaml 配置] --> B[重启 DSH]
    end
subgraph 验证阶段
    B --> C[观察启动日志]
    C --> D{是否看到 Compaction plugin registered}
    D -- 否 --> E[检查启动日志中的错误信息]
    E --> F{是否修复配置}
    F -- 是 --> B
    F -- 否 --> G[验证失败]
    D -- 是 --> H[进行长对话测试]
    H --> I{上下文压力是否达到阈值}
    I -- 否 --> J[继续对话直到触发压缩]
    J --> I
    I -- 是 --> K[终端输出压缩日志]
    K --> L[查看监控面板确认压缩发生]
    L --> M{压缩是否正常触发}
    M -- 是 --> N[验证成功]
    M -- 否 --> O[检查压缩日志与配置参数]
    O --> P{是否调整配置}
    P -- 是 --> B
    P -- 否 --> G
end</code></pre>
简要说明：保存配置后先重启 DSH，让插件加载生效；随后观察启动日志，确认 [Compaction] plugin registered 出现，若未出现则回到日志排查错误。确认插件注册后，通过长对话把上下文压力推到阈值，触发压缩并观察终端日志，最后可用监控面板可视化确认压缩是否真正发生。
5. 针对自定义 Provider 的特别说明
你的配置中使用的是 my-deepseek 和 nvidia 两个自定义 Provider，窗口大小可能和官方不同。建议：
先设置较低的阈值（如 0.5-0.6），确保压缩尽早触发。
如果发现压缩后对话质量明显下降，可以调低 retainRatio（如 0.15）。
配置添加后记得重启 DSH 才能生效。如果添加后仍然没有自动压缩，可以检查一下启动日志中是否有错误信息。
总结
上下文自动压缩是延长 DeepSeek Harees 长对话质量的关键能力。核心配置步骤可以概括为：在 settings.yaml 中添加 dsh-compaction-basic 配置块，设置合理的 thresholdRatio（建议 0.6）和 retainRatio（建议 0.2），并开启 autoCompact 与 preservePrefix。
配置完成后需要重启 DSH 才能生效，并通过启动日志、长对话测试或监控面板确认压缩是否正常触发。对于使用 my-deepseek 和 nvidia 等自定义 Provider 的环境，建议适当调低阈值以尽早触发压缩，若压缩后质量下降可进一步调低 retainRatio。如果压缩始终未生效，请检查启动日志中的错误信息。