Metadata-Version: 2.4
Name: university-calendar
Version: 1.0.0
Summary: 通用高校校历与课程表管理工具
Home-page: https://cnb.cool/xiaosicau/university-calendar
Author: xiaoshishun
Author-email: xiaosicau@example.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PyQt5
Requires-Dist: openpyxl
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# University Calendar（校历助手）

通用高校校历与课程表管理桌面工具，支持任意大学通过导入向导自定义学校信息、学期安排和课程表。

**作者**：肖诗顺  
**源码**：[CNB 仓库](https://cnb.cool/xiaosicau/university-calendar)  
**环境**：macOS / Windows / Linux · Python >= 3.8  
**许可证**：MIT

## 功能特性

- 📅 校历查看（日历高亮重要日期）
- 📚 课程表管理（手动添加 / Excel 导入）
- ⏰ 上课提醒（提前 30 分钟弹窗 + 声音）
- 🔄 系统托盘常驻（最小化到托盘）
- 🚀 开机自启动（跨平台支持）
- 📊 周课表 / 今日课程 / 重要日期一览
- 🏫 通用配置：支持任意大学，通过导入向导自定义学校、学期、课程信息

## 安装

```bash
pip install university-calendar
```

或从源码安装：

```bash
git clone https://cnb.cool/xiaosicau/university-calendar.git
cd university-calendar
pip install -e .
```

## 使用

```bash
university-calendar
```

或使用简写命令：

```bash
uni-cal
```

或通过 Python 模块运行：

```bash
python -m university_calendar
```

### 首次使用

首次运行时会启动导入向导，引导您完成以下配置：

1. 设置学校名称和学年
2. 配置学期开始/结束日期
3. 添加重要日期（开学、放假、考试等）
4. 添加课程表（支持手动添加或从 Excel 导入）

### Excel 课表格式

从 Excel 导入课程时，表格列顺序应为：

| 课程名 | 教师 | 教室 | 星期 | 节次 | 周次 |
|--------|------|------|------|------|------|
| 高等数学 | 张老师 | 101 | 周一 | 1-2 | 1-16 |

## 数据存储

用户数据保存在系统标准目录：

- **macOS**: `~/Library/Application Support/university_calendar/`
- **Windows**: `%APPDATA%\university_calendar\`
- **Linux**: `~/.university_calendar/`

## 隐私说明

本项目默认使用示例数据，不收集任何个人隐私信息。所有用户数据均存储在本地。

## 许可证

MIT License
