快捷面板

快捷面板是 UniClipboard 的键盘流主入口：一个独立的浮窗，列出当前空间的剪贴历史，按方向键定位、回车直接粘贴回原应用。整个流程不需要把焦点切到主窗口。

唤出与隐藏

平台	默认快捷键
macOS	`Cmd + Ctrl + V`
Windows / Linux	`Ctrl + Alt + V`

按一次唤出，再按一次隐藏。Esc 也可以直接收起面板。面板失焦后会自动隐藏（设计上不抢长焦点）。

快捷键被其它应用占用了？面板"按了没反应"通常是热键冲突，不是 bug。到设置 — 快捷键改成空闲组合即可。如果根本不想要这个面板，也可以在设置 — 快捷面板里整体关掉它 —— 关闭即时反注册全局快捷键。

键盘操作

面板设计为完全用键盘驱动。下面这套键位可在打开后立即用：

按键	作用
`↑` / `↓`	上下移动选中项
`Enter`	把选中项粘贴回上一个应用
按住 `Option` / `Alt`	请求纯文本粘贴
`Esc`	关闭面板，不粘贴
`Alt + Backspace`	从历史中删除选中项
`Cmd` / `Ctrl` + `C`	把选中项复制到系统剪贴板并关闭面板
`Cmd` / `Ctrl` + `V`	把选中项粘贴回上一个应用（等同 `Enter`）
`Cmd` / `Ctrl` + `1`–`9`	直接选第 1–9 项
`Cmd` / `Ctrl` + `0`	直接选第 10 项
直接输入	即时按子串过滤（substring，大小写无关）
输入 `type:` `#` `from:` `ext:` `time:`	行内添加筛选筹码（见下文「筛选」）

Cmd / Ctrl + C 与 Cmd / Ctrl + V 作用于当前 hover 或键盘选中的条目；但如果你正在编辑搜索框（选中了一段文字，或粘贴时查询词非空），会让位给搜索框原生的文本选中复制/粘贴行为。

Enter 的粘贴是通过模拟系统粘贴完成的，所以接收方应用感知到的是"用户刚按了 Cmd/Ctrl+V"，富文本与文件类型也会按目标应用支持的最高保真表示落地。

如果想粘贴纯文本，确认条目时按住 Option / Alt：可以按 Enter、点击条目，或继续使用 Cmd / Ctrl + 数字快捷键。UniClipboard 会先只把 text/plain 表示写回系统剪贴板；如果条目没有纯文本表示，则静默回退到普通多格式粘贴。

右键操作

右键任意条目——列表行或图片墙的 tile——可打开上下文菜单。右键会同时选中该条目，所以高亮的那条始终就是菜单作用的对象。

操作	说明
复制	把该项放回系统剪贴板（不粘贴），随后关闭面板。已失效条目（负载丢失）会灰显。
收藏 / 取消收藏	切换收藏标记。已收藏的条目会在列表里显示 ★。
发送到设备	把该项派发给某个已配对设备——或全部设备——不动本机剪贴板。离线对端不可点。
打开文件位置	仅文件条目：在系统文件管理器中定位收到的文件。
粘贴文件路径	仅文件条目：把本地路径直接输入到上一个应用，不改变系统剪贴板。
删除	立即从历史中移除该项——等同 `Alt + Backspace`，无确认。

这些与主窗口历史卡片上的逐项操作一致，所以临时复制、收藏或重发一条时不必再打开主窗口。

内嵌预览

选中一项后，右侧预览面板会按内容类型自动选择渲染方式：

表示类型	预览形态
纯文本	等宽字体；超大文本（>50KB）走虚拟化滚动
链接	提取域名 + 完整 URL
图片	内嵌缩略，按比例适配预览区，附带尺寸
代码 / HTML	与文本一致的渲染（不做语法高亮）
文件	文件名 + 图标；图片文件显示缩略图；多文件按行排列

超过 8 MB 的图片不会自动拉取——预览面会改为显示 加载图片 按钮，避免大原图阻塞预览；点击后再按需拉取完整图片。

预览只读。要把项目放回系统剪贴板或粘贴出去，回到列表按 Enter。

筛选

搜索框是一个复合筛选栏。直接输入即按子串匹配，再叠加以筹码（chip）形式呈现的结构化筛选。共有五个维度：

类型：文本 / 富文本 / 图片 / 文件（旧的 链接 / 代码 筹码仍可解析）。
标签：语义标签，如 link、code。
来源：条目被捕获的设备。
扩展名：文件扩展名，仅对文件类负载有意义。
时间：今天、昨天、近 7 天、近 30 天、本周、本月。

添加筹码有两种方式：点搜索框末尾的筛选按钮选值，或输入前缀再从建议里选：

type:image
#link
from:<设备>
ext:pdf
time:last_7d

筹码可叠加（多个筛选之间是 AND），每个都带 ✕ 可清除。筹码之外的普通词按子串匹配；不支持引号短语、布尔操作符、正则 —— 详见全文搜索 — 查询语法。

图片筛选 — 缩略图墙

列表里的图片条目通常在类型图标位置展示一枚小缩略图，让你不用打开预览也能一眼认出是哪张截图。当图片类型筹码固定时，列表切换为三列瀑布流缩略图墙，每个 tile 按图片自身比例排布——方便一次扫过多张最近截图。方向键仍按时间顺序导航，↑ / ↓ 与 Cmd/Ctrl + 1–9 的行为跟列表视图一致。

筛选写在内存里，关闭面板后 不持久 —— 下次打开是无筛选状态。这是刻意的：面板是即用即抛的入口，不当工作台用。

CLI 端的等价能力是 uniclip search，参数与上面对应：--type / --ext / --from-ms / --to-ms。详见 CLI 参考 — 搜索。

自定义快捷键

已录制的按键组合仍是主要触发方式。在 设置 → 快捷面板 → 双击修饰键 中，还可以选择 Option/Alt、Control 或 Command/Windows/Super，连续轻按两次该修饰键即可打开面板。关闭此选项不会影响已录制的快捷键。

macOS 上的双击修饰键需要单独授予 辅助功能（Accessibility） 权限。UniClipboard 只会静默检查权限状态，不会在后台弹系统授权框；请主动点击 打开辅助功能设置 完成授权。原生 Wayland 会话暂不支持该触发方式，即使会话同时提供 XWayland 的 DISPLAY 也会明确显示为不支持，此时继续使用已录制的快捷键。

设置 → 快捷键 → 全局 → 唤起快捷面板

记录器直接接受按键组合：按下你想用的组合即可，冲突会即时提示。也可以录制两段式快捷键：再按一个组合让第一段成为 leader 键，或连按两次同一组合作为"双击"。重置回默认，清空 让该项不绑定（此时只能从托盘菜单或 GUI 主窗口打开）。

避免与系统级或 IDE 快捷键冲突的常见选择：

macOS：⌃⌥⌘V、⌃⌘Space（注意会与"前一个输入法"冲突）
Windows：Win+V（与系统剪贴板历史冲突，关掉 Windows 那个再用）、Ctrl+Shift+V
Linux：Super+V、Ctrl+Alt+V（默认）

何时用面板，何时回主窗口

你想做的事	推荐入口
立刻粘贴最近的某一项	快捷面板
跨多设备查找几天前的内容	快捷面板筛选（类型 / 来源 / 时间）/ CLI `uniclip search`
长时间整理、批量删除、导出	主窗口仪表盘
配置筛选规则、按设备的内容类型限制	设备页 / 设置

排查

已录制的快捷键没反应：先看故障排查 — 剪贴板权限，macOS 还要确认 输入监控 已授权并彻底重启过应用。
macOS 上双击修饰键被禁用：点击设置旁的按钮授予 辅助功能 权限，然后返回 UniClipboard。Linux 原生 Wayland 会话会明确显示此触发方式不受支持，已录制的快捷键仍可使用。
面板里看不到刚复制的内容：守护进程没起或剪贴板监听被系统隔离。uniclip status 看 daemon.running 与剪贴板监听日志。
同步过来的项目从未出现在面板：可能在发送端被设备规则挡掉了，到对端的设备 → 内容类型白名单检查。

本页目录