DeepSeek Harness（DSH）的設計理念是“一切皆插件”。在通過 Web 工具或 Shell 調用模型下載大文件時，GUI 上往往無法看到進度，容易造成等待焦慮。dsh-download-progress 是一個爲 DSH Web GUI 服務的插件，通過 download 工具實時計算下載百分比，並在 Web 右下角懸浮面板顯示進度條、速度和文件大小。
功能¶
download工具實時計算下載百分比。- Web GUI 右下角懸浮面板顯示進度條。
- 面板顯示下載速度（B/s）、已下載/總大小、百分比。
- 暴露 GET /download-progress JSON 快照接口。
- 支持中英雙語界面。
- 零構建，安裝即用。
安裝與啓用¶
安裝插件：
dsh plugin --profile web add dsh-download-progress
安裝後需要重啓 dsh web 以使新增插件生效。
典型用法¶
在對話中讓模型調用 download 工具：
download({ url: "https://example.com/file.zip", dest: "file.zip" })
Web 右下角會實時顯示類似以下內容：
下載進度 2 個進行中
file.zip ▓▓▓▓▓░░░░░ 62%
34.5 MB / 55.7 MB 8.2 MB/s
適用場景與注意¶
適用場景：
適用於需要通過 DSH 下載大文件的場景，特別是使用 Web GUI 時，需要實時監控下載進度、速度和剩餘時間。
前置依賴：
- Node.js ≥ 18
- 目標 DSH 版本：0.1.0-rc.6
- 平臺：Web GUI（dsh web）；瀏覽器端依賴 shell.overlay slot
權限與安全：
- 網絡權限：download 工具會向目標 URL 發起 HTTP(S) 請求並流式寫入工作區文件。
- 文件權限：寫入路徑由調用方 dest 決定，僅寫入工作區內的目標文件及其父目錄。
- 隱私保護：不讀取憑據、不上傳任何數據、不做遙測。
- 瀏覽器端：僅輪詢同源 /download-progress；不讀取會話內容。
常見行爲：
- 如果服務器未返回 Content-Length（chunked 響應），進度可能一直顯示爲 0%，此時會顯示“下載中…”。
- 下載完成後，面板條目會停留約 1 分鐘自動消失。
- 取消下載時會刪除未完成的臨時文件。
生態與維護¶
該插件屬於 DSH 社區插件生態，與 DeepSeek 或幻方無官方從屬關係。插件目錄：dsh-download-progress。源碼倉庫：GitHub。許可證：MIT License。
