# 使用 Pinit

> 如何用 Pinit 钉住内容、操作贴图、恢复贴图布局、使用历史、快捷键以及 pinit:// URL scheme。

## 开始使用

打开磁盘映像，把 Pinit 拖到「应用程序」文件夹，然后打开它。Pinit 以一个小小的 P 字图标待在菜单栏里。第一次启动时，它会打开主窗口，列出钉住东西的各种方式 —— 最快的是随便复制点什么，然后按 ⌃⌥P。

Pinit 不需要任何权限，你也不会看到 macOS 弹出的请求。从本站下载的版本第一次运行时会把自己加入登录项，这样重启后贴图就会回来；可以在「设置 › 通用」里关掉。

- **仅菜单栏**: 默认选项。菜单栏里一个图标，没有 Dock 图标，也不出现在 ⌘Tab 里。
- **菜单栏和 Dock**: 两处都有。点按 Dock 图标打开主窗口；右键点按查看快捷操作；把文件拖到图标上即可钉住。
- **仅 Dock**: 菜单栏里没有图标，适合菜单栏已经挤满的情况。这项设置在「设置 › 通用 › Pinit 显示在」。

## 钉住内容

无论从哪里进来，结果都一样：一张贴图出现在指针附近，位于所有窗口之上。一次放进多项，就会得到多张贴图，扇形散开，彼此不会遮挡。

- **剪贴板 —— ⌃⌥P**: 钉住你最后复制的东西：一张图片、一段文字、一个链接，或者你在访达里复制的文件。菜单里也有，叫「钉住剪贴板内容」。
- **拖到菜单栏的图标上**: 把文件、图片、链接或选中的文字拖到图标上。在 macOS 26 上，拖到图标上方时，图标下面会弹出一张「松手即可钉住」的小卡片 —— 在图标或卡片上松手都行。
- **拖进主窗口**: 拖到窗口里的任何位置都行；内容会被钉住，窗口随即切换到「桌面」。
- **打开方式与 Dock**: 在访达里右键点按文件 › 打开方式 › Pinit，或把文件拖到 Pinit 的 Dock 图标上。Pinit 从不把自己设为任何东西的默认 App。
- **「服务」菜单**: 在任意 App 里选中文字、图片或链接，然后选取「服务 › 用 Pinit 钉住」。在访达里选中的文件，则选取「服务 › 用 Pinit 钉住文件」。
- **钉住文件…**: 在打开面板里选择一个或多个文件。Pinit 位于最前面时按 ⌘O。
- **钉住网页…**: 输入或粘贴一个网址。如果剪贴板里有链接，会已经替你填好。按 ⌘↩ 钉住。
- **新建文字贴图…**: 写一条便签。如果你输入的只是一个网址，按钮会随之改变，改为钉成网页。
- **终端**: open -a Pinit report.pdf 可以钉住你指定的任意文件。

## 每种贴图能做什么

Pinit 根据内容本身决定怎么显示，而不是看它从哪里来。从访达拖进来的 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-cn/guide
Markdown: https://pinit.kopit.app/zh-cn/guide.md
