# task_helper

**Repository Path**: lancezhang1994/task_helper

## Basic Information

- **Project Name**: task_helper
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Task Priority Helper

Task Priority Helper is a simple and easy-to-use task priority management tool that helps you organize and sort tasks based on their importance and time priority.

## Features

### 1. Task Management
- Add up to 9 tasks
- Set importance priority (1-3) for each task
- Set time priority (1-3) for each task
- Add optional task descriptions

### 2. Sorting Functionality
- Sort tasks based on total score (importance + time priority)
- When scores are equal, choose between importance-first or time-first sorting
- When priorities are equal, sort by task addition order

### 3. Display Modes
- **List Mode**: Display tasks in a list format, click on tasks to show/hide descriptions
- **Grid Mode**: Display tasks in a 3x3 grid, arranged from top-left (most important) to bottom-right (least important), click on tasks to show/hide descriptions

### 4. Data Management
- **Save Tasks**: Save tasks to a text file, choose save location
- **Import Tasks**: Import tasks from a text file
- **Clear Tasks**: Clear all tasks with one click

## Usage

### Adding Tasks
1. Click the "Add Task" button
2. Enter task content in the input field
3. Select importance and time priorities
4. Click the "Edit" button to add a task description

### Sorting Tasks
1. Select the "When priorities are equal" option (Importance first or Time first)
2. Select the "Display mode" option (List or Grid)
3. Click the "Sort Tasks" button to view sorted results

### Saving Tasks
1. Click the "Save Tasks" button
2. Select save location and file name in the file save dialog
3. Click the "Save" button

### Importing Tasks
1. Click the "Import Tasks" button
2. Select a text file containing tasks
3. Click the "Open" button

### Clearing Tasks
1. Click the "Clear All Tasks" button
2. Click "OK" in the confirmation dialog

## File Format

Tasks are saved as text files with the following format:

```
Task content,Importance priority,Time priority,Task description
```

Example:
```
Buy groceries,3,2,Need milk and eggs
Finish report,2,3,Due tomorrow
```

## Priority Explanation

- **Importance Priority**: 1 (Low) - 3 (High)
- **Time Priority**: 1 (Low) - 3 (High)
- **Total Score**: Importance + Time priority (Range: 2-6)

## Grid Layout

In grid mode, tasks are arranged by priority from highest to lowest:
- Top-left: Priority 9 (Most important)
- Top-right: Priority 7
- Middle row left: Priority 6
- Middle row center: Priority 5
- Middle row right: Priority 4
- Bottom-left: Priority 3
- Bottom-right: Priority 1 (Least important)

## Color Coding

- **Light Red**: Most important task (First task)
- **Light Yellow**: Second most important task (Second task)
- **Light Green**: Other tasks

## Browser Compatibility

- Recommended: Modern browsers (Chrome, Edge, Firefox)
- For browsers that don't support File System Access API, save functionality will fall back to traditional download

## Notes

- Maximum 9 tasks allowed
- Task descriptions are optional
- Saved files can be shared and imported across different devices
- Unsaved tasks will be lost when refreshing the page, please save in time

## Version Information

- Version: 1.0.0
- Last updated: 2026-03-07