Class Widgets：让课程管理更高效的桌面组件应用

Class Widgets 是一款专为学生和教师设计的桌面组件应用，它将课程表管理与实时信息展示完美结合，通过直观的界面和灵活的配置，帮助用户轻松掌握每日学习安排。无论是课程时间提醒、天气状况显示，还是自定义倒计时功能，Class Widgets 都能满足你对学习管理的多样化需求。

核心功能概览

Class Widgets 提供了五大核心功能模块，从课程管理到个性化设置，全方位提升你的学习效率：

课程表管理系统

📌 解决问题：传统纸质课程表无法实时更新，电子表格缺乏提醒功能。
带来价值：自动同步课程信息，实时显示当前和即将进行的课程，让你不再错过任何课堂。

实时天气集成

📌 解决问题：天气变化影响出行安排，但频繁切换应用查看天气效率低下。
带来价值：在桌面组件中直接显示当前城市天气和温度，帮助你提前做好出行准备。

自定义倒计时工具

📌 解决问题：重要考试、截止日期容易遗忘，缺乏直观的视觉提醒。
带来价值：支持设置自定义事件倒计时，如高考、作业截止日等，通过进度条直观展示剩余时间。

多主题界面切换

📌 解决问题：单一界面风格无法满足不同用户的审美需求。
带来价值：提供多种预设主题（如默认、Hoshino、Shiroko等），支持亮色/暗色模式切换，适应不同使用场景。

插件扩展系统

📌 解决问题：固定功能无法满足个性化需求。
带来价值：通过插件广场获取更多功能扩展，如语音提醒、自定义皮肤等，打造专属学习助手。

快速上手流程

1. 环境准备

确保你的系统已安装 Python 3.8 或更高版本。通过以下命令克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/cl/Class-Widgets
cd Class-Widgets

2. 依赖安装

项目使用 uv 进行依赖管理，执行以下命令安装所需依赖：

uv sync

3. 启动应用

在项目根目录下执行主程序：

python main.py

首次启动时，应用会自动创建默认配置文件并打开设置界面，你可以在此完成初始课程表设置。

4. 基本操作

• 添加课程：点击主界面"编辑课程表"按钮，填写课程名称、时间、地点等信息
• 切换主题：在设置界面的"外观"选项卡中选择喜欢的主题
• 设置倒计时：在"倒计时"面板中点击"+"号添加新的倒计时事件
• 查看天气：确保网络连接正常，天气信息会自动更新显示

深度配置指南

配置文件详解

应用的核心配置文件为 data/default_config.json，通过修改此文件可以实现精细的功能调整。以下是关键配置项的说明：

配置项	默认值	推荐配置	功能说明
ui.theme	"default"	"hoshino"	界面主题选择，支持default/hoshino/shiroko/minimize
notifications.enable	true	true	是否启用课程提醒通知
notifications.volume	50	70	提醒音量（0-100）
weather.auto_location	false	true	是否自动获取地理位置
countdown.show_in_taskbar	false	true	是否在任务栏显示倒计时进度

典型应用场景

场景一：高考倒计时设置

1. 打开"倒计时"设置面板
2. 点击"添加事件"，输入"高考"作为事件名称
3. 设置目标日期（如2024-06-07）
4. 选择显示样式为"大型进度条"
5. 勾选"置顶显示"选项

效果：桌面顶部会显示高考倒计时进度条，每天自动更新剩余天数。

场景二：课程提醒个性化

1. 进入"声音设置"界面
2. 为不同课程类型设置专属提示音（如数学选择"prepare_class.wav"）
3. 调整提前提醒时间为5分钟
4. 启用"课前震动"功能

效果：不同课程开始前5分钟，系统会播放对应提示音并震动提醒。

常见问题解决

问题一：天气信息无法更新

可能原因：网络连接问题或API密钥配置错误
解决方法：

1. 检查网络连接状态
2. 打开 data/weather_api.json 文件
3. 确认已正确配置至少一个天气API服务
4. 尝试切换不同的天气数据源（如从高德切换到小米天气）

问题二：课程表数据丢失

可能原因：配置文件损坏或误删除
解决方法：

1. 关闭应用程序
2. 复制 data/default_schedule.json 到 data/schedule.json
3. 重新启动应用，使用默认课程表重新配置

问题三：界面显示异常

可能原因：主题文件损坏或分辨率不匹配
解决方法：

1. 删除 ui/ 目录下的对应主题文件夹
2. 重新启动应用，系统会自动使用默认主题
3. 在设置中调整界面缩放比例适应屏幕

通过以上配置和优化，Class Widgets 将成为你学习生活中不可或缺的助手。无论是日常课程管理还是重要事件提醒，它都能以简洁高效的方式帮你轻松应对。开始使用 Class Widgets，让学习规划变得更加简单直观！