Skip to content
 
 

Repository files navigation

YouBoard - 剪贴板历史管理工具

一款轻量级 Windows 剪贴板管理工具,自动记录复制历史,支持文本、图片、文件、网址四大分类,附带桌面实时小组件,随取随用。

✨ 功能特性

  • 剪贴板监控 — 自动捕获复制内容,Ctrl+C 后实时显示,双重保障(Win32 事件 + 轮询)
  • 全局快捷键 — 默认 Alt+Q 呼出/隐藏窗口,设置中可自定义(支持 alt/ctrl/shift/win + 字母/F键),基于底层键盘钩子,可靠拦截全局按键
  • 快捷键冲突检测 — 录入时自动检测系统保留快捷键(Win+L/E/D/V 等 30+ 组合)及其他应用占用,红色警告提示
  • 四大分类 — 文本 / 图片 / 文件 / 网址,独立 Tab 管理,全新分类图标(res/ 目录)
  • 网址智能识别 — 纯 URL 自动归入网址分类,混合内容双存不丢失
  • 系统托盘 — 原生 QSystemTrayIcon 托盘(自定义 ICO 图标),右键快速操作;Win11 下启动时自动写入注册表提升到可见托盘区,系统识别图标同步为 YouBoard.ico
  • 复制去重 — 应用内复制不产生重复记录
  • 图片预览实时缩放 — 图片跟随预览框大小等比缩放(放大/缩小),拖拽分割条即时响应
  • 历史快照 — 记录删除/清空操作,支持一键回滚,新条目淡入动画
  • 中英双语 — 设置中一键切换语言,检查更新等对话框完整适配
  • 开机自启动 — 设置中开关控制
  • 自动更新 — 设置 → 关于 → 检查更新,软件内多线程分段下载(8线程并行 Range 请求,类似 IDM 原理,跑满带宽),5秒速度检测自动切换最快源,进度条实时显示 MB/百分比,全球多镜像探测,下载完成自动替换重启
  • 快捷键 — Enter 复制、Del 删除、Space 置顶、Ctrl+A 全选、Ctrl+O 打开、F5 刷新
  • 环境灯带 — 全宽 RGB 灯带动效,呼吸流转 + 按键波纹 + 操作浪涌(QPainter 30fps)
  • 自定义背景 — 支持 PNG/JPG/BMP 静态 + GIF 动态背景,面板半透明通透显露
  • 桌面小组件 — 置顶小窗口实时显示当前剪贴板内容与最近 20 条历史(上下滚动),点击条目一键复制;支持拖拽移动与八向自由缩放(四边 + 四角,配套缩放光标反馈),平时半透明、悬停完全清晰,位置与尺寸自动记忆,设置中可开关
  • 暗色/亮色主题 — 一键切换,毛玻璃半透明面板,设置更改后窗口状态保持;主题按钮使用自定义图标(res/anse.ico、res/liangse.ico)
  • 精简包体 — 便携版 EXE 约 28MB(≤30MB),不捆绑多媒体运行库,中英文完整适配
  • 自定义标题栏 — 无边框窗口 + 自绘标题栏,流光动效,拖拽移动,双击最大化,图标按钮(res/ 目录 ICO),边缘拖拽缩放(四边光标反馈 + 右下角 grip)
  • 背景实时跟随 — 自定义背景图随窗口缩放实时等比重绘(30ms 响应)

🎬 效果演示

📥 下载安装

安装版(推荐)

下载 YouBoard_Setup_v2.2.0.exe,双击安装,自动创建快捷方式和卸载程序。 覆盖安装时自动保留所有用户数据(剪贴板历史、配置、背景图、快捷键设置)。

便携版

下载 YouBoard.exe,放到任意目录双击即可运行,无需安装。

👉 前往 Releases 下载

🖥️ 系统要求

  • Windows 10 / 11(64 位)
  • 无需额外运行环境(EXE 已打包所有依赖)

🛠️ 开发者指南

环境准备

pip install PyQt6 pillow pyperclip keyboard pyinstaller

本地运行

python youboard_qt.py

打包 EXE

pyinstaller --noconsole --onefile --name YouBoard --icon=YouBoard.ico --add-data "YouBoard.ico;." --add-data "res;res" --version-file=version_info.txt --hidden-import=PyQt6 --hidden-import=PyQt6.QtWidgets --hidden-import=PyQt6.QtCore --hidden-import=PyQt6.QtGui --hidden-import=keyboard youboard_qt.py

或直接双击 YouBoard.bat 一键打包。

生成安装包

安装 Inno Setup 7 后,打开 youboard_setup.iss 编译即可。

输出:YouBoard_Setup_v2.2.0.exe

📁 项目结构

YouBoard/
├── youboard_qt.py       # 主程序(PyQt6 GUI 界面)
├── youboard_core.py     # 核心逻辑(监控、存储、Win32 API)
├── YouBoard.ico         # 应用图标
├── res/                 # 标题栏按钮图标 + 播放控制图标
│   ├── zuixiao.ico      # 最小化
│   ├── zuida.ico        # 最大化
│   ├── zuidahuifu.ico   # 恢复
│   ├── guanbi.ico       # 关闭
│   ├── shezhi.ico       # 设置按钮
│   ├── wenben.ico       # 分类:文本
│   ├── tupian.ico       # 分类:图片
│   ├── wenjian.ico      # 分类:文件
│   ├── wangzhi.ico      # 分类:网址
│   ├── sousuo.ico       # 搜索框图标
│   ├── anse.ico         # 主题按钮:暗色
│   └── liangse.ico      # 主题按钮:亮色
├── version_info.txt     # EXE 版本信息(v2.2.0)
├── YouBoard.bat         # 一键打包脚本
├── YouBoard.spec        # PyInstaller 配置
├── youboard_setup.iss   # Inno Setup 安装脚本(v2.2.0)
├── youboard_config.json # 用户配置(自动生成)
└── .youboard.json       # 剪贴板历史数据(自动生成)

📜 更新日志

YouBoard v2.2.0

  • 📦 压缩包内复制内容记录修复
    • 修复从压缩包(7z / rar / zip / tar / gz / bz2 / lzma / xz)内直接复制文件时无响应、不归入「文件」分类的问题
    • 新增 FileGroupDescriptor 虚拟文件物化引擎,兼容多种描述符布局(7-Zip / WinRAR / 资源管理器压缩文件夹),复制的压缩包内容自动提取落盘并记录到剪贴板历史
  • 🧩 桌面实时小组件
    • 置顶小窗口实时显示当前剪贴板内容与最近 20 条历史记录(上下滚动),点击条目一键复制回剪贴板
    • 支持拖拽移动、拖动右下角自由缩放,位置与尺寸自动记忆;设置中可随时开关
  • ✂️ 全面精简瘦身
    • 移除音乐播放器与视频动态背景功能,不再捆绑多媒体运行库,安装包大幅减小
    • 修复 Win11 无边框窗口左上角圆角缝隙;「文字」分类统一更名为「文本」并启用全新分类图标
  • 内存与性能优化
    • 图片库(PIL)按需加载、4K 背景图只保留窗口尺寸缩放副本、历史快照懒加载
    • 窗口隐藏/最小化时暂停全部动画并释放工作集,后台常驻内存大幅降低
  • 🖱️ 小组件缩放增强
    • 桌面小组件支持八向缩放(左/右/上/下四边 + 四个角),各热区配套对应缩放光标,松手即恢复普通光标
    • 宽度上限放宽至 1200px,平时半透明、悬停完全清晰
  • 🧲 托盘图标自动提升
    • Win11 默认把新托盘图标藏进溢出区,现启动时自动写注册表(isPromoted)提升到可见托盘区
    • 同步刷新系统识别的快照图标,任何安装路径首次运行后均自动生效
  • 🎨 图标焕新
    • 搜索框启用自定义搜索图标(res/sousuo.ico),主题暗/亮按钮启用自定义图标(res/anse.ico、res/liangse.ico)

YouBoard v2.1.0

  • 🔧 更新重启修复
    • 修复自动更新后弹出 "Failed to load Python DLL" 错误弹窗的问题
    • 更新脚本增加文件锁重试、临时目录清理和启动缓冲,确保新旧进程平稳交接
    • 更新只替换 EXE,所有用户数据(历史、配置、播放列表、背景)完整保留
  • 🌍 全球下载速度优化
    • 新增速度检测机制:下载 5 秒后评估实际速度,低于 200KB/s 自动切换下一个镜像源
    • 海外用户走 GitHub 直连 CDN + 8 线程分段,跑满带宽不受镜像影响
    • 国内用户 GitHub 慢时秒切加速镜像,不再傻等超时
    • 每个源都先探测 Range 支持,支持就 8 线程并行,不支持就单流,太慢就切
  • 🛡️ 检查更新友好提示
    • GitHub 403 限流 → "请求过于频繁,请稍后再试"(中英双语)
    • 网络断开/超时 → "无法连接到更新服务器,请检查网络后重试"(中英双语)
    • 不再显示原始英文报错
  • ⌨️ 全局快捷键稳定性
    • 新增 400ms 防抖:防止快捷键双触发导致窗口弹出后立刻缩回
    • Win32 注册失败时自动反注册重试,避免静默失效

YouBoard v2.0.0

  • 📂 音乐库文件夹
    • 新增「设置音乐库文件夹」功能,指定一个文件夹后自动递归扫描所有子目录中的音频文件
    • 每次启动自动检测音乐库中的新歌并加入播放列表,无需手动添加
    • 随时点击「刷新音乐库」手动检测新增歌曲,只添加没有的,不重复
    • 音乐库路径持久化保存,重启不丢失
  • 多线程分段下载(更新提速)
    • 自动更新下载引擎重写:先探测服务器是否支持 HTTP Range,支持则将文件切成 8 段并行下载
    • 类似 IDM / aria2 原理,多线程同时拉取不同字节区间,跑满你的网络带宽
    • 不支持 Range 的服务器自动降级为单流下载并尝试下一个镜像源
    • 512KB 大缓冲块 + 12s 快速超时,慢源秒切,整体下载速度提升 3-8 倍
  • 🎶 播放列表拖拽排序
    • 播放列表支持鼠标直接拖拽调整歌曲顺序
    • 松手后自动同步播放顺序,当前播放曲目索引跟随更新
    • 排序结果自动保存到配置,重启后保留

YouBoard v1.9.0

  • 🎵 内置音乐播放器
    • 新增独立「音乐」Tab,支持 MP3 / WAV / FLAC / OGG / M4A / AAC / WMA / OPUS / AIFF / APE 等主流格式
    • 播放列表自动保存到配置,重启后保留;支持添加文件 / 添加文件夹 / 移除 / 清空
    • 列表循环 / 单曲循环 / 随机播放三种模式,进度条可拖拽定位,音量独立调节
    • 播放控制按钮使用自定义图标(res/ 目录 shangyige / bofang / xiayige)
  • 🎬 视频动态背景
    • 支持 MP4 / AVI / MKV / MOV / WMV / FLV / WebM 等视频作为界面背景,循环播放并保留原声
    • 采用 QVideoSink 逐帧渲染 + 暗色遮罩,视频之上所有面板内容清晰可见
    • 设置中可单独调节视频音量或一键静音,视频进度可拖拽定位,跨重启 / 改设置后自动恢复到上次进度
  • 🧹 卸载完全清理
    • 卸载时自动删除配置文件、历史数据、图片缓存、图标资源等所有残留,不再遗留任何文件
  • 🌍 自动更新全球可用
    • 下载源首位始终为 GitHub 直连(全球可达),海外用户可直接检查并更新
    • 整理镜像列表,移除失效源,保留可用加速镜像作为国内兜底

YouBoard v1.8.0

  • 🔄 应用内实时自动更新
    • 检查更新后直接在软件内流式下载新版本,实时显示已下载 MB / 总大小 / 百分比进度条
    • 后台线程下载,界面不卡死,支持随时取消
    • 内置多个 GitHub 镜像源自动轮换,直连失败时依次尝试,大幅提升下载成功率
    • 下载完成后自动替换 EXE 并重启,全程无需手动操作

YouBoard v1.7.0

  • 🪟 自定义标题栏增强
    • 窗口控制按钮改用自定义 ICO 图标(res/ 目录),替代文字字符,对齐一致
    • 四边缘 6px 透明拖拽条:左/右 ↔ 光标、上/下 ↕ 光标,拖拽即缩放
    • 右下角 18x18 斜向三点 grip 图标,拖拽对角缩放
    • 背景图随窗口缩放实时等比重绘(30ms 响应,不再滞后)
  • 📦 安装包优化
    • 安装后只保留一个 uninstall.exe(不再有 unins000.exe)
    • 自动更新注册表卸载路径
  • 🎨 UI 细节
    • 设置中背景文件名过长时自动换行,不再撑破布局
    • 检查更新对话框中英双语显示(中文在上英文在下)

YouBoard v1.6.0

  • 剪贴板实时监控增强
    • 双重保障机制:Win32 AddClipboardFormatListener 事件驱动 + GUI 层直接轮询
    • Ctrl+C 后内容立即显示在列表中,不再遗漏
    • 监控线程异常时自动降级为轮询模式,确保永不丢失
  • ⌨️ 全局快捷键(keyboard 库重写)
    • 基于底层键盘钩子(WH_KEYBOARD_LL),可靠拦截全局按键
    • 支持 Win+键组合(如 Win+F8),不再受 Windows Shell 拦截影响
    • 设置中可自定义组合键(支持 alt/ctrl/shift/win + 字母/数字/F1-F12)
    • 录入时自动检测系统保留快捷键及其他应用占用,红色"⚠已占用"警告
    • 修改快捷键后立即生效,无需重启
  • 🖼️ 图片预览实时缩放
    • 图片跟随预览框大小等比缩放(可放大可缩小,比例不变)
    • 基于 QPixmap 缓存 + GPU 加速缩放,拖拽分割条/调整窗口大小时即时响应
  • 🌐 中英文完整适配
    • 检查更新对话框、版本提示等全部支持中英文切换
  • 🪟 窗口状态记忆
    • 设置更改(语言/主题/背景)后窗口位置、大小、最大化状态保持不变
  • 📦 安装包增强
    • 覆盖安装自动保留用户数据(历史、配置、背景图)
    • 安装目录生成 uninstall.exe 卸载程序
    • 安装/卸载图标使用自定义 YouBoard.ico
  • 🎨 UI 打磨
    • 去除所有面板边框和分割线竖条,干净通透
    • 呼吸圆点改为真圆形(border-radius 实现)
    • 历史快照去除黑白交替行,统一圆角卡片风格
    • 面板透明度优化至 ~41%,自定义背景图大面积清晰显露
  • 🔄 自动更新
    • 设置 → 关于 → 检查更新,查询 GitHub Releases 最新版本
    • 自动下载 + 替换 EXE + 重启,全程无需手动操作

v1.5.0

  • 🚀 框架迁移 tkinter → PyQt6,全面重写 UI 层
  • 🎨 环境灯带 QPainter 30fps 渲染 + 窗口淡入动画
  • 🖼️ 自定义背景增强(GIF 动态 + 半透明面板)
  • ⚡ Model/View 架构 + 搜索防抖 + 缩略图异步加载

v1.4.0

  • 🖼️ 自定义背景:设置 → 背景 → 上传自己的图片作为界面壁纸
  • 🎨 全新应用图标 YouBoard.ico
  • 彻底修复首次启动任务栏/托盘显示 Python 羽毛图标的问题

v1.2.0

  • 🌐 新增网址独立分类(第 4 个 Tab)
  • 🔔 新增 pystray 系统托盘(自定义图标)
  • 📋 应用内复制不再产生重复记录

v1.1.0

  • 中英双语支持
  • 开机自启动
  • 剪贴板历史管理(文字/图片/文件)
  • 历史快照与回滚

📄 License

MIT

About

YouBoard-Windows本地剪贴板历史管理器,Python开发,中英双语、开机自启、图片/文本/文件/网址全类型剪贴记录,无云端上传隐私本地存储,深色UI

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages