dsh-file-transfer: Add Download and Upload Operations to DSH Document Preview

前言¶

在 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 许可证。