前言¶
DeepSeek Harness（DSH）採用插件化架構，其生態由社區插件組成。在開發或使用 Harness 管理文件時，從 Files 樹或文檔預覽中導出文件，或在本地打包文件夾，通常是手動操作或需要額外的腳本。下面介紹的 dsh-file-download 插件直接在 Harness 的界面中集成了下載功能，解決了這一痛點。
它是什麼¶
dsh-file-download 是一個獨立維護的社區插件，由 lorsabyan 開發。它爲 Harness 的 Files 樹和文檔預覽添加了一個下載按鈕。通過這個插件，你可以直接保存任意常規文件，或者將整個文件夾（包含嵌套文件和空文件夾）打包爲 ZIP 下載。插件不依賴任何服務器端點、遙測數據或外部文件上傳。
核心功能¶
- 文件下載：在 Files 樹或文檔預覽中，點擊下載按鈕即可保存文件。
- 文件夾打包：選中文件夾並點擊下載，瀏覽器會生成
文件夾名.zip。ZIP 包含原始文件、擴展名以及所有嵌套結構（包括空文件夾）。 - 預覽下載：在文檔預覽工具欄中選擇 Download，可下載原始文件（例如在預覽 DOCX 時下載原
.docx文件）。 - 傳輸控制：下載過程中可以隨時點擊按鈕取消傳輸。
- 權限繼承：插件僅作爲 Harness 的客戶端擴展，繼承 Harness 安裝的現有權限，不引入額外的安全風險。
安裝與啓用¶
此插件需要你已安裝 Harness web 實例、dsh CLI 以及 pnpm。
- 從 v0.2.0 下載
dsh-file-download-0.2.0.tgz。 - 在文件所在目錄執行安裝命令（根據你的實際 profile 修改 web）：
dsh plugin --profile web add ./dsh-file-download-0.2.0.tgz
- 重啓 Harness web 服務器並刷新瀏覽器。
安裝完成後，可以通過以下命令驗證註冊：
dsh --profile web --dump-config
檢查輸出中是否包含 dsh-file-download 配置項。
典型用法¶
- 單個文件：在 Files 樹中找到文件，點擊其旁的下載圖標。如果點擊的是文件名，則打開原生預覽。
- 整個文件夾：點擊文件夾旁的下載圖標，瀏覽器會保存
文件夾名.zip。文件夾的展開/收起功能依然可用。 - 預覽下載：在文檔預覽的工具欄中選擇 Download。例如，在 DOCX 預覽頁面下載原始 DOCX 文件。
- 取消下載：在傳輸過程中點擊按鈕，提示會顯示進度，狀態消息會報告完成或錯誤。
兼容性與限制¶
- 文件大小：小於 32 MiB 的文件使用瀏覽器正常的下載行爲。超過 32 MiB 的文件會通過 Chrome 或 Edge 的保存對話框選擇目標文件後進行流式傳輸。
- 瀏覽器支持：Chrome 和 Edge 在安全上下文中支持大文件的流式傳輸和文件夾的即時保存對話框。其他瀏覽器通常支持小於 32 MiB 的 ZIP 下載。
- ZIP 限制：生成的 ZIP 存檔受以下限制：
- 大小：小於 4 GiB
- 條目數：小於 10,000 個
- 嵌套層級：小於 64 層
- 元數據預算：小於 8 MiB
- 錯誤處理：如果源文件列表不完整、文件不可讀、是符號鏈接或不支持的條目，插件會報錯而不是生成不完整的 ZIP。
- 許可證：MIT 許可證。
