dsh-download-progress

DSH web 插件：下载进度面板。URL 下载器、agent shell/SSH 传输追踪、工作区黑箱下载监控，全部汇聚到一个可拖拽的右下角浮窗，实时显示字节数、速度、百分比与预计剩余时间。

English: A DeepSeek Harness (DSH) web plugin that surfaces a draggable download-progress panel in the bottom-right corner of the web GUI. It tracks panel-started URL downloads, agent shell/SSH transfers, and any "black-box" file growth inside registered workspaces — with live bytes, speed, percentage and ETA.

⚠️ AI 产物声明

本项目为 AI（DeepSeek 驱动的智能体）产物：功能设计、架构选型、代码编写、测试与文档均由 AI 在对话中迭代完成，人工仅提供需求与验收反馈。

• 开发过程中经真机验证（下载器、SSH/shell 追踪、黑箱监控、拖拽交互均有实测记录），但边界情况无法穷尽，生产使用前请自行审阅与测试；
• 欢迎提交 Issue / Pull Request 修正问题或扩展能力；
• 本项目基于 MIT 协议开源，可自由使用、修改与分发。

功能特性

来源	图标	说明
面板下载器	🌐	面板输入 URL 下载，或让 agent 调用 download_url 工具。curl 后台执行，HEAD 预取 Content-Length 得到真实百分比；可在面板单独取消
shell 下载追踪	💻	自动解析 pwsh/bash 工具命令中的 curl -o / Invoke-WebRequest -OutFile / wget -O，提取目标路径与 URL（含 HEAD 总大小）。小于 64 KB 的响应静默忽略
SSH 传输追踪	⇩ / ⇧	自动追踪 ssh_download（字节/速度实时增长）与 ssh_upload（不定进度 + 源文件大小）
黑箱下载监控	📥	每 1.5s 扫描 workspaceRegistry 中全部工作区的顶层：任何增长 ≥64 KB 的文件或新目录（git clone、BITS、变量路径下载等）都会被捕捉，最多并发追踪 3 个
拖拽面板	—	胶囊按钮与面板均可拖动（视口内自动夹取）、↺ 一键复位；拖动与点击严格分离，不会误触

模型工具：

• download_url — 后台下载 URL 到工作区（dest 省略时按 URL 文件名存到工作区根目录，目标目录需已存在）
• download_status — 查询所有任务实时进度

安装

方式一：DSH 插件市场（推荐）

GUI 内打开插件市场，搜索 dsh-download-progress，一键安装。

方式二：dsh plugin add

dsh plugin --profile web add https://github.com/Fro2en12/dsh-download-progress

方式三：手动挂载

git clone https://github.com/Fro2en12/dsh-download-progress
# 编辑 profiles/web/cordis.patch.yml，在 plugins 后追加：
#   - insert:
#       - id: dsh-download-progress
#         name: 'dsh-download-progress'

安装后重启 dsh web，右下角出现 ⬇ 下载 胶囊按钮即成功。