下载队列：aria2 与可选迅雷双引擎、磁力链接、按会话记录下载历史；aria2 不随包附带，需自行安装，迅雷引擎需自装 SDK 并提供 API Key；主要面向 Windows。

安装

# npm 包（预构建）

dsh plugin --profile web add @philomelcc/dsh-downloads

# GitHub 源码（首次需按提示配置 allowBuilds 构建授权后重试）

dsh plugin --profile web add github:philomelcc/dsh-workbench#path:/packages/download-center

装任何插件都等于在你的机器上跑第三方代码，权限和你本人一样大——能读你的文件、用你的凭据、访问网络，工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截，所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS；dsh 会打印出需要添加的确切键名，把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下，重跑一次即可装上。放行构建本身就是一次信任判断：请只安装可信来源，并尽量锁定 commit（github:owner/repo#sha）。

README

工作台模块：一个真正的下载队列——进度、暂停/继续/取消、磁力链接、Chrome 默认下载接管，以及每个会话下载过什么的记录。

安装

dsh plugin --profile web add @philomelcc/dsh-workbench
dsh plugin --profile web add @philomelcc/dsh-downloads

重启 Web UI，模块会加出下载标签。

引擎

来源	引擎
磁力 / `.torrent`	aria2（DHT + LPD，`--seed-time=0`）
HTTP / HTTPS	配了 API Key 时走迅雷 P2SP，否则 aria2 16 连接

本包不自带 aria2（GPLv2，5 MB 的二进制）。自己装好后模块会自动找到：

环境变量 ARIA2C_PATH 指向可执行文件，或
缓存副本 ~/.dsh/download-center/bin/aria2c[.exe]，或
winget install aria2.aria2 / scoop install aria2 后重启。

没有 aria2 时页面照样能开；磁力会给出可读错误，/wb/downloads/health 会说明原因。

迅雷引擎是可选的，也不是依赖（它带一个需要构建批准的原生模块）。有 API Key 就自己装：

npm i @xunlei-open/dlsdk @xunlei-open/dlsdk-native-windows-x64

凭据放在 ~/.dsh/secrets/xunlei.txt。没装 SDK 时磁力/HTTP 走 aria2，迅雷引擎给出可读错误，不影响页面。

端点

方法	路径	请求体
GET	`/wb/downloads/list`	—（任务 + 统计）
GET	`/wb/downloads/history`	—（会话记录）
GET	`/wb/downloads/health`	—（引擎路径、默认目录）
POST	`/wb/downloads/create`	`{ url, dir?, fileName?, backend? }`
POST	`/wb/downloads/pause` · `resume` · `cancel` · `remove`	`{ id }`
POST	`/wb/downloads/open`	`{ id, kind: 'file' \| 'dir' }`
POST	`/wb/downloads/register`	`{ … }` —— 供 `fast_download` 工具登记

所有路由只接受回环访问。

结构

index.js            Host：上面的路由
client.js           Client：页面 + registerView('downloads')
lib/tasks.js        任务表、状态机、持久化、历史记录
lib/engines.js      aria2 / 迅雷子进程引擎与进度解析
lib/xunlei*.mjs     迅雷 worker（独立进程，dll 崩了不带走 host）
chrome-extension/   可选的 Chrome 默认下载接管扩展
test/               client 侧冒烟测试

MIT。aria2 和迅雷 SDK 保持各自许可。

内容来自项目 README（GitHub）↗

链接

GitHub 仓库 ↗ npm 包 ↗ 通过 dsh-market 安装 ↗

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus；发表内容需要 GitHub 账号。

philomelcc/dsh-workbench#downloads

安装

README

安装

引擎

端点

结构

链接

同类插件

DayuanJiang/next-ai-draw-io#dsh-plugin★ 36802

Tencent/WeKnora#dsh-weknora★ 36302

superdesigndev/treg★ 7042

T-Auto/dsh-ops★ 5074

sixtysevenlf/dsh-blender-plugin★ 1575

TencentCloudBase/CloudBase-AI-Toolkit#dsh-plugin★ 1155

社区评论