pureexe/dsh-image-base64

dsh-image-base64

一个 DeepSeek Harness 插件，用于修复：

This turn failed 400 "'url' field must be a base64 encoded image."
INVALID_REQUEST

当具备视觉能力的模型（例如 meta/muse-glimmer）通过一个严格校验图像 MIME 类型的 OpenAI 兼容网关（例如 LM Studio）提供服务时，会出现此问题。

为什么会发生这种情况

完整讨论请参见 deepseek-ai/deepseek-harness#4615。简要版本如下：

- dsh-attachment-local 的请求图像质量阶梯会在源图像带有 alpha 通道时将其重新编码为 image/webp（JPEG 没有可回退的 alpha 通道）。粘贴的截图或带透明度的 PNG 往往带有 alpha 通道。
- LM Studio 的 OpenAI 兼容端点仅接受 base64 data: URL 中的 image/png、image/jpeg 和 image/gif。它会在协议层以 400 拒绝 image/webp（以及其他任何格式），此时请求尚未到达模型。
- dsh-llm-pi-ai 会将附件存储提供给它的任何 mediaType 直接转发到请求中——两者之间没有格式协商，因此这种不匹配会原封不动地到达 LM Studio。

这个插件做了什么

它包装了附件存储的 readImageRequest()（即 dsh-llm-pi-ai 为获取进入请求的确切字节/MIME 类型而发起的调用），并在其媒体类型不在接受列表（默认是 image/png、image/jpeg、image/gif）中时，使用 sharp 将结果转码为 image/png。所有已经是接受格式的内容都会原样通过——只有那些原本会被拒绝的图像才会承担转码开销。

安装

在你的 DSH 配置文件目录中（或通过 dsh plugin --profile  add，它会在配置文件内转发给 pnpm）：

dsh plugin --profile  add /home/pakkapon/dsh-image-base64

然后在该配置文件的 package.json 中的 dsh.profile.bundles 下将其列出：

{
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"dsh-image-base64"
]
}
}
}

重启配置文件（或者如果设置了 patchReload: live，让它自动加载）即可加载它。

配置

接受的媒体类型默认为 [image/png, image/jpeg, image/gif]（LM Studio 的白名单）。要扩大或缩小该范围，请从你自己的补丁层（配置文件 cordis.patch.yml 或 $DSH_HOME/cordis.patch.yml）中定位该插件的 id：

- id: image-base64-compat
config:
acceptedMediaTypes: [image/png, image/jpeg, image/gif, image/webp]

注意事项

- 这仅修补附件存储的请求图像投影——它不会影响图像的存储方式，只影响在模型请求中通过网络发送的内容。
- 转码为 PNG 对其所接收的像素是无损的，但将一张大照片重新编码为 PNG 会比等效的 JPEG/WebP 更大。如果你的
网关实际上接受 WebP，请将其添加到 acceptedMediaTypes 中，而不是依赖默认值。

许可证

MIT