# 功能特性

本文档详细列出了 ElegantClipboard 的所有功能特性。
界面截图请参见 [README.md](README.md)（截图拍摄于 v0.5.0，可能与最新版本略有差异）。

## 术语约定

- **悬浮预览窗口** - 指鼠标悬停后弹出的独立预览窗口（包含图片与文本两类）
- **图片悬浮预览** - 图片类型的悬浮预览窗口，支持 `Ctrl+滚轮` 缩放
- **文本悬浮预览** - 文本/HTML/RTF 类型的悬浮预览窗口，支持 `Ctrl+滚轮` 滚动

## 剪贴板管理

- **多类型支持** - 文本、图片、文件、HTML、RTF 五种内容类型
- **无限历史记录** - 自动记录所有复制内容，随时回溯
- **智能搜索** - 实时搜索历史记录，优化的 LIKE 查询（专为中文等 CJK 文本优化）
- **内容去重** - BLAKE3 哈希自动去重，相同内容不重复存储
- **置顶/收藏** - 重要内容可置顶或收藏，不受自动清理影响
- **拖拽排序** - 卡片支持拖拽排序，跨置顶/普通区域拖拽自动切换状态
- **点击即粘贴** - 点击记录直接粘贴到活动窗口
- **纯文本粘贴** - 支持以纯文本形式粘贴（Shift+Enter 或右键菜单）
- **文本编辑** - 双击或右键编辑已保存的文本内容
- **来源应用识别** - 自动记录复制内容的来源应用名称和图标
- **去重策略** - 可选置顶/忽略/始终新建三种重复内容处理方式
- **数据导入/导出** - 支持 JSON 格式的数据导入导出，方便迁移

## 搜索优化

- **中文兼容性** - 使用优化的 LIKE 查询，完美支持中文等 CJK 文本
- **字段智能选择** - 仅在预览字段和文件路径上搜索，避免大文本字段全表扫描
- **性能平衡** - 在搜索准确性和性能之间取得最佳平衡
- **关键词高亮** - 搜索时自动提取关键词上下文，提升搜索体验

## 图片悬浮预览

- **缩略图预览** - 图片类型自动生成缩略图（Asset Protocol 零开销加载）
- **单图片文件预览** - 复制的图片文件自动显示图片预览（失败时回退为文件卡片）
- **悬浮预览窗口** - 鼠标悬停按设置延时弹出独立预览窗口（默认 500ms），支持大图查看
- **Ctrl+滚轮缩放** - 图片悬浮预览窗口支持平滑缩放（CSS transition 动画，零窗口 resize）
- **缩放百分比显示** - 缩放时右下角显示百分比徽章，1.2 秒后自动淡出
- **预览位置可选** - 支持自动/左侧/右侧三种预览位置偏好

## 文本悬浮预览

- **独立文本预览窗口** - 文本/HTML/RTF 内容可悬浮打开独立预览窗口
- **默认关闭** - 文本预览默认关闭，可在设置中单独开启
- **Ctrl+滚轮滚动** - 复用 Ctrl+滚轮手势滚动文本预览，避免与列表滚动冲突
- **主题与圆角同步** - 自动跟随主窗口深浅色主题与直角模式
- **预览位置可选** - 与图片预览一致，支持自动/左侧/右侧

## 文件管理

- **文件有效性检测** - 并行检查文件是否存在（rayon），失效文件显示红色警告
- **右键菜单** - 粘贴、粘贴为路径、在资源管理器中显示、查看详细信息
- **文件详情对话框** - 查看已复制文件的完整信息，标注失效文件

## 性能优化

- **读写分离** - 数据库连接读写分离，减少锁争用，提高并发性能
- **WAL 模式** - 启用 WAL 模式支持并发读写操作
- **内存优化** - 针对读写连接配置不同的缓存大小（写连接 64MB，读连接 32MB）
- **索引优化** - 部分索引、复合索引、降序索引等多种索引策略
- **无锁设计** - 全局鼠标监控使用原子变量，避免锁竞争
- **虚拟滚动** - 前端使用 react-virtuoso 实现高效虚拟列表，万条数据仍保持流畅

## 窗口管理

- **全局快捷键** - 自定义快捷键唤出/隐藏窗口（默认 Alt+C）
- **Win+V 替换** - 可选替换系统 Win+V（通过注册表禁用系统热键）
- **点击外部隐藏** - 全局鼠标监控，点击窗口外部自动隐藏（仅窗口可见时启用）
- **窗口固定** - 锁定窗口防止自动隐藏
- **跟随光标** - 可选在光标位置显示窗口
- **多显示器支持** - 智能定位，保持窗口在屏幕边界内
- **记住窗口大小** - 可选持久化窗口尺寸，重启后恢复（默认开启）

## 自定义设置

- **工具栏自定义** - 配置工具栏按钮的显示、隐藏和排序
- **自定义存储路径** - 支持数据迁移和路径自定义
- **历史记录限制** - 可设置最大记录数（0 为无限制）
- **内容大小限制** - 单条内容最大大小可配置
- **显示设置** - 预览行数（1-10 行）、时间格式、字符数/大小/来源应用显示可选
- **卡片密度** - 紧凑/标准/宽松三种卡片间距
- **音效反馈** - 可选复制/粘贴操作音效
- **预览设置** - 图片/文本预览可独立开关，悬浮预览延时（默认 500ms）、缩放步进（5%-50%）、预览位置偏好
- **窗口状态重置** - 窗口隐藏时自动重置搜索和滚动位置（可选）
- **开机自启** - 支持系统启动时自动运行
- **管理员启动** - 可选以管理员权限运行（UAC 提升）
- **数据库优化** - 手动触发 OPTIMIZE / VACUUM
- **数据统计** - 实时查看数据库、图片缓存大小和文件数量
- **数据清理** - 三级清理操作：清空历史 / 恢复默认配置 / 重置所有数据

## 外观主题

- **跟随系统强调色**（默认） - 自动读取 Windows 系统强调色，实时跟随变更
- **经典黑白** - 简约黑白灰配色
- **翡翠绿 / 天空青** - 预设配色方案
- **暗色模式** - 自动跟随系统深色/浅色模式
- **窗口毛玻璃特效** - 支持 Mica / Acrylic / Tabbed 三种 Windows 11 DWM 背景特效（Win10 自动回退）

## 自动更新

- **版本检查** - 启动时自动检查更新，也可手动在设置中触发
- **下载进度** - 支持显示下载进度，可取消下载
- **更新日志** - 显示版本发布说明，了解新功能
- **系统代理支持** - 自动读取 Windows 系统代理设置，代理环境下也能正常检查和下载更新

## 系统集成

- **系统托盘** - 左键切换窗口、右键菜单（设置、重启、退出）
- **非焦点窗口** - 窗口不抢占焦点，不影响当前操作
- **键盘模拟** - Windows 使用 SendInput、其他平台使用 enigo 模拟 Ctrl+V 实现粘贴
- **快速粘贴** - 支持 Alt+数字键快速粘贴对应位置的条目（可自定义）
- **启动通知** - 应用启动后显示系统通知，提示快捷键
- **管理员提权** - 通过任务计划程序实现免 UAC 提权（设置中可选）
- **便携版支持** - 提供无需安装的便携版 exe，自动识别便携模式