一个把每一次复制都留下来的 Mac 剪贴板管理器。
按 Shift-Command-V，你复制过的东西还都在。文字和图片，可搜索，按空格看大图预览。它以普通文件的形式存在你自己的 Mac 上，这一页会把是哪几个文件说清楚。
Mac 剪贴板管理器到底是干什么用的
macOS 只给你一个剪贴板位置。复制第二样东西，第一样就没了。不是归档，不是能找回来，就是没了。单次损失都很小。一个还得再去找一遍的网址、一行你本来已经有的配置、一个早复制了十秒的快递单号。真正的代价是，你会在没做过任何决定的情况下学会两条规矩。复制完必须马上粘贴，绝不能连着复制两样东西。一个 Mac 剪贴板管理器把这两条都取消掉。你随便复制，四次之前那一条照样够得着。
Mac 剪贴板管理器底下的机制其实并不好看。Coco 每秒查两次系统剪贴板，内容一变就把当时的东西记下来。记的是文字，或者图片，时间，以及那一刻在前台的是哪个应用。所以那一行会带上这段内容来源应用的图标。复制一样已经有的东西不会出现两条，原来那条会带着新的时间戳回到最上面。没有索引服务，没有自己的后台守护进程，整条路径上也没有任何一处网络请求。
不舒服的那部分值得直说，因为大多数讲 Mac 复制粘贴历史的页面会跳过它。一个 Mac 剪贴板管理器会看到你复制的一切。你复制的东西里有很多是你绝不会往搜索框里打的。从密码管理器里拷出来的密码、API 令牌、恢复码、你正在转发的一条私信。任何在 Mac 上保留剪贴板历史的工具，手里拿着的就是这些。这个功能方便，这一点没什么好争的。真正要问的是这份记录最后落在哪里、还有谁读得到、以及你多快能让它消失。这一页剩下的部分用文件路径回答，不用形容词。
这个 Mac 剪贴板管理器留下什么，以及把它留在哪儿
文字、图片，以及它们来自哪个应用
文字按你复制时的样子存下来，只有一个刻意的例外。默认去掉结尾的换行，而且 Coco 会把系统剪贴板上的那份也一起处理；所以之后在任何地方按 Command-V 粘出来都是干净的。剪贴板上的其它格式，富文本、HTML、文件，原样搬过去，一个字节都不动。图片存成 PNG，文件名就是它自己内容的 SHA-256。所以同一张截图复制两次只占一个文件。超过 10 MB 的会被缩到最长边 4096 像素；缩完还超过 10 MB，这一条就直接跳过，而不是悄悄给你降质留着。
搜索，以及空格键
在面板里打字就会过滤，匹配走内容本身和你给它加的备注。最近的 320 条在你敲下按键的同一帧里搜完；更早的交给后台任务，搜完再并进来，所以几千条也不会把这次按键卡住。选中一行会在列表旁边的预览栏里显示，按空格把它展开成大图预览。这就是「粘对了那张截图」和「粘了它旁边那张」的区别。如果这条内容是一个文件路径，预览走 QuickLook。PDF 和音视频会真的渲染出来，而不是给你看一串字符。
收藏、备注，以及怎么把东西弄掉
那些你天天要粘的东西，比如地址、授权码、一段总在重打的代码，都可以钉进收藏。收藏是独立的一份列表，有自己的标签页和自己的文件。收藏不受历史条数上限和自动清理的影响，所以别的东西在轮换时，它们不会滚走也不会过期。任何一条都可以带一段简短备注，备注和内容本身一起参与搜索。Delete 删掉选中的行，多选也一样；设置里有清空历史和清空收藏两个按钮。
粘回你刚才那个应用
回车会把这条写进系统剪贴板，把你刚才那个应用切回前台，然后给它发一个 Command-V。最后这一步需要辅助功能权限，因为 macOS 会丢掉来自未授信应用的合成按键。Coco 不会在这里默默失败。它会直说权限没开，告诉你内容已经在剪贴板上、可以自己手动粘；也可以直接帮你打开系统设置里对应的那一栏。另外还有一个只复制不粘贴的动作，如果你只想拿到这条、不想它被粘到任何地方。
历史到底存在哪里
两个 JSON 文件，clipboard-history.json 和 clipboard-favorites.json；外加一个装 PNG 的文件夹。如果 iCloud 云盘可用，它们默认被放到 iCloud 云盘的 Coco 文件夹里。这样同一个账号下的第二台 Mac 看到的是同一份历史。那是你自己的 iCloud，不是我们的服务器。Coco 没有账号、没有遥测，也没有任何属于它自己的上传通道。在设置里关掉「使用 iCloud 同步」，一切退回 ~/Library/Application Support/Coco；状态那一行会显示「仅本机」。剩下的部分，一个 Mac 剪贴板管理器也该说清楚。Coco 自己不加密这些文件，也不会识别出某条内容是从密码管理器里复制来的。所以复制过来的密码就和别的文字一样存着，直到你把它删掉。
把这个 Mac 剪贴板管理器和 macOS、Raycast、Alfred、Paste 摆在一起
先从基准说起，因为这就是这个品类存在的理由。macOS 根本没有剪贴板历史。访达里的「显示剪贴板」窗口给你看的是当前那一条，不是列表；没有任何设置项、隐藏面板或者终端命令能把它变成列表。下面每一个 Mac 剪贴板管理器都在补同一个洞，而且核心那件事它们都做得不错。差别在核心之外，以及它要你付什么。
Raycast 的免费版就带剪贴板历史，Pro 是每月 $8 卖它别的能力。如果你已经住在 Raycast 里，没什么必要再加一个。Alfred 的剪贴板历史属于 Powerpack，大约 £34 买断。多年的 Alfred workflow 积累是留在原地的好理由。Paste 是专门做这一件事的，大约每月 $2.49。四年下来比这里任何一个买断都贵。Coco 是一台 Mac $49 买断。剪贴板只是这个启动器的一个功能，它还会把 macOS 26 移除的启动台网格画回来。如果你要的确实只是剪贴板历史，Paste 是更专注的那个产品，我们宁愿把这句说出来。
| Coco | macOS | Raycast | Alfred | Paste | |
|---|---|---|---|---|---|
| 剪贴板历史 | Powerpack | ||||
| 不付费也能用剪贴板历史 | 7 天试用 | ||||
| 和应用启动器打包在一起 | |||||
| 启动台式图标网格 | |||||
| 一次性买断 | 系统自带 | ||||
| 价格 | $49 买断 | 系统自带 | 免费或 $8/月 | £34 买断 | 约 $2.49/月 |
在你的 Mac 上把剪贴板历史配起来
装上 Coco，按 Shift-Command-V
把 Coco 拖进「应用程序」并打开。剪贴板快捷键出厂就是 Shift-Command-V，可以改。列表一开始是空的。Coco 运行之前你复制过的东西，任何工具都找不回来。从你下一次复制开始它就有内容了。这一步不需要配置任何东西。
决定留多少、留多久
设置 → 剪贴板。历史条数上限默认无限；想让它小一点就选 100、500、1,000、2,000 或 5,000。自动清理默认关闭，可以让超过 7、30、90 或 365 天的条目在下次启动时被清掉。如果你工作时会复制凭据，这是第一个该改的设置。
打开辅助功能，回车才能直接粘
想直接粘回你刚才那个应用，就得给它发一个 Command-V。macOS 会一声不响地丢掉这个按键。要它生效，得在「隐私与安全性 → 辅助功能」里勾上 Coco。Coco 第一次会提示你，也能直接帮你打开那一栏。不想开也行。内容照样在剪贴板上，你自己粘就是了。
选好历史存在哪儿
iCloud 云盘可用时，Coco 默认把数据放到 iCloud 云盘的 Coco 文件夹；这样两台 Mac 是同步的。如果你更希望「你复制过的一切」这份记录永远不离开这台机器，就在设置里关掉「使用 iCloud 同步」；存储那一行会变成「仅本机」；东西都在 ~/Library/Application Support/Coco 下面。
实际上最常被问到的问题
- macOS 自带剪贴板历史吗？
- 没有。macOS 的剪贴板上只保留一条内容，复制别的东西就会把它永久替换掉。访达里有一个「编辑 → 显示剪贴板」的窗口，但那给你看的是当前这一条，不是列表；没有任何偏好设置、隐藏面板或终端命令能把它变成列表。通用剪贴板（在 Mac 和 iPhone 之间共享剪贴板的那个）同样只有一个位置。所以在 Mac 上保留剪贴板历史必须靠第三方应用。Coco、Raycast、Paste，或者买了 Powerpack 的 Alfred。别的也有几个。这就是这一类软件存在的全部理由。
- Coco 把我的剪贴板历史存在哪里？
- 两个 JSON 文件，clipboard-history.json 和 clipboard-favorites.json；外加一个存图片的 PNG 文件夹。iCloud 云盘可用时，它们默认放在 iCloud 云盘的 Coco 文件夹里。这样登录同一个 Apple 账号的第二台 Mac 看到的是同一份历史。那是你自己的 iCloud 云盘，不是属于 Coco 的服务器。不需要注册账号，没有遥测；剪贴板这部分代码里也没有任何属于 Coco 自己的上传通道。如果你希望它永远不离开这台机器，就在设置里关掉「使用 iCloud 同步」；所有东西会留在 ~/Library/Application Support/Coco；存储那一行会显示「仅本机」。
- 我要是复制了密码会怎样？
- 它会像别的文字一样被存下来。Coco 不会识别出某条内容来自密码管理器，也不会区别对待。所以复制过来的密码、API 令牌或恢复码会一直待在历史里，直到有什么东西把它拿掉。你有三种办法。选中那一行按 delete；用设置里的「清空」按钮一次性清掉整份历史；或者把自动清理设成 7 天或 30 天，让更早的条目在下次启动时被丢掉。Coco 自己不加密这些文件。保护它们的是保护你整个个人文件夹的那套东西，在 Mac 上应该是 FileVault。真正的开关是那两个保留设置。
- 它存图片还是只存文字？
- 都存。复制一张截图，它会存成一个 PNG，文件名就是这张图内容的哈希。所以同一张图复制两次不会占两个文件。大于 10 MB 的图片会被缩到最长边 4096 像素；缩完还超过 10 MB 的就跳过，而不是降一半画质留着。选中一行图片会在预览栏里显示；搜索框为空时按空格，它会展开成大图预览。在粘之前分辨两张长得差不多的截图，靠的就是这个。任何一条图片也可以另存成 PNG 文件。
- 历史能往回追多久？
- 你放多远它就有多远。上限默认是无限，所以在你开口之前它什么都不会丢；其它选项是 100、500、1,000、2,000 和 5,000 条。设了上限之后，新的进来最老的就掉出去。自动清理是另一个独立开关，默认关闭。它可以让超过 7、30、90 或 365 天的条目在 Coco 下次启动时被丢掉。收藏不受这两者影响，所以钉住的授权码不会在你脚底下过期。重新复制一个历史里已经有的东西，会把那一条挪回最上面，而不是加一条重复的。
- 它和 Raycast、Alfred 或 Paste 有什么不同？
- 四个的核心是一样的，都是把复制过的留下来、能搜、能粘回去。所以你该选哪个 Mac 剪贴板管理器，取决于核心之外是什么。Raycast 免费版就带剪贴板历史，Pro 每月 $8；如果你已经在用 Raycast，就用它的剪贴板。Alfred 把剪贴板历史放在 Powerpack 里，大约 £34 买断。有 workflow 积累的话留着它是对的。Paste 只做这一件事，订阅制大约每月 $2.49。Coco 是 7 天免费试用、不需要信用卡，之后一台 Mac $49 买断。剪贴板长在一个启动器里，那个启动器还会把 macOS 26 移除的启动台网格画回来。仅支持 Apple Silicon，macOS 14 及以上。
复制这段提示词，或者直接发给你已经在用的 AI——它会用你自己会敲的那些命令来驱动 Coco。
安装 Coco 技能（npx skills add butterflydream-ai/Coco --skill coco -g -y），然后用 coco 在我的剪贴板历史里搜索“invoice”，把最新的一条粘贴到最前面的应用里。背后发生了什么
- coco clipboard search --query "invoice" --json
- coco clipboard paste --id <id>