文档

快捷键、规则、权限

所有操作都能用键盘完成。

快捷键

⇧⌘V打开 / 关闭面板(全局)
↑ ↓移动选择
⌘↵粘贴选中的条目
⇧⌘↵粘贴为纯文本
⌘1 … ⌘9快速粘贴前 9 条
⌘K动作:对选中条目做转换
↵ / ⌥↵在动作面板里:转换并粘贴 / 只转换并复制
⌥(按住)显示被涂黑的密钥
⌘⌫删除选中条目(对密钥即立即销毁)
⌘P固定 / 取消固定
⌘⌥1 … 7切换类型过滤(全部、文本、代码、链接、图片、文件、受守护)
⌘,设置
esc先关动作面板,再关面板

全局快捷键可在 设置 → 快捷键 中修改。

搜索

直接输入即可搜索文本、拼音(全拼或首字母)和来源 App 名。用前缀缩小范围:type:json、app:Xcode、is:secret。

密钥规则如何工作

每一次复制都会按同样的顺序经过检查,第一个命中的规则决定怎么处理。全部在你的 Mac 上完成,只扫描前 64 KB,耗时在几毫秒内。

  1. Concealed / Transient 标记. 密码管理器用 org.nspasteboard.ConcealedType、TransientType 或 AutoGeneratedType 标记的内容,不记录。
  2. 排除的 App. 从排除列表里的 App(默认包含 1Password、Bitwarden、钥匙串访问等)复制的内容,不记录。
  3. 密钥扫描器. 内置规则能识别 AWS Key、GitHub Token、OpenAI / Anthropic Key、Stripe、Slack、Google API Key、JWT、私钥和带密码的数据库 URL。命中后存为“敏感项”。
  4. 其余内容. 正常保存、去重、可搜索。

命中密钥后怎么处理

  • 销毁(默认). 以涂黑形式显示,30 秒后销毁;不进入搜索索引;删除时覆写数据。
  • 打码. 保留,但始终涂黑显示,按住 ⌥ 才显示明文。
  • 关闭. 该类别的规则不生效。

规则的写法尽量避免误报:普通的 UUID、Git commit SHA 不会被当作密钥。如果有误判,可在 设置 → 隐私与守护 里把该规则改成“打码”或“关闭”。

设置 → 隐私与守护 里的规则试验台可以粘贴一段字符串,看会命中哪条规则。你在那里输入的内容不会被保存,也不会写进日志。

权限问题排查

不同 macOS 版本里菜单和设置项的名称可能略有差异。ClipVigil 里的 设置 → 权限 页面始终显示当前状态,并提供“复制诊断信息”按钮(不含任何剪贴板内容)。

剪贴板访问:请设为“始终允许”

较新的 macOS 版本可能会在 App 于后台读取剪贴板之前询问。ClipVigil 需要读取剪贴板才能记录历史。

系统弹窗出现时,选择“始终允许”。

如果你选了“不允许”,或 ClipVigil 显示“受限”横幅:打开 系统设置 → 隐私与安全性 → 从其他 App 粘贴,找到 ClipVigil,设为“始终允许”,然后退出并重新打开 ClipVigil。

访问受限期间 ClipVigil 无法记录新的复制内容,但不会崩溃;你仍可使用片段,并用 ⌥⌘V 手动加入当前剪贴板。

辅助功能:仅在需要代你粘贴时使用

ClipVigil 用辅助功能向最前面的 App 发送 ⌘V,这样 ⌘↵ 才能直接粘贴。

打开 系统设置 → 隐私与安全性 → 辅助功能,把 ClipVigil 打开。如果已列出但不生效,先关再开,或用“−”移除后重新添加。

没有这个权限时,⌘↵ 只会复制,需要你自己粘贴,其他功能不受影响。

还是不行

打开 设置 → 权限,点“复制诊断信息”,发给我们。内容只有各项权限状态和 App 版本,不含任何剪贴板内容。 support@clipvigil.app