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
卸载后刷新页面,交付卡片将恢复为官方渲染状态。