dsh-grok-adaptation
使用 Sharp 规范化尺寸过小的 Grok Responses 图像，同时保持受支持的大尺寸图像不变。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:RailgunHamster/dsh-grok-adaptation#547154864464aebe9ba7bd50d3fcd29c34936d27Grok Adaptation 以 dsh-grok-adaptation 发布，当前版本为 0.3.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DeepSeek Harness plugin that normalizes undersized Grok image inputs on the OpenAI Responses HTTP/SSE path.
The plugin keeps Grok requests on the normal Responses HTTP/SSE path. It does not open or require a WebSocket connection.
For every input_image in a Responses message or function_call_output item, the plugin reads image metadata with Sharp/libvips. If either image edge is 24 pixels or smaller, it:
Square images fill the canvas. Narrow or rectangular images keep their aspect ratio and receive transparent padding instead of being stretched. Images whose width and height are both greater than 24 pixels are sent unchanged.
Sharp provides one mature decoding path for PNG, JPEG, GIF, WebP, TIFF, AVIF, and other supported formats. The plugin does not maintain separate handwritten image decoders.
Image normalization runs only when all of the following are true:
/v1/responses or /responsesgrok- (configurable via autoModelPrefixes)Optional plugin config:
hostnames: if set, only those hostnames are intercepted; an empty list means any hostmarkerHeader / markerValue: optional route marker, default x-dsh-grok-adaptation: v2The model-prefix check is mandatory. Gemini, Qwen, GPT, web-search, and other non-Grok requests are forwarded unchanged, even if they carry the marker.
Install the package into the DSH web profile:
dsh plugin --profile web add https://github.com/RailgunHamster/dsh-grok-adaptation.git
dsh plugin --profile web install
Restart dsh-web after installation. The package includes Sharp and its platform binary dependencies.
Add the marker only to the Grok route:
llm-pi-ai:
providers:
grok:
api: openai-responses
baseURL: https://api.example.com/v1
apiKeyEnv: GROK_API_KEY
headers:
x-dsh-grok-adaptation: v2
Do not add this marker to ordinary GPT or web-search provider routes.
To limit interception to one upstream host, set plugin config:
- id: grok-adaptation
config:
hostnames: ['api.example.com']
autoModelPrefixes: ['grok-']
The package contains no credentials. It uses the Authorization header already created by DSH.
pnpm install
pnpm run check
The tested cases include Grok 4.6 Responses requests with current-turn images and tool-result image replays, using PNG, JPEG, GIF, WebP, 1x16, 16x26, 16x32, and 16x16 inputs. Undersized images were normalized and the resulting requests completed successfully.
MIT
插件让 Grok 请求继续使用标准 Responses HTTP/SSE，不打开也不依赖 WebSocket。
对于 Responses message 或 function_call_output 中的每个 input_image，插件使用 Sharp/libvips 读取图片信息。如果图片任意一边不超过 24 像素，插件会：
正方形图片会填满画布。窄图或矩形图保持原始比例，使用透明留白，不会被强行拉伸。宽度和高度都大于 24 像素的图片原样发送。
Sharp 为 PNG、JPEG、GIF、WebP、TIFF、AVIF 以及其他支持的格式提供统一且成熟的解码路径。插件不再维护手写的格式专用解码器。
只有以下条件同时满足时才会进行图片规范化：
/v1/responses 或 /responsesgrok- 开头（可通过 autoModelPrefixes 配置）可选插件配置：
hostnames：若填写，则只拦截这些主机名；空列表表示不限制主机markerHeader / markerValue：可选路由标记，默认 x-dsh-grok-adaptation: v2实际生效仍以模型前缀为准。即使 Gemini、Qwen、GPT、web search 或其他非 Grok 请求带有该标记，也会原样转发，不会被修改。
将插件安装到 DSH web profile：
dsh plugin --profile web add https://github.com/RailgunHamster/dsh-grok-adaptation.git
dsh plugin --profile web install
安装后重启 dsh-web。插件依赖中包含 Sharp 及其对应平台的二进制依赖。
只给 Grok 路由添加标记：
llm-pi-ai:
providers:
grok:
api: openai-responses
baseURL: https://api.example.com/v1
apiKeyEnv: GROK_API_KEY
headers:
x-dsh-grok-adaptation: v2
不要给普通 GPT 或 web-search provider 路由添加这个标记。
如果只想拦截某一个上游主机，可以在插件配置里写：
- id: grok-adaptation
config:
hostnames: ['api.example.com']
autoModelPrefixes: ['grok-']
插件不包含任何凭据，使用 DSH 已经生成的 Authorization 请求头。
pnpm install
pnpm run check
已测试 Grok 4.6 Responses 请求，包括当前轮图片和工具结果图片回放，覆盖 PNG、JPEG、GIF、WebP、1x16、16x26、16x32 和 16x16 图片。小图经过规范化后，请求成功完成。
MIT