前言¶
DeepSeek Harness 的架構以插件爲中心。在 Web Composer 的使用場景中，處理本地文件通常需要特定的工具支持。dsh-local-file-upload 插件解決了從 Web 界面直接將本地文件上傳到當前 Session workspace 的需求，使 Agent 能夠直接調用這些文件。
這是什麼¶
這是一個客戶端插件，由 zhangbo1201 維護。它通過在 Web Composer 工具欄添加上傳按鈕，實現本地文件到 DSH workspace 的流轉。
安裝與啓用¶
在安裝之前，請確保當前使用的是 Web profile。
dsh plugin --profile web add dsh-local-file-upload
安裝完成後，必須重啓當前活躍的 dsh web 進程，工具欄中的上傳按鈕纔會出現。
核心功能¶
該插件提供了以下能力：
- 輸入方式：支持在工具欄中一次選擇多個文件，或直接在 composer 中使用
Cmd+V/Ctrl+V粘貼普通文件。圖片格式（PNG/JPG/WebP/GIF）會走 DSH 原生的圖片附件路徑，其他文件則通過此插件處理。 - 存儲路徑：文件會被寫入當前 Session workspace 下的
.dsh-uploads/目錄。 - 文件命名：系統會自動分配無衝突的文件名，防止覆蓋現有文件。存儲的文件名會自動淨化，移除路徑分隔符、空格和
@符號。 - 安全限制：插件會拒絕上傳符號鏈接目錄，並在 Host 端驗證解碼後的字節計數。
使用與注意事項¶
上傳成功後，composer 中會自動追加 @.dsh-uploads/<name> 標記，這可以直接被 dsh-at-file 和 agent 文件系統工具使用。
需要注意以下幾點：
- 單文件限制：每個文件的傳輸限制爲 10 MiB。
- 本地傳輸：文件傳輸僅通過本地 DSH loopback 連接進行，不會上傳到任何雲服務。
- 清理：上傳的文件會保留在 workspace 的
.dsh-uploads/目錄中，直到被手動移除。建議將此目錄添加到項目的.gitignore中，以避免誤提交敏感文件或大文件。
