前言¶
Agent 在下载素材、模型、视频、GitHub 安装包时，单连接流式下载有三个老问题：慢，单连接吃不满带宽，几百兆的文件要等很久，还容易在超时边缘反复中断；拦，抖音、B站、小红书这类资源带防盗链，不补 Referer 直接 403；挂，Node.js 走系统证书库，Windows 上系统证书链损坏时，HTTPS 下载会报证书错误。
这个插件把这三件事一次性包进一个工具里，Agent 只需要给 URL 和目标路径。
它是什么¶
dsh-mt-download 是一个 DeepSeek Harness 插件，维护者是 643048695。它是一个多通道文件下载器，优先用 aria2c 开 16 个连接分块并发，拿不到就自动退回 Node.js 原生单流。
核心功能¶
主通道：aria2c 16 连接并发¶
插件会调用本机 aria2c 的 JSON-RPC（默认端口 127.0.0.1:16801），用 16 个连接分块并发下载。服务没起来时按需拉起，平时零占用。分块并发要服务端支持 Range，不支持时 aria2c 会自然退化成单连接，不会下坏文件。
备用通道：Node.js 原生单流¶
aria2c 不可用、或下载中途报错时，插件会自动改用 Node.js 原生 fetch 流式单连接落盘，保证文件最终能下完。
防盗链自适应¶
插件按域名自动注入 Referer（抖音 / B站 / 小红书 / 微博 / GitHub），并统一带现代浏览器 User-Agent。调用方也可以传自己的 headers 覆盖。
路径解析¶
目标路径可以是具体文件名，也可以是目录或带结尾斜杠的路径；给目录时从 URL 末段推断文件名。
结果回报¶
返回绝对路径、字节数、耗时、平均速度和实际走通的通道。
安装与启用¶
Web UI 的插件页填 github:643048695/dsh-mt-download，或命令行：
dsh plugin --profile <profile> add github:643048695/dsh-mt-download
配置¶
写在 profile 的 cordis.patch.yml 里本插件那一行的 config 下：
| 字段 | 默认值 | 说明 |
|---|---|---|
defaultConnections |
16 |
默认并发连接数（工具入参可逐个覆盖，范围 1–16，受底层引擎限制） |
timeoutSeconds |
600 |
默认超时秒数 |
aria2Port |
16801 |
aria2c JSON-RPC 端口 |
aria2Path |
"" |
aria2c 可执行文件绝对路径；留空则自动探测 |
checkCertificate |
true |
是否校验 TLS 证书；系统证书链损坏或内网测试可设为 false |
关于 aria2c 从哪来¶
插件不打包 aria2c 二进制，只负责找到并驱动本机已有的那份。查找顺序：
- 配置项
aria2Path - 环境变量
MT_ARIA2C_PATH/ARIA2C_PATH/DOUYIN_ARIA2C_PATH - 系统
PATH上的aria2c - 常见安装位置（Windows 的
Program Files\aria2、Motrix 内置目录；macOS/Linux 的/usr/bin、/usr/local/bin、/opt/homebrew/bin等）
一个都找不到时不会失败——直接走备用通道。
工具签名¶
download_file¶
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
url |
string | 是 | 下载地址 |
output_path |
string | 是 | 保存路径（文件名或目录） |
connections |
integer | 否 | 并发连接数，默认 16，范围 1–16 |
timeout_seconds |
integer | 否 | 超时秒数，默认 600 |
headers |
object | 否 | 自定义请求头，覆盖自动注入的同名项 |
返回：
{
"success": true,
"file_path": "C:\\path\\to\\file.bin",
"file_size_bytes": 25098,
"file_size_human": "24.51 KB",
"duration_seconds": 1,
"speed_human": "24.51 KB/s",
"method": "aria2c (16 并发通道)"
}
失败时返回 { "success": false, "error": "..." }，并带上两个通道各自的失败原因。
说明与限制¶
- aria2c 拉起来后是 detached 后台进程，插件退出不会主动关掉它；下次下载直接复用。
- 分块并发要服务端支持
Range。不支持时 aria2c 会自然退化成单连接，不会下坏文件。 - 自动注入的
Referer只覆盖几个已知站点，其他站点请自己传headers。 - 只做 HTTP/HTTPS 直链下载，不处理网页解析、m3u8 切片或登录态。
兼容性¶
Node.js >= 20。宿主侧只用到 tools 服务的 register，没有硬依赖，任何带工具注册表的 DSH profile 都能挂上。
适用场景¶
适合需要从多个网站下载大文件或需要处理防盗链的智能体开发场景。插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
结尾¶
这个插件通过主通道（aria2c 16 连接）和备用通道（Node.js 单流）的组合，解决了 Agent 下载慢、被拦、易挂的问题。
- 插件目录页：https://www.skillhub.cn/plugins/643048695/dsh-mt-download
- GitHub 仓库：https://github.com/643048695/dsh-mt-download
