ClipboardHistory for macOS

一个轻量、原生的 macOS 菜单栏剪贴板历史工具。它会保存最近 30 条文本剪贴板内容，按 Control + V 打开搜索面板，选择记录后自动复制并粘贴到之前使用的应用。

功能

• 菜单栏常驻，不占用 Dock 图标
• 自动保存最近 30 条文本剪贴板内容
• 支持搜索、重复内容去重和多行文本
• Control + V 快捷键打开历史面板
• 选择记录后自动发送 Command + V
• 数据只保存在本机，不需要网络或第三方服务

系统要求

• macOS 13 或更高版本
• Apple Silicon Mac（当前预构建安装包为 arm64）

安装

在 Releases 下载最新版，或使用仓库中的安装包：

• dist/ClipboardHistory-1.0.0-arm64.dmg：打开后将应用拖入“应用程序”，推荐使用。
• dist/ClipboardHistory-1.0.0-arm64.pkg：双击并按安装器提示安装。

当前安装包使用本地 ad-hoc 签名，不包含 Apple Developer ID。首次打开时，如果 macOS 提示无法验证开发者，请在“系统设置 → 隐私与安全性”中允许打开，或在 Finder 中右键应用并选择“打开”。

权限

应用可以在没有辅助功能权限时记录和复制剪贴板内容。如果需要选择后自动粘贴，请在：

系统设置 → 隐私与安全性 → 辅助功能

中允许 ClipboardHistory。未授予权限时，应用仍会把选中的内容复制到系统剪贴板，可以手动按 Command + V 粘贴。

从源码运行

需要安装 Xcode Command Line Tools：

swift run

构建安装包

./build-mac.sh

构建脚本会编译 arm64 release、生成标准 .app，并在 dist/ 中生成 .dmg 和 .pkg。也可以只构建可执行文件：

swift build -c release --triple arm64-apple-macosx13.0

许可证

本项目采用 MIT License。