DeepSeek Harness 插件：@leisureyu/dsh-smart-dl

前言¶

DeepSeek Harness (DSH) 的插件生态旨在解决特定场景下的开发与运维需求。在处理外部资源下载时，手动配置 curl 或 aria2 往往需要额外的环境设置。@leisureyu/dsh-smart-dl 插件解决了这个问题，它内置了 aria2，通过一个命令即可完成安装与配置，支持大文件多线程加速、断点续传以及内容校验。

插件概览¶

插件名称：@leisureyu/dsh-smart-dl
维护者：LeiSureYu
分类：联网工具
核心价值：零配置，内置 aria2，自动回退到系统 curl，支持断点续传与内容校验。

安装与启用¶

安装过程需要使用 DSH 的插件管理命令。

在 DSH 界面侧边栏选择「插件」。
点击「添加插件」，粘贴包名 @leisureyu/dsh-smart-dl。
点击「安装」，安装完成后重启 DSH 一次。

也可以直接在命令行中执行：

dsh plugin --profile web add @leisureyu/dsh-smart-dl

对于桌面版（DeepSeek Harness 0.2.0 起），建议使用桌面版自带的 CLI 路径进行安装：

& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add @leisureyu/dsh-smart-dl

安装后无需任何额外配置，aria2 二进制文件通过 npm 的 optionalDependencies 机制随插件一起安装。

核心功能¶

该插件提供了以下能力：

多线程下载：利用内置的 aria2c 进行多连接下载，加速大文件传输。
自动回退：当目标服务器不支持多线程时，自动回退到系统自带的 curl 单线程下载。
断点续传：支持中断后通过相同的 url 和 output 进行续传。
进度面板：在带 Web 界面的 profile（web / desktop）中，右下角会显示实时进度面板（文件名、百分比、速度、剩余时间）。
进度查询：提供 download_status 工具，用于只读查询最近任务的进度状态。
批量下载：支持通过 targets 参数一次下载多个文件，可设置 maxBandwidth 限制整批带宽，设置 timeoutMs 设置单条目超时。
SHA-256 校验：支持传入 sha256 参数，下载后逐字节核对文件完整性。
自定义请求头：支持 UserAgent、Referer 和自定义 Headers。
镜像自动选择：设置 mirror: "auto" 时，插件会从内置候选表中选择一个与原地址同源的镜像。
跨平台支持：支持 Windows x64/arm64 与 Linux x64/arm64。

典型用法¶

安装完成后，插件会注册两个工具：smart_download 和 download_status。

单文件下载¶

最简单的用法是直接传入 URL。为了确保文件完整性，建议同时传入 sha256。如果下载地址是 GitHub，可以使用 mirror: "auto" 自动选择镜像。

smart_download(
  url: "https://github.com/owner/repo/releases/download/v1.4.0/tool.zip",
  sha256: "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
  mirror: "auto"
)

批量下载¶

使用 targets 数组可以一次性下载多个文件。

smart_download(
  targets: ["url1", "url2"],
  maxBandwidth: 1024,
  timeoutMs: 5000
)

注意事项¶

macOS 限制：macOS 能安装并使用该插件，但由于平台限制，其底层下载逻辑永远走 curl 单线程。
进度面板限制：进度面板只在带 Web 界面的 profile 生效（web / desktop），纯 CLI profile 下无法显示界面面板，但命令行功能不受影响。
权限说明：插件以当前 DSH 进程的权限运行。在安装前，应检查源码与许可证，确保符合你的使用规范。