CopyLists
macOS 13+·原生 Swift·纯本地·MIT
你的剪贴板，终于有了记忆
每天你复制粘贴几十次，却只有一条内容能留下。 CopyLists 默默记录每一次复制——文字、链接、代码、截图，一个快捷键随时取用。
核心功能
⚡️ 呼之即来，挥之即去
任意界面按下 ⌘⇧V，历史面板瞬间浮现于屏幕中央。选好内容按回车，自动切回原应用完成粘贴，全程不超过 2 秒。
🖼️ 截图也是历史的一部分
微信截图、系统截图、网页复制的图片，一律自动入库并生成缩略图预览。需要时选中按回车，原图直接还原到剪贴板。
♻️ 再也不会有重复条目
同一段内容复制了三次？列表里image.png只有一条，使用次数安静地累加在角落。历史永远整洁，不需要手动清理。
🏷️ 六种类型，一眼看清
自动识别 URL / 邮箱 / 文件路径 / 代码片段 / 截图 / 纯文本，顶部标签栏一键过滤，左右方向键也能切换。
⌨️ 全程不碰鼠标
↑↓ 选条目 · ←→ 切标签 · ↵ 粘贴 · ⌘⌫ 删除 · ⎋ 关闭。从呼出到粘贴，双手始终在键盘上。
🔒 数据只在你的电脑里
无账号、不联网、不上传。所有内容存储在本机 ~/Library/Application Support/CopyLists/，卸载即清除，没有任何后顾之忧。
最新功能
⭐️ 收藏 — 永久保存重要内容
对任意条目点击 ⭐ 星标或按 ⌘S 将其收藏。收藏项永久保留，不受 LRU 淘汰算法影响，即使清空历史也不会丢失。顶部筛选栏出现专属「收藏」标签，随时一键过滤。
👁 预览浮窗（⌘P）
选中任意条目按 ⌘P，内容在屏幕右上角以浮窗展示：
- 文字：可直接编辑，
⌘↩保存并写回剪贴板 - 图片：支持画笔 / 箭头 / 矩形三种标注工具，调色板自选颜色，
⌘Z/⌘⇧Z撤销重做，⌘↩将标注后的图片写回剪贴板 - 📌 图钉按钮：点击后浮窗悬浮于所有应用最顶层，切换到其他 App 也不消失
- 多个浮窗同时打开时从右上角依次向下排列，不重叠；位置和尺寸自动记忆
🔍 图片文字识别（OCR）
截图复制后，CopyLists 在后台自动识别图片中的文字（中文简繁 + 英文），识别结果参与搜索。想找上周截图里的那行代码？直接在搜索框输入关键词即可。
🚀 开机自动启动
设置面板中开启「开机自动启动」，登录 Mac 后 CopyLists 自动在后台就绪，无需手动启动。
🛡 隐私保护
- 一键暂停：状态栏菜单点击「暂停记录」，剪贴板内容不再被记录，图标变为实心提示；再次点击恢复
- 排除应用：1Password、Bitwarden、Dashlane、LastPass 等密码管理器默认加入排除列表，处于前台时自动跳过，密码不会入库
- 可在设置中自定义排除任意 App 的 Bundle ID
⚙️ 设置面板（⌘,）
点击状态栏图标 → 设置，或按 ⌘,：
- 历史记录条数上限（20 / 50 / 100 / 200 / 500 条）
- 开机自动启动开关
- 暂停/恢复监听
- 排除应用管理（增删 Bundle ID）
快捷键速查
| 按键 | 动作 |
|---|---|
⌘⇧V | 唤起 / 隐藏面板 |
↑ / ↓ | 选择条目 |
← / → | 切换类型标签 |
↵ | 粘贴到当前应用 |
⇧↵ | 纯文本粘贴（去除富文本格式） |
⌘S | 收藏 / 取消收藏 |
⌘P | 预览浮窗 |
⌘1 ~ ⌘9 | 快速粘贴第 1~9 条 |
⌘⌫ | 删除选中条目 |
⎋ | 关闭面板 |
预览浮窗内：
| 按键 | 动作 |
|---|---|
⌘↩ | 保存并关闭（文字写回剪贴板 / 图片含标注写回） |
⌘Z | 撤销标注（图片） |
⌘⇧Z | 重做标注（图片） |
⎋ | 关闭浮窗 |
安装方式
方式一：下载安装包（推荐）
- 点击下载
CopyLists.dmg解压(地址：github.com/evenjxr/cop…) - 将
CopyLists.app拖入Applications文件夹 - 右键点击 → 打开（首次必须用右键，否则系统会阻止）
方式二：源码构建
git clone git@github.com:evenjxr/copyLists.git && cd copyLists
bash build_app.sh
open CopyLists.app
安装常见问题
❓ 打开提示「无法打开，因为无法验证开发者」
macOS 的 Gatekeeper 会阻止未经 App Store 签名的应用直接运行。
解决方法（二选一）：
① 右键打开（推荐）
在 Finder 中找到 CopyLists.app，按住 Control 键 + 单击（或右键），选择「打开」，在弹出对话框中点击「打开」即可。只需操作一次，后续直接双击即可正常启动。
② 系统设置解除限制
如果弹出提示后没有出现「打开」按钮：
- 打开「系统设置」→「隐私与安全性」
- 滚动到「安全性」区域，找到「已阻止使用 CopyLists.app，因为来自身份不明的开发者」
- 点击右侧「仍要打开」按钮，输入密码确认
❓ 粘贴动作无效（内容已复制但没有自动粘贴）
CopyLists 模拟 ⌘V 需要「辅助功能」权限。
开启步骤：
- 打开「系统设置」→「隐私与安全性」→「辅助功能」
- 点击右下角 🔒 解锁（需输入密码）
- 在列表中找到 CopyLists，打开右侧开关
- 无需重启，立即生效
如果列表中没有 CopyLists，先启动一次应用，触发一次粘贴操作，系统会自动弹出授权请求。
❓ 开机启动没有生效
macOS 13 及以上系统对「登录项」有专门管理入口：
- 打开「系统设置」→「通用」→「登录项与扩展」
- 在「登录时打开」列表中确认 CopyLists 处于开启状态
- 如果不在列表中，在 CopyLists 设置面板里重新切换一次「开机自动启动」开关
❓ 搜索框无法输入文字
同样需要辅助功能权限，参考上方「粘贴动作无效」的解决步骤。
❓ 历史记录在重启后丢失
历史记录保存在 ~/Library/Application Support/CopyLists/。
如果重启后为空，可能是沙盒权限问题（源码构建版本）。推荐使用打包版 .dmg 安装。
数字说话
| 50 | 条默认历史上限（可在设置中调整至 500 条） |
| 6 | 种内容类型，自动识别无需手动分类 |
| 0 | 字节离开本机，完全离线运行 |
| 1 | 个快捷键，覆盖所有使用场景 |
CopyLists · macOS 13+ · MIT License · Made with Swift ❤️
