DSH Plugins
返回列表
🤖

dsh-image-size-guard

模型推理 更新于 2026.11.03

在终端中运行以下命令:

dsh plugin install qq744287383/dsh-image-size-guard

将以下提示词粘贴到 DeepSeek Harness 对话框中:

在 DeepSeek Harness 中执行 dsh plugin install qq744287383/dsh-image-size-guard,或从 https://github.com/qq744287383/dsh-image-size-guard 克隆后按 README 安装;首次安装后重启一次 Harness 以便浏览器加载新客户端模块。

插件介绍

长对话里每一轮请求都会带上完整历史,图片也会在每次请求里重新编码进 body,体积会一路涨上去。像 agent2api 这类网关有固定的请求体上限(例如 16 MiB),一旦越过,网关会以不可重试的方式拒绝,会话往往就卡死——Harness 自带的图片预算未必能提前拦住,你也很难靠「删一张再试」稳定恢复。

这个插件在请求真正发出前量测 body(用适配器实际会发送的图片缓存),若某条受管 provider 会超限,就按策略批量把最旧的历史图片换成占位文本,一次把体积压到上限以下的低水位,并尽量保留最近几轮的图片。它用 targetTurns、minFillPercent、protectedTurns 等参数控制「一次删多少、留多少余量」,避免每轮只删一张导致前缀缓存反复失效、成本暴涨。

你可以在 Settings → Image size guard 里按 provider 配置上限、保留区、占位大小和开关;保存后通过配置层生效,无需重启 Harness。若已挂载官方的 image-offload 执行器,插件会发出 IMAGE_OFFLOAD_REQUIRED 由执行器写持久化记录;否则也能自行写入并以 REQUEST_TOO_LARGE 触发重试, omission 会进入 Session 的 image/offload 事件,resume、fork 与 compaction 后仍有效。

适合在 Harness 里走有严格 body 限制的网关、对话里经常带截图或附件的 Agent 用户;纯文本对话或从未逼近上限的场景可以不开。若只剩文字仍超预算,插件会放行并告警,因为已没有可省略的图片。

使用场景

  • 走 agent2api 等网关的长对话因截图累积逼近或超过 body 上限
  • 多轮 Agent 会话里历史图片反复进请求导致体积失控
  • 需要在不手工改历史的前提下自动省略最旧图片并继续对话

适合人员

  • 使用 DeepSeek Harness 且路由到有严格请求体上限的 provider 的用户
  • 对话中频繁上传截图或图片附件的 Agent 使用者
  • 需要为不同 provider 单独配置上限与保留区的运维或开发者