文档
快捷键、规则、权限
所有操作都能用键盘完成。
快捷键
| ⇧⌘V | 打开 / 关闭面板(全局) |
| ↑ ↓ | 移动选择 |
| ⌘↵ | 粘贴选中的条目 |
| ⇧⌘↵ | 粘贴为纯文本 |
| ⌘1 … ⌘9 | 快速粘贴前 9 条 |
| ⌘K | 动作:对选中条目做转换 |
| ↵ / ⌥↵ | 在动作面板里:转换并粘贴 / 只转换并复制 |
| ⌥(按住) | 显示被涂黑的密钥 |
| ⌘⌫ | 删除选中条目(对密钥即立即销毁) |
| ⌘P | 固定 / 取消固定 |
| ⌘⌥1 … 7 | 切换类型过滤(全部、文本、代码、链接、图片、文件、受守护) |
| ⌘, | 设置 |
| esc | 先关动作面板,再关面板 |
搜索
直接输入即可搜索文本、拼音(全拼或首字母)和来源 App 名。用前缀缩小范围:type:json、app:Xcode、is:secret。
密钥规则如何工作
每一次复制都会按同样的顺序经过检查,第一个命中的规则决定怎么处理。全部在你的 Mac 上完成,只扫描前 64 KB,耗时在几毫秒内。
- Concealed / Transient 标记. 密码管理器用 org.nspasteboard.ConcealedType、TransientType 或 AutoGeneratedType 标记的内容,不记录。
- 排除的 App. 从排除列表里的 App(默认包含 1Password、Bitwarden、钥匙串访问等)复制的内容,不记录。
- 密钥扫描器. 内置规则能识别 AWS Key、GitHub Token、OpenAI / Anthropic Key、Stripe、Slack、Google API Key、JWT、私钥和带密码的数据库 URL。命中后存为“敏感项”。
- 其余内容. 正常保存、去重、可搜索。
命中密钥后怎么处理
- 销毁(默认). 以涂黑形式显示,30 秒后销毁;不进入搜索索引;删除时覆写数据。
- 打码. 保留,但始终涂黑显示,按住 ⌥ 才显示明文。
- 关闭. 该类别的规则不生效。
规则的写法尽量避免误报:普通的 UUID、Git commit SHA 不会被当作密钥。如果有误判,可在 设置 → 隐私与守护 里把该规则改成“打码”或“关闭”。
设置 → 隐私与守护 里的规则试验台可以粘贴一段字符串,看会命中哪条规则。你在那里输入的内容不会被保存,也不会写进日志。
权限问题排查
剪贴板访问:请设为“始终允许”
较新的 macOS 版本可能会在 App 于后台读取剪贴板之前询问。ClipVigil 需要读取剪贴板才能记录历史。
系统弹窗出现时,选择“始终允许”。
如果你选了“不允许”,或 ClipVigil 显示“受限”横幅:打开 系统设置 → 隐私与安全性 → 从其他 App 粘贴,找到 ClipVigil,设为“始终允许”,然后退出并重新打开 ClipVigil。
访问受限期间 ClipVigil 无法记录新的复制内容,但不会崩溃;你仍可使用片段,并用 ⌥⌘V 手动加入当前剪贴板。
辅助功能:仅在需要代你粘贴时使用
ClipVigil 用辅助功能向最前面的 App 发送 ⌘V,这样 ⌘↵ 才能直接粘贴。
打开 系统设置 → 隐私与安全性 → 辅助功能,把 ClipVigil 打开。如果已列出但不生效,先关再开,或用“−”移除后重新添加。
没有这个权限时,⌘↵ 只会复制,需要你自己粘贴,其他功能不受影响。
还是不行
打开 设置 → 权限,点“复制诊断信息”,发给我们。内容只有各项权限状态和 App 版本,不含任何剪贴板内容。 support@clipvigil.app