🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI

安全文件下载 Apoze/dsh-safe-download-files

DeepSeek Harness
Apoze56 天前有提交已提供中文文档扫描:含敏感能力

带 SSRF 防护与类型校验地下载公共文件到工作区

29.1/100
综合分
0
GitHub 星标
—
npm 周下载
—/5
用户评分

数据截至 2026/9/16 · 周下载取自 npm 全网(含 CI / 镜像),非本站安装数;综合分由星标、活跃度与兼容性检查合成。

该插件未发布到 npm,按作者文档从 GitHub 源安装即可(静态检查只覆盖 npm 路径,不代表插件不可用)。
安装命令 · 需先装 dsh CLI 引擎
dsh plugin --profile web add Apoze/dsh-safe-download-files
该包不可直接 npm 安装,改从 GitHub 源安装(明细见下方安装检查)

状态速览

判定依据:实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态
信任档位:需留意
是什么
dsh 原生插件 · security
装得上吗
实装验证未通过(dep_tree_unresolvable),装前请到仓库确认最近更新与 issue
安全吗
本站尚未对该插件做风险分级
暂未覆盖,不等同于无风险
还在维护吗
更新放缓:最近一次提交在 56 天前
档位由哪些信号合成

本站实装验证(真实安装 L4 覆盖全站;L5 为运行时冒烟或实机截图,覆盖范围小于 L4) · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。 下方各区块是它的证据明细。

验证判据与等级说明 →
⚠︎ 实装验证未通过(dep_tree_unresolvable · 2026/9/25) ——可能是验证环境差异,装前建议到 GitHub 仓库确认最近更新与 issue。
社区实装还没有人打卡 · 装过的第一个就是你
安装兼容性检查需源码安装

engines.node 要求 >=22.22.2,不满足 Node 22.19.0;仓库 package.json 标记 private,未发布到 npm,需从源码安装

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

✗npm 包dsh-safe-download-files(未发布到 npm,仅可源码安装)
✗Node 引擎要求 >=22.22.2 · 基线 Node 22.19 不满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明

源码安装时若 pnpm 拦截 prepare 脚本,按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑。

验证方式:npm registry 存在性 + package.json 静态校验 · 最后检查 2026/9/23 02:25:55

安全扫描自动 · 静态分析源码
v2.7.0
🔵 扫描:含敏感能力尚无人工评估
展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力:执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量(至少其一)。这是能力清单,不是危险判定——具体能力项与证据见下方,安装前请自行判断是否需要。

读写/删除本地文件发起外部网络请求
查看扫描证据(共 7 处,展示前 7 条)
  • 删除本地文件
    downloader.js:132
    if (tempPath !== undefined) await unlink(tempPath).catch(() => undefined);
  • 发起网络请求
    downloader.js:185
    const response = await transport.request(url, signal, { "user-agent": USER_AGENT });
  • 读取本地文件
    downloader.js:247
    for await (const chunk of createReadStream(path)) {
  • 读取本地文件
    downloader.js:279
    const workspace = await realpath(cwd);
  • 写入本地文件
    downloader.js:282
    await mkdir(candidate, { recursive: true, mode: 0o700 });
  • 读取本地文件
    downloader.js:283
    const actual = await realpath(candidate);
  • 删除本地文件
    downloader.js:305
    await unlink(tempPath);
扫描于 2026/11/4(0 天前) · 范围 入口闭包 + 发布文件清单 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用,不构成安全背书;人工评估与自动扫描相互独立、互不覆盖。

依赖的 DSH / Cordis 模块
@deepseek-ai/cordis@deepseek-ai/dsh-invariants@deepseek-ai/dsh-system-prompt@deepseek-ai/dsh-tools@deepseek-ai/dsh-web
给这个插件打分还没有人投票↓
用户评分
还没有人投票,来当第一个

功能亮点

  • SSRF防护
  • MIME类型校验
  • 下载公共文件到工作区

为 DeepSeek Harness 提供安全的 download_files 工具,带 SSRF 防护和 MIME 校验。

README

由 DeepSeek 最新模型翻译生成
DeepSeek Harness 的安全文件下载 一个 DeepSeek Harness 插件,暴露一个模型工具: download_files({ directory?: string, items: [{ url: string, file_name?: string }] }) 它可以将公共文件安全地下载到当前 DSH 工作区。这是一个非官方社区插件。 安全性 - 仅使用 HTTP(S) GET,不接受模型控制的请求头、Cookie 或凭据。 - 阻止 localhost、私有网络、元数据端点和保留 IP 地址范围。 - 固定已验证的 DNS 结果,并对每次重定向重新验证。 - 检测真实文件类型,并拒绝不匹配或未知的内容。 - 拒绝可执行文件、脚本、压缩包、Office 文件、HTML、SVG 和 WebAssembly。 - 拒绝绝对路径、父目录遍历、不安全名称和逃逸符号链接。 - 先写入临时文件,再以原子方式发布。 - 绝不覆盖已存在的文件。 接受的内容包括光栅图像、PDF、UTF-8 文本/Markdown/CSV/JSON/XML,以及常见的音频/视频格式。
展开完整文档(README 剩余 1 节)
DeepSeek Harness 的安全文件下载

一个 DeepSeek Harness 插件,暴露一个模型工具:

download_files({
directory?: string,
items: [{ url: string, file_name?: string }]
})

它可以将公共文件安全地下载到当前 DSH 工作区。这是一个非官方社区插件。

安全性

- 仅使用 HTTP(S) GET,不接受模型控制的请求头、Cookie 或凭据。
- 阻止 localhost、私有网络、元数据端点和保留 IP 地址范围。
- 固定已验证的 DNS 结果,并对每次重定向重新验证。
- 检测真实文件类型,并拒绝不匹配或未知的内容。
- 拒绝可执行文件、脚本、压缩包、Office 文件、HTML、SVG 和 WebAssembly。
- 拒绝绝对路径、父目录遍历、不安全名称和逃逸符号链接。
- 先写入临时文件,再以原子方式发布。
- 绝不覆盖已存在的文件。

接受的内容包括光栅图像、PDF、UTF-8 文本/Markdown/CSV/JSON/XML,以及常见的音频/视频格式。

安装

dsh plugin --profile web add "git+https://github.com/Apoze/dsh-safe-download-files.git#main"

这是一个完整的 DSH bundle。安装后重启 DSH:

dsh --profile web --dump-config
dsh web

无需手动添加 Cordis 条目。

限制

| 限制 | 值 |
| 每次调用的文件数 | 100 |
| 并发下载数 | 8 |
| 文件大小 | 25 MB |
| 单次调用总大小 | 250 MB |
| 重定向次数 | 5 |
| 每个文件的超时时间 | 30 秒 |
| 工具超时时间 | 420 秒 |

当同一批次中的其他项失败时,成功的文件仍会保留。

测试

pnpm install --frozen-lockfile
pnpm test

测试套件涵盖 SSRF、DNS 固定、重定向验证、MIME 不匹配、路径遍历、冲突、取消、大小限制和部分失败。

许可证

MIT

HTTP 传输维护

版本 0.1.1 使用编译后的 Apoze dsh-safe-web-fetch 0.1.0-next.1 发布版(源码提交 736e690cccd2d74126455633cd92fd252c35de08),并通过 lockfile 完整性哈希进行固定。其 Undici 8.10.2 修复了 https://github.com/nodejs/undici/issues/5360 中描述的未捕获的暂停解析器 EOF 崩溃。未使用运行时异常抑制或 node_modules 补丁。现有的 DNS 固定、私有地址拒绝、取消和大小限制仍然有效。
预览分享卡片长什么样 ↓Apoze/dsh-safe-download-files
分享 · DeepSeek Harness Hub
Apoze/dsh-safe-download-files

带 SSRF 防护与类型校验地下载公共文件到工作区

这是你的仓库?认领条目

回到顶部