文件穿梭机 · Shuttle

DeepSeek Harness 插件：电脑显示一个二维码，手机用系统相机扫码，就能把照片、视频和任意文件直接传到这台电脑。数据只在同一个局域网内传输，不经过任何中转服务器；手机端零安装。

产品截图

桌面端	手机端

功能

• 扫码传文件：手机与电脑连同一个 WiFi，扫二维码打开上传页；手机页提供「相册」「文件」两个入口，相册包含系统相册与拍摄，微信内置浏览器同样可用。
• 断点能力：手机端按文件逐个上传，实时显示每个文件的进度；失败可以重新选择该文件重传。
• 最近 / 浏览双视图：DSH Web UI 的「最近」按日期分组展示所有子目录的接收文件；「浏览」以文件管理器风格浏览保存目录，支持路径面包屑、新建/重命名/删除文件与空目录、在系统文件管理器中打开。
• 搜索与视图：支持按文件名搜索；最近搜索接收记录，浏览搜索当前目录并可切换全部保存位置；支持类型、目录、时间筛选，以及宫格/列表和多种排序方式。
• 网络接口选择：电脑有多个网卡（VPN、虚拟机网桥等）时，手动选择与手机同一 WiFi 的地址，二维码随之更新。
• 链接重置：一键轮换一次性 token，旧二维码立即失效。
• 纯离线：二维码在 Host 端本地生成，不依赖任何外部服务。

安装

从 GitHub 安装（默认分支 main）：

plugin_manager install_bundle target=github:MC0571/Shuttle

本地目录安装（开发调试用）：

plugin_manager install_bundle target=<本仓库绝对路径>

安装后侧边栏会出现「文件穿梭机」入口；首次使用请允许系统防火墙的「接受传入连接」。

使用

1. 打开侧边栏「文件穿梭机」。
2. 手机上用系统相机扫描页面上的二维码（微信内置浏览器也可以：会显示单入口「文件」；需要照片/相机选择器时请用系统相机扫码）。
3. 在上传页选择照片/文件，选择保存子目录（可选），等待上传完成。
4. 回到电脑页面查看文件，可直接打开所在文件夹、重命名或删除。

配置

cordis.patch.yml 的 config 支持：

字段	含义
saveDir	接收目录；默认 <系统下载目录>/FileShuttle，文件默认保存在其下的 默认/ 子目录。界面上也可以随时修改，修改结果持久化到 $DSH_HOME/shuttle/settings.json。

运行期设置（保存目录、网络接口）由界面写入同一设置文件；二维码 token 每次 DSH 启动或手动重置时轮换。

接口

局域网监听端口（随机）：

GET  /s/<token>            手机上传页
GET  /s/<token>/dirs       可选保存子目录
POST /s/<token>/upload     原始文件流（?name=<文件名>&dir=<子目录>）
GET  /s/<token>/health     健康检查

同源管理 API（注册在 DSH Web 服务器的 /shuttle 前缀，仅供本机 Web UI 调用）：

GET  /shuttle/api/state
GET  /shuttle/api/qr.svg
GET  /shuttle/api/list?path=
POST /shuttle/api/mkdir
POST /shuttle/api/rename
POST /shuttle/api/delete
POST /shuttle/api/open
POST /shuttle/api/settings
POST /shuttle/api/rotate-token

安全说明

• 目标是“自己的手机 → 自己的电脑”：使用 128-bit 一次性 token、仅监听局域网、请求校验 token 后才可读写；token 在每次启动/重置时轮换。
• 管理 API 只挂在 DSH Web 服务器（默认仅回环地址）上，不暴露给局域网。
• 手机上传页是本地生成的自包含 HTML，不加载任何外部资源。
• 若要防止同一 WiFi 内的其他人窥探，请只在可信网络使用；后续可加入 HTTPS + 证书指纹（需要额外的配对流程）。

已知限制

• 手机零安装意味着 iOS 通过网页上传时可能把 HEIC 转成 JPEG、Live Photo 只保留静帧。
• 微信「扫一扫」打开局域网 IP + 非标准端口的地址时，可能被微信拦截或缓存，表现为“有时能开、有时没反应”；请优先使用系统相机，或按页面提示在浏览器中打开。
• 微信内的相册选择器路径可能在选图期间被系统回收（表现为页面重置、照片丢失），因此微信内只保留稳定的「文件」入口；需要更顺手的体验请改用手机系统相机扫码，或在浏览器中打开。
• iOS 切后台会挂起页面：大视频传输时请保持页面在前台。
• 删除目录仅支持空目录，避免误删整棵目录树。
• 当前版本不提供反向传输（电脑 → 手机）与剪贴板同步。