DeepSeek Harness（DSH）的聊天編輯器原生沒有附件功能。如果不使用插件，常見的做法是把文件路徑寫進消息裏，讓模型去讀。這種做法有三個問題：容易失敗、污染你的原文、且模型未必真能讀取。dsh-upload-plugin 插件直接在編輯器裏增加了“附件”能力，讓模型能直接看到圖片或讀取文件內容，同時保持你的文本原樣。
這是一個 DeepSeek Harness 插件，由開發者 danhcng3822f 維護，採用 MIT 許可證。它解決了 DSH 原生編輯器缺乏附件交互的問題，通過兩種方式將內容傳遞給模型：圖片作爲原生草稿圖像，文件通過上下文注入塊。
核心功能¶
圖片與文件處理¶
插件提供了兩種主要的附件方式：
* 添加圖片：支持使用 /photos 命令或工具欄上的 [📷] 按鈕。圖片會作爲原生草稿圖像傳遞給模型，模型能直接看到圖片內容，不會在文本框裏生成額外的指令。
* 添加文件：支持使用 /files 命令或工具欄上的 [📄] 按鈕。文件會上傳到工作區，並在你的草稿中生成一個引用芯片，模型會通過上下文注入塊讀取文件內容。
會話歷史與工具欄¶
- 瀏覽歷史：使用
/uploads可以瀏覽當前會話中已上傳的文件列表，點擊即可重新引用。 - 快捷工具欄：[📷] 和 [📄] 按鈕直接出現在編輯器工具欄上，位於發送按鈕左側，方便快速操作。
模型配置支持¶
- Vision 設置：在 Settings 的 Vision 頁面中，可以爲每個模型勾選或取消“圖片輸入”能力。這會修改模型配置中的
input字段。 - 推理努力級別：插件支持模型推理強度的選擇，允許通過自定義選項擴展推理級別列表。
安裝與啓用¶
安裝¶
該插件需要運行在帶有 web profile 的 DeepSeek Harness 環境中。
dsh plugin --profile web add github:danhcng3822f/dsh-upload-plugin
安裝完成後，重啓 DSH 或重新加載 http://127.0.0.1:3080 即可生效。
使用方法¶
1. 附加圖片¶
點擊工具欄的 [📷] 或輸入 /photos，從本地選擇圖片文件（支持 .png, .jpg, .jpeg, .webp, .gif）。圖片會直接進入草稿區，模型在生成回覆時會將圖片作爲內容的一部分進行處理。
2. 附加文件¶
點擊工具欄的 [📄] 或輸入 /files，選擇文檔文件（支持 .txt, .pdf, .json, .csv 等）。文件會通過上下文注入塊傳遞給模型，模型會根據指令讀取文件內容。
3. 查看歷史¶
輸入 /uploads，系統會列出當前會話中已上傳的文件列表，點擊文件名即可將其重新引用到當前對話中。
4. 配置 Vision¶
進入 Settings -> Vision 頁面。爲需要讀取圖片的模型勾選 Vision 選項。這會更新模型配置，允許模型處理圖片輸入。
注意事項¶
- 內容注入機制：文件通過上下文注入塊傳輸，你的原始文本保持不變，不會被粘貼進去。圖片是 DSH 原生的草稿圖像。
- 單次發送：附件在每次發送時一次性注入，沒有待處理隊列。發送後，下一次消息除非重新附加，否則不會攜帶上次的指令。
- 環境要求：插件依賴 DSH 的
webprofile，並需要 Node.js 和 pnpm（用於源碼安裝）。
總結¶
該插件通過原生圖片處理和上下文注入，填補了 DSH 在文件附件上的空白。安裝與配置遵循標準 DSH 插件流程，適合需要在對話中頻繁交互文檔或圖片的場景。更多細節可查閱 GitHub 倉庫 或 社區目錄。
