DeepSeek Harness 插件：@leisureyu/dsh-smart-dl

前言¶

DeepSeek Harness (DSH) 的插件生態旨在解決特定場景下的開發與運維需求。在處理外部資源下載時，手動配置 curl 或 aria2 往往需要額外的環境設置。@leisureyu/dsh-smart-dl 插件解決了這個問題，它內置了 aria2，通過一個命令即可完成安裝與配置，支持大文件多線程加速、斷點續傳以及內容校驗。

插件概覽¶

插件名稱：@leisureyu/dsh-smart-dl
維護者：LeiSureYu
分類：聯網工具
核心價值：零配置，內置 aria2，自動回退到系統 curl，支持斷點續傳與內容校驗。

安裝與啓用¶

安裝過程需要使用 DSH 的插件管理命令。

在 DSH 界面側邊欄選擇「插件」。
點擊「添加插件」，粘貼包名 @leisureyu/dsh-smart-dl。
點擊「安裝」，安裝完成後重啓 DSH 一次。

也可以直接在命令行中執行：

dsh plugin --profile web add @leisureyu/dsh-smart-dl

對於桌面版（DeepSeek Harness 0.2.0 起），建議使用桌面版自帶的 CLI 路徑進行安裝：

& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add @leisureyu/dsh-smart-dl

安裝後無需任何額外配置，aria2 二進制文件通過 npm 的 optionalDependencies 機制隨插件一起安裝。

核心功能¶

該插件提供了以下能力：

多線程下載：利用內置的 aria2c 進行多連接下載，加速大文件傳輸。
自動回退：當目標服務器不支持多線程時，自動回退到系統自帶的 curl 單線程下載。
斷點續傳：支持中斷後通過相同的 url 和 output 進行續傳。
進度面板：在帶 Web 界面的 profile（web / desktop）中，右下角會顯示實時進度面板（文件名、百分比、速度、剩餘時間）。
進度查詢：提供 download_status 工具，用於只讀查詢最近任務的進度狀態。
批量下載：支持通過 targets 參數一次下載多個文件，可設置 maxBandwidth 限制整批帶寬，設置 timeoutMs 設置單條目超時。
SHA-256 校驗：支持傳入 sha256 參數，下載後逐字節覈對文件完整性。
自定義請求頭：支持 UserAgent、Referer 和自定義 Headers。
鏡像自動選擇：設置 mirror: "auto" 時，插件會從內置候選表中選擇一個與原地址同源的鏡像。
跨平臺支持：支持 Windows x64/arm64 與 Linux x64/arm64。

典型用法¶

安裝完成後，插件會註冊兩個工具：smart_download 和 download_status。

單文件下載¶

最簡單的用法是直接傳入 URL。爲了確保文件完整性，建議同時傳入 sha256。如果下載地址是 GitHub，可以使用 mirror: "auto" 自動選擇鏡像。

smart_download(
  url: "https://github.com/owner/repo/releases/download/v1.4.0/tool.zip",
  sha256: "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
  mirror: "auto"
)

批量下載¶

使用 targets 數組可以一次性下載多個文件。

smart_download(
  targets: ["url1", "url2"],
  maxBandwidth: 1024,
  timeoutMs: 5000
)

注意事項¶

macOS 限制：macOS 能安裝並使用該插件，但由於平臺限制，其底層下載邏輯永遠走 curl 單線程。
進度面板限制：進度面板只在帶 Web 界面的 profile 生效（web / desktop），純 CLI profile 下無法顯示界面面板，但命令行功能不受影響。
權限說明：插件以當前 DSH 進程的權限運行。在安裝前，應檢查源碼與許可證，確保符合你的使用規範。