dsh-dl-server 0.4.0 → 0.4.1

package/README.md

@@ -17,23 +17,32 @@ A persistent download queue for DeepSeek Harness.
 Settings → Plugins → Install a third-party plugin → Add plugin
 ```
 
-Type **`dsh-dl-server@0.1.1`**, confirm, then **restart DSH once**.
+Type **`dsh-dl-server@0.4.0`**, confirm, then **restart DSH once**.
 
 ### From the command line
 
 ```sh
-dsh plugin add dsh-dl-server@0.1.1
+dsh plugin add dsh-dl-server@0.4.0
 ```
 
 > **Pin the version.** `0.1.0` declared `@deepseek-ai/dsh-storage-domain` as a regular dependency, so pnpm installed a second copy inside the plugin; the injected service then no longer matched the host and the plugin never mounted (every service stayed `pending`). `0.1.1` moves it to `peerDependencies`.
 >
-> pnpm also caches registry metadata — without an explicit version you may still resolve `0.1.0`.
+> pnpm also caches registry metadata — without an explicit version you may still resolve an older release.
 
 > `dsh` must be on your PATH. The desktop build ships one at
 > `…\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd`; if you have never added it, use the UI path.
 
 **Requires DSH 0.2.1-rc.5 or newer.**
-**aria2 is optional** — install it for 16-way segmented downloading, or skip it and the plugin falls back to a single-stream transfer. Same features, less speed.
+**aria2 is optional but strongly recommended** — install it for 16-way segmented downloading. Without it the plugin falls back to a single-stream transfer: same features, roughly a tenth of the speed. The plugin warns at startup and reports the reason through `download_status`, so a slow first install is not a mystery.
+
+| Platform | Install aria2 |
+| --- | --- |
+| Windows | `winget install aria2.aria2` |
+| Ubuntu / Debian | `sudo apt install aria2` |
+| Fedora | `sudo dnf install aria2` |
+| Arch | `sudo pacman -S aria2` |
+| macOS | `brew install aria2` |
+
 
 ---
 
@@ -136,7 +145,7 @@ The last row is the point: **on a per-connection-throttled host, segmentation be
 - **Ownership is per session.** Any session on the machine can *see* every job; only the owner can mutate one.
 - **`cleanup(scope="all")` deletes files.** The default `allWithoutFiles` only drops records.
 - **Checkpoints live in DSH storage**, not as lock files dropped into your home directory — the plugin does not depend on `TMPDIR` or the working directory.
-- **When aria2 is unavailable** the transport degrades to a single Node stream. No features lost, some speed lost.
+- **When aria2 is unavailable** the transport degrades to a single Node stream. No features lost, some speed lost — and the plugin says so instead of staying quiet, because a silent 10× slowdown looks like a bug.
 
 ---
 
@@ -156,6 +165,7 @@ The roadmap names product stages (`v1`, `v1.1`, `v1.2`, `v1.3`, `v2`); npm versi
 | `0.2.x` | v1.1 | mirrors / mirror cooldown / size-aware concurrency / session fairness / disk budget / loud failures | released |
 | `0.3.x` | v1.2 | queue de-duplication / mirror self-verification | released |
 | `0.4.x` | v1.3 | custom request headers (`Referer` / `Cookie` / `User-Agent`) on every attempt, validated at enqueue, redacted in output | released |
+| `0.4.1` | patch | missing aria2 is now a loud, actionable warning instead of a silent speed cliff; `download_status` reports the channel | released |
 | `1.0.0` | v2 | shell interception / torrents / own segmented engine / content addressing | planned |
 | `1.1.x` | v3 | user panel + callbacks into the agent | planned |
 

package/README.zh.md

@@ -17,23 +17,32 @@
 设置 → 插件 → 安装第三方插件 → 添加插件
 ```
 
-输入框里填 **`dsh-dl-server@0.1.1`**，确认，然后**重启一次 DSH**。
+输入框里填 **`dsh-dl-server@0.4.0`**，确认，然后**重启一次 DSH**。
 
 ### 方式二：命令行
 
 ```sh
-dsh plugin add dsh-dl-server@0.1.1
+dsh plugin add dsh-dl-server@0.4.0
 ```
 
-> **带上 `@0.1.1`。** `0.1.0` 把 `@deepseek-ai/dsh-storage-domain` 声明成了普通依赖，pnpm 会给插件装第二份，服务和宿主对不上、插件挂不住（全部 `pending`）。0.1.1 改成 `peerDependencies` 已修复。
+> **带上版本号。** `0.1.0` 把 `@deepseek-ai/dsh-storage-domain` 声明成了普通依赖，pnpm 会给插件装第二份，服务和宿主对不上、插件挂不住（全部 `pending`）。0.1.1 改成 `peerDependencies` 已修复。
 >
-> 另外 pnpm 会缓存 registry 元数据 —— 不带版本号时可能仍然解析到 `0.1.0`。
+> 另外 pnpm 会缓存 registry 元数据 —— 不带版本号时可能仍然解析到旧版本。
 
 > `dsh` 需要先在 PATH 里。桌面版自带的那份在
 > `…\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd`，没加过 PATH 的话用方式一。
 
 **要求 DSH 0.2.1 或以上。**
-**aria2 可选** —— 装了走 16 线程分段，没装走单流兜底，一样能下，只是慢一些。
+**aria2 可选，但强烈建议装** —— 装了走 16 线程分段；没装走单流兜底，功能一个不少，速度大约只有十分之一。没装时插件会在启动日志里明确警告，`download_status` 也会报出原因，不会让你以为"DLS 就这速度"。
+
+| 平台 | 装 aria2 |
+| --- | --- |
+| Windows | `winget install aria2.aria2` |
+| Ubuntu / Debian | `sudo apt install aria2` |
+| Fedora | `sudo dnf install aria2` |
+| Arch | `sudo pacman -S aria2` |
+| macOS | `brew install aria2` |
+
 
 ---
 
@@ -156,6 +165,7 @@ agent 会调 `download_enqueue` 两次拿到 `J#10` / `J#11`，然后 `download_
 | `0.2.x` | v1.1 | 镜像表 / 镜像冷却 / 并发分档 / 会话公平 / 磁盘余量 / 失败显式化 | 已发布 |
 | `0.3.x` | v1.2 | 队列去重 / 镜像自证同源 | 已发布 |
 | `0.4.x` | v1.3 | 自定义请求头（`Referer` / `Cookie` / `User-Agent`）：每次尝试都带，入队时校验，输出只列名字 | 已发布 |
+| `0.4.1` | 补丁 | 没装 aria2 从"静默变慢"改成"明确警告 + 安装命令"；`download_status` 能看出走的哪条通道 | 已发布 |
 | `1.0.0` | v2 | 拦截 shell 下载 / 种子与磁力 / 自研分段引擎 / 内容寻址 | 计划 |
 | `1.1.x` | v3 | 用户面板 + 操作回传 agent | 计划 |