# 使用 Pinit

> 如何用 Pinit 釘選東西、操作貼圖、恢復你的貼圖佈局、使用歷史、快速鍵，以及 pinit:// URL scheme。

## 開始使用

打開磁碟映像檔，把 Pinit 拖到「應用程式」資料夾，然後打開它。Pinit 以一個小小的 P 字圖示待在選單列裡。第一次啟動時，它會打開主視窗，列出各種釘選方式 —— 最快的是複製任何東西，然後按 ⌃⌥P。

Pinit 不要求任何權限，你也不會看到 macOS 跳出任何提示。從本站下載的版本會在第一次執行時把自己加入登入項目，讓你的貼圖在重新啟動後回來；你可以在「設定 › 一般」裡關閉。

- **僅選單列**: 預設選項。選單列裡一個圖示，沒有 Dock 圖示，也不出現在 ⌘Tab 裡。
- **選單列和 Dock**: 兩者都有。按一下 Dock 圖示打開主視窗；按右鍵使用快速動作；把檔案拖到圖示上即可釘選。
- **僅 Dock**: 沒有選單列圖示，適合選單列已經擠滿的情況。這個設定在「設定 › 一般 › Pinit 顯示在」。

## 釘選東西

每一種方式的結果都一樣：指標附近出現一張貼圖，浮在所有視窗之上。一次釘選多個項目就會變成多張貼圖，展開排列，不會互相遮住。

- **剪貼簿 —— ⌃⌥P**: 釘選你最後複製的東西：圖片、文字、連結，或你在 Finder 裡複製的檔案。選單裡對應的項目是「釘選剪貼簿內容」。
- **拖到選單列的圖示上**: 把檔案、圖片、連結或選取的文字拖到圖示上。在 macOS 26 上，拖到圖示時下方會打開一張小小的「放開即可釘選」卡片 —— 在圖示或卡片上放開都可以。
- **拖進主視窗**: 把任何東西拖到視窗裡的任何地方；它會被釘選，視窗也會切換到「桌面」。
- **「打開檔案的應用程式」和 Dock**: 在 Finder 裡對檔案按右鍵 › 打開檔案的應用程式 › Pinit，或把它拖到 Pinit 的 Dock 圖示上。Pinit 永遠不會把自己設為任何東西的預設 App。
- **「服務」選單**: 在任何 App 裡選取文字、圖片或連結，然後選擇「服務 › 用 Pinit 釘選」。如果是在 Finder 裡選取的檔案，請選擇「服務 › 用 Pinit 釘選檔案」。
- **釘選檔案…**: 從打開面板中選擇一個或多個檔案。Pinit 在最前面時按 ⌘O。
- **釘選網頁…**: 輸入或貼上網址。如果剪貼簿裡有連結，就已經幫你填好了。按 ⌘↩ 釘選。
- **新增文字貼圖…**: 寫一則便條。如果你輸入的只是一個網址，按鈕會跟著改變，改為釘成網頁。
- **終端機**: open -a Pinit report.pdf 會釘選你指定的任何檔案。

## 每種貼圖能做什麼

Pinit 依照東西「是什麼」決定怎麼顯示，而不是依照它「從哪裡來」。從 Finder 拖來的 PNG 和從瀏覽器複製的 PNG，會變成同樣的圖片貼圖。

- **圖片**: PNG、JPEG、HEIC、TIFF、WebP、GIF 和 APNG（動態），還有 PSD、AVIF、相機 RAW、JPEG 2000、OpenEXR、TGA、ICNS 和 SVG。可以縮放、旋轉、翻轉、標註、選取文字和翻譯。
- **文字**: 純文字與格式化文字、剪貼簿裡的 HTML、文字檔和原始碼。可以就地編輯，並有自己的文字大小。
- **PDF**: 內嵌的 PDF 檢視器。按兩下即可捲動和翻頁；按 Esc 返回。
- **文件**: Word、Excel、PowerPoint、Pages、Numbers、Keynote、RTF、OpenDocument、網頁封存檔、字體和 3D 檔案都透過「快速查看」預覽，和 PDF 一樣分成兩種模式。
- **網頁**: 即時的 WebKit 檢視。按兩下即可與網頁互動；按 Esc 回到移動貼圖。
- **影片與音訊**: 影片靜音循環播放，附有播放列。音訊顯示波形。空白鍵播放和暫停。
- **其他檔案與資料夾**: 一張卡片，附有「快速查看」縮圖、名稱、種類和大小。按兩下就用它自己的 App 打開檔案。

## 操作貼圖

貼圖浮在一般視窗之上，但從不接管選單列，所以你正在使用的 App 依然是主角。按一下貼圖，把鍵盤交給它；下面的按鍵作用於最前面的貼圖。

不透明度值得了解一下。⌘ 加捲動會讓貼圖變淡，讓你能透過它看見後面。調到 0% 時，點按會穿過它，落到底下的東西上 —— 描圖或比對時很方便 —— 按住 ⌘ 就會讓它重新顯示，方便你再次抓住它。

- **移動**: 拖移貼圖上的任何地方，或用方向鍵微調（按住 ⇧ 一次移動 10 點）。
- **調整大小與縮放**: 拉邊緣、捲動、雙指捏合，或按 + 和 −。按 1 回到 100%。
- **不透明度**: ⌘ 加捲動。按 O 回到 100%。新貼圖的初始不透明度在「設定 › 貼圖」裡。
- **旋轉與翻轉**: R 旋轉 90°，H 水平翻轉，V 垂直翻轉（限圖片）。
- **陰影**: S 開啟或關閉貼圖的陰影。
- **複製與儲存**: ⌘C 複製貼圖的內容。⌘S 把圖片貼圖儲存成檔案。
- **關閉**: Esc、⌫ 或 ⌘W。關閉的貼圖會留在「歷史」裡，「重新打開關閉的貼圖」（⌘⇧T）會把最後一張帶回來。
- **全部隱藏**: 在任何貼圖上按 ⌃H，或選擇選單裡的「隱藏 / 顯示所有貼圖」。再按一次就全部回來。
- **按右鍵**: 上面所有動作，以及沒有對應按鍵的動作。

## 標註、文字與翻譯

在圖片貼圖上按 Return 鍵，就地標註：箭頭、矩形、螢光筆、編號步驟、文字和馬賽克。按 Return 鍵或勾號儲存；按 Esc 捨棄變更。標註後的圖片會取代原本的貼圖，重新啟動後依然保留。

在文字貼圖上，按 Return 鍵開始編輯，按 ⌘↩ 完成。

按 E 會用「原況文字」開啟圖片內的文字選取：拖移選取文字，按 ⌘C 複製。按 T 會翻譯圖片裡的文字，並把譯文覆蓋在原文上。辨識和翻譯都在你的 Mac 上執行；翻譯需要 macOS 15 或以上版本，第一次使用某個語言組合時，可能會下載 Apple 的語言檔案。

## 貼圖佈局：重新啟動後依然在

Pinit 會隨時儲存你的貼圖 —— 每次釘選和關閉之後，以及你移動東西時每隔幾秒。再次啟動時，它會把每張貼圖照原樣放回原處：位置、大小、縮放、不透明度、旋轉和翻轉、是否隱藏、你編輯過的文字和畫上的標記。

它儲存的是東西的來源，而不是副本：檔案的路徑、網頁的網址、便條的文字。只有背後沒有檔案的圖片 —— 貼上的截圖、你標註過的圖片 —— 才會存成副本。所以如果你移動或刪除了某個檔案，下次那張貼圖就會被略過，而不是空白地重新出現。所在顯示器已經不在的貼圖，會回到主螢幕上。

如果想每次都從空白開始，請關閉「設定 › 貼圖 › 啟動時恢復貼圖」。

## 主視窗、歷史與收藏

用 ⌃⌥L、選單裡的「打開 Pinit…」，或按一下 Dock 圖示打開主視窗。用 ⌘1、⌘2 和 ⌘3 切換頁面。工具列的「釘選」按鈕涵蓋所有釘選方式，搜尋欄位可以依名稱和貼圖內的文字過濾。

- **桌面**: 現在釘住的東西。「定位」會幫你找到貼圖 —— 取消隱藏、把調淡的貼圖恢復為完全不透明、如果它的顯示器不在了就移到主螢幕 —— 並讓它的外框閃爍。
- **歷史**: 你釘選過的所有東西，依日期分組。「再次釘選」會把關閉的貼圖放回去，沿用它最後的位置、大小和不透明度。只記錄釘選，從不記錄剪貼簿。
- **收藏**: 在「歷史」裡為項目加上星號，就能把它保留在這裡。收藏永不過期。
- **鍵盤**: ↑ 和 ↓ 選取，Return 鍵定位或再次釘選，⌘⌫ 關閉或移除，⌘F 搜尋，Esc 清除搜尋。

> 「歷史」預設保留 30 天。可以在「設定 › 貼圖 › 保留時間」裡改成 1 週、90 天或永久，也可以關閉歷史。桌面上的貼圖和收藏永遠不會被清理。

## 快速鍵

全域快速鍵在任何 App 中都能使用。預設只有兩個設定了按鍵；其他的可以在「設定 › 快速鍵」裡指定。如果某個快速鍵已被其他 App 佔用，選單會在該項目旁邊註明。

- **⌃⌥P**: 釘選剪貼簿內容（全域）。
- **⌃⌥L**: 顯示主視窗（全域）。
- **預設沒有按鍵**: 「釘選檔案…」、「新增文字貼圖…」、「隱藏 / 顯示所有貼圖」和「重新打開關閉的貼圖」（全域 —— 請自行指定）。
- **⌘N · ⌘O · ⌘L**: 新增文字貼圖 · 釘選檔案 · 釘選網頁（Pinit 在最前面時）。
- **⌘⇧V · ⌘⇧T**: 釘選剪貼簿內容 · 重新打開關閉的貼圖。
- **⌘0 · ⌘Y · ⌘,**: 主視窗 · 歷史 · 設定。

## 自動化：pinit:// URL scheme

從任何地方打開這些連結 —— 「捷徑」App 裡的「打開 URL」動作、Raycast 或 Alfred 指令，或終端機裡的 open。記得對文字做百分比編碼：空格是 %20。

刻意不提供用連結釘選檔案的方式：任何網頁都能觸發 URL scheme。檔案請用拖放、「打開檔案的應用程式」、「服務」選單或 open -a Pinit。url 參數只接受 http 和 https 網址。

- **pinit://pin?url=…**: 釘選網頁。
- **pinit://pin?text=…**: 釘選文字。如果只有一個網址，會釘成網頁。
- **pinit://clipboard**: 釘選剪貼簿內容。
- **pinit://new**: 打開「新增文字貼圖」視窗。
- **pinit://toggle**: 隱藏或顯示所有貼圖。
- **pinit://reopen**: 重新打開最後關閉的貼圖。
- **pinit://open · history · favorites**: 在對應的頁面打開主視窗。

```sh
open "pinit://pin?url=https://example.com"
```

## 設定

從選單列的圖示打開「設定」，或在 Pinit 位於最前面時按 ⌘,。

- **一般**: Pinit 顯示的位置（選單列、Dock 或兩者）、登入時啟動、外觀、語言，以及下載版的自動檢查更新。
- **貼圖**: 新貼圖的預設不透明度和陰影、啟動時恢復貼圖，以及歷史：開啟或關閉、保留多久，還有「清除歷史」。
- **快速鍵**: 設定、更改或清除六個全域快速鍵。
- **關於**: 版本、本站連結和隱私權政策。

## 疑難排解

- **選單列裡沒有 Pinit 圖示**: 在 macOS 26 上，請到「系統設定 › 選單列」允許 Pinit。在任何版本上，選單列太擠都可能讓圖示藏到瀏海後面 —— 請在「設定 › 一般」裡切換為「選單列和 Dock」或「僅 Dock」。
- **快速鍵沒有反應**: 可能已被其他 App 佔用；選單會把該項目標示為無法使用。請在「設定 › 快速鍵」裡選擇其他按鍵。
- **雙指捏合時，底下的 App 也跟著縮放**: 這是預期中的行為。沒有「輔助使用」權限，Pinit 無法阻止捏合手勢同時傳到下方的視窗。貼圖本身仍會正確縮放；捲動以及 + 和 − 不會有這個副作用。
- **重新啟動後，有張貼圖沒有回來**: 它的檔案被移動、重新命名或刪除了，所以 Pinit 略過了它，而不是顯示一張空白的貼圖。在「歷史」裡找到該項目；檔案放回原處後，「再次釘選」就能用了。
- **找不到某張貼圖**: 打開主視窗，在「桌面」裡找到它，然後按「定位」。它會取消隱藏、恢復為完全不透明，並顯示外框。

## 解除安裝

從 Pinit 的選單結束它，然後把 Pinit 從「應用程式」資料夾移到垃圾桶。App 本身只需要這樣。

你的貼圖、歷史和圖片副本存放在 ~/Library/Application Support/app.kopit.pinit（Mac App Store 版存放在 ~/Library/Containers/app.kopit.pinit）。刪除那個資料夾即可一併移除。如果開啟了登入時啟動，登入項目會隨著 App 一起消失。

---

Canonical: https://pinit.kopit.app/zh-tw/guide
Markdown: https://pinit.kopit.app/zh-tw/guide.md
