DeepSeek Harness (DSH) Web 提供了一個插件化界面，但原生文件處理通常需要截圖保存或手動複製文件路徑。dsh-file-upload 插件通過提供直觀的上傳按鈕和拖放支持，簡化了這一過程。
這是一個由 666emmm 維護的插件，旨在爲 DSH Web 添加文件上傳和剪貼板路徑管理功能。
核心功能¶
插件支持以下操作：
- 上傳方式：通過界面圖標點擊或直接拖拽文件、圖片或文件夾到 DSH 窗口。支持多選文件。
- 智能路由：根據當前模型是否支持圖片，自動決定將文件發送到官方附件 rail 或作爲路徑文本插入。
- 圖片處理：支持的圖片格式（PNG/JPEG/WebP/GIF）會被歸檔到附件目錄並添加到官方附件 rail。系統會自動生成
file_id，支持同一圖片的複用。 - 文件管理：在設置卡片的“文件上傳”區域，可以瀏覽附件庫（支持圖片/文件/文件夾標籤），查看原始名稱、大小、修改時間，並支持一鍵複製
@path引用或刪除文件。 - 剪貼板路徑讀取（零拷貝）：在操作系統文件管理器中複製文件或文件夾後，點擊界面上的剪貼板按鈕，插件會直接讀取系統剪貼板中的真實路徑並插入
@path引用。這避免了文件內容的實際傳輸和磁盤佔用。 - 文件夾支持：支持拖拽文件夾，插件會遞歸讀取內容並在附件庫中重建文件夾結構。
安裝與啓用¶
使用官方 bundle 安裝命令即可完成安裝。此命令要求 dsh web 正在運行。
dsh plugin --profile web add "github:666emmm/dsh-file-upload#main"
安裝後，重啓 dsh web 以加載插件。
典型用法¶
- 上傳文件：點擊輸入框旁的上傳圖標，在系統文件選擇器中多選文件或文件夾。
- 拖拽操作：直接將文件或文件夾拖拽到 DSH 窗口的任意位置。
- 路徑引用：在文件管理器中複製文件路徑，點擊剪貼板按鈕，將
@path引用插入到光標處。
注意事項與限制¶
- 文件大小限制：
- 單文件上傳限制爲 64 MB，這是 DeepSeek Files API 的硬性限制。
- 本地附件存儲默認限制爲 20 MB。超過 20 MB 的圖片會通過路徑文本發送，模型仍可通過
read_image讀取。
- 存儲位置：上傳的文件默認歸檔至
~/Documents/DSH/Attachments/images/<YYYY-MM-DD>/（圖片）或.../files/<YYYY-MM-DD>/（其他文件）。該路徑可在設置中配置。 - 加載器 ID：該插件的加載器註冊 ID 爲
file-upup，而非file-upload。DSH 內置的file-upload佔用了file-uploadID，因此必須使用file-upup以避免啓動時出現重複 ID 衝突。 - 公共上傳：默認情況下，插件只允許同源訪問（CSRF 安全）。如需通過端口轉發或公網訪問，需在設置中開啓“允許公共上傳”選項。
該插件通過提供零拷貝路徑讀取和直觀的上傳界面，降低了 DSH Web 中文件交互的門檻。更多詳情可查看插件目錄或源碼倉庫。
