EFClip，從頭到尾。

安裝

1. 下載 Mac 版 EFClip。它是一個 4 MB 的磁碟映像檔，以我的 Developer ID 簽署並經過 Apple 公證。
2. 打開它，把 EFClip 拖到「應用程式」檔案夾。
3. 從「應用程式」中打開 EFClip，不要從磁碟映像檔裡打開：macOS 會把從磁碟映像檔啟動的 App 放在暫時位置執行，更新將無法進行。
4. 選單列中會出現一個寫著 EF 的剪貼板圖像。沒有 Dock 圖像，也沒有需要關閉的視窗；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 秒，或僅使用快速鍵。

在某一列上按一下滑鼠右鍵

拷貝、拷貝並貼上、釘選、編輯文字、命名、類別、預覽和刪除。該選單中的每一項也都有快速鍵；完整列表見快速鍵。

視窗底部

清除歷史紀錄⋯會移除除已釘選項目和類別中項目以外的所有內容。開啟同步後，它也會清除你其他裝置上的歷史紀錄，所以會先詢問。旁邊是：設定、關於、檢查更新和結束。

貼上

Return 會把所選項目放進剪貼板並關閉視窗。然後你按 ⌘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 是否在忽略列表中，以及文字是否符合你的某個模式。來自密碼管理工具的隱藏拷貝是刻意略過的。Finder 中的檔案不會被儲存，超過 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 指南。有不清楚或缺少的地方？在追蹤器上告訴我。