DSH Plugins Marketplace

DSH Plugins

Plugins

/

Tools & Capabilities

/

dsh-image-rescue

d

dsh-image-rescue

Manifest valid

When an image over the 8192 px per-side limit (or 64 MP) would make the Host reject the whole prompt, stores it byte-for-byte as a generic file and hands the model the saved path — no resize, no re-en

hasBundlePatch

dsh-image-rescue

大图不再被拒收:消息里显示为文件卡片,提示原图已按字节保留,模型拿到路径

DeepSeek Harness 会把"超过部署限额"的图片直接拒收:单边超过 8192px、总像素超过 6400 万、 或编码字节超过 20 MiB 时,整条消息发送失败(Web UI 提示:图片宽高不能超过 8192px,请缩小后重试)。 对"把 4 张扫描件转成 PDF""把这张长截图里的文字抄出来"这类任务来说,这个限制没有道理: 模型并不需要以视觉方式看完整分辨率,它需要的是拿到原图。

这个 Host 插件把拒绝改成"原图救回":

  • 尺寸合规的图片:完全走原有流程,行为不变(先调用原方法,正常消息不会多一次解码)。
  • 超限的图片:原始字节原样存为通用文件附件(不缩放、不重编码、不裁切、不改色彩配置), 模型收到该文件的只读路径与一行中文说明;它可以用 read_image 查看,也可以直接用 自己的工具(Python/Pillow、ImageMagick、img2pdf …)按原分辨率处理。
  • 被救回的图片在会话里表现为文件附件(文件名保留原扩展名),历史与后续轮次都能复用。
  • 超出单条消息图片数量/总字节上限的图片同样按文件保存,不再中断发送。

安装

dsh plugin --profile <profile> add dsh-image-rescue
# 或从本地目录安装
dsh plugin --profile <profile> add /path/to/dsh-image-rescue

安装后无需配置。重启 Host(或让插件管理器热加载)即生效。只在 Host 侧工作, 不需要客户端代码,所以桌面版和 Web 版行为一致。

已验证

2026-11-12,在运行中的 DSH Desktop(@deepseek-ai/dsh-desktop-runtime 0.2.1-rc.2) 上用真实 UI 自动化验证:

用例结果
9000×3000 JPEG(超过 8192 单边上限)通过:不再出现 8192 报错;消息显示为文件卡片 wide_9000x3000.jpg / JPG 321KB;会话日志记录 type:"file",bytes: 328873;磁盘对象 sha256 与源图一致
800×600 JPEG(对照)通过:仍然是普通图片附件,与未安装插件时一致

此外仓库内 npm test(13 项单元测试)与一份针对真实 @deepseek-ai/dsh-attachment-local 的集成测试(21 项断言:基线拒收、救回后字节一致、readFileStream 校验、损坏图片仍报错、 数量超限救回、卸载后恢复原生行为)全部通过。完整的证据记录见 docs/verification.md。

配置(全部可选)

字段默认含义
enabledtrue置为 false 可临时关闭救回,恢复 DSH 原生行为
note内置中文一句话每条被救回图片后附带的说明文本模板;false 表示不附加任何文本

模板占位符:{name} 文件名、{dimensions} 宽×高(头部可读时)、{size} 编码大小、 {limit} 当前单边像素上限。

- id: image-rescue
  name: dsh-image-rescue
  config:
    note: 'Original kept uncompressed at the path above ({dimensions}, {size}).'

能救回什么、不能救回什么

救回(原因为尺寸/数量/字节限额):IMAGE_DIMENSION_TOO_LARGE、IMAGE_TOO_MANY_PIXELS、 IMAGE_TOO_LARGE、IMAGES_TOO_LARGE、TOO_MANY_IMAGES。

不救回(保持原生行为,照常报错):损坏的图片字节、声明类型与内容不符、后端根本没有 逐字节文件存储(ATTACHMENT_FILES_UNSUPPORTED)——这些是真正需要用户修正的输入问题。

代价与限制

  • 被救回的图片不进入视觉通道:模型看不到缩略图,需要看时它得自己调用 read_image (DSH 的图片读取工具会自动降采样显示)。这正是"不压缩"的代价,也是本插件的目的。
  • 原图字节会完整落盘(内容寻址、只存一份),磁盘占用随之增加;DSH 不自动清理附件。
  • 依赖 Host 侧 ctx.attachments 的标准服务契约(0.2.x)。若别的插件把 admitPromptContent 整个替换掉且没有链接到本插件,救回不生效。

实现

apply() 在挂载时包装 ctx.attachments.admitPromptContent,并在服务被替换时重新包装; 正常路径直接把调用转发给原实现。拒收发生在逐图片校验时,包装层按图片重新分类:能过的照常 validateImage + saveImage,超限的走 saveFile(该路径本身没有限额),然后把文件块与 说明文本按原顺序交还给 Session Controller。卸载/停用插件时恢复原方法。

English

DeepSeek Harness rejects a whole prompt when any image exceeds its vision limits (>8192 px per side, >64 MP, >20 MiB encoded), which blocks ordinary jobs like "turn these four scans into a PDF". This Host-only plugin turns the rejection into rescue: compliant images are admitted exactly as before; oversized ones are stored byte-for-byte as generic file attachments (no resize, no re-encode), and the model receives the read-only path so it can read_image them or convert them at full resolution with its own tools.

Install with dsh plugin --profile <name> add dsh-image-rescue. Optional config: enabled (default true) and note (default a short Chinese line; false disables it). Corrupt or mismatched images still fail exactly as before — only size/count/byte limits are rescued.

License

MIT

Comments

Loading…

Similar plugins

dsh-auto-convert

Prepares files before read, read_image and the vision tools open them: downscales images over 2048 px or 8 MB (one retry at 1280 px within the same turn), converts BMP/TIFF to PNG, relabels mislabeled

Development & InfrastructureManifest valid

★ 0

dsh plugin --profile web add dsh-auto-convert

Splits over-long screenshots into DSH-acceptable slices before prompt admission instead of letting them be rejected: vertical slices overlap so a line of text is never cut in half, and pure-JS codecs

Tools & CapabilitiesVision & MultimodalManifest valid

★ 0

dsh plugin --profile web add dsh-longshot
dsh-wallpaper2

No screenshots

Persistent image or MP4 wallpaper for the DSH Web profile: a wallpaper card under Settings -> General selects a local image or MP4 (up to 300 MB), tunes surface opacity and blur, compresses video loca

Themes & SkinsUI & ExperienceTerminal & ClientsManifest valid

★ 0

↓ 58/wk

dsh plugin --profile web add @frog755/dsh-wallpaper

by callaumyan-design

Clamp every image sent to the model to a maximum side length (default 2000px) so Claude's many-image limit is never exceeded.

Manifest valid

★ 0

MIT

JavaScript

Oct 19, 2026

dsh plugin --profile web add dshx-image-clamp

by zhiwuli0228

Digests the images in a prompt with a vision model before admission, so any model — a text-only one included — can read them without the session ever switching models, and adds a describe_image tool f

Tools & CapabilitiesVision & MultimodalManifest valid

★ 0

MIT

JavaScript

Oct 30, 2026

dsh plugin --profile web add dsh-image-router

by whiteS18

Configure multiple image providers in Settings and call image_generate with the one selected model; images save under generate/image and show inline in the conversation.

Tools & CapabilitiesVision & MultimodalManifest valid

★ 0

↓ 156/wk

MIT

JavaScript

Sep 13, 2026

dsh plugin --profile web add dsh-image-generation