dsh-read-image-jpeg-fallback

在 DSH 搭配 LM Studio 的 openai-completions 路由下，read_image 工具调用本身可以成功，但随后构建 Provider 请求时，PNG 或 WebP 格式的图像附件会被 LM Studio 直接拒绝。dsh-read-image-jpeg-fallback 正是针对这一传输层格式不匹配而生的轻量兼容垫片——它不替换 read_image、不引入 OCR、不调用额外的视觉模型，只在图像块即将进入 Provider 请求前，用 sharp 将 PNG/WebP 透明转码为不透明 sRGB JPEG（质量 90），随后让请求沿原有的多模态路径正常发出。转换全程在本地完成，主模型看到的仍然是图像本身，而非文字描述或工具输出。

插件挂载在 DSH 的 tools/post-execute 钩子之上，对已含 PNG 或 WebP 图像块的 read_image 结果生效：读取原始附件、转码、经 DSH attachment store 写入新 JPEG 附件、仅替换模型可见的图像块引用。原始的规范工具结果与内置 read_image 实现均不受影响。若转码任何一步失败，插件遵循 fail-open 策略——保留原始结果、写入日志警告，绝不将成功的工具调用变成插件错误。

如果你的主模型已经原生支持图像输入，使用 LM Studio 的 OpenAI 兼容接口，且 read_image 在请求构建阶段因格式被拒，这个插件就是最对症的方案。反过来，如果你的 Provider 已经能直接接受 DSH 发出的 PNG/WebP，或你的主模型是纯文本模型而真正需要的是 OCR 或视觉回退，那这个插件并不适用。