前言¶
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 许可证。
