# 智能快捷待办桌面应用

**Repository Path**: creepzzart/TaskFlow

## Basic Information

- **Project Name**: 智能快捷待办桌面应用
- **Description**: 智能快捷待办桌面应用，基于 Electron + React + TypeScript 构建。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-09
- **Last Updated**: 2026-05-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TaskFlow

智能快捷待办桌面应用，基于 Electron + React + TypeScript 构建。

## 功能特性

- 快速添加任务：全局快捷键 `Ctrl+Shift+A` 呼出快速添加窗口
- 系统托盘常驻：最小化后在后台运行
- 单实例锁定：防止重复启动应用
- 响应式界面：支持窗口缩放和自适应布局

## 技术栈

- **前端框架**: React 18 + TypeScript
- **桌面框架**: Electron 33
- **构建工具**: Vite
- **样式方案**: Tailwind CSS
- **打包工具**: electron-builder

## 开发环境

### 环境要求

- Node.js >= 18
- npm >= 9

### 安装依赖

```bash
npm install
```

### 开发模式

```bash
npm run electron:dev
```

这将启动 Vite 开发服务器和 Electron 应用。

### 构建打包

```bash
npm run electron:build
```

构建完成后，安装包将生成在 `release` 目录下。

## 项目结构

```
TaskFlow/
├── electron/           # Electron 主进程代码
│   ├── main.cjs       # 主进程入口
│   └── preload.cjs    # 预加载脚本
├── src/                # React 前端代码
│   ├── components/    # React 组件
│   ├── hooks/         # 自定义 Hooks
│   ├── lib/           # 工具函数
│   ├── types/         # TypeScript 类型定义
│   ├── App.tsx        # 主应用组件
│   └── main.tsx       # 前端入口
├── public/             # 静态资源
│   ├── icon.png       # 应用图标 (PNG)
│   └── icon.ico       # 应用图标 (ICO)
├── package.json        # 项目配置
├── vite.config.ts      # Vite 配置
├── tailwind.config.ts  # Tailwind CSS 配置
└── tsconfig.json       # TypeScript 配置
```

## 配置说明

### 图标配置

应用图标位于 `public` 目录：
- `icon.png`: PNG 格式，用于 macOS/Linux
- `icon.ico`: ICO 格式，用于 Windows

打包时会自动将图标复制到应用资源目录。

### 单实例锁定

应用默认启用单实例锁定，防止重复启动。尝试启动第二个实例时会自动将焦点切换到已运行的窗口。

## 许可证

MIT