让 Look 替你记住一切：剪贴板历史与图片剪贴板完全指南

Look 是一款开源、跨平台的轻量启动器（Spotlight 和 Raycast 的开源替代），它的剪贴板历史功能会自动记住你复制过的文本与图片。本文带你用 c" 和 ci" 两个前缀，快速找回任何一次复制的内容，并教你调整历史记录大小。

📋 什么是 Look 的剪贴板历史

每次你在任何应用里按 Ctrl+C / Cmd+C 复制内容，Look 都会悄悄把最近的文本剪贴片记录下来。当你打开 Look 输入框并输入：

c"

就会进入剪贴板历史模式，列出最近的文本剪贴片；继续输入关键词（如 c"密码），则只在历史中搜索匹配项。

• Enter：把选中的历史条目重新复制回系统剪贴板
• Cmd+I（Linux/Windows 为 Ctrl+I）：把选中条目直接粘贴回你刚才离开的应用，文本和图片都支持
• Cmd+D（Linux/Windows 为 Ctrl+D）：从 Look 的历史中删除选中条目

几个贴心细节：

• 文件/文件夹复制（Ctrl+C 或 Cmd+C 复制的文件）不会进入历史
• 计算器算出的结果在历史里显示完整算式（2+2 = 4），但粘贴时只贴结果值 4
• macOS 上历史保存在内存（当前会话）；Linux 和 Windows 上历史持久化到磁盘，重启后仍在

相关实现可参考：

• 剪贴板历史（macOS 侧）：ClipboardHistoryStore.swift
• 剪贴板后端（Linux/Windows 侧）：clipboard.rs

🖼️ 图片剪贴板：ci" 找回每一张截图

截图、微信聊天里复制的表情包、网页上复制的图片——输入：

ci"

即可打开图片剪贴板，按最新排序展示最近复制的图片。

• 每个图片条目带缩略图，行名默认取复制来源的应用名；在无法判断前台窗口的 GNOME / KDE Wayland 会话中，会显示为 Image from screen
• 每张图片以 PNG 形式保存在数据库旁边，并自动生成缩略图
• Enter 重新复制图片，Ctrl+I / Cmd+I 直接粘贴到来源应用

图片存储与缩略图的编码逻辑见：clipimage.rs，macOS 侧采集逻辑见：ClipboardImageCapture.swift。

⌨️ 快捷键速查表

操作	macOS	Linux / Windows
复制选中历史项回剪贴板	Enter	Enter
直接粘贴到来源应用（文本/图片）	Cmd+I	Ctrl+I
删除选中历史项	Cmd+D	Ctrl+D

小提示：在安全输入框（密码框、终端 sudo）中，Ctrl+I 无法注入粘贴，Look 会明确提示你，而不是静默失败。

🚀 一步直达：命令行启动剪贴板模式

Look 支持直接从命令行的指定模式启动，方便你把桌面快捷键绑定成"打开我的剪贴板历史"：

lookapp clipboard          # 打开 c" 剪贴板历史
lookapp clipboard-image    # 打开 ci" 图片剪贴板

模式名不区分大小写，且都有更短的别名：clipboard 可用 clip / cb，clipboard-image 可用 clipimg / ci。完整模式表见 user-guide.md。

⚙️ 调整历史大小：两个参数

Look 用两个配置项控制容量，可在设置中修改：

参数	含义	默认值	范围
clipboard_history_limit	文本剪贴板历史条数	10	10 ~ 100
clipboard_image_limit	图片剪贴板张数	20	5 ~ 50

🔒 隐私说明：Look 不会记住什么

• 加密/临时剪贴片从不落盘——系统标记为 concealed 或 transient 的复制内容（如密码管理器复制的内容）永远不会被写入历史
• 历史有容量上限（文本最多 5000 行），并且可以一条命令清空：look_clipboard_clear
• 每条历史都记录了来源应用，为将来"排除某应用进入剪贴板记忆"打下基础
• 开启 AI 功能后，Look 的 Recall 功能可以"问自己的机器"——比如"上周复制的那个 API key 是什么"——剪贴板历史就在本地参与检索，详见 ai-vision.md

📚 延伸阅读

• 用户指南（剪贴板与翻译章节）：user-guide.md
• 功能总览：features.md
• 整体架构（含剪贴板存储设计）：architecture.md

现在，下次复制完一段代码、一张截图，直接按 Look 的全局快捷键输入 c" 或 ci"，一切都在那里等你。