EFClip，从头到尾。

安装

1. 下载 Mac 版 EFClip。它是一个 4 MB 的磁盘映像，用我的 Developer ID 签名并经过 Apple 公证。
2. 打开它，把 EFClip 拖到“应用程序”文件夹。
3. 从“应用程序”中打开 EFClip，不要从磁盘映像里打开：macOS 会把从磁盘映像启动的 App 放在临时位置运行，更新将无法进行。
4. 菜单栏中会出现一个写着 EF 的剪贴板图标。没有程序坞图标，也没有需要关闭的窗口；App 就在菜单栏里。
5. 可选：设置 › 通用 › 登录时打开，这样重启后它也在。

你需要一台搭载 Apple 芯片（M1 或更新）的 Mac，以及 macOS 14 Sonoma 或更高版本。

窗口

按下 ⌥V 或点按菜单栏图标。历史记录会在鼠标指针处打开；如果你在设置 › 通用中选择了屏幕中央，则在屏幕中央打开。从图标打开时，它就在图标正下方。

窗口不会从你所在的 App 抢走焦点，所以文本光标保持原位。按 Esc、选取某项或点按别处时它会关闭。拖移边缘可放大；它会记住大小。如果想精确设置，有宽度（320 到 600）和高度（360 到 800）的滑块。

搜索

窗口一打开搜索栏就处于活动状态，直接输入即可。它会搜索文本和你给项目起的名称。大小写和重音符号都不影响：cafe 能找到 Café。图像按名称查找。

行

最新的项目在最上面。没有类别的已置顶项目排在其余内容上方。前九行显示 ⌘1 到 ⌘9，这样不用移动选择就能选取。一行会在已置顶时显示图钉，显示带有其类别的小标签，在像 #FF454F 这样的十六进制颜色旁显示色块，图像则显示缩略图和尺寸。已命名的项目显示其名称，文本在名称下方。

预览

⌃Space 在窗口旁边打开完整文本或较大的图像，并显示长度和拷贝时间。默认情况下，在某一行停留 1.5 秒时它也会打开；设置 › 通用 › 预览可改为 0.5 秒、3 秒，或仅使用快捷键。

右键点按某一行

拷贝、拷贝并粘贴、置顶、编辑文本、命名、类别、预览和删除。该菜单中的每一项也都有快捷键；完整列表见快捷键。

窗口底部

清除历史记录…会移除除已置顶项目和类别中项目以外的所有内容。开启同步后，它也会清除你其他设备上的历史记录，所以会先询问。旁边是：设置、关于、检查更新和退出。

粘贴

回车会把所选项目放进剪贴板并关闭窗口。然后你按 ⌘V，就和任何一次拷贝之后一样。该项会移回历史记录顶部。

如果想省掉第二步，请开启设置 › 通用 › 立即粘贴。这样 EFClip 会在窗口关闭片刻后代你按下 ⌘V。macOS 只允许拥有辅助功能权限的 App 代你按键，所以第一次它会打开权限对话框。在你允许之前，项目只会放进剪贴板，不会出任何问题。

⌥↩ 会执行与你的设置相反的操作，仅一次：“立即粘贴”关闭时它会粘贴，开启时则只拷贝。

置顶、类别和名称

历史记录会自行向前推进：旧项目为新项目让位。有三种方式能让一项永远不被移除。

置顶

⌥P，或右键菜单中的“置顶”。该项会进入“已置顶”筛选器，不受数量限制，永不过期。取消置顶用同样的按键。

类别

⌘K 打开一个菜单，里面有你的类别、“无”和“新建类别…”。类别中的项目始终也是已置顶的。每个类别在列表上方有自己的标签，开启同步后，在 iPhone 键盘里也有自己的标签。可在设置 › 类别中重命名或删除类别，或右键点按标签。删除类别后，其中的项目仍保持置顶，只是不再属于该类别。

名称

⌘N 给一项起个简短的标题，最多 40 个字符，显示在文本上方：办公室地址、房租账户、家里的 Wi-Fi。搜索也会匹配名称。已命名的项目与已置顶的项目一样会被保留。

编辑

⌘E 打开文本进行编辑。当你拷贝了带错字的内容，或想保留整理后的版本时很有用。

筛选器

搜索栏下方的标签用来筛选列表。⇥ 移到下一个，⇧⇥ 返回。窗口会在你排序后的第一个标签处打开。

拖移标签可重新排序，包括“全部”和“已置顶”，也可以在设置 › 类别中操作。开启同步并开启相同的筛选顺序后，iPhone 键盘会采用相同的顺序，你在键盘里设置的顺序也会回到 Mac。以较新的更改为准。每台设备对此都有自己的开关，所以你可以在其中一台上保持不同的顺序。

图像

只要设置 › 存储 › 存储图像开启，拷贝的图像和拷贝到剪贴板的截屏（⌃⇧⌘4）就会被保存。支持 PNG、JPEG、HEIC 和 TIFF。EFClip 保留最新的 15 张，每张缩放到最大 1280 px 并以 JPEG 存储，所以整个集合保持在约 24 MB 以内。已置顶的图像不计入这 15 张。

选取一张图像会把存储的图像放回剪贴板，可直接粘贴到消息、文稿或预览中。

忽略的内容

三条规则决定哪些内容绝不会被保存。

• 隐藏内容，永远如此。密码管理器和其他 App 会把敏感的拷贝标记为隐藏或临时。EFClip 绝不保存这些内容，任何设置都无法改变这一点。
• 忽略列表中的 App。设置 › 忽略 › App。其中某个 App 在最前面时，拷贝会被跳过。1Password、Bitwarden、密码和钥匙串访问从一开始就在列表里；可从菜单中添加任何正在运行的 App。
• 与你的模式匹配的文本。设置 › 忽略 › 文本匹配接受正则表达式。^\d{16}$ 跳过 16 位银行卡号，^\d{6}$ 跳过六位验证码。

另外，菜单栏图标上还有两个快捷开关：按住 ⌥ 点按会暂停保存，直到你再次按住 ⌥ 点按（暂停时图标会变淡），按住 ⌥⇧ 点按则仅跳过下一次拷贝。

超过 100 KB 的文本也不会被保存，只含空格的文本同样不会。

存储

设置 › 存储决定 EFClip 保留多少内容。

• 最多保留 50、100、200 或 500 项。默认是 200。超过上限时，最旧的未置顶项目会被移除。
• 删除时间：5、15、30 或 60 分钟，一天，一周，或 30 天（默认）。
• 退出 EFClip 时清除历史记录，默认关闭。已置顶的项目会保留。

已置顶的项目、类别中的项目和已命名的项目绝不会被这些限制删除。所有内容都存储在 Mac 上 EFClip 自己的沙盒文件夹中。

iPhone 同步

EFClip 可以与 EFKey 共享历史记录，EFKey 是我为 iPhone 做的键盘。键盘有自己的剪贴板面板；开启同步后，它和 EFClip 显示同一份历史记录。

所需条件

• Mac 和 iPhone 使用同一个 Apple ID，并已开启 iCloud。
• iPhone 上的 EFKey，已开通 EFKey Pro（€14.99，一次性付费）并为键盘开启完全访问。完全访问是键盘能够访问网络的前提。

开启方法

1. 在 Mac 上：EFClip › 设置 › 同步 › 与 iPhone 同步。下面一行会显示上次同步的时间，或出了什么问题。
2. 在 iPhone 上：EFKey › 工具 › 剪贴板 › 与 Mac 同步。
3. 在 Mac 上拷贝点什么，然后在键盘里打开剪贴板。它就在那里。

同步的内容

文本和链接、图像、置顶、类别（包括名称和顺序）、项目名称、删除操作以及筛选标签的顺序。设置不会同步：你的快捷键、窗口大小、忽略列表和上限都保留在各自设备上。不过历史记录上限会取折中。当一台设备保留 100 项而另一台保留 200 项时，在前者上被裁掉的旧项目会在所有设备上被删除，所以以较小的上限为准。

图像最宽以 1280 px 上传，如果对 iCloud 来说仍然太大，还会进一步缩小。只共享最新的 15 张图像；已置顶的图像始终会共享。

同步速度

你在 iPhone 上最后拷贝的内容会立刻出现在 Mac 上。这是 Apple 的通用剪贴板，无论有没有 EFClip 都能工作。其余的都是 EFClip 同步：

• 在 Mac 上所做的更改会在几秒钟内上传。
• Mac 会在你打开窗口时检查更改，窗口打开期间每 5 秒检查一次，其余时间每 30 秒检查一次。有更改时 iCloud 也会发出提示，但这些提示到达得晚，甚至根本不会到达，所以你能指望的是定期检查。
• iPhone 键盘会在你打开其剪贴板时获取更改。键盘无法在后台运行，所以这就是它查看的时机。

当两台设备不一致时

较新的更改胜出。置顶、类别和名称各自记住你上次更改它们的时间，与该项被拷贝的时间分开。所以你在 Mac 上置顶一个地址，一小时后又在 iPhone 上拷贝同一个地址，它仍保持置顶：拷贝会把它移到两端的顶部，但不会碰置顶。只有删除比另一台设备上的更改更新时，删除才会胜出。

保存位置以及谁能读取

历史记录会进入你的 Apple ID 的私人 CloudKit 数据库，位于 EFClip 和 EFKey 专属的区域。在任何内容离开 Mac 之前，文本、图像、名称、类别名称和筛选顺序都会经过端到端加密，密钥保存在你的 iCloud 钥匙串中。Apple 存储它们但无法读取。Apple 能看到的是：某项何时更改过，以及是否已置顶。就连记录名称也经过混淆，所以两份相同的拷贝看起来并不一样。

这些我一概看不到。路径上没有我的服务器，没有账户，也没有分析。

关闭同步

关闭与 iPhone 同步会停止这台 Mac 上的同步。不会删除任何内容：历史记录仍保留在 Mac、iPhone 和 iCloud 中。

要移除 iCloud 中的副本，请使用设置 › 同步中的从 iCloud 删除…。它会关闭这台 Mac 上的同步，并从你的 iCloud 中删除 EFClip 的整个区域。你的设备会保留各自的历史记录。有一点要注意：仍开启着同步的设备会在大约 30 秒内再次上传它的历史记录。所以请先在 EFKey 中关闭同步，再删除。在 EFKey 中，关闭同步时会问同一个问题：保留在 iCloud 或 从 iCloud 删除。

更新

EFClip 不在 Mac App Store 上架，所以它会自行更新。它在启动时和每六小时读取一次 efclip.app/appcast.xml。有新版本时，菜单栏图标上会出现红点，窗口底部会提供更新到 …；它会显示更改内容，并在安装前询问。你在其他 App 中工作时不会弹出任何内容。每个更新都用我的密钥签名，App 会拒绝其他任何内容。检查更新…在窗口底部和“关于”中。要停止自动检查，请关闭设置 › 通用 › 自动检查更新。

快捷键

疑难解答

按 ⌥V 没有反应

可能是别的 App 占用了同一个快捷键，或者 EFClip 没有运行（看菜单栏里有没有 EF 图标）。请在设置 › 通用 › 打开历史记录中选择其他组合。

选取某项后没有粘贴

这是默认行为：选取后按 ⌘V。如果“立即粘贴”已开启却仍没有反应，请打开系统设置 › 隐私与安全性 › 辅助功能，确认 EFClip 已被允许。更新之后，你可能需要在那里先关闭再开启。

我拷贝的内容不在历史记录里

请检查保存是否已暂停（图标变淡）、你拷贝所在的 App 是否在忽略列表中，以及文本是否匹配你的某个模式。来自密码管理器的隐藏拷贝是有意跳过的。访达中的文件不会被保存，超过 100 KB 的文本也不会。

iPhone 上没有出现同步内容

• 在键盘里打开剪贴板：它就是在这时检查的。
• 看 Mac 上“与 iPhone 同步”下面的那一行。它会显示上次同步成功的时间，或显示错误。
• 两台设备使用同一个 Apple ID，已开启 iCloud，EFKey Pro 有效，并已为 EFKey 开启完全访问。
• iCloud 已满或已退出登录？在修复之前 CloudKit 会停止工作。

删除的项目又回来了

某台离线的设备带着更新的更改把它带了回来，或者某台仍开启着同步的设备在“从 iCloud 删除”之后重新上传了。等两台设备都在线后再删除一次。

卸载

退出 EFClip（在窗口中按 ⌘Q），并把它从“应用程序”拖到废纸篓。历史记录仍保留在 ~/Library/Containers/eu.eef.efclip 中；删除该文件夹即可一并移除。如果开启过同步，请在卸载前使用“从 iCloud 删除”，否则副本会留在你的 iCloud 中。

开源许可

EFClip 使用 Sparkle 进行更新，采用 MIT 许可。全文在 App 中：关于 › 开源许可。

EFClip 1.0.3 指南。有不清楚或缺少的地方？在跟踪器上告诉我。