前言¶
DeepSeek Harness (DSH) Web GUI 的核心設計理念是「一切皆插件」。在開發或使用 DSH 進行對話時，處理文件附件是一個常見需求。原生上傳功能較爲侷限，且當模型不支持多模態時，圖片無法直接被理解。dsh-file-attachment 插件解決了這些問題：它接管了原生的附件上傳流程，支持拖拽、粘貼與點擊上傳，將圖片與文檔統一落盤，並通過 @絕對路徑 引用讓文本模型也能利用文件，同時爲非多模態模型提供 VLM 識別能力。
核心功能¶
該插件提供了完整的文件交互管線，主要能力如下：
- 多方式上傳：支持直接拖入文檔或圖片、使用
Ctrl+V粘貼、或點擊原生的 📎 附件按鈕進行多選上傳。插件已接管 DSH 本體的上傳按鈕。 - 統一落盤管理：圖片與文檔統一保存到會話工作區下的
.dsh-file-attachment/目錄。保存路徑格式爲<日期>/<清洗後文件名>，同一天內同名文件會自動追加序號。 - 輸入框內聯預覽：上傳後，輸入框上方會顯示內聯附件條。圖片以縮略圖展示（點擊可放大），文檔顯示類型圖標與文件名。點擊條目上的
×可移除附件條目，並同步清除輸入框中對應的@引用。 - 聊天區渲染：用戶消息中的
@圖片路徑會被渲染爲可點擊放大的縮略圖（Lightbox 效果），@文件路徑保持芯片樣式。 - VLM 智能識別：噹噹前會話模型不支持多模態時，插件會自動調用配置好的 VLM（Vision Language Model）對圖片進行識別，生成中文描述並回填到草稿區。若未配置 VLM API Key，則靜默跳過識別，不影響文件落盤。
- 跨平臺支持：支持 PC 瀏覽器與移動端瀏覽器。
安裝與啓用¶
通過官方 CLI 安裝該插件：
dsh plugin --profile web add @wszhoho/dsh-file-attachment
安裝完成後，重啓 DSH Web GUI 即可生效。
典型用法¶
- 拖入/粘貼：將文檔或圖片拖入輸入框，或直接從剪貼板粘貼，系統會自動落盤並在光標處插入
@引用。 - 多選上傳：點擊輸入框左側的 📎 按鈕，在系統文件選擇框中多選文檔或圖片，上傳後自動插入引用。
- 移除附件：點擊輸入框內附件條目旁的
×，可移除該附件並清除輸入框中對應的@路徑引用。 - 文本模型使用：即使當前模型不支持看圖，通過上傳圖片並配置 VLM，模型也能在生成回覆時引用圖片內容。
注意事項¶
- 不支持目錄：插件不支持直接拖入整個文件夾。
- 文件大小限制：單文件超過 50MB 時會被跳過並提示。
- 路徑依賴：文件保存路徑基於當前會話的工作區（
session.header.cwd），確保工作區目錄可寫。 - VLM 配置：使用 VLM 識別功能需在設置頁配置 API Key 與模型參數。
總結¶
wszhoho/dsh-file-attachment 是一個實用且專注的 DSH 插件，它規範了文件在 DSH 中的存儲與引用方式。對於需要處理文檔、代碼或圖片的 AI Agent 開發者，該插件能顯著提升交互體驗，降低多模態對接的門檻。
