固定下载路径 Lstalu/dsh-dlpath

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