p0deje/Maccy
GitHub: p0deje/Maccy
一款面向 macOS 的轻量级开源剪贴板管理器，支持历史记录保存、快速搜索和键盘快捷操作。
Stars: 19781 | Forks: 947
# [Maccy](https://maccy.app)
[](https://github.com/p0deje/Maccy/releases/latest)
[](https://app.bitrise.io/app/716921b669780314)
Maccy 是一款适用于 macOS 的轻量级剪贴板管理器。它会保存您所复制内容的历史记录，
并允许您快速导航、搜索和使用之前的剪贴板内容。
Maccy 可在 macOS Sonoma 14 或更高版本上运行。
* [功能特性](#features)
* [安装](#install)
* [使用方法](#usage)
* [进阶](#advanced)
* [忽略复制的项目](#ignore-copied-items)
* [忽略自定义复制类型](#ignore-custom-copy-types)
* [加快剪贴板检查间隔](#speed-up-clipboard-check-interval)
* [常见问题](#faq)
* [为什么在历史记录中选择项目后没有自动粘贴？](#why-doesnt-it-paste-when-i-select-an-item-in-history)
* [为打开 Maccy 分配快捷键时，提示该快捷键已被某些系统设置占用。](#when-assigning-a-hotkey-to-open-maccy-it-says-that-this-hotkey-is-already-used-in-some-system-setting)
* [如何恢复隐藏的底部栏？](#how-to-restore-hidden-footer)
* [如何忽略来自通用剪贴板的复制？](#how-to-ignore-copies-from-universal-clipboard)
* [我的键盘快捷键在密码框中失效了。该如何解决？](#my-keyboard-shortcut-stopped-working-in-password-fields-how-do-i-fix-this)
* [翻译](#translations)
* [初衷](#motivation)
* [许可证](#license)
## 功能特性
* 轻量且快速
* 键盘优先
* 安全且私密
* 原生 UI
* 开源且免费
## 安装
从 [releases](https://github.com/p0deje/Maccy/releases/latest) 页面下载最新版本，或使用 [Homebrew](https://brew.sh/)：
```
brew install maccy
```
## 使用方法
1. SHIFT (⇧) + COMMAND (⌘) + C 弹出 Maccy，或点击菜单栏中的图标。
2. 输入您想要查找的内容。
3. 要选择您想要复制的历史记录项，请按 ENTER，或单击该项，或使用 COMMAND (⌘) + `n` 快捷键。
4. 要选择历史记录项并粘贴，请按 OPTION (⌥) + ENTER，或者 OPTION (⌥) + CLICK 该项，或使用 OPTION (⌥) + `n` 快捷键。
5. 要选择历史记录项并粘贴（忽略格式），请按 OPTION (⌥) + SHIFT (⇧) + ENTER，或者 OPTION (⌥) + SHIFT (⇧) + CLICK 该项，或使用 OPTION (⌥) + SHIFT (⇧) + `n` 快捷键。
6. 要删除历史记录项，请按 OPTION (⌥) + DELETE (⌫)。
7. 要查看历史记录项的完整文本，请稍等几秒钟以显示提示框。
8. 要固定历史记录项使其保留在列表顶部，请按 OPTION (⌥) + P。该项将被移至顶部，并分配一个随机但固定的键盘快捷键。要取消固定，请再次按 OPTION (⌥) + P。
9. 要清除所有未固定的项目，请在菜单中选择 _Clear_，或按 OPTION (⌥) + COMMAND (⌘) + DELETE (⌫)。要清除包括固定项目在内的所有项目，请在按住 OPTION (⌥) 的情况下在菜单中选择 _Clear_，或者按 SHIFT (⇧) + OPTION (⌥) + COMMAND (⌘) + DELETE (⌫)。
10. 要禁用 Maccy 并忽略新的复制，请在按住 OPTION (⌥) 的同时点击菜单图标。
11. 要仅忽略下一次复制，请在按住 OPTION (⌥) + SHIFT (⇧) 的同时点击菜单图标。
12. 要自定义行为，请查看 "Preferences…" 窗口，或按 COMMAND (⌘) + ,。
## 进阶
### 忽略复制的项目
您可以让 Maccy 忽略所有复制的项目：
```
defaults write org.p0deje.Maccy ignoreEvents true # default is false
```
如果您有一些复制敏感数据的工作流，这会很有用。您可以将 `ignoreEvents` 设置为 true，复制数据后再将 `ignoreEvents` 恢复设置为 false。
您也可以在按住 OPTION (⌥) 的同时点击菜单图标。要仅忽略下一次复制，请在按住 OPTION (⌥) + SHIFT (⇧) 的同时点击。
### 忽略自定义复制类型
默认情况下，Maccy 会忽略某些被认为是机密或临时的复制类型。默认列表始终包括以下类型：
* `org.nspasteboard.TransientType`
* `org.nspasteboard.ConcealedType`
* `org.nspasteboard.AutoGeneratedType`
此外，默认配置包含以下类型，但它们可以被移除或覆盖：
* `com.agilebits.onepassword`
* `com.typeit4me.clipping`
* `de.petermaurer.TransientPasteboardType`
* `Pasteboard generator type`
* `net.antelle.keeweb`
您可以通过设置添加其他自定义类型。
要查找应用程序使用了哪些自定义类型，您可以使用免费应用程序 [Pasteboard-Viewer](https://github.com/sindresorhus/Pasteboard-Viewer)。
只需下载该应用程序并将其打开，从您想要忽略的应用程序中复制一些内容，然后在左侧边栏中查找任何自定义类型。[以下是使用此方法忽略 Adobe InDesign 的示例](https://github.com/p0deje/Maccy/issues/125)。
### 加快剪贴板检查间隔
默认情况下，Maccy 每 500 毫秒检查一次剪贴板，这对大多数用户来说应该足够了。如果您想加快检查速度，可以使用 `defaults` 进行更改：
```
defaults write org.p0deje.Maccy clipboardCheckInterval 0.1 # 100 ms
```
## 常见问题
### 为什么在历史记录中选择项目后没有自动粘贴？
1. 请确保您已在偏好设置中启用了 "Paste automatically"。
2. 请确保 "Maccy" 已添加到系统设置 -> 隐私与安全性 -> 辅助功能中。
### 为打开 Maccy 分配快捷键时，提示该快捷键已被某些系统设置占用。
1. 打开系统设置 -> 键盘 -> 键盘快捷键。
2. 找到该快捷键被使用的位置。例如，"Convert text to simplified Chinese" 位于服务 -> 文本下。
3. 禁用该快捷键或移除分配的组合键（[截图](https://github.com/p0deje/Maccy/assets/576152/446719e6-c3e5-4eb0-95fb-5a811066487f)）。
4. 重启 Maccy。
5. 在 Maccy 设置中分配快捷键。
### 如何恢复隐藏的底部栏？
1. 打开 Maccy 窗口。
2. 按 COMMAND (⌘) + , 打开偏好设置。
3. 在外观部分中启用底部栏（footer）。
如果由于某种原因这不起作用，请在 Terminal.app 中运行以下命令：
```
defaults write org.p0deje.Maccy showFooter 1
```
### 如何忽略来自[通用剪贴板](https://support.apple.com/en-us/102430)的复制？
1. 打开偏好设置 -> 忽略 -> Pasteboard Types。
2. 添加 `com.apple.is-remote-clipboard`。
### 我的键盘快捷键在密码框中失效了。该如何解决？
如果您的快捷键会产生某个字符（例如 `Option+C` → "ç"），macOS 的安全机制可能会在密码框中阻止它。请使用 [Karabiner-Elements](https://karabiner-elements.pqrs.org/) 将您的快捷键重新映射为其他组合，例如 `Cmd+Shift+C`。[查看详细解决方案](docs/keyboard-shortcut-password-fields.md)。
## 翻译
翻译由 [Weblate](https://hosted.weblate.org/engage/maccy/) 托管。
您可以使用它来建议对翻译进行修改，并将应用程序本地化为新的语言。
[](https://hosted.weblate.org/engage/maccy/)
## 初衷
市面上有许多类似的应用程序，那为什么还要再开发一个呢？
自从我从 Linux 转向 macOS 的过去几年里，我一直在努力寻找一款像 [Parcellite](http://parcellite.sourceforge.net) 一样免费且简单的剪贴板管理器，
但我没能找到。所以我决定自己开发一个。
此外，我想借此学习 Swift 并熟悉 macOS 应用程序的开发。
## 许可证
[MIT](./LICENSE)标签：Homebrew, LangChain, Maccy, 个人效率, 二进制发布, 剪切板记录, 剪贴板历史, 剪贴板管理器, 历史记录, 原生UI, 开发辅助工具, 开源工具, 快捷键, 快速搜索, 效率工具, 系统工具, 轻量级, 键盘操作, 隐私安全