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
- 01
Recommended: Settings → Plugins → Install a third-party plugin → Add plugin, type `dsh-dl-server@0.4.0`, confirm.
- 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
- 03
Restart DSH once so the plugin mounts.
Verify the integration
Not specified by the author
03DSH integration and capability boundaries
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 directoryMirror 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 minutesCustom 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.
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.
07Related DSH workflows
dsh-univer-office
by dream-num
Give DeepSeek Harness a real office environment. Univer Office Plugin brings spreadsheets, docs, slides, canvases, relational tables, and more into one runtime — with connected data, validation, versioned changes, and isolated worktrees for multi-agent collaboration.
clearai-dsh
by clearailhc
Brings an evidence-checked epistemic loop to DSH: research sessions settle into a browsable domain ontology with evidence chains and support levels; contradictory readings are surfaced for human adjudication.
dsh-fish-memory
by yuuyuko-uu
Stores time-stamped, decaying per-session memories, recalls relevant items, and optionally distills imported local archives through the configured DSH model.
dsh-trading
by zhu1090093659
Agent-native trading terminal built on DeepSeek Harness. Crypto, US, CN and HK in one three-column GUI, 19+ hot-swappable connectors, dry-run by default with human approval on every live order. BYOK, no data redistribution.
08Data and sources
A persistent download queue for DeepSeek Harness.
**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.
