MIT 协议的 DSH 插件(dsh-dl-server),把下载做成常驻的会话感知队列:立即返回 job id、可暂停 / 续传 / 取消、断点存在 DSH 存储、可选 aria2 16 路分段、镜像回退与按请求自定义头。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-11-21
许可证
MIT
01它能帮你完成什么?
下载大文件时不再依赖会话或单轮对话存活
立刻返回 job id,进度、目标路径与断点持久化在 DSH 存储里,跨会话结束与重启都能继续
经常拉模型、数据集或媒体归档,受够「会话一结束下载就断」的 DeepSeek Harness 用户
一次排队多个下载,再由 agent 统一等待
连续发起十次 enqueue 而不阻塞,然后用 `download_wait` 带超时地等到终态
在一轮对话里批量抓论文、数据集、Release 产物的 agent 与用户
02如何接入 DeepSeek Harness?
前置条件
- DeepSeek Harness 0.2.1-rc.5 或更高版本(README 写明的最低宿主版本)
- `dsh` 在 PATH 中,否则改用应用内的 UI 安装路径
- 强烈建议安装 aria2:没有它插件退回单流传输,速度大约只有十分之一
安装步骤
- 01
推荐路径:设置 → 插件 → 安装第三方插件 → 添加插件,输入 `dsh-dl-server@0.4.0` 并确认。
- 02
或用命令行:`dsh plugin add dsh-dl-server@0.4.0`(务必锁定版本号,不写版本时 pnpm 可能解析到缓存里的旧版本)。
$ dsh plugin add dsh-dl-server@0.4.0
- 03
重启一次 DSH,让插件完成挂载。
验证接入成功
作者未说明
03DSH 适配与能力边界
原生 DSH 插件(npm 包 `dsh-dl-server`),向宿主注入下载队列服务与 7 个 `download_*` 工具
持久化队列(7 个工具)
URL、目标路径、可选请求头→job id,以及 `download_status` / `download_wait` / `download_pause` / `download_resume` / `download_cancel` / `download_cleanup`
任务记录与断点写入 DSH 存储,而不是在用户主目录里丢锁文件镜像回退与冷却
GitHub Releases / HuggingFace / raw.githubusercontent / PyPI 链接→在原地址之后自动尝试回退镜像,原地址始终排在最前
同一主机连续两次失败会被停用 10 分钟自定义请求头
可选的 `headers` 对象(`Referer`、`Cookie`、`User-Agent` 等)→请求头会用于源站探测、镜像探测、aria2 下载与单流回退
头的值可能是会话 cookie;任务输出只列名字,值留在传输层与本地存储
04适合谁?何时不该用?
适合
- 经常拉模型、数据集或媒体归档,受够「会话一结束下载就断」的 DeepSeek Harness 用户
- 在一轮对话里批量抓论文、数据集、Release 产物的 agent 与用户
不适合
- `download_cleanup` 在 `scope="all"` 时会连已下载的文件一起删掉;默认的 `allWithoutFiles` 只删记录。请明确选择范围。
05兼容性、维护与安全提示
- `download_cleanup` 在 `scope="all"` 时会连已下载的文件一起删掉;默认的 `allWithoutFiles` 只删记录。请明确选择范围。
- 归属按会话划分:机器上任何会话都能看到所有任务,但只有发起任务的会话能暂停、续传或取消。
MIT · 活跃维护(最新 release v0.4.1,2026-11-15;README 安装示例仍写 0.4.0)
06常见问题
为什么我的下载一结束会话就断了?
因为多数 DSH 下载插件就是一个阻塞到文件落地的工具函数。DLS 做的是队列层:任务活在 DSH 里而不是会话里,所以进度和目标路径能扛过一轮对话、一个会话和一次重启。
一定要装 aria2 吗?
不必,但强烈建议。装了 aria2 才能 16 路分段;没有它插件退回单个 Node 流——功能一样,速度大约十分之一。插件会在启动时告警,并通过 `download_status` 报告原因。
应该装哪个版本?
安装命令里请锁定版本,例如 `dsh plugin add dsh-dl-server@0.4.0`。README 解释了两点:不写版本时 pnpm 可能解析到缓存里的旧 release;0.1.0 把 storage-domain 当成普通依赖装进了插件内部,导致服务注入对不上宿主、插件始终没挂载。
链接是对的但一直 403,DLS 能解决吗?
从 0.4.0 起可以:`download_enqueue` 接受 `headers` 对象(例如 Bilibili CDN 媒体需要 `Referer`)。请求头在入队时就校验(换行、控制字符、`Range` / `Host` 这类传输层专属名字会被 `header-invalid` 拒绝),并在任务输出里脱敏——只列名字。
清理会不会把我的文件删掉?
只有 `scope="all"` 会。默认的 `allWithoutFiles` 只删记录,已下载的文件保留。
07相关的 DSH 工作流
dsh-univer-office
作者 dream-num
在 DSH 内预览、创建与编辑表格、文档和幻灯片,由 Univer 驱动
clearai-dsh
作者 clearailhc
ClearAI:以本体为纲的原生 DSH 插件 —— 经证据核验的研究长成可浏览的领域本体。 · ClearAI: an ontology-first DSH agent preset — evidence-checked research that grows into a domain ontology.
dsh-fish-memory
作者 yuuyuko-uu
🐋 DSH 鱼的记忆:给会话一份会淡忘的长期记忆,每条都带时间。名字里的「鱼」来自 DeepSeek 的鲸鱼。
dsh-trading
作者 zhu1090093659
基于 DeepSeek Harness 的智能体原生交易终端,三栏界面聚合币圈、美股、A股与港股,内置 19+ 可热插拔连接器,默认模拟交易并需人工确认。
08数据与来源
A persistent download queue for DeepSeek Harness.
**Requires DSH 0.2.1-rc.5 or newer.**
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-21。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
