dsh-dl-server 0.4.0 → 0.4.1

package/lib/transport.js

@@ -60,6 +60,30 @@ export function planTransfer(sizeBytes, cap = 16) {
 const IS_WIN = process.platform === 'win32'
 const ARIA2_BIN = IS_WIN ? 'aria2c.exe' : 'aria2c'
 
+/**
+ * The command that installs aria2 on this platform.
+ *
+ * Missing aria2 is the single most common fresh-install problem: the queue keeps
+ * working through the single-stream fallback, so nothing fails loudly and the
+ * user just concludes that DLS is slow. Every surface that mentions the fallback
+ * quotes this string, so the advice cannot drift from the detection code.
+ *
+ * @param {NodeJS.Platform} [platform]
+ * @returns {string}
+ */
+export function aria2InstallHint(platform = process.platform) {
+  switch (platform) {
+    case 'win32':
+      return 'winget install aria2.aria2 （或从 https://github.com/aria2/aria2/releases 下载）'
+    case 'darwin':
+      return 'brew install aria2'
+    case 'linux':
+      return 'sudo apt install aria2 （Fedora: sudo dnf install aria2，Arch: sudo pacman -S aria2）'
+    default:
+      return '安装 aria2 并把 aria2c 放进 PATH'
+  }
+}
+
 /** Absolute locations worth checking beyond PATH. */
 function extraCandidates() {
   if (IS_WIN) {
@@ -196,17 +220,36 @@ export class Transport {
     this.config = config
     this.log = log
     this.mode = 'direct'
+    this.aria2Missing = false
     this.aria2 = undefined
     this.rpc = undefined
     /** @type {Map<string, { verified: string[], rejected: { url: string, reason: string }[] }>} */
     this.mirrorReports = new Map()
   }
 
+  /**
+   * Channel snapshot for `download_status`. When aria2 is missing the view
+   * carries the install hint so an agent reading a slow transfer can tell the
+   * user what to fix instead of guessing.
+   */
+  modeInfo() {
+    if (this.aria2Missing) {
+      return { mode: 'direct', aria2Missing: true, hint: aria2InstallHint() }
+    }
+    return { mode: this.mode }
+  }
+
   /** Detect aria2 and start the daemon if possible. Never throws. */
   async init() {
     const binary = await findAria2(this.config.aria2Path)
     if (!binary) {
-      this.log('info', 'aria2c not found, using the single-stream fallback')
+      this.aria2Missing = true
+      // warn, not info: this is the difference between 136 MB/s and 13 MB/s and
+      // the fallback is silent otherwise.
+      this.log(
+        'warn',
+        `aria2c 未找到，回退到单流模式（速度约为并发的 1/10）。安装：${aria2InstallHint()}`,
+      )
       return
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-dl-server",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "DLS — DSH Download Server: a global, session-aware, persistent download queue for DeepSeek Harness.",
   "type": "module",
   "main": "lib/index.js",