macOS Finder 扩展

百度网盘,
装进 Finder
侧边栏

像 iCloud Drive 一样,直接在 Finder 里浏览、下载、上传百度网盘文件。 不再需要官方客户端,不再频繁切换窗口。

macOS 12 Monterey 或更新 · 需要 bdpan CLI

New in Finder
视频
照片
demo.mp4
photo.jpg
ZIP
archive.zip
备份
banner.png
文档
8 个项目,可用空间 14.2 TB(百度网盘)

为什么选择 BdpanFinder

跟 macOS融为一体

🗂
Finder 原生集成

百度网盘出现在 Finder 侧边栏「位置」下,与 iCloud Drive、本地硬盘并列,完全原生。

⬇️
双击即下载

双击任意文件即可下载并打开,不需要手动选择保存路径,文件由 macOS 统一管理。

⬆️
拖拽上传

把本地文件拖进百度网盘文件夹,自动上传。支持创建文件夹、移动、删除。

🔒
沙盒外运行

个人开发工具,绕过 App Store 沙盒限制,可直接调用 bdpan CLI,兼容性更好。

菜单栏管理

菜单栏图标常驻,随时刷新、重连。不占 Dock 位置,专注后台运行。

🛠
开源可定制

完整 Swift 源码,基于 NSFileProviderReplicatedExtension,可自由修改 bdpan CLI 路径。


五分钟从零到能用

1
安装 bdpan CLI 并登录

BdpanFinder 通过 bdpan 命令行工具操作百度网盘,需先完成安装和鉴权。

$ bdpan login
# 完成后验证
$ bdpan whoami
2
克隆源码,用 Xcode 打开

项目使用 XcodeGen 管理,执行以下命令生成 Xcode 工程文件。

$ git clone https://github.com/
  jianshuo/bdpan-finder
$ xcodegen generate
$ open BdpanFinder.xcodeproj
3
配置代码签名

在 Xcode 的 Signing & Capabilities 中,为 BdpanFinderBdpanFinderExt 两个 Target 分别勾选 Automatically manage signing,选择你的 Apple 开发者账号。

4
构建并运行

⌘B 构建,⌘R 运行。几秒后,Finder 侧边栏「位置」下会出现「百度网盘」。

架构示意
🗂 Finder
文件请求 / 枚举 / 上传 / 下载
NSFileProvider API
🔌 BdpanFinderExt
File Provider Extension(沙盒关闭)
Process() shell out
💻 bdpan CLI
/usr/local/bin/bdpan · ls / download / upload / rm
HTTPS · Baidu PCS API
☁️ 百度网盘
pan.baidu.com 云存储

最低系统要求

坦诚说明不完美的地方

开源项目,欢迎 Fork

完整 Swift 源码托管在 GitHub。如果你也在用百度网盘,欢迎试用、提 issue,或者直接 PR。

jianshuo/bdpan-finder