前言¶
在 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-apiproxy 的 attachment-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_glance、vision_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)。無需額外配置項。
典型用法¶
- 像平時一樣粘貼或拖入圖片,附件卡片可預覽、可移除;
- 拖入或粘貼 PDF、Office、zip、視頻、音頻等文件,附件欄出現格式方塊;
- 輸入消息(可選),點擊發送——不會發送附件塊,圖片與文件上傳至
.drops/,路徑自動追加到消息; - 若已安裝 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 的開發者,它減少了「保存 → 手打路徑」的重複操作。