dsh-ghost-download
Manifest validDeepSeek Harness plugin that drives Ghost Downloader through its official ghd CLI: submit, probe, wait, control and verify downloads (md5/sha1/sha256/sha512/crc32), with a live queue panel and an acti
Ghost Downloader 插件(dsh-ghost-download)
让 DeepSeek Harness 智能体通过 Ghost Downloader 官方命令行工具 ghd 统一管理下载(添加 / 探测 / 查看 / 控制 / 等待 / 统计 / 体检)的 DSH 插件。它让「下载」这件事只有一个引擎,IDA 与桌面端共享同一个下载队列。
为什么做这个
下载能不能成功,很大程度上取决于网络状况,而不是发起方。网络不稳定时,让调用方自己发起下载会反复失败,而重试、续传这类改进很难在调用侧就地完成。
Ghost Downloader 恰好是为这类网络准备的:断点续传、多线程、失败重试都是它已有的能力。插件把「下载」交给它,而不是在调用侧重新实现一遍——链接进入 Ghost 的队列,与桌面端共用同一条,进度在界面上可见;默认落在会话工作目录,让发起调用的智能体能读回文件;提交前还可以先用 ghd probe 看一下大小、剩余空间与同名文件。
术语说明:下文「参数」指智能体每次调用工具时传的值,例如
dir、conflict、headers、waitSeconds、precheck、useGhostFolder——dir是参数,不是用户开关。「设置」指你在插件页配置、跨调用生效的值,例如ghdPath、allowedUrlSchemes、controlRemoveEnabled、waitLimitSeconds(上限)。
它提供什么
向智能体注册 8 个工具(全部走 ghd CLI,而非受限的 aria2 RPC):
ghost_download:提交一个或多个链接给 Ghost 下载(支持 http/https/ftp/magnet/ed2k、.torrentURL、HLS/DASH 清单);默认提交后立即返回,waitSeconds可同步等到完成。参数包括目标目录dir、种子文件序号select、重命名name、请求头headers、同名冲突策略conflict(默认keep)、useGhostFolder(忽略dir、交给 Ghost 自己的分类规则)、precheck(提交前用ghd probe检查磁盘空间与同名文件,只报告不自动跳过)和waitSeconds。ghost_probe:只预览链接、不建任务,返回解析出的文件名、大小与文件列表(种子可据此拿到select用的文件序号),带 5 分钟缓存;fresh:true可强制忽略缓存重新探测。ghost_tasks:列出 Ghost 当前所有任务及其状态与进度,可按status过滤,或用limit限制返回条数(最新优先,省略则全部)。ghost_task:查看单个任务详情(状态、进度、文件、错误)。失败的任务会附带归因(证书 / DNS / 鉴权 / 资源不存在 / 范围请求等原因)和一条建议动作,说明下一步该跑什么。ghost_control:控制任务——pause暂停、start继续/启动、retry重试(ghd start的封装:可指定taskIds,省略则重试所有failed任务)、remove删除(remove会删除该任务尚未完成的文件,可用设置关掉;deleteFiles:true还会删除已产出的文件)。ghost_wait:阻塞等待给定任务停止运行(完成 / 失败 / 暂停 / 删除)后汇报最终状态;timeoutSeconds默认为 600 秒、受waitLimitSeconds上限钳制。可选checksum参数做完整性校验——传"<算法>:<十六进制>"(md5/sha1/sha256/sha512/crc32)或裸十六进制摘要(按长度识别:8=crc32、32=md5、40=sha1、64=sha256、128=sha512),要求只传一个taskId。ghd本身没有任何校验和功能,所以插件在文件落盘后自行流式哈希(不把大文件读进内存);匹配则结果带「校验通过」,不匹配则ok:false且error.code = "checksumMismatch"并列出期望值与实际值,定位不到文件则为checksumNotVerified。ghost_stats:聚合当前队列里可见任务的状态计数与总字节大小;Ghost 不保留下载历史,因此它只能汇总当前队列(range参数仅作兼容收下,无法按时间过滤)。ghost_doctor:只读健康检查——ghd可用性、实时ghd tasks、对已知小文件的网络/证书探测、会话下载目录可写性,以及与 Ghost 自身UserConfig.json的交叉核对(下载目录与代理);返回一组成员级{name, ok, detail, hint},无副作用。
此外它还有两个非工具能力:
- 侧边栏「Ghost 下载队列」面板:在 Web 客户端右侧显示实时下载进度(每 5 秒轮询一份缓存 3 秒的队列快照),跟随 Ghost 桌面端同一队列。
- Shell 下载拦截:默认拒绝
curl -o/curl -O/wget这类自己写文件的 shell 下载,并把模型引导到ghost_download(可由blockShellDownloads关闭)。这是行为护栏,不是安全边界。
它带设置页,提供执行器路径、轮询间隔、协议白名单、等待上限、输出上限、以及 remove / 通知 / shell 拦截等设置。
安装(本地 bundle)
本插件以 link: 方式装进你的 profile(vendored 依赖必须随目录链接,见下方「已知限制」)。插件包自带的 cordis.patch.yml 内容为:
- insert:
- id: ghost-download
name: '@local/dsh-ghost-download'
在 profile 的 cordis.patch.yml 里插入同样一条,即可把 @local/dsh-ghost-download 这一行挂到 Loader:
- insert:
- id: ghost-download
name: '@local/dsh-ghost-download'
id 是 Loader 行 id,name 必须与 package.json 的 name 一致。装好后可在插件页用 ghdPath 指向 ghd.exe(默认依次探测 GHOST_GHD / GHD_PATH 环境变量、标准安装目录、最后交给 PATH)。
设置项
与 index.js 中的 Config(Schemastery schema)完全一致,共 12 项;全部为 .volatile(),保存后立即生效,无需重启插件:
| 字段 | 类型 | 缺省值 | 说明 |
|---|---|---|---|
enabled | boolean | true | 关闭后不注册任何 ghost_* 工具;其余设置保留。 |
ghdPath | string | "" | ghd.exe 路径;留空自动探测标准安装。 |
pollIntervalMs | natural | 5000 | 后台完成轮询间隔(毫秒,最小 1000)。 |
blockShellDownloads | boolean | true | 拒绝 curl -o / curl -O / wget 并引导改用 ghost_download。 |
maxUrlsPerCall | natural | 50 | 一次 ghost_download 最多接受多少个链接(最小 1)。 |
waitLimitSeconds | natural | 3600 | ghost_download / ghost_wait 同步等待的上限秒数(10–7200)。 |
watchLimitMinutes | natural | 30 | 后台监视单个任务的时限(分钟,最小 1)。超过后停止轮询并通知会话。 |
maxOutputChars | natural | 20000 | 成功结果回传给模型的上限(字符,最小 500)。 |
maxErrorChars | natural | 2000 | 失败时附带原始输出的上限(字符,最小 200)。 |
allowedUrlSchemes | string[] | ["http","https","ftp","magnet","ed2k"] | 允许提交的协议白名单;不在列表里的链接会被直接拒绝(至少一个)。 |
controlRemoveEnabled | boolean | true | 是否允许 ghost_control 的 remove。关闭后 remove 会从工具的参数枚举里消失;remove 会删除该任务尚未完成的文件。 |
noticeIncludePath | boolean | true | 后台完成通知里是否附带下载文件的绝对路径。 |
已知限制 / 注意事项
- 必须安装 Ghost Downloader 的
ghd命令行工具(桌面端「设置 → 命令行工具」安装);ghd未找到时会在调用时给出明确提示。 - vendored 依赖:
node_modules/@deepseek-ai/schemastery与@deepseek-ai/cosmokit随包附带(见VENDORED.md),只能用link:安装;npm pack/ 仓库安装会丢掉node_modules导致配置表单失效。升级 DSH 后若 schemastery / cosmokit 版本变化,需从新安装的app.asar重新提取。 - 单次最多 50 个链接(Windows 命令行 32K 限制);导出到模型的结果会被截断到
maxOutputChars/maxErrorChars。 ghost_download不传dir时会落到<会话工作目录>/downloads(让发起调用的智能体仍能读到文件);传useGhostFolder:true则忽略dir、交给 Ghost 自己的分类规则,文件可能落到工作区之外。- 同名冲突
conflict默认keep(保留两份),传overwrite才覆盖;precheck只是基于ghd probe的建议(blocked / skip / warn),永不自动跳过下载,是否继续由调用方决定。 ghost_probe结果缓存 5 分钟(按 URL + 合并后的 header 作键);fresh:true强制重探。header 值含 cookie/token,回显时会做脱敏,但会以命令行参数进入本机进程列表。- 任务 id 形如
tsk_0123;ghost_task/ghost_control/ghost_wait只接受这种格式的 id。 - 后台监视有上限:单任务 30 分钟、连续 CLI 失败 10 次或会话失联 3 次即停止,不会无限轮询。
- 工具超时是注册时按 schema 最大值推导的固定预算,调高
waitLimitSeconds不会突破宿主截止时间;等待超时后未完成的任务转入后台监视并通知会话。ghost_wait的timeoutSeconds默认 600 秒。 ghost_stats只能统计当前队列:Ghost 不保留下载历史,range参数收下但无法真正按时间过滤。
与同类的差异
先说可信度,避免把调研当成定论:
- 经官方文档核实:Mister Download Manager 的工具清单、协议与校验和;KGet、Motrix CLI、FluxDown 的存在与路线。
- 代理转述、未逐条复核:aria2 / qBittorrent / yt-dlp 的 MCP 包装现状,以及「无预检把系统盘撑满」的 issue。
- 「抽样范围内没找到」只代表这次没找到,不等于业界没有。
下载类工具按「队列是谁的」可以分三档:
| 项目 | 队列归属 | 与我们的差别 |
|---|---|---|
| Mister Download Manager | 它自己的(7 工具、5 种校验和) | 用户需要改用它 |
| KGet / Motrix CLI | 它们自己的桌面应用 | 同上,agent 只是接入方 |
| FluxDown | 它自己的引擎 + 内置 MCP | 协议面与我们持平(同样含 eD2K / HLS / DASH) |
| aria2-mcp 系 | 另起一个 aria2 实例 | agent 与人的队列互不相干 |
| 本插件 | 用户已经装着的 Ghost Downloader | 不新增引擎、不迁移队列 |
所以最实在的一条差异不是「功能更多」,而是这个插件是适配器,不是下载器:用户桌面上原本怎么用 Ghost,装完之后还是怎么用,只是多了一个智能体能代按按钮的入口;AI 发起的下载和人自己发起的下载在同一个队列里,界面上看得见、管得住。
相对 MDM 的具体差异(它是功能面最接近的一个):
- 8 个工具。比 MDM 的 7 个多出
probe(不建任务先看大小)、wait(同步等到结束)、stats(按状态汇总)、doctor(只读体检);MDM 的start_queue/stop_queue我们没有对应的整体队列开关。 - 协议面相对 MDM 更宽:除 http/https/ftp 外还有
magnet、ed2k、.torrent、HLS、DASH。但 FluxDown 这类多协议下载器同样覆盖,所以协议面不是本插件的独有优势。 - 默认落点绑会话工作目录:不传
dir时落到<会话工作目录>/downloads,目的是让智能体下完还能读回;这一条在本次抽样范围内没有见到第二家。 - 预检只报告、不自动跳过:
precheck给出 blocked / skip / warn 的建议,决策权留给调用方。 - 同步 / 异步双模式:默认立即返回任务 id、后台监视并在结束时通知;需要当场拿文件时用
waitSeconds或ghost_wait。 - 校验和 5 种,与 MDM 持平:md5 / sha1 / sha256 / sha512,以及 CRC32——
node:crypto不提供它,但zlib.crc32(Node ≥ 22.15)提供的就是 zip 使用的 IEEE 802.3 变体,所以直接用运行时实现,按块累计、不读进内存。
安全说明(哪些操作有破坏性)
ghost_control的remove会删除任务尚未完成的文件——这是本插件最具破坏性的操作,可用controlRemoveEnabled:false彻底移除该动作;deleteFiles:true还会删除它已经产出的文件。ghost_download传conflict:"overwrite"会覆盖同名已有文件;默认keep保留两份。headers里常含 cookie / token,值会进入ghd的命令行参数(本机其它进程可见);插件在调用卡片与错误输出里做了脱敏,但仍应谨慎处理敏感头。blockShellDownloads默认是行为护栏,只拦截明显写文件的curl -o/wget形态,不能当作阻止下载脚本的安全边界。ghost_download/ghost_probe只接受allowedUrlSchemes白名单内的协议;收紧白名单可降低风险。ghost_tasks/ghost_task/ghost_probe/ghost_stats/ghost_doctor是只读的(isConcurrencySafe为 true);ghost_control retry会启动任务,不是只读。
License
MIT © 2026 a-molecule-of-ATP。详见 LICENSE。
English summary: A DeepSeek Harness plugin that drives Ghost Downloader through its official ghd CLI. It registers eight model tools — ghost_download, ghost_probe, ghost_tasks, ghost_task, ghost_control, ghost_wait, ghost_stats, and ghost_doctor — and adds a live download-queue sidebar plus a guard that redirects shell downloads. ghost_control gains a retry action; new per-call arguments include useGhostFolder, precheck, conflict (default keep), waitSeconds, and checksum on ghost_wait (md5 / sha1 / sha256 / sha512 / crc32, verified by the plugin itself since ghd has no checksum support); omitting the dir argument saves under <session>/downloads. Twelve volatile settings cover the executable path, protocol allow-list, wait/output limits, and safety settings. See "How this differs from comparable projects" above for a sourced comparison against Mister Download Manager, including where this plugin is deliberately looser. It vendors Schemastery/Cosmokit for link installs and is licensed MIT.
Comments
Loading…
Similar plugins
by BeiWay1145
DeepSeek Harness plugin: force every large-file download through the local aria2 engine by denying shell download commands at the tool pre-execute hook. 强制下载统一走 aria2 的 DSH 插件。
★ 0
MIT
JavaScript
Sep 17, 2026
dsh plugin --profile web add dsh-download-guardby BeiWay1145
DeepSeek Harness plugin: force every large-file download through the local aria2 engine by denying shell download commands at the tool pre-execute hook. 强制下载统一走 aria2 的 DSH 插件。
★ 0
MIT
JavaScript
Oct 30, 2026
dsh plugin --profile web add dsh-ops-guardby Julyves
DeepSeek Harness (dsh) plugin: Git status pill in the session header — branch, dirty counts, ahead/behind, recent commits & changed files.
★ 3
↓ 44/wk
MIT
TypeScript
Sep 1, 2026
dsh plugin --profile web add dsh-git-uiby Yazzyk
DeepSeek Harness (dsh) 插件:在 Web GUI 里手动点选文件或目录,屏蔽 agent 对它们的读取、搜索、写入与编辑。A dsh plugin that denies an agent read/search/write/edit access to chosen files and directories, picked from the plugin's own We
★ 3
MIT
JavaScript
Nov 8, 2026
dsh plugin --profile web add dsh-file-shieldGives DeepSeek Harness control of the Tabbit Browser: auto-loads the tabbit-browser skill on install, detects official Tabbit and Tabbit Browser releases (>= 1.9.0), checks the tabbit-cli persistent r
★ 115
↓ 818/wk
MIT
TypeScript
dsh plugin --profile web add dsh-tabbitby ningmengxr
DeepSeek Harness 插件:pip/GitHub 下载卡死一键急停 + 下载进度检测 + 卡死识别 + 隐形追加条件。Emergency stop for stuck pip/GitHub downloads in DSH.
★ 3
↓ 360/wk
MIT
TypeScript
Oct 24, 2026
dsh plugin --profile web add dsh-task-control