Back to directory

dsh-download-server

In a curated listMaintenance: Active

jestions-dev/dsh-download-server

DLS — DSH Download Server: a global, session-aware, persistent download queue for DeepSeek Harness.

View on GitHub
$ dsh plugin add dsh-dl-server@0.4.0

148

stars

0

forks

JavaScript

Language

MIT

License

2026-11-08

Created

2026-11-15

Last push

MIT-licensed DSH plugin (dsh-dl-server) that makes downloads a persistent, session-aware queue: immediate job ids, pause/resume/cancel, checkpoints in DSH storage, optional aria2 for 16-way segmentation, mirror fallback and per-request headers.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-11-21

License

MIT

01What can it help you accomplish?

  • Download large files without keeping the session or the turn alive

    A job id returned immediately, with progress, destination and checkpoints persisted in DSH storage so the transfer survives session end and restart

    DeepSeek Harness users who pull models, datasets or media archives and are tired of downloads dying with the session

  • Queue many downloads at once and wait for them from the agent

    Ten enqueues fired without blocking, then `download_wait` to block until terminal state with a timeout

    Agents and users running batch fetches (papers, datasets, release assets) in one turn

02How to install into DeepSeek Harness

Prerequisites

  • DeepSeek Harness 0.2.1-rc.5 or newer (the README states the minimum host version)
  • `dsh` on PATH, or use the in-app UI path instead of the CLI
  • aria2 installed and strongly recommended — without it the plugin falls back to a single-stream transfer at roughly a tenth of the speed

Installation steps

  1. 01

    Recommended: Settings → Plugins → Install a third-party plugin → Add plugin, type `dsh-dl-server@0.4.0`, confirm.

  2. 02

    Or from the command line: `dsh plugin add dsh-dl-server@0.4.0` (pin the version — without an explicit version pnpm may resolve an older cached release).

    $ dsh plugin add dsh-dl-server@0.4.0

  3. 03

    Restart DSH once so the plugin mounts.

Verify the integration

Not specified by the author

03DSH integration and capability boundaries

DSH integrationNative runtime

Native DSH plugin (npm package `dsh-dl-server`) that injects a download-queue service and seven `download_*` tools into the host

  • Persistent queue (7 tools)

    URLs, destination path, optional request headers→Job ids plus `download_status` / `download_wait` / `download_pause` / `download_resume` / `download_cancel` / `download_cleanup`

    job records and checkpoints are written to DSH storage, not to lock files in your home directory
  • Mirror fallback with cooldown

    GitHub Releases / HuggingFace / raw.githubusercontent / PyPI URLs→a fallback mirror tried after the original, with the origin always kept first

    a host that fails twice in a row is parked for 10 minutes
  • Custom request headers

    an optional `headers` object (`Referer`, `Cookie`, `User-Agent`, …)→headers sent on the origin probe, mirror probes, aria2 download and single-stream fallback

    header values may be session cookies; job output lists names only and values stay in the transfer layer and local store

04Who is it for? When not to use it?

Good for

  • DeepSeek Harness users who pull models, datasets or media archives and are tired of downloads dying with the session
  • Agents and users running batch fetches (papers, datasets, release assets) in one turn

Not for

  • `download_cleanup` with `scope="all"` deletes the downloaded files as well; the default `allWithoutFiles` only drops records. Pick the scope deliberately.

05Compatibility, maintenance and safety notes

  • `download_cleanup` with `scope="all"` deletes the downloaded files as well; the default `allWithoutFiles` only drops records. Pick the scope deliberately.
  • Ownership is per session: any session on the machine can see every job, but only the session that started a job can pause, resume or cancel it.
2026-11-082026-11-15v0.4.1

MIT · actively maintained (latest release v0.4.1, 2026-11-15; README examples still pin 0.4.0)

06Frequently asked questions

Why does the download die when the session ends?

Because most DSH downloaders are one tool function that blocks until the file lands. DLS is the queue layer instead: the job lives in DSH, not in a session, so progress and destination survive the turn, the session and a restart.

Do I need aria2?

No, but it is strongly recommended. With aria2 you get 16-way segmented downloading; without it the plugin falls back to a single Node stream — same features, roughly a tenth of the speed. The plugin warns at startup and reports the reason through `download_status`.

Which version should I install?

Pin an explicit version in the install command, e.g. `dsh plugin add dsh-dl-server@0.4.0`. The README explains that without a pinned version pnpm may resolve an older cached release, and that 0.1.0 shipped the storage-domain package as a regular dependency so the plugin never mounted.

A URL is correct but returns 403 — can DLS help?

Yes, since 0.4.0: `download_enqueue` accepts a `headers` object (e.g. `Referer` for Bilibili CDN media). Headers are validated at enqueue (line breaks, control characters, transport-owned names like `Range`/`Host` are rejected with `header-invalid`) and redacted in job output — only names are listed.

Does cleanup delete my files?

Only with `scope="all"`. The default `allWithoutFiles` drops records and leaves downloaded files alone.

08Data and sources

  • Author-claimedgithub.come49f7bf96edf…

    A persistent download queue for DeepSeek Harness.

  • Author-claimedgithub.come49f7bf96edf…

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

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-11-21. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.