一个 Windows 桌面参考图浮窗工具(类似 PureRef 的轻量实现)——把参考图片钉在一个无边框、可置顶、可穿透的悬浮画板上,适合绘画、建模、设计时对照参考。
基于 Python + PySide6,单文件入口,无后端依赖。
- 多图包管理:图片按「图包」分组,侧边抽屉新建 / 重命名 / 删除 / 切换,布局独立保存
- 多种导入方式:工具栏按钮、拖拽文件 / 文件夹入画布、Ctrl+V 粘贴剪贴板图片、全局快捷键截屏收集
- 画布操作:移动 / 缩放 / 旋转图片卡片;画布平移、缩放;选中框实时变换
- 图片工具:左旋 / 右旋 15°、水平翻转、灰度、置顶 / 置底层级、左对齐、顶对齐、横向等距、自动网格、适应全部
- 浮窗特性:无边框窗口、边缘拖拽缩放、窗口置顶、贴边自动收起
- 鼠标穿透:开启后窗口只显示不拦截鼠标,可边画边对照(系统级 WS_EX_TRANSPARENT 实现)
- 主题:深色 / 浅色 / 跟随系统,即时切换
- 全局快捷键:任意应用内可用
- 系统托盘:显示隐藏、穿透开关、切换图包、设置、退出
要求:Windows 10/11,Python 3.10+
pip install -r requirements.txt
python main.py或用 pythonw.exe 启动可避免控制台窗口。
| 快捷键 | 功能 |
|---|---|
| Ctrl+Shift+H | 显示 / 隐藏窗口 |
| Ctrl+Shift+T | 鼠标穿透开关 |
| Ctrl+Tab | 切换到下一个图包 |
| Ctrl+Shift+C | 截屏收集到当前图包 |
| Ctrl+V | 粘贴剪贴板图片 |
| Ctrl+B | 图包抽屉开关 |
| Delete | 删除选中图片 |
快捷键可在「托盘右键 → 设置」中修改。
图包布局与设置保存在 %APPDATA%\RefBoard\ 下的 packs.json / settings.json,图片文件本身不被复制(引用原始路径;截屏收集的截图除外)。
- GUI:PySide6(QGraphicsView 画布 + QPainter 程序化绘制的线性图标,无图标资源文件)
- 鼠标穿透:Win32
SetWindowLongPtr(WS_EX_TRANSPARENT | WS_EX_LAYERED) - 全局热键:Win32
RegisterHotKey(ctypes) - 单实例:QLocalServer / 本地锁
