返回目录

dsh-download-server

精选清单收录维护状态: 活跃

jestions-dev/dsh-download-server

为 DeepSeek Harness 提供跨会话、持久化的下载队列。

前往 GitHub
$ dsh plugin add dsh-dl-server@0.4.0

148

星标

0

Fork

JavaScript

语言

MIT

许可证

2026-11-08

创建于

2026-11-15

最近推送

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:没有它插件退回单流传输,速度大约只有十分之一

安装步骤

  1. 01

    推荐路径:设置 → 插件 → 安装第三方插件 → 添加插件,输入 `dsh-dl-server@0.4.0` 并确认。

  2. 02

    或用命令行:`dsh plugin add dsh-dl-server@0.4.0`(务必锁定版本号,不写版本时 pnpm 可能解析到缓存里的旧版本)。

    $ dsh plugin add dsh-dl-server@0.4.0

  3. 03

    重启一次 DSH,让插件完成挂载。

验证接入成功

作者未说明

03DSH 适配与能力边界

DSH 适配原生运行时

原生 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` 只删记录。请明确选择范围。
  • 归属按会话划分:机器上任何会话都能看到所有任务,但只有发起任务的会话能暂停、续传或取消。
2026-11-082026-11-15v0.4.1

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` 只删记录,已下载的文件保留。

08数据与来源

  • 作者声明github.come49f7bf96edf…

    A persistent download queue for DeepSeek Harness.

  • 作者声明github.come49f7bf96edf…

    **Requires DSH 0.2.1-rc.5 or newer.**

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-21。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。