# workbook

**Repository Path**: rasir/workbook

## Basic Information

- **Project Name**: workbook
- **Description**: 桌面端的工作记录
- **Primary Language**: TypeScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-24
- **Last Updated**: 2026-03-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TaskBook - 任务管理应用

一个简洁高效的任务管理桌面应用，使用 Tauri + React 构建。支持任务创建、分类管理、数据导入导出等功能。

## 功能特性

- ✅ **任务管理**：创建、编辑、删除和完成任务
- ✅ **分类管理**：为任务组织分类，提高工作效率
- ✅ **数据统计**：实时显示任务完成率和统计信息
- ✅ **数据备份**：支持备份和恢复功能
- ✅ **数据导入导出**：支持 JSON 和 CSV 格式的数据导入导出
- ✅ **偏好设置**：保存用户配置和应用设置
- ✅ **主题切换**：支持浅色、暗色和自动主题模式
- ✅ **系统集成**：开机启动、系统通知、声音提醒等系统功能
- ✅ **跨平台支持**：Windows、macOS、Linux 桌面应用

## 技术栈

### 前端
- **React 18** - UI框架
- **TypeScript** - 类型安全
- **Ant Design** - UI组件库
- **Tauri** - 桌面应用框架
- **Rsbuild** - 构建工具

### 后端
- **Rust** - 后端语言
- **Tokio** - 异步运行时
- **SQLx** - 数据库访问
- **SQLite** - 数据存储

## 快速开始

### 环境要求
- Node.js >= 16
- Rust >= 1.70
- npm 或 yarn

### 安装依赖

```bash
npm install
```

### 开发模式

启动开发服务器，应用将在 [http://localhost:5173](http://localhost:5173) 可用：

```bash
npm run dev
```

### 生产构建

构建生产版本：

```bash
npm run build
```

预览生产构建：

```bash
npm run preview
```

### Tauri 特定命令

开发环境运行 Tauri 应用：

```bash
npm run tauri dev
```

构建生产 Tauri 应用：

```bash
npm run tauri build
```

## 项目结构

```
workbook/
├── src/                      # React 前端代码
│   ├── pages/               # 页面组件
│   ├── components/          # 可复用组件
│   ├── hooks/               # React 自定义钩子
│   ├── services/            # API 和服务
│   ├── types/               # TypeScript 类型定义
│   ├── styles/              # 全局样式
│   └── App.tsx              # 应用入口
├── src-tauri/               # Tauri 后端代码
│   └── src/
│       ├── commands/        # Tauri 命令处理器
│       ├── services/        # 业务逻辑服务
│       ├── db/              # 数据库配置
│       ├── models/          # 数据模型
│       ├── error.rs         # 错误处理
│       └── main.rs          # 应用入口
├── src-tauri/tauri.conf.json # Tauri 配置文件
└── package.json             # npm 依赖配置
```

## 数据管理

### 数据导出
支持将任务数据导出为 JSON 或 CSV 格式，可选择是否包含已归档和已完成的任务。

### 数据导入
支持从 JSON 或 CSV 文件导入任务数据，提供三种导入模式：
- **覆盖模式**：清空现有数据，导入新数据
- **合并模式**：保留现有数据，添加新数据（跳过重复）
- **更新模式**：根据 ID 更新现有任务，添加新任务

### 数据备份
一键备份所有任务数据，支持多个备份版本的管理和恢复。

## 应用设置

### 外观设置
- **主题**：浅色、暗色、自动（跟随系统）
- **语言**：中文、English、日本語

### 通知和声音
- **桌面通知**：接收任务提醒的桌面通知
- **声音提醒**：任务事件时播放声音

### 系统设置
- **开机启动**：系统启动时自动启动应用

## API 命令

### 任务命令
- `task_list` - 获取任务列表
- `task_create` - 创建任务
- `task_update` - 更新任务
- `task_delete` - 删除任务
- `task_complete` - 完成任务
- `task_stats` - 获取任务统计

### 数据命令
- `data_export` - 导出数据
- `data_import` - 导入数据（从文件路径）
- `data_import_from_content` - 导入数据（从内容）
- `data_clear` - 清空所有数据

### 系统命令
- `system_toggle_startup` - 切换开机启动
- `system_notify` - 显示系统通知
- `system_play_sound` - 播放声音
- `system_get_config` - 获取系统配置

## 贡献

欢迎提交 Issue 和 Pull Request！

## 许可证

MIT License

## 作者

Rasir - [GitHub](https://github.com/rasir1608) | [Gitee](https://gitee.com/rasir)

## 相关资源

- [Tauri 官方文档](https://tauri.app)
- [React 官方文档](https://react.dev)
- [Rust 官方文档](https://www.rust-lang.org)
- [Ant Design 组件库](https://ant.design)