📅 PS Calendar to ICS (iZJU)

🎓 专为浙江大学国际校区设计
将 PeopleSoft 课程表一键导出为标准 ICS 日历文件的 Tampermonkey 用户脚本

Github

博客地址

✨ 功能特点

🎯 核心功能

• 🏫 iZJU专用适配 - 专为浙江大学国际校区PeopleSoft系统设计
• 🔍 智能课程识别 - 基于真实HTML结构精确解析课程信息
• 📝 规范化命名 - 自动生成CS 101 - 实验室 (LA1)格式的清晰标识
• 🧩 多组件支持 - 完美处理实验室、理论课、讨论课等不同组件
• 🌐 中英双语 - 支持中英文混合的课程名称和时间格式

📅 智能行事历

• 🗓️ 2025-2026学年 - 内置完整的国际校区行事历数据
• 🚫 假期自动跳过 - 中秋国庆、元旦等假期自动排除课程
• 🔄 调休日处理 - 智能处理9月28日补课、10月11日补课等安排
• ⏸️ 停课日识别 - 校运动会、学生节等停课期间自动处理
• 🎉 特殊事件 - 自动添加开学典礼、重要截止日期等提醒

🔧 技术特性

• ✅ 精确日期计算 - 基于RRULE+EXDATE机制，每个日期都经过验证
• 🧠 智能状态管理 - 自动继承课程代码和组件信息
• 🌏 时区标准化 - 使用Asia/Shanghai时区，确保时间准确无误
• 📱 跨平台兼容 - 支持Outlook、Google Calendar、Apple Calendar等

🚀 快速开始

📥 安装步骤

1️⃣ 安装 Tampermonkey

在您的浏览器中安装 Tampermonkey 扩展

2️⃣ 安装脚本

🚀 一键安装: 通过 OpenUserJS 平台快速部署

⚠️ 重要配置:

1. 打开 开发者模式 开关
2. 进入 Tampermonkey 设置
3. 启用 "允许用户运行脚本" (如有该选项)

📋 使用指南

🔐 系统登录与导航

graph LR
    A[访问PeopleSoft] --> B[中文模式登录]
    B --> C[学期选课]
    C --> D[我的每周课程表]
    D --> E[列表查看]
    E --> F[导出ICS]

📱 支持的日历应用

• ✅ Microsoft Outlook - Windows/Mac
• ✅ Apple Calendar - macOS
• ✅ Thunderbird - 跨平台
• ✅ Notion Calendar - 现代化界面
• ✅ Google Calendar Web - 浏览器端

• ✅ Google Calendar - Android/iOS
• ✅ Apple Calendar - iOS
• ✅ Outlook Mobile - Android/iOS
• ✅ Samsung Calendar - Android
• ✅ Any.do Calendar - 跨平台

🧪 离线测试

💡 开发者友好: 支持本地HTML文件调试

1. 在 PeopleSoft 课表页面保存完整网页 (Ctrl+S)
2. 用浏览器打开保存的 HTML 文件  
3. "导出 ICS" 按钮同样可见并正常工作
4. 便于开发调试和功能验证

📊 支持的数据格式

✅ 星期一 2:00PM - 3:50PM
✅ 周二 08:00 - 09:35  
✅ 一三五 13:00-14:35
✅ Monday 14:00-15:50

✅ 15/09/2025 - 21/09/2025  (DD/MM/YYYY)
✅ 09/15/2025 - 09/21/2025  (MM/DD/YYYY)  
✅ 2025-09-15 - 2025-09-21  (YYYY-MM-DD)

脚本智能识别包含以下信息的表格：

• ⏰ 日期和时间
• 📍 教室/地点
• 👨‍🏫 讲师/教师
• 📆 开始/结束日期
• 🏷️ 课程代码和组件

🔧 故障排除

• ✅ 确认处于 "列表查看" 模式，而非"每周日历"模式
• ✅ 确认页面包含课程表数据
• ✅ 刷新页面重试
• ✅ 检查Tampermonkey是否已启用脚本

• ✅ 检查是否有"TBA"或"待定"的课程时间
• ✅ 确认日期格式被正确识别
• ✅ 打开浏览器控制台 (F12) 查看错误信息
• ✅ 确认学期时间在2025-2026学年范围内

• 🔍 脚本自动查找 td.PAGROUPDIVIDER 中的课程名称
• 🔄 如果找不到，会显示为"课程 1"、"课程 2"等
• ✏️ 可以在导入日历后手动修改事件标题
• 📝 建议提交issue反馈具体的HTML结构

• ⏰ 脚本使用 Asia/Shanghai 时区 (UTC+8)
• 🔧 如需其他时区，可修改脚本中的 TZID 常量
• 📅 确认导入的日历应用时区设置正确

⚙️ 技术规格

📅 行事历支持

🎯 2025-2026学年秋冬学期 完整支持

📚 学期时间

🗓️ 开始: 2025年9月15日
🗓️ 结束: 2026年1月10日 (含考试期)

🚫 假期自动排除

🔄 调休自动处理

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📋 贡献指南

• 🐛 Bug报告: 请提供详细的复现步骤和HTML结构
• 💡 功能建议: 欢迎提出新功能想法
• 🔧 代码贡献: 请遵循现有代码风格
• 📚 文档改进: 帮助完善使用说明

🏫 适配其他学校

如果您希望适配其他学校的PeopleSoft系统，欢迎Fork本项目！

📄 许可证

MIT License

Copyright (c) 2025 iZJU PS Calendar to ICS

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

🎓 Made with ❤️ for Zhejiang University International Campus

让课程管理更简单，让学习生活更有序 ✨

`