# LearningTools

**Repository Path**: calculuswjf/learning-tools

## Basic Information

- **Project Name**: LearningTools
- **Description**: 一款属于学生最佳的自习学习工具
- **Primary Language**: Python
- **License**: LGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-04-01
- **Last Updated**: 2025-12-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### **知域产品文档**

---

#### **1. 产品概述**

知域是一款专为学习和时间管理设计的桌面应用程序，旨在帮助用户高效规划学习时间、专注学习任务，并通过数据统计和分析功能，提供长期学习规划的支持。知域结合了虚拟自习室、番茄钟、记事板、学习日历等多种功能模块，为用户提供一个全面的学习管理解决方案。

#### **2. 核心功能**

##### **2.1 启动与配置**

* **启动方式** ：双击知域的 `.exe` 程序或点击桌面快捷方式即可启动。
* **配置说明** ：如果程序无法打开或功能异常，请在 `C:/ProgramData` 路径下解压 `LearningTools.zip` 压缩包。

##### **2.2 欢迎页**

* 欢迎页包含打卡功能、功能与日程入口，以及侧边工具栏。
* 用户可以通过工具栏快速切换至不同功能模块。
* **注意事项** ：点击标签页右侧的 `X` 符号可关闭当前标签页。

##### **2.3 今日运势**

* 程序启动后会随机显示“今日运势”，仅供娱乐，不作为真实信息参考。

##### **2.4 软件架构**

* 该软件基于Python语言编写，使用基于Qt的Pyside6作为基本GUI框架，最终使用PyInstaller进行exe成品打包
* **该软件必须要在Windows10或更高版本的计算机中运行**
* 该软件主要依赖对于ProgramData文件夹内的数据读写，不强求exe文件的路径，exe单个文件承包了整个项目的所有代码，因此exe本体文件可以随意移动到快捷方式指向的地方
* 该软件不需要额外构建Python开发环境或者Qt等相关库的安装，exe文件内均有集成

#### **3. 功能模块**

##### **3.1 虚拟自习室**

* **功能描述** ：虚拟自习室提供日程表查看、音乐播放器和番茄钟功能。
* **音乐播放器** ：支持基本的音乐播放功能，用户可将 `.mp3` 格式的音乐文件放入音乐文件夹。
* **番茄钟集成** ：在番茄钟运行时，自习室会显示番茄阶段和剩余时间。

##### **3.2 番茄钟**

* **功能描述** ：番茄钟帮助用户专注学习，通过工作时间、休息时间和长休息时间的循环，提升学习效率。
* **设置界面** ：用户可自定义工作时间、休息时间和长休息时间。
* **操作流程** ：

1. 设置番茄周期（工作阶段、休息时间、长休息时间）。
2. 点击“开始番茄计时”启动计时器。
3. 如需中断，可点击“终止番茄”。

##### **3.3 记事板**

* **功能描述** ：记事板用于记录临时笔记和标签，所有内容实时保存至数据库。
* **应用场景** ：适合记录灵感、待办事项或重要信息，方便后续整理和回顾。

##### **3.4 学习日历**

* **功能描述** ：学习日历支持日程记录和长期规划。
* **操作流程** ：

1. 选择特定日期后，点击右侧日程表进行记录。
2. 数据实时保存，用户可随时修改历史日期的日程。

* **应用场景** ：适合记录每日学习计划、任务安排或长期目标。

##### **3.5 学习统计**

* **功能描述** ：统计页面展示月度学习详情，基于打卡日期分析用户的学习行为。
* **应用场景** ：帮助用户了解学习进度，优化学习计划。

##### **3.6 信息与管理**

* **功能描述** ：提供知域的相关信息、开源仓库入口，以及音乐文件夹和数据文件夹的管理入口。
* **注意事项** ：音乐文件夹仅支持 `.mp3` 格式文件。

#### **4. 使用建议**

* **首次使用** ：建议用户熟悉各功能模块的操作流程，并根据个人需求设置番茄钟参数。
* **数据管理** ：定期备份音乐文件夹和数据文件夹，确保学习记录不丢失。
* **个性化设置** ：用户可根据学习习惯调整日程表和番茄钟参数，以达到最佳学习效果。

#### **5. 注意事项**

* **音乐文件格式** ：音乐文件夹仅支持 `.mp3` 格式。
* **数据保存** ：所有记录和设置均实时保存至数据库，无需手动备份。
* **技术支持** ：如遇到问题，可参考开源仓库或联系开发团队。
* **该软件必须要在Windows10或更高版本的计算机中运行**

#### **6. 总结**

知域是一款集学习管理、时间规划和数据分析于一体的应用程序，通过虚拟自习室、番茄钟、记事板和学习日历等功能，帮助用户高效学习和专注任务。无论是短期计划还是长期规划，知域都能为用户提供更多便利和效率。

#### **其他信息：**

该项目使用库：datetime

* os
* random
* subprocess
* time
* **PySide6**
* **PIL**
* **webbrowser**
* **shelve**
* **mutagen**
* **pygame**
* **pycaw**
* **ctypes**
* **comtypes**

(标粗的为来源于pipe的外部库)

#### **版本号：**

v0.1.0 [Beat]