S3 Explorer

S3 Explorer 是一个 macOS 原生 S3 对象存储浏览器，面向日常查看、预览、上传、下载和整理对象存储文件的场景。界面采用三栏结构：左侧 profile 与位置导航，中间对象列表，右侧详情与预览。

功能

• 多 profile：可保存多个 S3 / S3 兼容存储连接配置。
• 目录浏览：按 prefix 以类似文件夹的方式浏览对象。
• 递归模式：在当前路径下递归查看对象。
• 搜索：支持当前路径或递归结果中的对象搜索。
• 文件预览：选中文件后在右侧自动内联预览常见图片、文本、PDF、音频和视频。
• 外部预览：双击文件或按空格使用系统 Quick Look。
• 下载：支持单文件下载和目录打包为 ZIP 下载。
• 上传：支持上传文件和上传文件夹；空文件夹会被跳过，因为 S3 不保存真实目录。
• 分享：下载临时副本后调用 macOS 分享面板。
• 删除：支持删除对象和按 prefix 删除目录内容，并在删除前展示确认信息。
• 传输队列：显示上传、下载进度、失败信息和完成状态。

使用

1. 启动应用后创建或选择一个 Profile。
2. 填写 Endpoint、Region、Bucket、Access Key ID、Secret Access Key 和可选 Session Token。
3. 对于 MinIO、R2 等 S3 兼容服务，通常需要开启 path-style endpoint。
4. 保存后应用会自动连接并加载 Bucket 根目录。
5. 在对象列表中单击选择，双击打开目录或 Quick Look 文件。

预览支持

内联预览会自动加载常见小文件：

• 图片：jpg、jpeg、png、gif、heic、webp、tiff、bmp
• 文本：txt、md、json、xml、csv、log、swift、js、ts、html、css
• 文档：pdf
• 媒体：mp4、mov、m4v、mp3、wav、m4a、flac

较大的文件不会自动内联加载，可以使用 Quick Look 或下载后查看。音视频内联预览默认不自动播放。

本地数据

Profile、收藏和最近路径保存在当前 Mac 的 UserDefaults 中。连接信息只用于本机访问对象存储，不会写入仓库。

开发

要求：

• macOS
• Xcode 17 或更新版本

构建 Debug：

make debug

构建 Release：

make release

发布 DMG

本仓库可直接使用 Xcode 的 Release 构建产物生成 DMG。生成后的文件位于 dist/ 目录。

make dmg

验证 DMG：

make verify-dmg

注意

• S3 没有真实目录，界面中的目录是根据对象 key prefix 推导出来的。
• 上传文件夹时，只有文件会上传；空文件夹不会出现在 S3 中。
• 删除目录会删除所有以该 prefix 开头的对象，请在确认窗口中检查对象数量和 key。