OneClip¶

点击链接加入群聊OneClip交流群

OneClip

一个简单专业的 macOS 剪贴板管理工具

🚀 高效 · 🎨 现代 · ⚡️ 流畅 · 🔒 安全

概览¶

OneClip 是一款专为 macOS 打造的专业级剪贴板管理工具。采用 100% SwiftUI 原生技术，实现更顺滑的动画、更自然的系统融合与更低的资源占用。

💡 为什么选择 OneClip？

• ✅ 纯原生开发：100% SwiftUI，无第三方框架依赖，性能卓越
• ✅ 独特创新：栈粘贴板、拖拽容器、脚本系统、AI 集成等创新功能，提升工作效率
• ✅ 隐私安全：数据完全本地存储，无任何网络上传
• ✅ 持续更新：社群积极维护，快速响应用户反馈
• ✅ 免费功能足够强大：提供完整功能，无任何限制，无任何广告，无任何隐私收集

核心功能¶

• 智能记录：自动保存剪贴板历史，支持文本、图片、文件等格式
• 全格式支持：图片/视频/音频/文档等，完整保留元数据
• 文本/图片编辑：支持文本/图片编辑，删除可撤销；支持置顶、收藏、删除等管理操作
• 栈粘贴板：⌘+⇧+C 呼出栈粘贴板，方便批量管理；⌘+V 依次粘贴栈内容，⌘+⇧+S 按行拆分捕获内容
• 快速粘贴面板：⌘+； 呼出快速粘贴面板，快速粘贴最近内容
• 拖拽容器：⌘+⇧+D 呼出拖拽容器，暂存并拖出文件/图片到其他应用
• 极速搜索：⌘+F随打随搜，多维筛选与搜索高亮，快速定位历史内容
• 菜单栏集成：菜单栏快速访问、分类搜索、悬停预览与一键复制粘贴(左键复制，右键粘贴一气呵成)
• 全局快捷键：⌘+⇧+V 呼出主界面（支持自定义组合）
• 快捷回复：⌘+⇧+R 呼出快捷回复界面，支持文本/图片/文件模板及导入导出
• OCR 识别：主动识别屏幕或图片文本，支持 OCR 翻译与快速提取
• 脚本功能：支持 JS 脚本编写，实现自动化操作
• AI 集成：支持本地 AI（Ollama/LMStudio）与在线 AI 服务，智能总结与翻译
• 云同步：支持 iCloud/Dropbox 等自定义同步方案与数据备份/导入导出
• 自定义存储位置：支持自定义数据存储位置，便于管理
• 灵活控制：Dock 图标、后台模式、主题适配等配置；支持列表/卡片视图切换
• 现代界面：遵循 macOS 设计规范，毛玻璃与暗黑模式适配
• 便捷安装：支持 Homebrew 一键安装（也支持Sparkle 自动更新）
• 访达增强：支持访达 ⌘+X 剪切文件，然后 ⌘+V 在其他位置移动文件（别处单独付费的功能，OneClip 免费开放给大家）

⬇️ 下载与安装¶

系统要求¶

• macOS 12.0 及以上
• Apple Silicon+intel支持

📦 安装¶

方式一：GitHub Releases（推荐）

1. 前往 Releases 页面 下载最新版本
2. 将 OneClip.app 拖入 Applications（应用程序）文件夹
3. 首次打开若提示"来自未知开发者"，请按以下步骤处理：

方式二：网盘下载

• 123网盘下载

方式三：Homebrew 安装

使用 Homebrew 安装 OneClip：

1

brew install --cask Wcowin/oneclip/oneclip

如遇到报错请先卸载再重新安装：

1

brew uninstall --cask oneclip

🔓 首次打开若提示"来自未知开发者/已被隔离"如何解决¶

方法一：终端命令（推荐）

1

sudo xattr -rd com.apple.quarantine /Applications/OneClip.app

方法二：系统设置

1. 打开 系统设置 → 隐私与安全性
2. 找到 OneClip 相关提示
3. 点击"仍然打开"

方法三：一键工具

• 使用 macOS 小助手 一键处理

💡 仍有问题？ - 详细教程：https://mp.weixin.qq.com/s/qjSx09tqNq1KfVug2WtQFg - 联系作者：vip@oneclip.cloud

🎬 功能演示¶

📹 视频教程 - B 站：https://space.bilibili.com/1407028951/lists/5012369?type=series

核心功能展示¶

1️⃣ 主窗口 - 快速访问历史¶

• 按 ⌘+⇧+V 呼出主窗口
• 支持列表/卡片双模式切换
• 实时搜索、分类筛选
• 点击即可粘贴到当前应用

2️⃣ 栈粘贴板 - 批量复制粘贴¶

• ⌘+⇧+C 呼出栈面板
• 将多个项目加入栈中
• ⌘+V 依次粘贴（默认行为）
• 适合表单填写、批量编辑场景

3️⃣ 快捷回复 - 常用文本模板¶

• ⌘+⇧+R 呼出快捷回复
• 支持文本、图片、文件模板
• 可设置独立快捷键
• 支持导入/导出配置

4️⃣ 拖拽容器 - 文件临时存储¶

• ⌘+⇧+D 呼出拖拽容器
• 暂存文件、图片等内容
• 支持拖出到其他应用
• 适合文件整理、批量上传

5️⃣ 菜单栏 - 极简快捷访问¶

• 点击菜单栏图标查看最近项目
• 悬停预览内容详情
• 支持拖拽操作
• 快速粘贴常用内容

6️⃣ 快速粘贴面板 - 快速粘贴最近内容¶

• ⌘+；呼出快速粘贴面板
• 粘贴方便快捷，支持快速粘贴最近内容

🏗️ 技术与架构¶

核心技术栈¶

• Swift 5.9+
• SwiftUI (100% 原生)
• SQLite + WAL (数据持久化)
• Carbon Framework (全局热键)
• Accessibility API (权限管理)
• Sparkle (自动更新)
• Xcode 15+

架构设计¶

flowchart TB
    subgraph App["OneClip App"]
        L1["SwiftUI Views & ViewModels"]
        L2["ClipboardManager | SettingsManager<br/>HotkeyManager | WindowManager<br/>FavoriteManager | BackupManager"]
        L3["SQLite | Carbon | Accessibility"]
        L4["macOS System APIs"]
        L1 --> L2 --> L3 --> L4
    end
    style L1 fill:#e3f2fd
    style L2 fill:#fff3e0
    style L3 fill:#e8f5e9
    style L4 fill:#f3e5f5

核心组件¶

性能优化策略¶

• 批量更新机制：减少频繁的视图重绘
• 搜索防抖：延迟触发更新，避免每个字符都重新搜索
• 索引预计算：按类型分组，快速筛选
• 智能监控：根据活动状态自适应调整监控频率
• 懒加载缓存：按需加载图片和文件内容
• 内存压力管理：自动释放不必要的缓存

权限配置¶

首次启动时，OneClip 需要以下系统权限：

1. 辅助功能权限（必需）
2. 系统偏好设置 → 安全性与隐私 → 隐私 → 辅助功能

3. 添加 OneClip 并启用

4. 磁盘访问权限（可选，用于文件操作）

5. 系统偏好设置 → 安全性与隐私 → 隐私 → 完全磁盘访问
6. 添加 OneClip 并启用

🚀 使用指南¶

基础操作¶

1. 启动应用
2. 双击 OneClip.app 启动

3. 应用将在状态栏显示图标

4. 快速访问

5. 按 ⌘+⇧+V 打开主界面

6. 点击状态栏图标快速粘贴

7. 快捷回复

8. 按 ⌘+⇧+R 打开快捷回复界面

9. 点击快捷回复即可粘贴

10. 内容管理

11. 复制任何内容，自动保存到历史
12. 在主界面搜索和浏览历史记录
13. 点击任意项目即可粘贴

🎓 高级功能（逐步完善）¶

📁 智能分类系统¶

• 系统分类：文本、图片、文件、链接、代码等自动识别
• 自定义分类：支持创建自定义分类规则
• 颜色标记：不同分类使用不同颜色区分

🔍 强大搜索功能¶

• 实时搜索：随打随搜，即时显示结果
• 搜索高亮：匹配内容自动高亮显示
• 历史记录：保存搜索历史，快速复用（TODO）

⚙️ 丰富配置选项¶

• 外观设置：列表/卡片视图、暗黑模式、字体大小
• 存储策略：历史数量限制、自动清理、大文件处理
• 隐私保护：排除特定应用、敏感内容过滤
• 快捷键自定义：支持所有功能的快捷键配置

🔄 数据备份与同步¶

• 本地备份：自动/手动备份到本地
• 云同步：自定义同步方案
• 导入导出：支持配置和数据的导入导出

🛠️ 源码构建（早期版本）¶

我们开源了早期版本的源码，你可以自行下载构建：

快速开始¶

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# 克隆仓库
git clone https://github.com/Wcowin/OneClip.git
cd OneClip/src

# 构建
chmod +x build.sh
./build.sh

# 运行
open dist/OneClip.app

系统要求¶

• macOS 12.0+
• Xcode 15.0+

详细构建说明请查看 src/README.md

⚠️ 注意：开源的是早期版本（基于文件系统），采用 MIT 协议。当前正式版已采用数据库存储，功能更完善，为商业软件。

🐛 常见问题（FAQ）¶

1

sudo xattr -rd com.apple.quarantine /Applications/OneClip.app

开发路线图¶

✅ 已完成¶

• 基础剪贴板管理功能
• 全局快捷键支持
• 多格式内容支持（文本/图片/文件）
• 栈粘贴板功能
• 快捷回复系统
• 拖拽容器
• AI 功能集成
• Sparkle 自动更新
• 更多 AI 服务商集成
• 自定义同步方案
• 快速粘贴面板
• 云同步功能
• UI/UX 改进
• 脚本系统
• 密码保护

🚧 进行中¶

• 性能/功能持续优化
• 多语言支持完善

📋 计划中¶

• 插件系统
• 团队协作功能
• iOS/iPadOS/Windows客户端

💡 有功能建议？欢迎在 GitHub Discussions 提出！

关于作者¶

Wcowin

博客 | GitHub | 邮箱

🤝 反馈与支持¶

如果您在使用过程中遇到问题或有改进建议，欢迎通过以下方式联系：

📮 联系方式¶

⭐ 支持项目¶

如果 OneClip 对你有帮助，请考虑：

• 🌟 在 GitHub 上给个 Star
• 🔄 分享给你的朋友
• 📝 写使用体验或评测
• 💰 购买许可证支持开发
• 🐛 报告 Bug 或提出改进建议

🙏 致谢¶

感谢以下开源项目和服务：

• SwiftUI - Apple 的现代化 UI 框架
• Sparkle - macOS 自动更新框架
• Syncthing - 开源文件同步工具
• Ollama - 本地 AI 模型运行环境

感谢所有用户的支持和反馈！🎉

Star History¶