dsh-drop-to-path:把圖片與文件以工作區路徑交給純文本模型

前言

在 DeepSeek Harness(DSH)裏用純文本模型(例如 deepseek)時,常見做法是截圖後手動保存到工作區,再把路徑敲進對話。DSH 原生的圖片附件會走模型側的多模態通道;純文本模型在發送前會被 attachment-error 預檢攔截,Composer 會提示「The current model does not support images; switch to a model that supports images.」

PDF、Office、壓縮包、視頻、音頻等非圖片文件,DSH 本身也不接受作爲附件。社區裏已有 dsh-drag-and-drop 等插件,但拖拽時插入的是已有文件的原始路徑,不做複製,圖片仍按附件發送,粘貼也不支持。

下面介紹 dsh-drop-to-path(維護者 loudMore,SkillHub 分類:模型推理)。它保留 DSH 原生附件 UI,在點擊發送時才把圖片和文件轉爲工作區路徑,讓純文本模型通過 vision / 文檔工具讀取內容。配合 dsh-vision-toolkit 時,粘貼截圖即可看圖,無需手打路徑。

這是什麼

dsh-drop-to-path 是 DSH Web profile 插件(@dsh-external/dsh-drop-to-path,版本 0.1.0,MIT 許可證)。定位一句話:拖入或粘貼圖片與各類文件,發送時自動上傳至工作區並追加路徑到消息正文,模型只收到純文本,不觸發圖片附件預檢。

GitHub 倉庫:https://github.com/loudMore/dsh-drop-to-path
社區目錄頁:https://www.skillhub.cn/plugins/loudMore/dsh-drop-to-path

核心功能

繞過純文本模型的圖片預檢

插件不向模型發送圖片附件塊,發送前把圖片上傳到 <workspace>/.drops/,路徑追加到消息末尾。因此不會觸發 dsh-host-apiproxyattachment-error 預檢。

保留原生附件體驗

  • 圖片png / jpg / jpeg / webp / gif,上限 30MB):仍顯示原生附件卡片,可預覽、可移除。
  • 其他文件(文檔、壓縮包、視頻、音頻,上限 100MB):在附件欄顯示帶格式圖標的方塊 chip,懸停可見完整文件名,點 ✕ 可移除。

添加文件時 Composer 裏不會出現路徑文字;路徑僅在點擊發送時追加。

支持的文件類型

類型 擴展名 大小上限
圖片 png jpg jpeg webp gif 30MB
文檔 pdf doc docx xls xlsx ppt pptx txt md csv json 100MB
壓縮包 zip 100MB
視頻 mp4 mov webm mkv avi 100MB
音頻 mp3 wav flac m4a 100MB

支持粘貼與拖拽,圖片、文件及混合批次按順序上傳,最終合併爲一段路徑文本發送。上傳失敗會顯示可見提示,不會靜默吞掉消息。

與 dsh-vision-toolkit 配合

dsh-vision-toolkit 提供 vision_glancevision_pixel_diff 等 vision 工具,但工具入參是工作區文件路徑。本插件負責「附件 → 路徑」,vision-toolkit 負責「路徑 → 看圖 / OCR / 像素對比」。README 建議兩者一起安裝。

安裝與啓用

環境要求:DeepSeek Harness(Web profile)、Node.js、dsh CLI。

推薦通過 dsh plugin 安裝:

dsh plugin --profile web add /path/to/dsh-drop-to-path

也可手動寫入 package.json 依賴、dsh.profile.bundles,並將目錄複製到 profiles/<name>/node_modules/@dsh-external/dsh-drop-to-path,詳見倉庫 README。

安裝後需重啓 Web profile(重新啓動 launcher 或重啓 dsh web)。無需額外配置項。

典型用法

  1. 像平時一樣粘貼或拖入圖片,附件卡片可預覽、可移除;
  2. 拖入或粘貼 PDF、Office、zip、視頻、音頻等文件,附件欄出現格式方塊;
  3. 輸入消息(可選),點擊發送——不會發送附件塊,圖片與文件上傳至 .drops/,路徑自動追加到消息;
  4. 若已安裝 dsh-vision-toolkit,Agent 可通過 vision 工具讀圖,通過 PDF / 表格工具處理文檔。

文件存放在 <workspace>/.drops/,可按需自行清理。

適用場景與注意

適合誰

  • 在 DSH 裏使用純文本模型,但需要頻繁發送截圖、PDF、表格、視頻等;
  • 已安裝或計劃安裝 dsh-vision-toolkit,希望實現「粘貼即看圖」;
  • 需要比 dsh-drag-and-drop 更完整的粘貼 + 自動複製 + 非圖片文件支持。

與 dsh-drag-and-drop 的區別

dsh-drag-and-drop 適合引用工作區裏已有的文件路徑;本插件適合發送新截圖和新文件,並自動複製到工作區。兩者可互補使用。

安全提示

插件以當前 DSH 進程權限運行,會向工作區寫入文件。安裝前請閱讀源碼與 MIT 許可證,確認行爲符合預期。SkillHub 爲獨立社區目錄,與 DeepSeek / 幻方無官方從屬關係。

結尾

dsh-drop-to-path 把 DSH 原生附件 UI 與純文本模型的路徑式工具鏈銜接起來:圖片保留預覽體驗,其他文件以方塊 chip 展示,發送時統一轉爲工作區路徑。對依賴 dsh-vision-toolkit 的開發者,它減少了「保存 → 手打路徑」的重複操作。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜