FinderClip(为macOS Finder提供直观的剪切粘贴体验)

为 macOS Finder 提供直观的剪切粘贴体验

✨ 简介¶

FinderClip 是一个轻量级的 macOS 菜单栏应用，让你可以在 Finder 中使用熟悉的 ⌘X 和 ⌘V 快捷键来剪切和移动文件，就像在 Windows 中一样自然。

前往GitHub仓库下载

🎯 功能特点¶

📖 使用方法¶

基本操作¶

1. ⌘X — 在 Finder 中选择文件后按 ⌘X 剪切
2. ⌘V — 导航到目标文件夹后按 ⌘V 移动
3. Esc — 按 Esc 键取消剪切状态

🚀 快速开始¶

系统要求¶

• macOS 12.0 或更高版本
• Xcode Command Line Tools

从源码构建¶

方式一：使用 Xcode（推荐）

1
2
3
4

git clone https://github.com/Wcowin/Mac-Finder-Clipboard.git
cd Mac-Finder-Clipboard
open FinderClip.xcodeproj
# 在 Xcode 中按 ⌘R 运行

方式二：命令行构建

1
2
3
4
5
6
7
8

git clone https://github.com/Wcowin/Mac-Finder-Clipboard.git
cd Mac-Finder-Clipboard

# 构建并运行
./scripts/build.sh --run

# 或仅构建
./scripts/build.sh

首次使用¶

1. 运行应用后，菜单栏会出现剪刀图标 ✂️
2. 如果显示 "⚠ 点击授予权限..."，点击它打开系统设置
3. 在辅助功能列表中找到并勾选 FinderClip
4. 返回应用，菜单栏显示 "✓ 已就绪" 即可使用

🛠 技术实现¶

核心技术¶

• CGEvent API - 拦截全局键盘事件
• Accessibility API - 检测焦点元素状态
• UserNotifications - 现代化的通知系统
• ServiceManagement - 开机自启支持

工作原理¶

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

用户按下 ⌘X
    ↓
检测是否在 Finder
    ↓
检测是否在文本编辑状态
    ↓
模拟 ⌘C 复制文件
    ↓
标记剪切模式
    ↓
用户按下 ⌘V
    ↓
转换为 ⌘⌥V（系统剪切粘贴）
    ↓
文件移动完成

📁 项目结构¶

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

Mac-Finder-Clipboard/
├── main.swift                    # 应用入口
├── AppDelegate.swift             # 应用代理和菜单栏
├── FinderCutPasteManager.swift   # 核心功能实现
├── SettingsManager.swift         # 设置管理
├── SettingsWindowController.swift # 设置界面
├── Assets.xcassets/              # 应用图标资源
├── FinderClip.xcodeproj/         # Xcode 项目
├── Info.plist                    # 应用配置
├── FinderClip.entitlements       # 权限配置
├── appcast.xml                   # Sparkle 更新源
├── build.sh                      # 构建脚本入口
├── scripts/
│   └── build.sh                  # 完整构建/发布脚本
├── tools/sparkle/                # Sparkle 签名工具
├── LICENSE                       # MIT 许可证
└── README.md                     # 说明文档

🚀 构建命令¶

1
2
3
4
5
6
7

./scripts/build.sh              # 构建 Debug 版本
./scripts/build.sh --run        # 构建并运行
./scripts/build.sh --release    # 构建 Release 版本
./scripts/build.sh --release 1.0.3  # 发布 v1.0.3
./scripts/build.sh --clean      # 清理构建
./scripts/build.sh --status     # 查看项目状态
./scripts/build.sh --help       # 显示帮助

🤝 贡献¶

欢迎参与项目开发！

1. Fork 本仓库
2. 创建你的特性分支 (git checkout -b feature/AmazingFeature)
3. 提交你的更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 打开一个 Pull Request

也欢迎提交 Issue 报告 Bug 或建议新功能！

📄 许可证¶

本项目采用 MIT License 开源。

👨‍💻 作者¶

Wcowin - GitHub

📝 更新日志¶

v1.0.3 (2025-12-30)¶

• 🌐 添加语言选择功能（中文/English）
• 🎛️ 设置界面新增语言切换器
• 💾 语言偏好自动保存并持久化
• 🔄 切换语言后界面立即更新
• 📐 优化设置窗口布局

v1.0.2¶

• 简化设置界面，更加简洁美观
• 优化菜单栏布局
• 授权后立即生效，无需重启应用
• 移除冗余功能

v1.0.1¶

• 首个公开发布版本

⭐ Star History¶

如果这个项目对你有帮助，请给它一个 Star ⭐

PS：打个广告，如果你需要 Mac 的粘贴板管理工具，可以试试 OneClip。OneClip 已经内置了 FinderClip 的功能，更加全面，欢迎体验！