OneClip¶

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

OneClip

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

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

概览¶

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

💡 为什么选择 OneClip？

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

🎯 核心功能¶

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

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

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

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

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

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

• 😼 文本/图片编辑：支持文本/图片编辑。

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

• 🎯 菜单栏集成：一键复制粘贴最近内容，状态实时可见。左键复制，右键粘贴，所见即所得。

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

• 📦 拖拽容器：Control+Shift+D呼出拖拽容器，方便管理

• 🔧 灵活控制：Dock 图标、后台模式、主题适配均可配置

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

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

• 🤖 AI 集成：支持本地 AI 模型（Ollama）和在线 AI 服务

• ☁️ 云同步：支持 Syncthing 和自定义iCloud等等方式的多设备同步，数据安全可控

• 👍 访达增强：支持访达Cmd+X剪切文件，然后Cmd+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 站：OneClip 完整使用教程
YouTube：OneClip Full Tutorial

核心功能展示¶

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

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

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

• Control+Shift+C 呼出栈面板
• 将多个项目加入栈中
• Control+Shift+V 依次粘贴
• 适合表单填写、批量编辑场景

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

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

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

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

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

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

🏗️ 技术与架构¶

核心技术栈¶

• Swift 5.9+
• SwiftUI (100% 原生)
• Core Data (数据持久化)
• 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       │
      ├─────────────────────────────────────────┤
      │    Core Data | Carbon | Accessibility   │
      ├─────────────────────────────────────────┤
      │         macOS System APIs               │
      └─────────────────────────────────────────┘

核心组件¶

性能优化策略¶

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

权限配置¶

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

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

3. 添加 OneClip 并启用

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

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

🚀 使用指南¶

基础操作¶

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

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

4. 快速访问

5. 按 Cmd+Option+V 打开主界面

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

7. 快捷回复

8. 按 Cmd+Option+R 打开快捷回复界面

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

10. 内容管理

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

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

📁 智能分类系统¶

• 系统分类：文本、图片、文件、链接、代码等自动识别
• 自定义分类：支持创建自定义分类规则
• 正则表达式：基于正则匹配的智能分类
• 颜色标记：不同分类使用不同颜色区分

🔍 强大搜索功能¶

• 实时搜索：随打随搜，即时显示结果
• 多字段匹配：支持内容、来源应用、分类等多维度搜索
• 搜索高亮：匹配内容自动高亮显示
• 历史记录：保存搜索历史，快速复用

⚙️ 丰富配置选项¶

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

🔄 数据备份与同步¶

• 本地备份：自动/手动备份到本地
• 云同步：基于 Syncthing 的多设备同步
• 导入导出：支持配置和数据的导入导出

⚙️ 配置选项¶

⌨️ 快捷键速查表¶

💡 所有快捷键均可在设置中自定义，支持检测冲突

界面设置¶

• Dock 图标: 自动显示/隐藏
• 启动模式: 开机自启动选项
• 主题适配: 自动跟随系统主题
• 快捷回复: 设置快捷回复快捷键
• 丰富模式/极简模式: 切换界面模式

存储设置¶

• 历史数量: 可设置最大保存条目数
• 数据清理: 定期清理过期内容
• 文件处理: 大文件存储策略

📊 性能与体验¶

• 内存占用: 运行时约120MB
• CPU 使用: 空闲时 < 1%
• 启动时间: < 1 秒
• 响应速度: 快捷键响应 < 100ms
• 存储效率: 智能压缩，节省磁盘空间
• 性能优化: 智能管理，优化性能
• 性能监控: 实时监控性能指标
• 粘贴板自适应监控: 根据活动与资源自动调整频率

🐛 常见问题（FAQ）¶

1

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

🗺️ 开发路线图¶

✅ 已完成¶

• 基础剪贴板管理功能
• 全局快捷键支持
• 多格式内容支持（文本/图片/文件）
• 栈粘贴板功能
• 快捷回复系统
• 拖拽容器
• AI 功能集成
• Syncthing 云同步
• Sparkle 自动更新
• Homebrew 支持

🚧 进行中¶

• 更多 AI 服务商集成
• 性能持续优化
• UI/UX 改进
• 多语言支持完善

📋 计划中¶

• iCloud 同步支持
• 浏览器扩展
• 插件系统
• 团队协作功能
• iOS/iPadOS 客户端
• 更多第三方服务集成

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

👨‍💻 关于作者¶

Wcowin

📝 博客 • 🐙 GitHub • 📧 邮箱

🤝 反馈与支持¶

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

📮 联系方式¶

⭐ 支持项目¶

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

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

🙏 致谢¶

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

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

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