需求拆解
用户复制文本、图片或文件后，工具需要保存可读的历史记录，并提供搜索、置顶、删除和快速粘贴能力。
剪贴板历史工具
CopyHistory 的实现思路
CopyHistory 解决的是“复制过的内容如何可靠找回”的问题。开发时把重点放在本地监听、结构化存储、快速搜索和键盘操作上，让剪贴板历史成为一个可控的本地工作记录。
技术方案
项目使用 Swift、AppKit 和 SwiftUI 构建 macOS 应用，通过 NSPasteboard 读取剪贴板变化，并使用 SQLite 做本地持久化和迁移。
实现边界
历史记录只保存在本机，不设计云同步、用户发布、在线分享或远程分析流程。
主要模块
- 剪贴板监听：监听系统剪贴板变化，识别文本、图片、文件和富文本等类型。
- 历史数据：用本地数据库保存条目，并在版本升级时处理 SQLite schema 迁移。
- 快捷操作：通过全局快捷键唤起面板，支持键盘导航、搜索、置顶和快速粘贴。
- 预览处理：为图片和文件条目生成缩略图或预览，避免一次性加载过多数据。
