File Manager — 用户手册 | YoBench

「File Manager」模块的用途

File Manager 是一个统一的浏览器,用于查看本机电脑与云存储中的文件。无需在 Finder/Explorer、FTP 客户端、S3 控制台与 WinSCP 之间来回切换,您只需一个窗口即可同时打开最多四个文件夹并排显示、在它们之间拖拽文件,并通过传输队列盯紧长时间的复制任务。

您将获得:

• 四种连接类型 — 本地磁盘、FTP、SFTP 以及 S3 兼容存储(Amazon S3、MinIO、Yandex Cloud、Backblaze B2、Cloudflare R2 等)。
• 最多四个文件夹并排 — 双栏、三栏或四栏浏览器,每一栏都有独立的导航、排序与筛选。
• 传输队列 — 复制与移动操作显示在独立面板中,展示每个文件的进度与字节数,支持暂停、恢复与取消。
• 断点续传上传 — 大文件在 S3 中按 8 MB 切块;若连接中断,传输会从最后一个成功的分片继续。
• 冲突处理 — 文件名冲突时可选择跳过、覆盖或自动重命名,并支持「应用到全部」选项。
• 检查器 — 图片、文本、PDF、视频与音频的预览,以及文件属性与按需计算的 SHA256 哈希。
• ZIP 归档 — 在浏览器内即可创建与解压。
• 会话恢复 — 应用重启后已打开的文件夹与栏位会被还原。
• 加密的凭据 — FTP 密码、SSH 密钥与云访问密钥均加密存储。

支持的连接及其参数

Local

• Folder — 文件夹路径。Choose 按钮会打开系统选择器。

FTP

• Host — 服务器地址。
• Port — 默认 21。
• Username 与 Password。
• Root path — 作为该连接的「根目录」,默认为 /。
• Use TLS — 启用 FTPS 的复选框,默认关闭。
• 连接以被动模式运行。

SFTP

• Host 与 Port(默认 22)。
• Username。
• Password — 用于密码认证(可选)。
• Private Key — SSH 私钥文本(-----BEGIN OPENSSH PRIVATE KEY-----…)。可选。
• Passphrase — 若密钥被口令保护时使用。
• Host Fingerprint — SHA256:… 格式的服务器指纹,用于 trust-on-first-use 校验。可选。
• Root path — 默认为 /。

可以使用密码、密钥,或两者同时使用。

S3 兼容存储

• S3 Endpoint — 提供商 URL。AWS S3 留空即可。示例:https://storage.yandexcloud.net、https://s3.us-west-002.backblazeb2.com、https://<account>.r2.cloudflarestorage.com,MinIO 则为 http://localhost:9000。
• S3 Region — 默认 us-east-1。
• S3 Bucket — 必填。
• S3 Prefix — Bucket 内的可选前缀,作为该连接的「根目录」。
• S3 Access Key 与 S3 Secret Key。
• Force Path Style — 针对需要 path-style URL 而非 virtual-hosted 的提供商(例如 MinIO)的复选框。默认关闭。

对于大文件,系统会自动启用分片上传(multipart upload),分片大小为 8 MB。

窗口布局

File Manager 同时支持最多四栏。每一栏都包含:

• 地址栏 — 当前路径;点击即可编辑(或按 Cmd/Ctrl+L)。
• 文件列表 — 可按名称、大小、修改时间或类型排序。
• 搜索 / 筛选输入框 — 按子串过滤列表。
• 隐藏文件开关 — 显示或隐藏点开头文件。

栏位可以增加和移除。当打开少于四栏时,右侧会显示 + Add column 按钮。使用 Tab / Shift+Tab 在栏位之间切换,或用 Cmd/Ctrl+1..4 直接跳转。

右侧可以打开检查器 — 一个带三个标签页的侧边面板:

• Preview — 选中文件的预览。支持图片、文本(最多 100,000 字符)、PDF、视频与音频。归档与二进制文件仅显示元数据。
• Properties — 大小、修改日期、完整路径。
• Hash — 按需计算的 SHA256。

检查器宽度可用鼠标调整(280 至 720 像素之间)。

传输队列

所有耗时操作(复制、移动、上传、下载)都会落入窗口底部的传输面板。可以隐藏并再次显示。

每个任务展示:

• 操作类型(复制、移动、上传)。
• 进度 — 已完成的文件数 / 总数。
• 状态 — 运行中、已暂停、已完成、已取消或失败。
• 字节进度。

可用操作:

• Pause(‖) — 暂停运行中的任务。
• Resume(▶) — 继续已暂停或失败的任务。
• Cancel(×) — 在任意状态下取消任务。
• Clear finished — 从列表中清除已完成的任务。

如果目标位置已存在同名文件,会弹出冲突处理对话框:

• Skip — 跳过此文件。
• Overwrite — 覆盖已有文件。
• Rename — 追加 (1)、(2) 等。
• Apply to all remaining conflicts — 把当前选择应用到此任务中剩余的所有冲突。
• Cancel job — 取消整个操作。

归档

文件或文件夹的右键菜单中有 Create archive(创建归档)与 Extract archive(解压归档):

• 支持的格式:ZIP。
• 归档可由任意栏中选中的文件打包(例如把本地文件夹打包成 ZIP 后直接上传到 S3)。
• 归档可以解压到任意连接的任意文件夹中。
• Zip-bomb 防护:解压后数据上限为 10 GB。

会话恢复

应用重启后会还原以下内容:

• 哪些栏曾经打开以及它们的宽度。
• 每一栏的连接与当前文件夹。
• 排序、筛选与隐藏文件开关。
• 当前激活的栏与检查器的宽度。

连接本身单独存储,绝不会丢失。会话在变更后以 0.5 秒去抖延迟自动保存。

文件夹实时更新

对于本地文件夹,File Manager 会监听文件系统并自行刷新列表 — 在 Finder/Explorer 中新增或删除文件,栏位会立即更新。对于远程连接(FTP、SFTP、S3),自动刷新不可用 — 请按 Cmd/Ctrl+R 或点击 Refresh 按钮重新读取文件夹。

安全

• FTP 密码、SSH 密钥、口令以及 S3 凭据均在本地应用数据库中加密存储。
• 渲染层(UI 进程)永远看不到原始密钥 — 只能看到「password set」/「key set」标志。
• Show password 按钮做了限速:每个进程每小时最多查看 5 次。
• 对 SFTP,可以固定服务器指纹(SHA256:…);下次连接时,应用会进行校验 — 防止网络上的服务器假冒。

键盘快捷键

设置

File Manager 设置共有四个分区:

• Sources — 已保存连接的完整 CRUD,提供 Test、隐藏与移除按钮。
• Behaviour — 默认行为:是否显示隐藏文件、拖放行为等。
• Hotkeys — 键盘快捷键参考表。
• About — 模块信息。

使用流程

1. 连接到本地文件夹

1. 在侧边栏打开 File Manager。
2. Settings → Sources → New source。
3. 类型选择 — Local。
4. 名称(例如「Documents」)与路径。
5. 保存。
6. 在浏览器中点击 + Add column 并选择新连接。

2. 连接到 S3

1. Settings → Sources → New source → 类型选择 S3。
2. 填写 Endpoint(AWS 留空即可)、Region、Bucket、Access Key、Secret Key。
3. 若您的提供商需要 path-style URL(例如 MinIO),请启用 Force Path Style。
4. Test — 连接应能成功列出对象。
5. 保存。

3. 在不同提供商之间复制文件

1. 打开两栏 — 一个本地文件夹,另一个 S3(或 FTP)。
2. 在源栏中选择文件(Cmd/Ctrl+A、Shift+click、Cmd/Ctrl+click)。
3. 把所选项拖到目标栏 — 或按 F5(复制) / F6(移动)。
4. 传输会出现在底部的传输面板中。如果目标已有同名文件,则弹出冲突对话框。
5. 关闭窗口或继续工作 — 传输会在后台运行。可以稍后暂停与恢复,甚至跨应用重启。

4. 把云端归档解压到本机电脑

1. 打开两栏:S3(或 FTP)与本地文件夹。
2. 在远程栏中找到 ZIP 归档。
3. 右键归档 → Extract archive。
4. 选择目标文件夹 — 甚至可以直接选择本地栏。
5. 解压会像普通传输一样在后台运行 — 带进度并支持暂停。

下一步

• DB Manager — 把数据库备份直接定时发到 S3 或 FTP 服务器。
• Scenarios — 自动化重复的文件搬运,并复用同一批连接。
• Settings — 配置主密码以保护每一个已保存的连接。

帮助与反馈

某项功能出问题或希望支持新的特性?通过反馈表单联系我们。