本地历史

本地历史默认开启，把截图、长图和新建贴图异步写入本机目录。从历史恢复产生的贴图不会重复写入。可在“设置 → 通用”关闭记录、暂停记录，或修改保留规则。

历史 Dock

按 Ctrl + Shift + H 显示或隐藏。点击卡片会重新贴图；同一历史贴图仍在桌面时，只把它提到顶层。悬停卡片显示大图预览，预览不接收鼠标事件。

操作	说明
`Ctrl` + `F`	Dock 显示时打开搜索框，可搜文本记录和已经文字识别过的图片
`↑` / `W`、`↓` / `S`	翻页；每页只解码当前屏幕容得下的缩略图
卡片右上角	鼠标进入后才显示删除；Dock 内删除不可撤销且不二次确认
右下角清空	鼠标进入后才显示；立即清除全部历史展示项，不关闭已在桌面的贴图
托盘“清空历史...”	会要求确认

新格式图片历史同时保存未压平原图和可编辑标注，恢复为贴图后仍可按空格再次编辑。启用新格式时会一次性清理旧格式记录。

该选项默认关闭。开启后把剪贴板中的图片和文本记入本地历史，不记录文件列表，也不记录本应用自己写入剪贴板的内容。

项	范围
保留天数	`1..365`，默认 7 天
最大条数	`1..10000`，默认 1024
Windows 默认目录	`%LOCALAPPDATA%\Snipkap\History`
macOS 默认目录	`~/Library/Application Support/Snipkap/History`

只接受已存在且可写的文件夹。切换目录只影响新记录，旧内容仍留在原处，历史 Dock 随即读取新目录。

脚本和 AI 请用 CLI 的 history 命令，不要依赖固定延时。