feat(downloader): resume failed downloads from completed segments across runs

Fingerprint-gated reuse of atomically-published segment files (DASH/ISM/HLS) behind a continue_downloads config option and one-off dl --continue-downloads flag.

docs/reference/configuration/download.md

@@ -92,6 +92,34 @@ dl:
     to set server-wide download defaults for every request it handles. Keys the API does not know
     are ignored there (`speed_limit`, for example; `serve` has its own `global_speed_limit`).
 
+## `continue_downloads`
+
+- **Type:** `bool`  ·  **Default:** `false`
+
+Keep a failed download's completed segment files so the next attempt resumes from where it
+stopped instead of restarting from byte zero.
+
+Only whole, fully downloaded segments are reused; partially written segments are always
+discarded, and no partial-byte (`Range`) resume across runs takes place. Reuse also
+requires proof that the remote content is unchanged: the manifest URL, segment count, and
+byte ranges must all match the previous run, otherwise the download silently restarts
+clean.
+
+!!! note "What can and cannot resume"
+    - Segmented DASH, ISM, and HLS tracks resume.
+    - Single-file (non-segmented) downloads and DASH tracks collapsed to a single ranged
+      download never produce segment files, so this option does not apply to them (the
+      downloader has its own in-flight partial-file handling for those).
+    - HLS resumes Widevine/PlayReady and unencrypted content only; AES-128 content always
+      restarts. An HLS failure during the post-download merge step also restarts.
+
+For a one-off resume without changing config, pass `dl --continue-downloads` on the
+command line (the flag can only enable resume, never disable it).
+
+```yaml title="Resume failed downloads"
+continue_downloads: true
+```
+
 ## `subtitle`
 
 - **Type:** `dict`  ·  **Default:** `{}`

docs/reference/configuration/index.md

@@ -31,7 +31,7 @@ Where the file lives, how unshackle discovers it, and how to edit it:
 |------|------|
 | [Directories](directories.md) | `directories`, `filenames` |
 | [Services & authentication](services.md) | `services`, `credentials`, `firefox_cookies`, `remote_services`, `serve` |
-| [Download & processing](download.md) | `dl`, `subtitle`, `audio`, `muxing`, `language_tags`, `dual_multi_mode` |
+| [Download & processing](download.md) | `dl`, `continue_downloads`, `subtitle`, `audio`, `muxing`, `language_tags`, `dual_multi_mode` |
 | [Output & naming](output.md) | `output_template`, `tag`, `tag_rules`, `tag_group_name`, `tag_imdb_tmdb`, `chapter_fallback_name`, `unicode_filenames` |
 | [DRM & CDM](drm.md) | `cdm`, `remote_cdm`, `decryption` |
 | [Network & proxy](network.md) | `network`, `headers`, `proxy_providers` |