dsh-dlpath · 固定下载路径插件

为 DeepSeek Harness 提供固定的下载/存储目录：默认存储位置可在设置页修改；下载自动新建时间戳文件夹；C 盘非必要路径自动重定向到存储位置，避免文件散落 C 盘。

纯静态 profile 插件，随部署自动加载，无需每次手动运行。

功能

• 固定存储位置：所有下载统一进入默认存储目录（自动探测首个可写的非 C 盘 Downloads：D→E→F→G，全部不可写时退回系统下载目录）。
• 下载自动建文件夹：每次下载在存储目录下自动新建时间戳文件夹存放文件（如 D:\Downloads\2026-08-17-153025\xxx）；支持 subdir 显式子目录。
• C 盘重定向规则：仅「必须留在 C 盘」的路径（C:\Windows、Program Files*、ProgramData、AppData、用户点目录如 .dsh）保留原位；其余指向 C 盘的保存目标自动重定向到存储位置；非 C 盘路径不干预。
• 双通道下载：优先 web.fetch（文本）；web provider 缺失时自动回退 curl.exe（经宿主 shell，支持二进制）。
• GUI 设置页：侧边栏 → 设置 →「下载存储」——查看/修改存储位置（含目录浏览）、落盘规则说明、已存文件列表（可下载）。
• 文件取回路由：/dlpath/<目录>/<文件> 直接下载（支持子目录）。

安装

方式一：从 GitHub（推荐）

dsh plugin --profile web add lstalu/dsh-dlpath

方式二：本地 link（开发）

在 profile 的 package.json 添加依赖并加入 dsh.profile.bundles：

// dsh-home/profiles/web/package.json
{
  "dependencies": { "dsh-dlpath": "link:F:/path/to/dsh-dlpath" },
  "dsh": { "profile": { "bundles": [ "…", "dsh-dlpath" ] } }
}

然后在 dsh-home/profiles/web/node_modules 建立链接（或 pnpm install），重启 DSH。

依赖说明：插件在运行时使用宿主的 @deepseek-ai/dsh-tools（peerDependency）。本地 link 安装时，若解析不到，需在包内提供 node_modules/@deepseek-ai 链接到宿主 vendor 树（resources/vendor/dsh/node_modules/@deepseek-ai）。

使用

• 模型工具：
  • download_file(url, name?, subdir?, target?) — 下载到固定存储位置
  • dlpath_status() — 查看当前存储位置 / 是否在 C 盘 / 配置文件
  • dlpath_set_dir(dir) — 更改默认存储位置（目录不存在自动创建，持久化）
• 设置页：侧边栏 → 设置 →「下载存储」
• 取回文件：http://127.0.0.1:<端口>/dlpath/<目录>/<文件>

配置

配置文件：<用户目录>/dlpath.config.json（JSON：{ "dir": "F:/Downloads" }），由插件读写，进程重启后自动恢复。

目录结构

dsh-dlpath/
├── package.json        # 包声明（dsh.bundle.patch + dsh.client）
├── cordis.patch.yml    # 宿主组合行（insert dlpath）
├── index.mjs           # 宿主半体：3 个工具 + dlpath 服务 + /dlpath 路由 + /dlpath-api/* API
└── lib/client.js       # 浏览器半体：设置页「下载存储」

限制

• web.fetch 只返回文本/html 正文；二进制文件经 curl 兜底通道下载。
• /dlpath 路由只服务文本文件（读取通道限制）。
• 浏览器「另存为」的目标目录由浏览器设置决定，不受本插件控制。

License

MIT © lstalu