Fro2en12/dsh-download-progress

DSH 网页插件:下载进度面板(AI 产物)

Project Overview项目介绍

It is a native DSH web plugin that adds a draggable download progress panel to the bottom-right corner of DSH's web GUI. It can be installed three ways: search and install one-click via the built-in DSH plugin market, run the dsh plugin add CLI command, or manually clone the repo and edit the DSH config file to add the plugin entry. After installation, restart the dsh web process, and you will see the download capsule button in the corner, confirming a successful install. The plugin supports all DSH versions from 0.1.1-rc.2 stable to 0.1.2-alpha.3 latest, with peer dependency covering both stable and alpha release channels.

Once installed, the plugin works automatically with no extra setup required. It tracks multiple types of download activity: panel-initiated URL downloads, curl/wget/Invoke-WebRequest calls in bash/pwsh shells, SSH transfers, and any file growth over 64KB in registered DSH workspaces. Users can manually initiate downloads by pasting URLs into the panel, cancel individual in-progress tasks, and clear out finished or failed records. The panel is draggable, collapsible into a small capsule that shows real-time progress summary, and can be reset to the default position with one click.

The plugin uses curl as its download backend, which ships by default on all supported desktop platforms. There are some known limitations to note: chunked transfers that don't report a Content-Length can't show a progress percentage, and deep nested directory downloads may not be caught by the black box workspace scanner. The project is released under the permissive MIT license, so it can be used, modified, and distributed freely without restriction. All core functionality and security features have been tested, but users are still advised to review the code before using it in production environments.

这是一个专为 DeepSeek Harness (DSH) 开发的原生插件,会在 DSH 网页端界面右下角添加一个可拖拽的下载进度浮窗。它可以追踪面板发起的 URL 下载、Agent 调用的 shell/SSH 传输,以及工作区内所有新增/增长的文件,实时显示下载字节数、速度、百分比和预计剩余时间。支持通过插件市场搜索一键安装,也可通过 CLI 命令或手动克隆挂载。

插件开启后无需额外配置即可自动追踪绝大多数下载传输活动,用户也可以手动粘贴下载链接发起任务,支持单独取消任务、一键清理已完成记录。浮窗支持拖拽调整位置,一键复位,无活动任务时会折叠成右下角的胶囊按钮,同时显示实时进度摘要。适合经常通过 DSH Agent 处理文件下载传输、需要清晰追踪进度的用户使用。

插件依赖系统自带的 curl 工具,Windows 10+、Linux 和 macOS 一般都预安装了该工具。本项目基于 MIT 协议开源,可自由使用修改。存在一些已知限制:无 Content-Length 的分块传输无法显示百分比,深层嵌套目录的下载可能无法被黑箱监控捕捉,所有配置参数均经校验,插件还内置了 CSRF 安全防护。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

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

把 Fro2en12/dsh-download-progress 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

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.

兼容性:支持 DSH 0.1.1-rc.2(stable / npm latest)至 0.1.2-alpha.3(alpha 最新)——工具注册走官方 defineTool(参数自校验 + 规范输出)、阈值通过 Schemastery Config 暴露、下载子进程尊重 exec.signal(工具被取消时进程树随任务中止并标记 canceled)。插件依赖的全部官方 API(defineTool / tools 事件 / webServer.register / subprocess spawn signal / fs.listDir / workspaceRegistry / shell.overlay slot / react seed)已在 0.1.2-alpha.3 逐项核对无断点;peerDependencies 范围 >=0.1.1-rc.2 <0.2.0-0 同时覆盖两条发布通道。ssh_download/ssh_upload 追踪保留为向后兼容(官方包已不含 ssh 工具,无匹配即零开销)。

0.1.2 起:面板 HTTP API 自带请求来源防护(loopback Host + 写操作 Origin 校验,见下方「安全模型」),并修复了完成字节数被 HEAD 大小覆盖、取消后半成品残留、并发写同一目标等九项问题。

⚠️ 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 的响应静默忽略
安装/下载命令兜底 无法解析出目标文件的 wsl/apt/pip/npm/git clone/docker pull 等命令,也会显示为“安装/下载任务”,至少展示已用时间
SSH 传输追踪 自动追踪 ssh_download(字节/速度实时增长)与 ssh_upload(不定进度 + 源文件大小);兼容旧版/第三方 ssh 工具,无匹配即零开销
黑箱下载监控 每 1.5s 扫描 workspaceRegistry 中全部工作区的顶层:任何增长 ≥64 KB 的文件或新目录(git clone、BITS、变量路径下载等)都会被捕捉,最多并发追踪 3 个
拖拽面板 胶囊按钮与面板均可拖动(视口内自动夹取)、↺ 一键复位;拖动与点击严格分离,不会误触
折叠进度摘要 有活动任务时,右下角胶囊直接显示实时百分比、速度与已用时间(如 ⏳ 下载中 45% · 2.1MB/s · 2m 10s);任务行也会显示「已进行 xxm xxs」

模型工具

  • download_url — 后台下载 URL 到工作区(dest 省略时按 URL 文件名存到工作区根目录,目标目录需已存在);execute 尊重 exec.signal,工具被取消时终止 curl 进程树
  • download_status — 查询所有任务实时进度

安装

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev skill-security-guard 下一个 Next ironlaw →