快捷方式管理器（Shortcut Organizer）—— 一款高颜值、高效率的桌面快捷方式管理工具

基于 Electron + React + TypeScript 打造，支持拖拽添加、分类管理、深浅色主题与系统托盘，让你的常用应用与文件触手可及。

---

一、为什么需要它？

桌面图标太多太乱？常用软件、脚本、文档散落各处？每次都要在开始菜单或资源管理器里翻找？

快捷方式管理器 帮你把本地应用、文件、脚本等快捷方式集中在一个窗口里，按分类整理，支持自定义图标与颜色、搜索、拖拽添加，还能最小化到系统托盘，随时一键启动。数据本地持久化，换主题、关掉重开都不会丢。

---

二、项目简介

本项目是一个跨平台桌面应用（Windows / macOS / Linux），采用现代前端技术栈开发，界面简洁、交互流畅，适合日常办公与开发场景下的快捷方式统一管理。

项目信息	说明
项目名称	Shortcut Organizer（快捷方式管理器）
当前版本	1.0.1
开发技术	Electron + React 18 + TypeScript
UI 样式	TailwindCSS
许可证	MIT

---

三、核心功能一览

• 分组管理：自定义分类，每个分类可设置图标与颜色，一目了然。
• 一键启动：点击快捷方式即可运行对应应用、脚本或打开文件。
• 拖拽添加：将文件、.lnk 快捷方式等直接拖入窗口，自动在当前分类下创建快捷方式。
• 拖拽移动：快捷方式可拖动到其他分类，快速归类。
• 搜索：支持按分类与快捷方式名称搜索，快速定位。
• 主题切换：深色 / 浅色主题，随系统或手动切换。
• 数据持久化：数据本地存储，关闭应用后再打开，配置不丢失。
• 系统托盘：窗口可最小化到托盘，不占任务栏，需要时再唤出。
• 单实例运行：避免重复打开多个窗口，从桌面快捷方式再次打开会直接唤起已有窗口。

---

四、技术栈

类别	技术
桌面壳	Electron（主进程 + 预加载 + 渲染进程）
前端框架	React 18 + TypeScript
构建工具	Vite
样式	TailwindCSS
数据持久化	better-sqlite3 / 简化文件存储
动画与图表	Framer Motion、Recharts
其他	Sonner（消息提示）、uuid、zod 等

---

五、项目结构

├── electron/                # Electron 主进程
│   ├── main.js              # 主进程入口（窗口、托盘、IPC、存储）
│   ├── preload.js           # 预加载脚本，暴露安全 API
│   ├── simpleStorage.js     # 简化文件存储
│   └── database.js          # SQLite 数据库（可选）
├── src/                     # 前端源码
│   ├── components/          # UI 组件
│   ├── contexts/            # React Context（全局状态）
│   ├── hooks/               # 自定义 Hooks
│   ├── lib/                 # 工具与存储适配
│   ├── pages/               # 页面
│   ├── types/               # 类型定义
│   └── main.tsx             # 前端入口
├── index.html               # HTML 模板
├── package.json             # 依赖与脚本
├── electron-builder.json    # 打包配置
└── ...

---

六、安装与运行

环境要求

• 已安装 Node.js（建议 LTS 版本）：https://nodejs.org/

步骤

1. 克隆项目并安装依赖

git clone https://github.com/CarryingFish/Shortcut_Organizer.git
cd Shortcut_Organizer
npm install

2. 开发模式（带热重载）

npm run dev

会同时启动 Vite 开发服务器和 Electron 窗口，修改前端代码可热更新。

3. 构建前端

npm run build

前端会构建到 dist/static。

4. 预览生产版

npm run preview

先构建再以生产模式启动 Electron，可验证打包前效果。

5. 打包分发

npm run dist          # 生成安装包（如 NSIS、portable）
npm run dist:portable # 仅生成便携版
npm run dist:inno    # 打包后再用 Inno Setup 打安装包

---

七、窗口预览

---

八、版本记录摘要

• 1.0.1：拖拽添加快捷方式、单实例运行、统一自定义图标、开发模式自动打开 DevTools 等。

更详细的版本说明见仓库根目录 VERSION.md。

---

九、小结

快捷方式管理器 适合希望把常用应用、文件、脚本集中管理、并喜欢现代桌面应用体验的用户。技术栈主流、结构清晰，也可作为 Electron + React + TypeScript + Vite 的练手或参考项目。

---

源码获取

• GitHub 仓库：https://github.com/CarryingFish/Shortcut_Organizer

欢迎 Star、Fork、提 Issue 或 PR。
如有问题或建议，可在仓库中提交 Issue 反馈。

---