Class Widgets 高效配置指南：从零基础到个性化定制

Class Widgets 作为一款开源桌面组件工具，通过模块化配置与直观界面，帮助用户高效管理课程安排与桌面信息展示。本文将带你从核心功能认知到深度配置，快速掌握这款工具的使用精髓。

一、项目核心功能：它能为你解决什么问题？

如何让桌面实时显示课程动态？Class Widgets 提供三大核心能力：课程表管理模块（cses_mgr.py）支持自定义课程时间与科目；天气组件（weather.py）整合多源气象数据；插件系统（plugin.py）允许扩展功能。这些模块通过主程序（main.py）协同工作，形成"数据处理-界面渲染-用户交互"的完整闭环。

资源文件按功能分类存储：audio/目录存放课程提醒音效，img/包含主题图片与图标，ui/则提供不同风格的界面模板。这种结构设计让功能扩展与资源替换变得简单。

二、零基础启动：3分钟上手流程

如何快速启动项目？按照以下步骤操作，即可在几分钟内看到效果：

🔧 步骤1：获取项目代码

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

🔧 步骤2：启动应用程序

python main.py  # 常规启动
# 或开启调试模式：python main.py --debug

启动后将看到桌面悬浮组件，显示当前时间、课程信息与天气状态。以下是两种主题效果对比：

三、个性化定制：打造专属桌面组件

如何让组件更符合使用习惯？通过修改配置文件与主题设置，可实现深度定制：

🔧 基础配置（data/default_config.json）

{
  "ui": {
    "theme": "default",  // 默认值：default，可选：hoshino/shiroko/minimize
    "transparency": 0.8   // 默认值：0.8，建议范围0.6-0.9
  },
  "notifications": {
    "enable": true,       // 默认值：true，关闭设为false
    "advance_alert": 5    // 默认值：5分钟，课程前提醒时间
  }
}

💡 修改后需重启应用生效，主题切换会改变组件边框样式与背景透明度。

🔧 高级插件配置 在data/default_config.json中新增plugins字段：

"plugins": {
  "enabled": ["weather", "countdown"],  // 启用的插件列表
  "weather": {
    "api_source": "amap",  // 默认值：amap，可选：open_meteo/qq
    "update_interval": 30  // 默认值：30分钟，建议不低于15分钟
  }
}

💡 插件广场功能（plugin_plaza.py）可获取更多扩展，需确保网络连接正常。

通过以上配置，Class Widgets 将成为你的个性化学习助手，既美观又实用。更多高级技巧可参考项目docs/目录下的使用指南。