dsh-image-once

在 DSH 对话里贴过几张截图之后，你可能没改多少字，却感觉每一步都在等——因为默认链路会把历史里每张未 offload 的图片，在每一次请求里重新 base64 内联。请求体从几十 KB 涨到几 MB 时，延迟往往跟着成倍往上走，而瓶颈常常不在你家上行，而在网关反复 ingest 同一份大图。

dsh-image-once 做的是「图片只发一次」：同一张图在对话中的每一次「出现」只在它第一次被送进模型的那次请求里原样内联，保证模型第一眼能看全；该次请求顺利产出第一个 chunk 之后才记账，失败或重试不会误记。之后的任何一步请求里，这张出现会被标成已 offload，由 DSH 自带的占位文字接替——里面带着 sha256、尺寸、文件名和本地只读路径，模型真要抠细节时再 read_image，那一次会当作新的出现再内联一次。记账只在内存里改本次请求的副本，不写回会话；带 purpose 的标题、摘要类辅助请求也不改写。

插件会递归扫进 tool-result，兼容扁平与嵌套两种 read_image 返回形状，避免「看起来装了插件却每步仍在重发」的静默失效。改写时逐块重建消息，未改动的文本与外壳原样保留。设置里可按宿主注册的 provider 开关，并可选限定模型 id，改完即时生效。

适合经常在 agent 工作流里贴截图、又希望长对话里每步请求体保持轻量的用户——尤其是「看一眼图然后主要靠文字往下推」的场景；若你依赖模型在每一步都自动「看见」整张历史图而不愿主动 read_image，需要接受视觉信息只在内联那一次最完整。