# todoList

**Repository Path**: wongvio/todo-list

## Basic Information

- **Project Name**: todoList
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 2
- **Created**: 2025-05-29
- **Last Updated**: 2025-06-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 📝 专注清单 (Focus Todo)

一个基于 Electron 的现代化待办事项管理应用，集成番茄钟功能，帮助你提高工作效率和专注力。

本项目由 [ynaa.net](https://ynaa.net) 创建并免费开源，欢迎大家参与贡献和反馈。

## 📸 界面预览

![专注清单界面预览](https://gitee.com/wongvio/todo-list/raw/master/build/01.png)

<details>
<summary>点击展开更多预览图</summary>

### 📋 任务管理界面
![任务管理界面](https://gitee.com/wongvio/todo-list/raw/master/build/02.png)

### 🎵 白噪音界面
![番茄钟界面](https://gitee.com/wongvio/todo-list/raw/master/build/03.png)

### 👤 登录界面（注册用户就可以免费使用，支持windows和mac同步）
![白噪音界面](https://gitee.com/wongvio/todo-list/raw/master/build/04.png)

### 🔄 任务关联番茄钟
![设置界面](https://gitee.com/wongvio/todo-list/raw/master/build/05.png)

</details>

## ✨ 功能特性

### 📋 任务管理
- **智能分类**：今天、明天、本周、已计划等多种视图
- **任务优先级**：支持设置任务优先级
- **番茄钟集成**：为每个任务设置番茄钟数量
- **进度跟踪**：实时显示任务完成状态
- **快速添加**：简洁的任务添加界面

### ⏰ 番茄钟功能
- **专注计时**：25分钟专注时间（可自定义）
- **休息提醒**：短休息（5分钟）和长休息（15分钟）
- **可视化计时器**：直观的倒计时显示
- **任务关联**：番茄钟与具体任务绑定

### 🎵 白噪音功能
- **多种环境音效**：提供7种不同的专注背景音
  - 🌧️ **雨声** - 舒缓的雨水声，营造宁静氛围
  - ☕ **咖啡厅** - 温馨的咖啡厅环境音
  - 🏙️ **城市声** - 轻柔的城市背景音
  - 🔥 **火焰声** - 温暖的壁炉火焰声
  - 🌧️ **雨中小镇** - 小镇雨声配鸟鸣
  - 🚗 **交通声** - 轻柔的道路交通音
  - 🌊 **海浪声** - 舒缓的海浪拍岸声
- **音量控制**：每种音效独立音量调节
- **循环播放**：支持无缝循环播放
- **状态记忆**：自动保存播放状态和音量设置
- **后台播放**：应用在后台时继续播放
- **智能管理**：应用退出时自动清理音频资源

### 🎨 用户界面
- **现代化设计**：简洁美观的用户界面
- **自定义标题栏**：无边框窗口设计
- **响应式布局**：适配不同屏幕尺寸
- **图标支持**：Font Awesome 图标库

## 🛠️ 技术栈

- **框架**: Electron 27.0.0
- **前端**: HTML5 + CSS3 + JavaScript (ES6+)
- **数据存储**: electron-store
- **图标**: Font Awesome 6.0.0
- **构建工具**: electron-builder

## 📦 安装与运行

### 环境要求
- Node.js 16.0.0 或更高版本
- npm 或 yarn 包管理器

### 安装依赖
```bash
npm install
```
### 开发模式运行
```bash
npm run dev
```

### 生产模式运行
```bash
npm start
```

### 构建应用
```bash
npm run build
```

## 📁 项目结构
TodoList/

├── index.html          # 主页面

├── main.js            # Electron 主进程

├── package.json       # 项目配置

├── js/

│   └── app.js         # 应用逻辑

└── styles/

│   └── main.css       # 样式文件

## 🎯 使用指南

### 添加任务
1. 在底部输入框中输入任务内容
2. 选择番茄钟数量（1-8个）
3. 点击添加按钮或按回车键

### 管理任务
- **完成任务**：点击任务前的复选框
- **删除任务**：点击任务右侧的删除按钮
- **查看分类**：点击左侧导航栏切换不同视图

### 使用番茄钟
1. 选择要专注的任务
2. 点击开始按钮启动计时器
3. 专注工作25分钟
4. 休息5分钟后继续下一个番茄钟

### 使用白噪音
1. **开启音效**：点击白噪音面板中的音效按钮开始播放
2. **调节音量**：使用音量滑块调节每种音效的音量大小
3. **混合播放**：可以同时播放多种音效，创造个性化的专注环境
4. **一键静音**：点击"停止所有"按钮快速关闭所有音效
5. **自动恢复**：重新打开应用时会记住上次的播放设置

> 💡 **专注小贴士**：建议在番茄钟专注时段开启白噪音，可以有效屏蔽外界干扰，提高专注效果。不同的音效适合不同的工作场景，可以根据个人喜好和当前任务类型选择合适的背景音。

## ⚙️ 配置选项
应用支持以下自定义配置：

- 番茄钟时长（默认25分钟）
- 短休息时长（默认5分钟）
- 长休息时长（默认15分钟）
配置数据通过 electron-store 自动保存到本地。

## 🤝 贡献指南
欢迎提交 Issue 和 Pull Request 来改进这个项目！

### 开发流程
1. Fork 本仓库
2. 创建功能分支 ( git checkout -b feature/AmazingFeature )
3. 提交更改 ( git commit -m 'Add some AmazingFeature' )
4. 推送到分支 ( git push origin feature/AmazingFeature )
5. 创建 Pull Request
## 📄 许可证
本项目采用 AGPL-3.0 许可证 - 查看 LICENSE 文件了解详情。

### ⚠️ 重要提示
- 本软件采用 **GNU Affero General Public License v3.0 (AGPL-3.0)** 开源许可证
- 如果您修改了本软件并通过网络提供服务，必须公开您的修改源代码
- 任何基于本软件的衍生作品也必须采用相同的 AGPL-3.0 许可证
- 商业使用需要遵守 AGPL-3.0 的相关条款
- 详细条款请参阅项目根目录下的 LICENSE 文件

### 🌟 关于 ynaa.net
**ynaa** 代表 "**Y**our **N**ext **A**wesome **A**pplication"，致力于为用户提供优质的开源应用程序。

- 🌐 官网：[ynaa.net](https://ynaa.net)
- 💬 欢迎注册并加入我们的社区进行技术交流
- 🚀 探索更多优秀的开源项目
- 📧 如有问题或建议，欢迎通过官网联系我们
## 🙏 致谢
- Electron - 跨平台桌面应用框架
- Font Awesome - 图标库
- electron-store - 数据据持久化
专注清单 - 让每一分钟都更有价值 ⏰✨