DSH Web GUI 在遠程環境或容器中運行時,交付文件通常需要通過 SFTP 或 SCP 下載,或者先在側邊欄預覽再另存。dsh-save-button 在交付卡片上增加了一個下載按鈕,利用瀏覽器的下載管理器將文件直接寫入磁盤,無需額外的 SFTP/SCP 步驟。
插件介紹¶
定位: 爲 DSH Web GUI 交付卡片增加下載按鈕。
維護者: hanbernate。
許可證: MIT。
該插件通過在官方交付卡片上注入下載操作,解決遠程訪問時的文件傳輸痛點。它完全基於瀏覽器原生下載機制,不依賴任何構建步驟或外部庫。
安裝與啓用¶
- 安裝插件到 web profile:
dsh plugin --profile web add dsh-save-button
- 重啓 Web GUI 或刷新瀏覽器頁面,插件纔會生效。
使用方式¶
安裝後,交付卡片的官方 “Open” 按鈕右側會出現一個 “Download” 按鈕。每個被 present 聲明的文件都會對應一個下載按鈕。
- 下載: 點擊後,插件會先發送探查請求確認文件可用,隨後通過瀏覽器的下載管理器流式傳輸文件。文件名由 Host 的
Content-Disposition決定。 - 狀態反饋: 界面會顯示 “Preparing download…”、”Download started” 或 “Download failed”(失敗可點擊重試)。
- 不影響官方功能: 點擊卡片或 “Open” 仍可在側邊欄預覽;下拉菜單中的 “Open in default app” 和 “Open containing folder” 保持可用。
環境與限制¶
- 支持版本: 僅支持 DSH 以下 RC 版本:
- 0.1.5-rc.*
- 0.1.7-rc.*
- 0.2.0-rc.*
- 0.2.1-rc.*
- 文件來源: 只有在當前會話中通過
present聲明的文件才能被下載。 - 零依賴: 插件無構建步驟,無其他依賴。
卸載¶
dsh plugin --profile web remove dsh-save-button
卸載後刷新頁面,交付卡片將恢復爲官方渲染狀態。