dsh-file-transfer：爲 DSH 文檔預覽添加下載與上傳操作

前言¶

在 DSH 的開發工作流中，開發者常需要在文檔預覽或文件樹管理中直接獲取文件或上傳素材。flyhigao/dsh-file-transfer 插件針對這一需求，在文檔預覽工具欄和文件行添加了原生的下載與上傳入口，省去了手動導出的步驟。

這是什麼¶

這是一個客戶端插件，由開發者 flyhigao 維護。它的核心價值是在 DSH 文檔預覽工具欄和文件夾行添加下載和上傳操作，從而簡化文件交互流程。

核心功能¶

1. 在 DSH 文檔預覽工具欄和文件夾行添加下載和上傳操作。
2. 下載當前預覽文件（文件夾爲 ZIP），保留原始文件名。
3. 上傳文件到工作區文件夾（支持多選，不遞歸）。
4. 限制：下載總大小 < 10 GiB，單文件上傳 < 1 GiB。
5. 流式傳輸上傳以避免瀏覽器內存緩衝。
6. 自動處理文件名衝突（添加 (n) 後綴）。

安裝與啓用¶

使用 DSH 官方命令安裝此插件：

dsh plugin --profile web add github:flyhigao/dsh-file-transfer

安裝後需要重啓 DSH Web 服務並刷新瀏覽器頁面以使插件生效。

典型用法¶

1. 打開文件預覽，點擊下載圖標保存文件。
2. 點擊文件夾行的上傳圖標，選擇文件並確認上傳。

注意事項¶

1. 需要安裝 DSH Web 0.1.7-rc.2 或更新版本。
2. 下載操作使用 DSH 的只讀 workspaceFiles 遠程。
3. 上傳操作通過插件主機路由進行，限制單文件大小爲 1 GiB。
4. 文件名衝突不會覆蓋現有文件，而是添加 (n) 後綴（例如 report(1).txt）。
5. MIT 許可證。