Maccy 剪贴板历史：装完即用的快捷键与调参速查
【免费下载链接】MaccyLightweight clipboard manager for macOS项目地址: https://gitcode.com/gh_mirrors/ma/Maccy
Maccy 是面向 macOS Sonoma 14+ 的免费开源（MIT）剪贴板历史管理器。它记录你复制的文本、图片和文件，历史全部只存本机，不走任何网络同步。
先说结论
- 一天内多次需要"刚才复制的那个"，就值得装。全流程键盘操作：唤起、搜索、粘贴、固定都有键。
- 数据只存本机，没有云同步。需要跨设备取同一条历史，别装。
- 它只记录"复制"动作，不记录打字输入；复制频率很低、系统自带剪贴板够用，跳过。
- 固定项不受"清空"影响，适合长期保留可复用素材。
跑起来
brew install maccy启动后菜单栏出现 Maccy 图标。最小验证：随便复制一段文本，按Command + Shift + C，刚复制的内容应出现在列表顶部。顺手在偏好设置（Command + ,）的常规页打开"登录时启动"，开机自动运行。
日常操作：剪贴板历史检索与复用
主链路只围绕一个弹出窗口：
- 按
Command + Shift + C唤出历史窗口（也可点菜单栏图标）。默认出现在光标所在屏幕。 - 输入关键词过滤。默认精确匹配、不区分大小写；常规页可改模糊、正则或混合模式。
- 选中目标条目，按
Enter把该项写回系统剪贴板，再到目标应用里粘贴（鼠标双击等效）。 - 鼠标悬停条目约 1.5 秒，浮出完整内容预览，不用展开就能预览全文。
如果想省掉"切窗口再粘贴"：按Option + Enter，选中项直接粘贴进上一个窗口；要去格式就用Option + Shift + Enter以纯文本粘贴。
想让某条长期保留：按Option + P固定，它移到顶部且不会被"清空"移除。清空所有未固定项按Option + Command + Delete；再加Shift则连固定项一起清。
剪贴板默认值速查
| 参数 | 默认值 | 修改位置 |
|---|---|---|
| 历史上限 | 200 条，范围 1～999 | 偏好设置 → 存储页 |
| 剪贴板轮询间隔 | 500 ms | 终端执行defaults write org.p0deje.Maccy clipboardCheckInterval 0.1 |
| 记录内容类型 | 文本、图片、文件全记录 | 偏好设置 → 存储页，三类分别开关 |
| 搜索模式 | 精确匹配（不区分大小写） | 偏好设置 → 常规页，精确/模糊/正则/混合四档 |
| 选中条目默认动作 | 复制（不自动粘贴） | 偏好设置 → 常规页"自动粘贴" |
| 排序 | 最近复制时间 | 偏好设置 → 存储页 |
排坑
选中条目后没粘贴
- 症状：选中条目按
Option + Enter，窗口关闭了，但目标位置没内容。 - 原因：自动粘贴靠模拟按键实现，需要辅助功能权限，默认未授予。
- 解法：先在常规页打开"自动粘贴"，再到系统设置 → 隐私与安全性 → 辅助功能里添加 Maccy。
快捷键提示已被系统占用
- 症状：偏好设置里录制快捷键，提示该组合已被系统使用。
- 原因：系统快捷键占了它，服务 → 文本类较常见。
- 解法：到系统设置 → 键盘 → 键盘快捷键找到占用项，解除或改键，再回 Maccy 重新录制并重启应用。
密码输入框里快捷键失效
- 症状：组合在普通输入正常，密码框里唤不出窗口。
- 原因：组合会产出字符（如
Option + C产生 ç）时，macOS 安全输入会拦截。 - 解法：换成不产生字符的组合，如
Command + Shift + V；坚持原组合可看仓库 docs/keyboard-shortcut-password-fields.md 的重映射方案。
底部状态栏不见了
- 症状：窗口底部的快捷键提示条消失。
- 原因：偏好设置外观页的 footer 开关处于关闭状态。
- 解法：外观页重新打开 footer 开关；仍无效就在终端用
defaults把showFooter键写成 1。
边界
适合用键盘在多窗口间搬代码、链接和素材的人；复制频率很低、或需要跨设备同步剪贴板历史，系统自带功能或其他工具可能更合适。
【免费下载链接】MaccyLightweight clipboard manager for macOS项目地址: https://gitcode.com/gh_mirrors/ma/Maccy
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
