azwosile/dsh-highres-vision

dsh-highres-vision

大肥鱼出来卖个萌

🐳 鲸鱼娘登场喵～ 如果这个小插件帮到了你，记得给仓库点个 ⭐ Star 喵！

星星越多，鲸鱼娘越开心，也会更有动力继续维护这个插件喵～ 💙

（求求啦喵～）

⚠️ 只给 DeepSeek 的视觉模型用。

2026-09-10 起视觉模型是 DeepSeek-V4.1-Flash（正式名 deepseek-flash）；

旧名 deepseek-v4-flash-vision-exp / deepseek-v4-flash 仍被接受，请求同样转由 V4.1-Flash 承接。

deepseek-v4-pro 官方不支持视觉。

DeepSeek Harness 高清识图增强插件 v0.3.2（本身也是由 deepseek v4 flash vision exp 开发()）

适配内核

内核版本 · 状态 0.1.2-rc.1（DSH Desktop 0.8.1 内置） · ✅ 已实测 0.1.5-rc.1（npm latest） · ✅ 已实测 0.1.5-rc.2（npm next） · ✅ 已实测 ≤ 0.1.1-rc.x · ⚠ 未实测

package.json 声明：engines.dsh: ">=0.1.2-rc.1"，另附 dsh.compatibility.dshReleases 逐版本表。

自验：node verify-kernel.mjs [内核树B] ... —— 26 项宿主契约逐条对比，退出码 0 表示不用改代码。

功能

1. 仅在 DeepSeek 系列模型下启用 按会话判定当前 provider / model，非 DeepSeek 时对那个 agent 屏蔽 highres_read， 也不注入 pre-step 提醒（不影响其它会话）。中途切换模型即时生效。 判定：provider 为 deepseek-official，或模型名含 deepseek（兜住第三方中转）。 判定不出时按 unknownModelPolicy 处理，默认 allow。

2. 自动抬升每模型图片预算 宿主适配器（官方 dsh-llm-deepseek）会按每个模型的 imagePixelBudget 把图片二次投影， 官方默认值只有 640000 像素（≈800×800）/ 1 MiB。 插件加载时逐条判定，只给 DeepSeek 系列且已声明 image 模态的条目补上 imagePixelBudget: 1690000（1300×1300）与 imageMaxBytes: 8388608（8 MiB）， 立即生效，无需重启。

• 写入目标只有 llm-deepseek 这一个 settings 命名空间（官方 DeepSeek 适配器自己的模型目录）；

ginka-* / amd 等 llm-pi-ai provider 结构上不会被碰

• 逐条白名单：id 或 name 不含 deepseek 的条目一律跳过
• 只抬不降、不动纯文本模型、不动显式 low 档、只在需要时才写盘

3. 放宽图片限制 源准入 + 规范化是两套独立预算，这里一起放宽，图片进附件库时不再被降采样。

• 源准入（超标直接拒收）：单图 32 MiB / 单边 8192px / 单请求 600 张 / inline 总量 64 MiB
• 规范化（存进附件库的那份）：像素上限 8192×8192（DSH 默认 2048×2048）/

长边 8192px / 编码字节 16 MiB（DSH 默认 4 MiB）

• 适配器：base64 累计 44 MiB

⚠️ 只改源准入是不够的 —— v0.3.0 就栽在这：3840×2160 通过准入后，

被规范化默认值砍成 2730×1536（丢 49.4% 像素），后面 1300 的分块是在降质源上做的。

v0.3.1 补上规范化预算后原样入库。

4. 高清分块识图 注册 highres_read 工具，自动定位当前会话最近一张用户图片，生成 整图 + ≤1300×1300 高清分块（overlap 自动 65 / 130 / 195px）后通过宿主 read_image 注入模型。 不覆盖宿主 read_image。用户发大图且模型未调用该工具时，agent/pre-step 会提醒。 工具参数：tile / overlap / skipWhole / maxTiles。

相对 v0.2.0 的改动

# · 改动 · 说明 1 · 分块基线 800 → 1300 · V4.1-Flash 的等效像素从 ≈800×800 / 384 token 提到 ≈1300×1300 / 1024 token。沿用 800 白丢约 62% 分辨率 2 · 新增「仅 DeepSeek 系列启用」 · 非 DeepSeek 会话下对该 agent 屏蔽 highres_read，切模型即时生效；不碰别的会话 3 · 新增自动抬升每模型图片预算 · 新增 lib/model-budget.js。不抬这段，1300 的分块会在发请求前被压回 800×800 4 · 修复失效配置键 · cordis.patch.yml 里 maxRequestImageBytes 在 harness 0.1.2-rc.1 已不存在（静默 no-op），改为 maxInlineRequestImageBytes 5 · 修复漏掉的规范化预算（0.3.1） · 只抬源准入不够：DSH 规范化默认把图压到 2048×2048 以内，3840×2160 入库即丢 49.4% 像素。补上 normalizedImageMax* 三个键 6 · 新增可配置项 · deepseekOnly / unknownModelPolicy / modelBudgetScope / tile / overlap / remind / remindThreshold / autoRaiseModelBudget / modelImagePixelBudget / modelImageMaxBytes 7 · 新增离线自检 · verify.mjs，不装插件也能跑 8 · 移除 router-standard 兼容说明 · 上游那套预设已不适配 V4.1-Flash

没变的部分：纯 Node 实现（依赖 jimp，不需要 Python / Pillow）、不覆盖宿主 read_image、

识别后清理本次临时目录而不动附件库。

相对 v0.3.1 的改动

# · 改动 · 说明 1 · 修复「不传参数自动取会话最近一张图」恒失败 · findLatestSessionImage() 读的 session.events 在 harness 0.1.2-rc.1 的 Session 上不存在（只有 snapshotEvents() / ownEvents() / eventAt() / seq），判定恒为 undefined → 不传参数的调用一律返回 file_path/image/attachmentId is required。改用 session.snapshotEvents()，保留 events 作更旧内核回退 2 · `verify.mjs` 补上该路径的回归用例 · 之前只测 tile / model-budget / model-detect 三块纯函数，所以这个缺陷从 v0.2.0 一路带到 v0.3.1。现在导出 sessionEvents / findLatestSessionImage 并直接断言 3 · 声明适配内核 · package.json 加 engines.dsh: ">=0.1.2-rc.1" 与 dsh.compatibility.dshReleases 逐版本表 4 · 新增 `verify-kernel.mjs` · 26 项宿主契约在任意几棵内核树上逐条对比，判断「换内核要不要改代码」

影响面：带 file_path 或 attachmentId 的显式调用一直是好的，

坏的只有「让插件自己去会话里找最近一张用户附图」这条最省事的路径。

配置

- id: dsh-highres-vision
  name: dsh-highres-vision
  config:
    deepseekOnly: true               # 只在 DeepSeek 系列模型下启用
    unknownModelPolicy: allow        # 判定不出模型时：allow | deny
    autoRaiseModelBudget: true       # false = 不抬模型预算
    modelBudgetScope: deepseek       # deepseek = 只改 DeepSeek 条目；all = 该命名空间全部
    modelImagePixelBudget: 1690000   # 1300 x 1300
    modelImageMaxBytes: 8388608      # 8 MiB
    tile: 1300                       # 单块最大边长；旧基线可设 800
    overlap: 0                       # 0 = 自动
    remind: true                     # false = 关闭 pre-step 提醒
    remindThreshold: 1300            # 缺省与 tile 一致

modelImagePixelBudget 需要与 tile 同批调整。

边界：插件只抬预算，不改模型名与模态。模型没写 inputModalities: [text, image]

时按内核规则视为纯文本而跳过，需要你自行添加。

安装

git clone https://github.com/azwosile/dsh-highres-vision.git
dsh plugin --profile web add ./dsh-highres-vision

装配后重启 DSH Desktop 一次（放宽准入限制的 bundle 补丁只在启动时组合）。 Node >= 18，依赖 jimp 安装时自动装好，不需要 Python / Pillow。

自检（不装插件也能跑）：

node verify.mjs            # 自包含合成图，预期 112 通过 / 0 失败
node verify.mjs <样本目录>  # 额外跑本地真实图片
node verify-kernel.mjs <内核树A> [内核树B] [...]   # 内核契约对比，退出码 0 = 全部一致

回滚

dsh plugin --profile web remove dsh-highres-vision

（装了超级注入器的话也可以用 dev_uninject_plugin dsh-highres-vision）

预算抬升写进 settings.yaml 后不会随卸载自动撤销，需手动删掉那两个字段或走 Models 页重置。

dsv4fv开发