mini-clipboard

PGshenApache-2.0更新放缓

一款开源 macOS 剪贴板管理工具，主打简洁美观的界面和顺滑的操作体验，帮你在 Mac 上高效管理复制历史。

Open-source. Focused on simple, beautiful, and smooth experience.

v1.0.3发布于 2025-12-13 16:44 UTC255star24fork同步于 2026-11-07 07:33 UTC

剪贴板管理 macOS Swift 轻量工具

对比 GitHub 官网 clipboard mac mini

怎么上手

由 README 提炼，执行前请确认

原文

从 Releases 下载最新 .dmg，打开后将 Mini Clipboard.app 拖入 Applications 文件夹；源码构建可执行 make build 或 make app

硬件要求按 README 说明

仅支持 macOS 12+，Apple Silicon 原生；README 未说明 Intel 机型兼容性。

支持 Apple Silicon

下载：源码 zip·GitHub Releases（安装包）本站不镜像安装包

项目说明

由 README 自动翻译提炼

没人工点评？写下你的经验

macOS 上轻量好看的剪贴板管理器，帮你快速找回并跨应用粘贴历史内容

一款开源 macOS 剪贴板管理工具，主打简洁美观的界面和顺滑的操作体验，帮你在 Mac 上高效管理复制历史。

核心能力

自动采集文本、链接、图片、文件、颜色等剪贴板历史
时间线支持横向、纵向、网格三种布局，可预览与重命名
用 Pinboards 收藏分组，历史与收藏独立管理
双击直接粘贴，支持纯文本粘贴与顺序粘贴栈
关键词加类型、来源应用过滤，输入即搜

容易踩的坑

直接粘贴和顺序粘贴栈需在系统设置中开启“辅助功能”权限；首次安装需在“安全性与隐私”中允许已知开发者应用；历史默认保留 30 天，到期自动清理未收藏内容。

内容由模型根据 README 生成，可能不完整或不准确，以官方文档为准。看原文 README

用户点评

登录用户的真实使用记录，可按版本和硬件筛选

共 0 条

还没有人点评。第一个说出真实体验的人最有价值。

README 原文

未翻译

在 GitHub 打开

Mini Clipboard（macOS）

English | 中文

轻量、好看的 macOS 剪贴板管理器：采集历史、时间线浏览、收藏分组、直接粘贴、快速粘贴、即时搜索等能力，帮助你更快地跨应用粘贴内容。

功能特性

历史采集：自动捕获文本、链接、图片、文件、颜色等类型
时间线浏览：横向列表、纵向列表、网格三种布局，可快速预览与重命名
收藏分组：Pinboards 创建/重命名/颜色标记，历史与收藏独立
直接粘贴：双击快速复制，写入系统剪贴板，支持纯文本粘贴
搜索与过滤：关键词 + 类型/来源应用过滤，输入即搜
设置与快捷键：历史保留周期、布局切换、快捷键映射、面板位置调节

按键

面板：⇧+⌘+P（可设置修改）
直接粘贴：双击或回车键
快速预览：空格键
移动：方向键
搜索：任意键
多选：Shift 或 Command 键 + 鼠标点击

界面预览

列表布局网格布局查看演示视频：👇

安装指南

从 Releases 下载最新版本的.dmg。
打开下载的文件，将 Mini Clipboard.app 拖入 Applications 文件夹。
首次安装时，需要开启允许已知开发者的应用。
- 打开“系统偏好设置” → “安全性与隐私” → “安全”
- 点击“已知开发者”，确认允许 Mini Clipboard 安装。
从“应用程序”文件夹启动 Mini Clipboard。

环境要求

macOS 12+（Apple Silicon 原生）
Xcode 15+，Swift 5.9+

快速开始

使用 Xcode

打开 MiniClipboard.xcodeproj，选择 mini-clipboard Scheme，直接运行。

使用 Makefile

构建 Debug：
- make build
生成可分发的 .app：
- make app → 输出到 dist/Mini Clipboard.app
生成未签名 DMG：
- make dmg-unsigned → 输出到 dist/Mini-Clipboard.dmg
全流程签名与公证（需开发者证书/账号）：
- 配置 DEVELOPER_ID、TEAM_ID、APPLE_ID、APP_PASSWORD 或 NOTARY_PROFILE
- make package-signed
清理：
- make clean

应用图标（可选）

在 public/ 放置源图 logo.png 后可一键生成 iconset 与 logo.icns：
- make icon
若系统安装了 ImageMagick，将自动生成圆角矩形；否则使用方形。

权限与隐私

直接粘贴和顺序粘贴栈需要启用“辅助功能”权限。首次运行会弹窗引导打开系统设置。
历史保留期默认 30 天，可在设置中调整；到期自动清理未收藏的历史。

默认快捷键（可在设置中修改）

面板：⇧+⌘+P

目录结构

App/：应用入口、委托与面板窗口控制
Services/：剪贴板监听、快捷键、粘贴、搜索、隐私规则
Storage/：历史索引与设置持久化
UI/：面板根视图、历史时间线、设置页与控件
Models/：数据模型与枚举
dist/：构建产物（.app 与 .dmg）
public/：应用图标资源
docs/：需求与技术设计文档

开发者提示

本地数据目录：~/Library/Application Support/MiniClipboard/（索引与持久内容）。
重要模块：
- 剪贴板监听（Services/ClipboardMonitor.swift）
- 直接/栈式粘贴（Services/PasteService.swift）
- 快捷键注册（Services/HotkeyService.swift）
- 历史索引与清理（Storage/IndexStore.swift）
- 时间线 UI（UI/HistoryTimelineView.swift）

许可协议

开源协议：Apache License 2.0（见 LICENSE）。

mini-clipboard

怎么上手

项目说明