dsh-media-guard

多模态智能体循环里，图片附件常常是请求体积最大的变量。DSH 核心已经用 offloadRequestImages 做了 20 MiB 的 oldest-first 截断兜底，但策略粗糙：要么整张删掉，要么直接溢出。dsh-media-guard 在这个安全层之上叠加了更精细的优化与保留策略——压缩而不是删除、按内容地址去重、区分当前轮次与历史轮次、区分用户媒体与工具媒体，让请求在到达 Provider 之前就处于可控体积之内。

核心能力包括三件事：第一，用 sharp 把超大图片压成 WebP 并写回 DSH 不可变附件存储，原始文件和会话日志始终不动；第二，按 sha256 内容地址去重，相同图片只保留一份，后续引用变成确定性 Evidence Note；第三，在 llm/stream 瀑布流上仅拦截 agent-loop 构建的请求，手拼调用、压缩、回放等路径完全不受影响。保护模式下，插件还会把序列化预算对齐到适配器上限，避免官方适配器再触发一次不可见的二次截断。

适合正在用 DSH 跑多模态智能体、频繁遇到图片请求超限或体积不可控的开发者和团队。默认零配置即可工作，在 DSH 首页 composer 下方会出现一行实时状态条，展示当前压力、保留图片数、预算余量和压缩、去重、外置计数。