前言¶

DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。在使用視覺模型處理圖片時，默認的適配器限制較爲嚴格：每張圖片的像素預算通常只有 640000（約 800×800），最大文件大小限制在 4MiB。這導致高分辨率圖片在入庫或傳輸時會被降質，影響識別精度。

dsh-highres-vision 是針對這一痛點的補丁插件。它主要解決兩個問題：一是放寬 DeepSeek 系列模型的圖片准入與存儲限制，二是提供 highres_read 工具以分塊方式讀取大圖。

插件概述¶

• 插件名稱：dsh-highres-vision
• 維護者：azwosile
• 分類：模型推理
• 開源協議：MIT
• 核心功能：僅在 DeepSeek 系列模型下啓用，自動抬升圖片預算，提供高清分塊識圖工具。

核心功能¶

1. 限定模型範圍
   插件僅在 DeepSeek 系列模型下啓用。判定邏輯爲 provider 爲 deepseek-official，或模型名包含 deepseek。非 DeepSeek 會話會自動屏蔽 highres_read 工具，且不會影響其他會話。若判定失敗，默認策略爲 allow。

2. 自動抬升每模型圖片預算
   插件加載時會檢查 DeepSeek 系列模型配置，並自動補全以下字段：

   • imagePixelBudget: 1690000（1300×1300 像素）
   • imageMaxBytes: 8388608（8 MiB）
     這些配置會寫入 settings.yaml 中的 llm-deepseek 命名空間，且無需重啓即可生效。

3. 放寬圖片限制
   插件同時放寬了圖片的源准入限制與規範化限制：

   • 源准入：單圖 32MiB，單邊 8192px，單請求 600 張，inline 總量 64MiB。
   • 規範化：像素上限 8192×8192（DSH 默認 2048×2048），長邊 8192px，編碼字節 16MiB。
   • 注意： 僅放寬准入是不夠的，插件會同時處理規範化限制，避免圖片入庫後被二次壓縮。

4. 高清分塊識圖
   插件註冊了 highres_read 工具。當用戶發送大圖且模型未調用該工具時，系統會自動定位會話最近一張用戶圖片，生成「整圖 + ≤1300×1300 的高清分塊」並通過宿主的 read_image 注入。分塊重疊度可配置（默認自動）。插件不覆蓋宿主的 read_image 方法。

安裝與啓用¶

插件依賴 Node.js 環境和 jimp 庫。安裝前請確保 DSH 內核版本 >= 0.1.2-rc.1。

1. 克隆倉庫：

    git clone https://github.com/azwosile/dsh-highres-vision.git

2. 添加插件：

    dsh plugin --profile web add ./dsh-highres-vision

安裝完成後需重啓一次 DSH Desktop，以使放寬准入限制的 bundle 補丁生效。

配置示例¶

在 DSH 的插件配置中添加以下 YAML 結構。modelImagePixelBudget 需要與 tile 保持一致。

- id: dsh-highres-vision
  name: dsh-highres-vision
  config:
    deepseekOnly: true               # 僅在 DeepSeek 系列模型下啓用
    unknownModelPolicy: allow        # 判定失敗時的策略：allow | deny
    autoRaiseModelBudget: true       # 是否自動抬升模型預算
    modelBudgetScope: deepseek       # 調整範圍：deepseek | all
    modelImagePixelBudget: 1690000   # 像素預算 (1300x1300)
    modelImageMaxBytes: 8388608      # 最大字節 (8 MiB)
    tile: 1300                       # 分塊邊長
    overlap: 0                       # 0 爲自動重疊
    remind: true                     # 是否開啓 pre-step 提醒
    remindThreshold: 1300            # 提醒閾值

自檢與回滾¶

1. 自檢腳本（不安裝插件亦可運行）：

    node verify.mjs
    node verify.mjs <樣本目錄>
    node verify-kernel.mjs <內核樹A> [內核樹B] ...

其中 `verify-kernel.mjs` 用於對比宿主契約，退出碼 0 表示無需修改代碼。

2. 回滾卸載：

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

注意事項¶

• 模型支持：插件僅適用於 DeepSeek 的視覺模型。自 2026-09-10 起，視覺模型正式名爲 deepseek-flash（DeepSeek-V4.1-Flash）。舊名仍兼容，但 deepseek-v4-pro 官方不支持視覺。
• 配置殘留：插件寫入的預算配置在卸載後不會自動從 settings.yaml 中刪除，需手動刪除對應字段。
• 內核版本：最低要求內核版本 0.1.2-rc.1。