高效管理课程表的桌面组件：Class Widgets 全攻略

Class Widgets 是一款开源课程工具，它将复杂的课程管理转化为直观的桌面小组件，让课程安排一目了然。无论是学生还是教师，都能通过这款轻量级应用实现课程可视化、时间管理和个性化提醒，彻底告别传统纸质课表的诸多不便。

核心价值：为何选择 Class Widgets 管理课程？

1. 轻量化设计，资源占用比浏览器标签还低

Class Widgets 采用 Python 编写，核心代码仅 500KB，启动速度比打开微信还快。与同类软件相比，它不会在后台偷偷占用大量内存，即使低配电脑也能流畅运行。💡 关键在于其模块化架构，主程序入口 仅负责核心调度，各功能模块按需加载。

2. 多主题切换，白天黑夜都有舒适体验

软件内置默认、hoshino、minimize、shiroko 四种主题，每种主题都包含亮色和暗色模式。无论是白天在教室使用，还是夜晚自习，都能自动适配环境光线。📌 主题配置文件位于 ui/主题目录，用户可自定义颜色、字体和布局。

3. 插件广场生态，满足个性化需求

通过插件系统，Class Widgets 能扩展出天气显示、考试倒计时、作息管理等功能。社区已贡献 20+ 实用插件，从学习辅助到生活提醒，一站式满足校园场景需求。

图：Class Widgets 桌面小组件展示，包含当前课程、天气和倒计时功能

零门槛部署流程：3 分钟让课程表跑起来

环境检测：先确认你的电脑是否支持

在终端输入以下命令，检查 Python 环境是否就绪：

# 检查 Python 版本（需 3.8+）
python --version
# 检查 pip 包管理器
pip --version

如果提示 "command not found"，需先安装 Python 官方环境。

安装步骤：四行命令完成部署

# 克隆项目仓库
git clone https://gitcode.com/gh_mirrors/cl/Class-Widgets

# 进入项目目录
cd Class-Widgets

# 安装依赖（国内用户可加 -i https://pypi.tuna.tsinghua.edu.cn/simple）
pip install -r requirements.txt

# 启动程序
python main.py

常见问题排查

• 依赖安装失败：尝试升级 pip pip install --upgrade pip
• 启动闪退：检查是否有中文路径，程序不支持含中文的安装目录
• 界面乱码：安装系统字体 font/HarmonyOS_Sans_SC_Bold.ttf

高频使用场景解析：学生与教师的不同打开方式

学生场景：从早八到晚自习的时间管家

课前提醒：设置预备铃提醒，提前 5 分钟弹窗通知，再也不会睡过头。铃声文件可在 audio/目录 自定义替换。

考试倒计时：在桌面添加高考/四六级倒计时组件，实时显示剩余天数，备考更有紧迫感。配置文件位于 data/default_config.json。

多课表切换：通过 menu/schedule_edit.ui 编辑不同学期课表，一键切换上课模式与假期模式。

图：学生模式下的桌面组件，显示当前课程和接下来的课程安排

教师场景：课堂管理的效率助手

课时计时：上课后自动开始倒计时，剩余 5 分钟时桌面组件变色提醒，把握教学节奏。

自定义课程图标：在 img/subject/ 目录替换学科图标，让课表更具个性化。支持 SVG 格式，可自行设计学校专属图标。

多班级管理：通过插件广场安装 "班级切换" 插件，快速切换不同班级的课程表，适合任课教师使用。

生态扩展指南：从用户到贡献者的进阶之路

插件开发：用 Python 扩展功能

Class Widgets 提供简单的插件开发接口，只需创建两个文件：

1. 插件元数据文件（plugin.json）
2. 功能实现文件（main.py）

示例插件可参考 plugin/目录 中的模板，支持添加新的桌面组件、菜单选项和后台任务。

主题制作：设计你的专属界面

主题由 UI 文件和样式表组成，修改 ui/default/theme.json 可自定义：

• 窗口透明度（0.8-1.0）
• 文字颜色和大小
• 组件布局和边距

制作完成的主题可提交到社区主题库，优秀作品将在插件广场展示。

贡献代码：参与项目改进

1. Fork 项目仓库
2. 创建 feature 分支（git checkout -b feature/amazing-feature）
3. 提交修改（git commit -m 'Add some amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 创建 Pull Request

详细贡献指南见 docs/contributing/ 目录下的文档，包括代码规范和 PR 流程。

图：Class Widgets 功能概览，包含天气显示、课间计时和考试倒计时

Class Widgets 不仅是一款课程管理工具，更是一个活跃的开源社区。无论你是需要高效管理时间的学生，还是追求教学效率的教师，都能在这里找到适合自己的使用方式。立即部署体验，让课程管理变得简单而优雅！