OneClip¶

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

OneClip

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

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

概览¶

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

💡 为什么选择 OneClip？

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

🎯 核心功能¶

• 📋 智能记录：自动保存剪贴板历史，支持文本、图片、文件等格式

• 🔎 极速搜索：随打随搜，多维筛选快速定位

• 🗂️ 全格式支持：图片/视频/音频/文档等，完整保留元数据

• ⌨️ 全局快捷键：⌘+⇧+V 呼出主界面，支持自定义组合

• 🔄 快捷回复: ⌘+⇧+R 呼出快捷回复界面，支持自定义组合

• 🎨 布局多样：支持列表/卡片双模式切换。支持Paste同款布局。

• 😼 文本/图片编辑：支持文本/图片编辑。删除内容可撤销。置顶、收藏、删除样样有。

• 📥 栈粘贴板：⌘+⇧+C呼出栈粘贴板，方便管理。⌘+V依次粘贴栈粘贴板内容。

• 🎯 菜单栏集成：支持菜单栏分类搜索，一键复制粘贴最近内容，状态实时可见。只需要左键复制/粘贴，所见即所得。

• 💾 自定义存储位置：支持自定义存储位置，方便管理

• 📦 拖拽容器：⌘+⇧+D呼出拖拽容器，存取文件方便快捷

• 🧀 OCR识别：支持主动识别屏幕/图片内容识别，OCR翻译，快速提取文字和翻译

• 🔧 灵活控制：Dock 图标、后台模式、主题适配均可配置。列表/卡片双模式切换。支持Paste同款布局。

• 🍺 便捷安装：支持 Homebrew 一键安装(即将支持)和Sparkle自动更新

• 🎨 现代界面：遵循 macOS 设计规范，毛玻璃与暗黑模式适配

• 🤖 AI 集成：支持本地 AI 模型（Ollama/LMStudio）和在线 AI 服务（比如智谱清言、通义千问），智能总结与翻译

• ☁️ 云同步：支持iCloud/Dropbox等自定义方式的多设备历史记录同步，数据安全可控

• 👍 访达增强：支持访达⌘+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️⃣ 菜单栏 - 极简快捷访问¶

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

🏗️ 技术与架构¶

核心技术栈¶

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

架构设计¶

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

      ┌─────────────────────────────────────────┐
      │              OneClip App                │
      ├─────────────────────────────────────────┤
      │     SwiftUI Views & ViewModels          │
      ├─────────────────────────────────────────┤
      │  ClipboardManager | SettingsManager     │
      │  HotkeyManager    | WindowManager       │
      │  FavoriteManager  | BackupManager       │
      ├─────────────────────────────────────────┤
      │     SQLite  | Carbon  | Accessibility   │
      ├─────────────────────────────────────────┤
      │         macOS System APIs               │
      └─────────────────────────────────────────┘

核心组件¶

性能优化策略¶

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

权限配置¶

首次启动时，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 客户端

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

👨‍💻 关于作者¶

Wcowin

📝 博客 • 🐙 GitHub • 📧 邮箱

🤝 反馈与支持¶

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

📮 联系方式¶

⭐ 支持项目¶

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

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

🙏 致谢¶

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

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

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

Star History¶