一个 手机桌面风格 的 Windows 启动器，使用 PyQt6 构建。
拖入文件/文件夹/快捷方式即可生成图标，支持自定义 URL 和命令行图标。
A phone‑home‑screen‑style launcher for Windows, built with PyQt6.
Drag files, folders, or shortcuts onto the grid to create icons. Supports custom URL and command icons.
┌──────────────────────────────────────────────┐
│ 文件 帮助 │ ← 菜单栏
├──────────────────────────────────────────────┤
│ [主页] [工作] [工具] │ ← 多行标签栏（缩小时自动换行）
│ │
├──────────────────────────────────────────────┤
│ ┌──────┐ ┌──────┐ ┌──────┐ │
│ │ 📁 │ │ 📄 │ │ 🌐 │ │ ← 48×48 图标网格
│ │ 项目 │ │ 报表 │ │ GitHub│ │
│ └──────┘ └──────┘ └──────┘ │
│ │
├──────────────────────────────────────────────┤
│ 就绪 — 拖入文件或右键空白区域创建图标 │ ← 状态栏
└──────────────────────────────────────────────┘
| 🖱️ 拖放添加 | 从资源管理器拖入文件/文件夹/.lnk 快捷方式即可创建图标 |
| 🔗 自定义图标 | 右键空白区域 → 新建文件/文件夹/快捷方式/网址/命令图标 |
| ✅ 批量管理 | 文件 → 批量管理，勾选图标后批量删除 |
| ✏️ 编辑属性 | 右键 → 编辑属性…，快捷方式支持描述与自定义图标 |
| 🖥️ 打开方式 | 右键 → 用其他应用打开…（Windows 打开方式对话框） |
| 🔍 图标搜索 | Ctrl+F 按名称过滤，Esc 关闭 |
| 📏 图标大小 | 视图 → 图标大小（小/中/大），偏好持久化 |
| 📱 手机网格布局 | 图标自动排列，窗口缩放时自动调整列数 |
| 图标可在标签页内拖动排序，也可跨标签页移动 | |
| 🏷️ 多行标签栏 | 窗口缩小时标签页自动换行，双击/F2 重命名，←→ 切换 |
| 🌐 中英双语 | 文件 → 语言 切换，偏好自动保存 |
| 📦 导入导出 | ZIP 压缩包备份/恢复，含版本信息和进度条 |
| ⌨️ 快捷键 | 15+ 快捷键覆盖所有功能，Ctrl+B/Ctrl+F/Shift+Del 等 |
| 💾 自动保存 | 所有操作即时写入 data/tabs.json，支持启动恢复 |
| 🎨 Win11 风格 | 圆角、浅色主题、Fluent Design 风格 |
| 🖱️ Drag & drop | Drop files, folders, or .lnk shortcuts from Explorer to create icons |
| 🔗 Custom icons | Right-click empty area → New File/Folder/Shortcut/URL/Command icon |
| ✅ Batch manage | File → Batch Manage, check icons to bulk delete |
| ✏️ Edit properties | Right-click → Edit…; shortcuts support description & custom icon |
| 🖥️ Open With | Right-click → Open With… (Windows dialog) |
| 🔍 Search icons | Ctrl+F filters by name, Esc closes |
| 📏 Icon size | View → Icon Size (small/medium/large), preference saved |
| 📱 Phone‑grid layout | Auto‑flow grid, columns adjust on window resize |
| Rearrange icons within a tab; drag to another tab to move | |
| 🏷️ Multi-row tabs | Tabs wrap on narrow windows; double-click/F2 to rename; arrows to switch |
| 🌐 Bilingual | File → Language, preference auto‑saved |
| 📦 Backup | ZIP export/import with metadata and progress bar |
| ⌨️ Shortcuts | 15+ keyboard shortcuts: Ctrl+B, Ctrl+F, Shift+Del, and more |
| 💾 Auto‑save | Instant persistence to data/tabs.json; survives restart |
| 🎨 Win11 themed | Rounded corners, light theme, Fluent Design aesthetic |
# 克隆项目
git clone <repo-url>
cd ToolboxPanel
# 安装依赖 (仅两个)
pip install -r requirements.txt- Python ≥ 3.10
- PyQt6 ≥ 6.5 — GUI 框架
- pywin32 ≥ 305 — Windows .lnk 快捷方式解析
python run.py首次运行会自动创建 data/ 文件夹并初始化配置。
将工具箱打包为独立文件夹，无需安装 Python 即可运行。
# 安装 PyInstaller（一次性）
pip install pyinstaller
# 编译
python build.py
# 清理编译产物
python build.py clean编译完成后，dist/Toolbox/ 文件夹可复制到任意 Windows 电脑直接运行：
dist/Toolbox/
├── Toolbox.exe ← 双击启动
└── _internal/ ← 运行时依赖（勿手动修改）
目录打包（
--onedir）比单文件（--onefile）更可靠，启动更快，也是 PyInstaller 推荐的分发方式。
ToolboxPanel/
├── run.py # 开发入口 · Dev entry point
├── launcher.py # 打包入口 · Build entry point
├── build.py # 编译脚本 · Build script
├── requirements.txt # 依赖 · Dependencies
├── README.md # 本文件 · This file
├── data/ # 运行时数据 (自动创建 · auto‑created)
│ ├── tabs.json # 标签页 & 图标状态
│ ├── config.json # 用户配置（语言偏好等）
│ └── icons/ # 图标 PNG 缓存
└── src/toolbox/
├── main.py # QApplication + Win11 样式
├── app_window.py # QMainWindow 主窗口
├── tab_widget.py # QStackedWidget + WrapTabBar — 标签页管理
├── wrap_tab_bar.py # 自定义多行标签栏
├── i18n.py # 中英双语翻译模块
├── shortcut_dialog.py # 快捷键参考对话框
├── progress_dialog.py # 进度条 + 日志对话框
├── icon_grid.py # QScrollArea + DropContainer — 图标网格
├── icon_widget.py # 单个图标组件 (图标 + 标签 + 复选框)
├── icon_label.py # 可编辑标签 (双击改名/连字符/省略号)
├── flow_layout.py # 自定义 QLayout — 手机网格 + 可变宽度
├── models/
│ ├── data_store.py # JSON 持久化
│ ├── tab_model.py # 标签页数据模型
│ └── icon_model.py # 图标数据模型 + IconType 枚举
├── services/
│ ├── backup_manager.py # ZIP 导入/导出 + 后台线程 + 元数据
│ ├── icon_resolver.py # 系统图标提取 & 缓存 & .lnk 解析
│ └── launcher.py # 打开文件/URL/运行命令/快捷方式
└── utils/
└── windows_shortcut.py # pywin32 WScript.Shell .lnk 解析
data/tabs.json 使用 sort_order 而非像素坐标存储图标位置，窗口缩放不会影响布局。
Icons use sort_order (not pixel coordinates) so resizing the window never breaks the layout.
{
"version": 1,
"tabs": [
{
"id": "uuid",
"name": "主页",
"order": 0,
"icons": [
{
"id": "uuid",
"type": "file | folder | shortcut | url | command",
"display_name": "我的文件",
"source_path": "C:\\Users\\...\\file.docx",
"target_path": "C:\\Users\\...\\file.docx",
"arguments": "",
"working_dir": "",
"icon_cache_file": "uuid.png",
"sort_order": 0
}
]
}
]
}新增
- 单实例运行：同一时间只允许一个实例，重复启动时自动拉取已有实例的窗口（防止数据文件被多个实例互相覆盖）
其他
- 代码清理：移除未使用的导入与局部变量
新增
- 列表式标签页行右键新增「编辑属性…」（修改说明与路径）和「重命名」（内联改名）
修复
- 修复列表式标签页拖拽时幽灵窗口位置偏左/漂移的问题（高分屏 DPI 错位 + 抓取点修正）
修复
- 修复列表式标签页拖拽排序失效的问题（拖拽后行消失、顺序不保存）——改为完全自定义拖拽实现
- 修复列表式标签页拖拽时程序闪退的问题（缺失导入）
新增
- 列表式标签页支持左键上下拖拽调整行顺序（带插入指示线），顺序自动保存
修复
- 修复列表标签页添加新项后重启应用该项出现两次的问题（数据重复写入）
- 修复「文件 → 重置数据」必然崩溃的问题（未定义变量）
- 修复编辑快捷方式图标并设置自定义图标时的崩溃（缺失 import）
- 修复列表标签页重命名不保存的问题（重启后名称还原）
- 修复语言切换时列表标签页名称不刷新的问题
- 版本号收敛为单一来源（
__version__），关于对话框 / 导出元数据 / 编译横幅自动跟随
新增
- 列表式标签页（全新标签页类型）：文件 → 新建列表标签页 (Ctrl+Shift+T) 或标签页右键菜单
- 两列列表：说明 + 文件/文件夹地址，列分割线可拖拽调整
- 第一列双击内联编辑，悬停显示完整文本
- 第二列单击直接打开，双击弹出文件/文件夹选择对话框
- 右键单元格删除（带确认），Delete 键删除选中行
- 空白处右键新建列表项（描述 + 路径选择）
- 数据格式：TabModel 新增 tab_type 与 list_items 字段
兼容性
- 完全兼容旧版导出数据（旧 JSON 自动按图标网格类型加载）
- 新导出数据包含列表标签页，不要求旧版本兼容
新增
- 图标编辑功能：右键图标 → 编辑属性…，按类型显示字段（名称/路径/参数/URL/命令）
- 快捷方式设置界面优化：新增描述字段 + 自定义图标（文件选择 + 索引 0-999 + 使用默认重置）
- 用其他应用打开（右键 → 用其他应用打开…），调出 Windows「打开方式」对话框
- 图标搜索：Ctrl+F / 视图 → 查找，按名称实时过滤，Esc 关闭
- 图标大小切换：视图 → 图标大小（小 32 / 中 48 / 大 64），偏好持久化
- 新建快捷方式图标（右键空白区域 → 新建快捷方式图标…）
- 批量管理复选框高对比度样式
修复
- 修复 IconGrid.setStyleSheet 过早调用导致的 Qt 6 原生崩溃（移至 init 末尾）
- 修复 IconEditDialog 未使用导入（QStackedWidget/QMessageBox/Qt）
- 修复图标选择行重复添加（addRow 冗余调用）
- 修复图标重提取逻辑混乱（自定义图标优先 → 路径变化回退重提取）
- 新增 IconModel.description 字段持久化快捷方式描述
- 新增 IconResolver.extract_icon_from_file()（ExtractIconEx 按索引提取，失败回退默认图标）
- 清理临时调试文件
新增
- 全局快捷键系统：Ctrl+B 批量管理、Ctrl+W/R 标签操作、Ctrl+Shift+* 创建图标
- 快捷键参考对话框（帮助 -> 快捷键参考），中英双语表格
- ZIP 压缩包导入/导出：含 metadata（版本/时间/统计）+ 进度条 + 实时日志
- 导出文件名含时间戳 + 随机码，永不覆盖
- 重置数据功能（Ctrl+Shift+R）
- 所有菜单项标注快捷键
修复
- 清理冗余代码，删除 context_menu.py、drag_data.py 等未使用文件
- 清理 10+ 处未使用导入和死信号
- README 全面更新
新增
- 批量管理模式：文件 -> 批量管理，图标右上角复选框，勾选后批量删除
- 多行标签栏：窗口缩小时标签页自动换行，不再隐藏
- 标签页按钮宽度根据名称自适应
- 双击标签页名称弹出重命名对话框
- F2 快捷键重命名当前标签页
- 左右方向键切换标签页
- 新建标签页时弹出名称输入对话框
- 编译脚本 build.py + launcher.py 打包入口
修复
- 修复快捷方式打开报错 WinError 5 — 改用 os.startfile(.lnk)
- 修复 QInputDialog.getText 按钮中英文不一致
- 修复新建标签页对话框取消后仍创建
- 删除冗余文件 context_menu.py, drag_data.py
- 清理未使用的信号和导入
新增
- 左键单击图标选中（蓝色边框）
- Ctrl+单击多选
- F2 重命名选中图标
- Delete 批量删除选中图标
- 中英文双语切换，偏好保存到 data/config.json
- 关于对话框显示版本号、作者、项目地址
修复
- 图标网格对齐 — AlignTop + stretch
- 文字裁切 — 加宽组件 + 减少内边距
- 长英文单词断词 — 连字符 hyphenation
- QScrollArea 拖放事件拦截 — 自定义 DropContainer
- FlowLayout 未纳入父容器 — 使用 addWidget
- 菜单栏颜色对比度 — 深色底 + 白色文字
变更
- 图标文字自动换行，超过三行省略
- Win11 Fluent Design 风格
- 图标文字白色 + 半透明暗色圆角底
- 图标悬停高亮效果
- 初始版本，核心功能完整
MIT