ChatGPTClaudeGrok / X / CursorGemini

dsh-smart-download:DeepSeek Harness 的智能多线程下载插件

leisureyu/dsh-smart-download

工具与能力已验证
收录时间 2026-09-29
页面最后更新 2026-11-11

为 DeepSeek Harness 提供内置 aria2 的多线程下载插件,自动探测服务器能力选择并发或 curl 回退,支持断点续传与实时进度查询。

dsh-smart-download 是给 DeepSeek Harness 用的下载能力扩展,把一次文件下载变成自动决策的过程。它先探测目标服务器是否支持多连接,支持就调用随插件分发的 aria2c 并发加速,不支持或探测异常就安全回退到系统 curl,保证文件总能下完。除多线程加速外,它还提供断点续传、镜像前缀加速、按文件大小分档的并发数,以及可查询的进度快照;协议白名单与文件名净化让不可信 URL 也不会写到工作目录之外。

如何安装

install
npmdsh plugin --profile <your-profile> add @leisureyu/dsh-smart-dl

--profile 换成你本机实际使用的 profile 名(ls ~/.dsh/profiles/ 可查看目录名):浏览器版通常是 web,桌面版通常是 desktop 或 desktop-NNN。

分类
工具与能力
平台
DSH Plugin
作者
leisureyu
分发方式
插件

dsh-smart-download 核心特性

内置 aria2 多线程加速不支持时自动回退 curl零配置随插件安装断点续传与进度查询
Listed on dsh-plugin.org

dsh-smart-download 仓库简介

它是做什么的?

它是 DeepSeek Harness(DSH)的智能下载插件,把「下载一个文件」变成一次自动决策。它解决的是大文件下载慢、服务器不支持多线程、中途断线要重来的麻烦:下载前先探测目标服务器,能并发就用内置的 aria2 多线程加速,不能就自动回退到系统 curl,两种情况都能把文件下完。插件由 LeiSureYu 维护,采用 MIT 协议,用 TypeScript 编写,支持 Windows x64 / arm64 与 Linux x64 / arm64。

核心功能

  • 自动多线程加速:下载前先探测服务器是否支持多连接,支持则调用随插件分发的 aria2c 并发下载,不支持则回退到系统 curl 单线程,任何探测异常都按「不支持多线程」安全处理,不会让下载直接失败。
  • 零配置内置 aria2:aria2 二进制随插件一起安装,无需自行下载或配置 PATH,安装后即可使用。
  • 按文件大小分档并发:1MB 至 50MB 走 4 连接,50MB 及以上走 8 连接,返回结果里的 reason 会区分「不支持 Range」「文件太小」「aria2 缺失」等情况。
  • 进度可见与可查询:web profile 下界面右下角有实时进度面板,显示文件名、百分比、速度与剩余时间,完成后自动消失;download_status 工具可只读查询最近任务的百分比、速度与 ETA。
  • 断点续传与镜像加速:中断后用同样的 url 与 output 再调用一次即可续传,续传前会比对远端长度与 ETag / Last-Modified,无法证实同源就删掉半包重下;下载境外资源慢时可传入镜像前缀加速。
  • 安全边界:只允许 http / https 协议,file: 等协议在下载开始前直接拒绝;未指定输出名时按 URL 推导,且只取单个路径段,避免写到工作目录之外。

怎么使用这个插件?

在 DSH 中启用后,直接让模型调用 smart_download 并给出 url 即可,可选传入 output 指定保存文件名、传入 mirror 走镜像加速;下载完成后返回 success、path、method、size、fellback 等字段,其中 requestedUrl 是实际请求的地址,mirrored 标明本次是否走了镜像。想知道进度时调用 download_status,它会返回最近任务的百分比、速度与 ETA,可以回答「刚才那个下载到百分之几了」。若中途中断,用同样的 url 与 output 再调用一次即可续传。注意进度面板只在 web profile 生效,其他 profile 下功能不受影响,只是没有界面面板,仍可用 download_status 查询进度。

报错怎么排查?

  • 下载成功却报 ToolOutputError:早期版本探测不到文件大小时返回 size: undefined,会被宿主判为非法 JSON,按官方说明升级到修复版本即可。
  • 文件被写到工作目录之外:URL 路径穿越(如 ..%2F..%2F..%2Fescaped.txt)在旧版本可逃逸,现由「解码后再切分、只取最后一段并净化」拦截,请使用修复后的版本。
  • 本地文件被意外复制:file:// 协议曾被 curl 接受并复制本地文件,现由协议白名单在下载前拦截。
  • 目标文件已存在却拿到旧内容:aria2 曾另存为 f.1.bin 而返回的 path 仍指向旧文件,现统一带覆盖参数处理。
  • 续传后文件损坏:旧版本只要服务器支持 Range 就无条件续传,在「远端变小」「等长但内容变了」场景下会退出码 0 但文件是错的,现续传前先比对远端长度与 ETag / Last-Modified。
  • 进度面板一直显示「下载中」:旧版本进度记录缺少 state 字段,且未读取 DSH_HOME、无会话时写入无人读取的目录,现按会话写入进度目录并新增 cancelled 状态。

本页是基于该插件官方 README 独立重写的导读——权威文档和最新变更请以源头为准:leisureyu/dsh-smart-download。插件是安装时就在你机器上运行的第三方代码;收录不代表背书——安装前请自行审阅源码。

安装、更新、卸载这个插件,都在 DeepSeek Harness 的 DSH Plugin Hub 插件市场完成
ChatGPTClaudeGrok / X / CursorGemini

DSH Plugin 常见问题