前言¶
DeepSeek Harness (DSH) 採用插件化架構。在使用僅文本模型時,直接粘貼圖片往往只能顯示文件路徑,或者完全無法處理。dsh-paste-preview 解決了這個問題,它允許在文本模型中通過文件附件的形式處理圖片,同時保留縮略圖預覽。
插件定位¶
dsh-paste-preview 是一個 DeepSeek Harness (dsh) 網頁插件,由 wertyq111 維護。它將粘貼的圖片轉換爲縮略圖,並在發送消息後保持可縮放預覽。許可證爲 MIT。
核心功能¶
- 粘貼生成縮略圖:在輸入框粘貼圖片時,附件欄顯示縮略圖而非文件路徑。
- 兼容文本模型:當選用的模型不支持圖像輸入時,圖片會被重新封裝爲普通文件附件,由 DSH 存儲,工具(如
modlens_read_image)可讀取。支持視覺的模型保持原生路徑。 - 消息中顯示縮略圖:發送後的消息中會顯示可縮放的縮略圖,刷新頁面後依然存在。
- 多輸入方式:支持拖拽上傳和文件選擇器上傳。
安裝與啓用¶
- 執行安裝命令:
dsh plugin add dsh-paste-preview
- 安裝後需要重啓 DSH 才能生效。
使用注意¶
- 與 modlens 的兼容性:如果同時使用
@liustack/modlens,由於其默認的pasteToPath功能會攔截粘貼操作,需要在cordis.patch.yml中將其關閉:
- id: modlens
config:
pasteToPath: false
- 消息顯示機制:發送的消息縮略圖依附於 DSH 內置的文件卡片。如果 DSH 未來修改該組件結構,可能會退化爲純文件卡片。此外,在消息持久化完成前,可能會短暫顯示純文件卡片。
- 權限與校驗:插件的所有 HTTP 路由均通過 DSH 的
connection.requestRejection檢查,未認證請求返回 401。存儲的文件通過 DSH 的附件存儲讀取,會重新校驗名稱、大小和摘要。
結語¶
該插件通過巧妙的路由設計,彌合了視覺模型與文本模型之間的體驗鴻溝。如果你需要在純文本環境中處理圖片並保持交互體驗,可以參考文檔與源碼進行集成。