Skip to content

haord/ClipPlusPlus

Repository files navigation

Clip++ - Windows 剪贴板管理工具

Clip++ 是一款强大的 Windows 剪贴板历史管理工具,支持文本和图片的历史记录、代码片段管理,以及快捷键快速访问。

功能特性

核心功能

  • 剪贴板历史记录:自动记录所有复制的文本和图片
  • 图片支持:完整支持图片剪贴板,包括缩略图预览和悬停大图预览
  • 代码片段管理:创建和管理常用的代码片段,快速插入
  • 全局快捷键:使用 Ctrl+Shift+V 快速调出历史菜单
  • 系统托盘:最小化到托盘,不占用任务栏空间
  • 数据持久化:使用 SQLite 数据库永久保存历史记录

高级功能

  • 智能去重:基于 SHA256 像素哈希的图片精确去重
  • 自动清理:自动删除超出上限的旧记录和孤立的图片文件
  • 增量更新:高性能数据库增量操作,避免全量重写
  • 可靠重试:剪贴板读取失败自动重试,确保数据不丢失
  • 可配置预览:支持自定义图片预览大小(200-800px)

系统要求

  • 操作系统:Windows 10/11 或更高版本
  • .NET 运行时:.NET 10.0
  • 内存:建议 100MB 以上可用内存
  • 磁盘空间:根据历史记录数量而定,建议预留 500MB

安装与运行

方式一:直接运行(开发环境)

dotnet run

方式二:编译发布版本

dotnet build -c Release

方式三:独立发布(推荐用于分发)

生成包含运行时的独立可执行文件,无需安装 .NET:

dotnet publish -c Release -r win-x64 --self-contained true /p:PublishSingleFile=true

使用指南

基础操作

1. 复制内容

正常使用 Ctrl+C 复制文本或图片,Clip++ 会自动记录到历史中。

2. 查看历史

  • 方式一:按下 Ctrl+Shift+V 调出历史菜单
  • 方式二:右键点击系统托盘图标,选择 History 分组

3. 粘贴历史项

在历史菜单中点击任意项目即可粘贴到当前光标位置。

4. 预览图片

鼠标悬停在历史菜单中的图片项上,会自动弹出大图预览。

设置配置

右键托盘图标 → 选择 "Settings" 打开设置界面。

历史记录设置

  • Max History Items:最大历史记录数量(默认:50)

    • 超过此数量时,最旧的记录会被自动删除
    • 建议范围:10-1000
  • History Group Size:历史分组大小(默认:50)

    • 控制托盘菜单中每个分组的记录数量
  • Preview Size (px):图片预览大小(默认:400)

    • 控制鼠标悬停时显示的预览图尺寸
    • 建议范围:200-800

通用设置

  • Launch at Windows Startup:开机自启动
    • 勾选后,Windows 启动时自动运行 Clip++

快捷键

  • Menu Shortcut:打开历史菜单的快捷键
    • 默认:Ctrl+Shift+V
    • 当前版本暂不支持自定义

应用设置

修改设置后,必须点击 "Apply Settings" 按钮才会生效。

代码片段管理

创建文件夹

  1. 打开 Settings → 切换到 "Manage Snippets" 标签
  2. 点击 "Add" 按钮(Folders 下方)
  3. 输入文件夹名称

创建代码片段

  1. 选择一个文件夹
  2. 点击 "Add" 按钮(Snippets 下方)
  3. 在右侧编辑:
    • Snippet Title:片段标题
    • Snippet Content:片段内容
  4. 点击 "Save All Snippets" 保存

使用代码片段

右键托盘图标 → 选择 Snippets 下的文件夹 → 点击代码片段名称即可粘贴。

清空历史

方式一:设置界面

  1. 打开 Settings → General Settings
  2. 点击 "Clear All History" 按钮
  3. 确认对话框中点击 "Yes"

方式二:手动删除(不推荐) 删除数据库文件:

%AppData%\ClipPlusPlus\clippp.db
%AppData%\ClipPlusPlus\images\

数据存储

存储位置

所有数据存储在用户 AppData 目录:

C:\Users\<用户名>\AppData\Roaming\ClipPlusPlus\
├── clippp.db          # SQLite 数据库(历史记录、代码片段、设置)
├── images\            # 图片文件存储目录
│   └── *.png          # 图片文件(GUID 命名)
└── debug.log          # 调试日志文件

许可证

本项目遵循 MIT 许可证。

About

Clip manager for windows

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages