1

.dockerignore

@@ -0,0 +1,12 @@
+.git
+__pycache__/
+venv/
+*.pyc
+*.log
+*.backup
+*_old.*
+.last_*
+debug_page.html
+monitor.log
+config.ini
+data/

BUG修复_邮件课程列表不正确.md

@@ -1,213 +0,0 @@
-# BUG修复：邮件通知课程列表不正确
-
-## 问题描述
-
-**症状：**
-- 日志显示检测到2门新增课程：
-  - 马克思主义基本原理 (A3505000018)
-  - 软件需求分析与设计 (A0801050220)
-
-- 但邮件通知显示的是3门**完全不同**的课程：
-  - C++程序设计
-  - 体育(三) 乒乓球
-  - 概率论与数理统计
-
-## 根本原因
-
-代码逻辑错误：
-
-```python
-# 错误的实现
-if self.check_grade_changes(grade_info, grade_html):
-    courses_file = self.script_dir / '.last_courses.txt'
-    if courses_file.exists():
-        # ❌ 发送的是当前所有课程的前3门，而不是新增课程
-        self.send_email_notification(current_courses[:3])
-```
-
-### 问题分析
-
-1. `check_grade_changes` 函数内部计算了新增课程列表 `new_courses`
-2. 但函数只返回 `True/False`，**没有返回新增课程列表**
-3. 主循环中使用了 `current_courses[:3]`（当前所有课程的前3门）
-4. 导致邮件中显示的课程与实际新增的课程不一致
-
-### 举例说明
-
-**场景：**
-- 之前有6门课程：A、B、C、D、E、F
-- 新增2门课程：G、H
-- 当前总共8门课程：A、B、C、D、E、F、G、H
-
-**错误行为：**
-- 日志显示：新增2门（G、H）✓ 正确
-- 邮件显示：A、B、C（前3门）❌ 错误
-
-**期望行为：**
-- 邮件显示：G、H ✓ 正确
-
-## 修复方案
-
-### 1. 修改 `check_grade_changes` 函数签名
-
-```python
-# 修改前
-def check_grade_changes(self, current_content: str, current_html: str = None) -> bool:
-
-# 修改后
-def check_grade_changes(self, current_content: str, current_html: str = None) -> tuple:
-    """检查成绩是否有变化
-    
-    Returns:
-        tuple: (是否有变化: bool, 新增课程列表: list)
-    """
-```
-
-### 2. 返回新增课程列表
-
-```python
-# 修改前
-if new_courses:
-    # ... 记录日志 ...
-    return True
-
-# 修改后
-if new_courses:
-    # ... 记录日志 ...
-    return (True, new_courses)  # 返回元组
-
-# 其他情况
-return (False, [])  # 无变化
-return (True, [])   # 有变化但无新增课程（成绩更新）
-```
-
-### 3. 更新调用代码
-
-```python
-# 修改前
-if self.check_grade_changes(grade_info, grade_html):
-    self.send_email_notification(current_courses[:3])  # ❌ 错误
-
-# 修改后
-has_changes, new_courses = self.check_grade_changes(grade_info, grade_html)
-
-if has_changes:
-    if new_courses:
-        # 有新增课程，发送真正的新增课程列表
-        self.send_email_notification(new_courses)  # ✅ 正确
-    else:
-        # 没有新增课程但内容变化（成绩更新），发送通用通知
-        self.send_email_notification()
-```
-
-## 修复效果
-
-### 修复前
-```
-日志：
-[INFO] ✓ 检测到新增课程成绩！共 2 门
-[INFO]   1. [2025-2026 秋季] 马克思主义基本原理 (A3505000018)
-[INFO]   2. [2025-2026 秋季] 软件需求分析与设计 (A0801050220)
-
-邮件：
-新增课程（共3门）：
-  - 2025-2026 秋季 C++程序设计          ❌ 错误！
-  - 2025-2026 秋季 体育(三) 乒乓球      ❌ 错误！
-  - 2025-2026 秋季 概率论与数理统计     ❌ 错误！
-```
-
-### 修复后
-```
-日志：
-[INFO] ✓ 检测到新增课程成绩！共 2 门
-[INFO]   1. [2025-2026 秋季] 马克思主义基本原理 (A3505000018)
-[INFO]   2. [2025-2026 秋季] 软件需求分析与设计 (A0801050220)
-
-邮件：
-新增课程（共2门）：
-  - 2025-2026 秋季 马克思主义基本原理   ✅ 正确！
-  - 2025-2026 秋季 软件需求分析与设计   ✅ 正确！
-```
-
-## 测试建议
-
-### 1. 单元测试场景
-
-**场景1：新增课程**
-- 之前：3门课程
-- 现在：5门课程（新增2门）
-- 期望：邮件显示新增的2门
-
-**场景2：成绩更新**
-- 之前：5门课程
-- 现在：5门课程（某门成绩变化）
-- 期望：邮件显示通用通知
-
-**场景3：无变化**
-- 之前：5门课程
-- 现在：5门课程（完全相同）
-- 期望：不发送邮件
-
-### 2. 集成测试
-
-```bash
-# 1. 删除历史记录（模拟首次运行）
-cd ~/grade_monitor
-rm .last_*
-
-# 2. 运行测试
-python3 monitor.py --test
-
-# 3. 再次运行（模拟检测到变化）
-# 手动编辑 .last_courses.txt，删除几行
-python3 monitor.py --test
-
-# 4. 检查邮件内容是否正确
-```
-
-## 影响评估
-
-### 向后兼容性
-- ✅ 完全兼容：函数返回元组，Python 会自动解包
-- ✅ 不影响测试模式：test_fetch 不调用此函数
-- ✅ 不影响旧版数据：历史文件格式不变
-
-### 风险等级
-- 🟢 **低风险**：仅修改返回值类型
-- 🟢 所有调用点已更新
-- 🟢 已通过语法检查
-
-## 部署步骤
-
-```bash
-# 1. 本地打包
-cd /mnt/e/50425/Documents/Github/GPA_Monitoring
-./打包.sh
-
-# 2. 上传到服务器
-scp gpa_monitor.tar.gz user@server:~/
-
-# 3. 服务器上更新
-systemctl stop grade-monitor
-cd ~/grade_monitor
-cp monitor.py monitor.py.backup.$(date +%Y%m%d_%H%M%S)
-tar -xzf ~/gpa_monitor.tar.gz
-systemctl restart grade-monitor
-
-# 4. 验证
-tail -f monitor.log
-```
-
-## 后续优化建议
-
-1. **添加单元测试** - 测试 `check_grade_changes` 函数
-2. **记录邮件内容** - 在日志中记录发送的课程列表
-3. **邮件确认机制** - 发送成功后记录一份副本
-
----
-
-**BUG编号：** #001  
-**严重程度：** 高（数据不一致）  
-**修复日期：** 2026-01-21  
-**修复人员：** GitHub Copilot  
-**测试状态：** 待用户验证

Debian服务器部署指南.md

@@ -1,408 +0,0 @@
-# 成绩监控系统 - Debian服务器部署指南
-
-## 📦 项目文件说明
-
-### 必需文件（需要上传到服务器）
-
-| 文件名 | 用途 | 何时使用 |
-|--------|------|----------|
-| `monitor.py` | **主程序** | 运行监控的核心文件 |
-| `config.ini` | **配置文件** | 包含账号密码、邮箱配置（⚠️ 敏感文件） |
-| `requirements.txt` | **Python依赖列表** | 安装Python包时使用 |
-| `setup_python.sh` | **环境安装脚本** | 首次部署时执行，安装所有依赖 |
-| `grade-monitor.service` | **systemd服务配置** | 设置开机自启和后台运行 |
-
-### 可选文件（参考文档）
-
-| 文件名 | 用途 |
-|--------|------|
-| `config（模板）.ini` | 配置文件模板，新用户参考 |
-| `readme.md` | 项目说明文档 |
-| `部署.md` | 详细部署步骤 |
-| `常见问题解决.md` | 常见问题和解决方案 |
-
-### 不需要的文件（不要上传）
-
-- `venv/` - 虚拟环境（服务器上重新创建）
-- `.git/` - Git仓库（可选）
-- `.last_*` - 运行时生成的缓存文件
-- `monitor.log` - 运行时生成的日志文件
-
----
-
-## 🚀 Debian服务器部署步骤
-
-### 第一步：准备文件
-
-```bash
-# 在本地打包必需文件
-cd /mnt/e/50425/Documents/Github/GPA_Monitoring
-
-# 创建压缩包（只包含必需文件）
-tar -czf gpa_monitor.tar.gz \
-    monitor.py \
-    config.ini \
-    requirements.txt \
-    setup_python.sh \
-    grade-monitor.service \
-    readme.md
-
-# 查看压缩包内容
-tar -tzf gpa_monitor.tar.gz
-```
-
-### 第二步：上传到服务器
-
-```bash
-# 方法1：使用 scp
-scp gpa_monitor.tar.gz 用户名@服务器IP:/home/用户名/
-
-# 方法2：使用 rsync（推荐）
-rsync -avz gpa_monitor.tar.gz 用户名@服务器IP:/home/用户名/
-
-# 方法3：使用 sftp
-sftp 用户名@服务器IP
-put gpa_monitor.tar.gz
-```
-
-### 第三步：在服务器上解压并安装
-
-```bash
-# 登录到Debian服务器
-ssh 用户名@服务器IP
-
-# 解压文件
-cd ~
-tar -xzf gpa_monitor.tar.gz
-cd gpa_monitor  # 或者你解压到的目录
-
-# 给脚本添加执行权限
-chmod +x setup_python.sh
-
-# 运行安装脚本（会自动安装Python、创建虚拟环境、安装依赖）
-./setup_python.sh
-```
-
-### 第四步：检查配置文件
-
-```bash
-# 编辑配置文件（如果需要修改）
-nano config.ini
-
-# 确认配置正确：
-# - USERNAME 和 PASSWORD（学号和密码）
-# - 邮箱配置（SENDER_EMAIL、SENDER_PASSWORD、RECEIVER_EMAIL）
-# - CHECK_INTERVAL（建议120秒以上）
-```
-
-### 第五步：测试运行
-
-```bash
-# 激活虚拟环境
-source venv/bin/activate
-
-# 测试运行（获取一次成绩，不进行监控）
-python3 monitor.py --test
-
-# 如果测试成功，运行正式监控
-python3 monitor.py
-# 按 Ctrl+C 停止
-```
-
----
-
-## 🔧 设置后台运行（三选一）
-
-### 方案A：使用 tmux（推荐，简单易用）
-
-```bash
-# 1. 安装 tmux（如果没有）
-sudo apt update
-sudo apt install tmux
-
-# 2. 创建会话并运行
-tmux new -s grade_monitor
-source venv/bin/activate
-python3 monitor.py
-
-# 3. 离开会话（程序继续运行）
-# 按 Ctrl+B，然后按 D
-
-# 4. 重新连接查看
-tmux attach -t grade_monitor
-
-# 5. 查看所有会话
-tmux ls
-```
-
-**tmux 使用时机：**
-- ✅ 测试阶段使用
-- ✅ 需要随时查看程序输出
-- ✅ 临时运行，不需要开机自启
-
----
-
-### 方案B：使用 systemd 服务（推荐，生产环境）
-
-**`grade-monitor.service` 文件用途：**
-这是 systemd 服务配置文件，告诉系统如何启动、管理和自动重启你的程序。
-
-```bash
-# 1. 编辑服务文件，修改用户名和路径
-nano grade-monitor.service
-
-# 确保这些路径正确：
-# User=你的用户名
-# WorkingDirectory=/home/你的用户名/gpa_monitor
-# ExecStart=/home/你的用户名/gpa_monitor/venv/bin/python3 /home/你的用户名/gpa_monitor/monitor.py
-
-# 2. 复制服务文件到系统目录
-sudo cp grade-monitor.service /etc/systemd/system/
-
-# 3. 重新加载 systemd
-sudo systemctl daemon-reload
-
-# 4. 启动服务
-sudo systemctl start grade-monitor
-
-# 5. 查看状态
-sudo systemctl status grade-monitor
-
-# 6. 设置开机自启
-sudo systemctl enable grade-monitor
-```
-
-**systemd 常用命令：**
-```bash
-# 启动
-sudo systemctl start grade-monitor
-
-# 停止
-sudo systemctl stop grade-monitor
-
-# 重启
-sudo systemctl restart grade-monitor
-
-# 查看状态
-sudo systemctl status grade-monitor
-
-# 查看日志
-journalctl -u grade-monitor -f
-
-# 开机自启
-sudo systemctl enable grade-monitor
-
-# 禁用自启
-sudo systemctl disable grade-monitor
-```
-
-**systemd 使用时机：**
-- ✅ 生产环境长期运行
-- ✅ 需要开机自启动
-- ✅ 程序崩溃后自动重启
-- ✅ 系统化管理
-
----
-
-### 方案C：使用 nohup（最简单，但不推荐）
-
-```bash
-# 后台运行
-source venv/bin/activate
-nohup python3 monitor.py > output.log 2>&1 &
-
-# 查看进程
-ps aux | grep monitor.py
-
-# 停止程序
-pkill -f monitor.py
-```
-
-**nohup 使用时机：**
-- ✅ 临时快速运行
-- ❌ 不适合长期运行
-- ❌ 程序崩溃不会自动重启
-
----
-
-## 📊 监控和维护
-
-### 查看日志
-
-```bash
-# 查看监控日志（程序自己的日志）
-tail -f ~/gpa_monitor/monitor.log
-
-# 查看最后100行
-tail -n 100 ~/gpa_monitor/monitor.log
-
-# 搜索关键词
-grep "新增课程" ~/gpa_monitor/monitor.log
-
-# 查看系统日志（如果用systemd）
-sudo journalctl -u grade-monitor -f
-sudo journalctl -u grade-monitor --since "1 hour ago"
-```
-
-### 检查运行状态
-
-```bash
-# 方法1：查看进程
-ps aux | grep monitor.py
-
-# 方法2：查看日志时间戳
-ls -lh ~/gpa_monitor/monitor.log
-
-# 方法3：systemd状态（如果用systemd）
-sudo systemctl status grade-monitor
-```
-
-### 更新程序
-
-```bash
-# 1. 停止程序
-# tmux: Ctrl+C 或 tmux kill-session -t grade_monitor
-# systemd: sudo systemctl stop grade-monitor
-
-# 2. 备份配置
-cp config.ini config.ini.backup
-
-# 3. 上传新版本文件并解压
-
-# 4. 恢复配置
-cp config.ini.backup config.ini
-
-# 5. 重启程序
-# tmux: 重新运行
-# systemd: sudo systemctl restart grade-monitor
-```
-
----
-
-## 🔒 安全建议
-
-### 1. 保护配置文件
-
-```bash
-# 设置文件权限（只有所有者可读写）
-chmod 600 config.ini
-
-# 查看权限
-ls -l config.ini
-# 应该显示：-rw------- 1 用户名 用户名
-```
-
-### 2. 不要上传敏感文件到 GitHub
-
-在 `.gitignore` 中添加：
-```
-config.ini
-*.log
-.last_*
-venv/
-```
-
-### 3. 定期检查日志
-
-```bash
-# 检查是否有异常
-grep -i "error\|fail\|warning" monitor.log
-
-# 检查登录情况
-grep "登录" monitor.log | tail -20
-```
-
----
-
-## ❓ 常见问题
-
-### Q1: 如何确认程序在运行？
-
-```bash
-# 方法1：查看进程
-ps aux | grep monitor.py
-
-# 方法2：查看日志最后几行
-tail monitor.log
-
-# 方法3：查看文件修改时间
-ls -lh monitor.log
-```
-
-### Q2: 程序报错"请不要过快点击"怎么办？
-
-```bash
-# 编辑配置文件，增加检查间隔
-nano config.ini
-
-# 修改 CHECK_INTERVAL 为更大的值（如300秒）
-CHECK_INTERVAL = 300
-
-# 重启程序
-```
-
-### Q3: 如何在多台服务器部署？
-
-```bash
-# 每台服务器重复部署步骤，注意：
-# 1. 每台服务器使用不同的监控账号（如果可能）
-# 2. 适当增加 CHECK_INTERVAL 避免同时访问
-# 3. 可以设置不同的邮件接收地址
-```
-
-### Q4: 忘记 tmux 会话名怎么办？
-
-```bash
-# 列出所有会话
-tmux ls
-
-# 连接到第一个会话
-tmux attach
-```
-
----
-
-## 📝 快速命令参考
-
-```bash
-# === 部署 ===
-tar -xzf gpa_monitor.tar.gz
-cd gpa_monitor
-chmod +x setup_python.sh
-./setup_python.sh
-
-# === 运行 ===
-# 测试
-source venv/bin/activate && python3 monitor.py --test
-
-# tmux运行
-tmux new -s grade_monitor
-source venv/bin/activate && python3 monitor.py
-
-# systemd运行
-sudo cp grade-monitor.service /etc/systemd/system/
-sudo systemctl daemon-reload
-sudo systemctl start grade-monitor
-sudo systemctl enable grade-monitor
-
-# === 监控 ===
-# 查看日志
-tail -f monitor.log
-
-# 查看状态
-sudo systemctl status grade-monitor
-
-# === 停止 ===
-# tmux: Ctrl+C
-# systemd: sudo systemctl stop grade-monitor
-# nohup: pkill -f monitor.py
-```
-
----
-
-## 📞 获取帮助
-
-- 查看项目 README: `cat readme.md`
-- 查看常见问题: `cat 常见问题解决.md`
-- 查看详细部署: `cat 部署.md`
-- 查看程序帮助: `python3 monitor.py --help`

Dockerfile

@@ -0,0 +1,23 @@
+FROM python:3.11-slim
+
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    GPA_DATA_DIR=/data
+
+WORKDIR /app
+
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends ca-certificates \
+    && rm -rf /var/lib/apt/lists/* \
+    && useradd --create-home --shell /usr/sbin/nologin appuser \
+    && mkdir -p /data \
+    && chown -R appuser:appuser /app /data
+
+COPY requirements.txt /app/
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY monitor.py /app/
+
+USER appuser
+
+CMD ["python", "/app/monitor.py", "--config", "/data/config.ini"]

docker-compose.yml

@@ -0,0 +1,10 @@
+ services:
+  gpa-monitor:
+    build: .
+    container_name: gpa-monitor
+    restart: unless-stopped
+    environment:
+      GPA_DATA_DIR: /data
+    volumes:
+      - ./data:/data
+      - ./config.ini:/data/config.ini:ro

docs/完整使用文档.md

@@ -0,0 +1,970 @@
+# 成绩监控系统 - 完整使用文档
+
+> **最后更新：** 2026-01-29  
+> **版本：** v2.0 - 自动会话恢复版
+
+---
+
+## 📑 目录
+
+1. [服务器部署指南](#服务器部署指南)
+2. [快速更新指南](#快速更新指南)
+3. [故障排查指南](#故障排查指南)
+4. [常见问题解决](#常见问题解决)
+5. [服务管理](#服务管理)
+6. [历史BUG修复记录](#历史bug修复记录)
+
+---
+
+# 服务器部署指南
+
+## 📋 前置要求
+
+- Linux服务器（Debian/Ubuntu/CentOS等）
+- Python 3.7+
+- 服务器能访问外网
+- SSH访问权限
+- （可选）Docker 20+ / Docker Compose v2
+
+## 📦 项目文件说明
+
+### 必需文件（需要上传到服务器）
+
+| 文件名 | 用途 | 何时使用 |
+|--------|------|----------|
+| `monitor.py` | **主程序** | 运行监控的核心文件 |
+| `config.ini` | **配置文件** | 包含账号密码、邮箱配置（⚠️ 敏感文件） |
+| `requirements.txt` | **Python依赖列表** | 安装Python包时使用 |
+| `setup_python.sh` | **环境安装脚本** | 首次部署时执行，安装所有依赖 |
+| `grade-monitor.service` | **systemd服务配置** | 设置开机自启和后台运行 |
+
+### 可选文件（参考文档）
+
+| 文件名 | 用途 |
+|--------|------|
+| `config（模板）.ini` | 配置文件模板，新用户参考 |
+| `README.md` | 项目说明文档 |
+| `diagnose.sh` | 故障诊断脚本 |
+
+### 不需要的文件（不要上传）
+
+- `venv/` - 虚拟环境（服务器上重新创建）
+- `.git/` - Git仓库（可选）
+- `.last_*` - 运行时生成的缓存文件
+- `monitor.log` - 运行时生成的日志文件
+
+## 🚀 部署步骤
+
+### 第一步：准备文件
+
+```bash
+# 在本地打包必需文件（WSL或Git Bash）
+cd /mnt/e/50425/Documents/Github/GPA_Monitoring
+```
+
+### 第二步：上传到服务器
+
+```bash
+scp gpa_monitor.tar.gz 用户名@服务器IP:/home/用户名/
+```
+
+### 第三步：在服务器上解压并安装
+
+```bash
+# 登录到服务器
+ssh 用户名@服务器IP
+
+cd grade_monitor  # 你解压到的目录
+
+# 给脚本添加执行权限
+chmod +x setup_python.sh diagnose.sh
+
+# 运行安装脚本（会自动安装Python、创建虚拟环境、安装依赖）
+./setup_python.sh
+```
+
+### 第四步：检查配置文件
+
+```bash
+# 编辑配置文件（如果需要修改）
+nano config.ini
+
+# 确认配置正确：
+# - USERNAME 和 PASSWORD（学号和密码）
+# - 邮箱配置（SENDER_EMAIL、SENDER_PASSWORD、RECEIVER_EMAIL）
+# - CHECK_INTERVAL（建议120秒以上）
+```
+
+配置文件示例：
+```ini
+[login]
+USERNAME = 你的学号
+PASSWORD = 你的密码
+LOGIN_URL = ...
+GRADE_URL = ...
+
+[email]
+SENDER_EMAIL = your_email@163.com
+SENDER_PASSWORD = SMTP授权码（不是邮箱密码！）
+RECEIVER_EMAIL = 接收通知的邮箱
+
+[monitor]
+CHECK_INTERVAL = 120  # 建议120-300秒
+REQUEST_DELAY = 5
+MAX_RETRIES = 3
+RETRY_DELAY = 10
+```
+
+### 第五步：测试运行
+
+```bash
+# 激活虚拟环境
+source venv/bin/activate
+
+# 测试运行（获取一次成绩，不进行监控）
+python3 monitor.py --test
+
+# 查看提取的成绩
+cat .last_grade_content.txt
+```
+
+---
+
+## 🐳 Docker 部署（推荐）
+
+> 适合已有 Docker 环境的服务器（例如 docker.aizhangz.top）。
+
+### 1) 准备文件（本地或服务器）
+
+必需文件：
+- `monitor.py`
+- `requirements.txt`
+- `Dockerfile`
+- `docker-compose.yml`
+- `config.ini`（⚠️ 敏感文件）
+
+### 2) 在服务器上运行
+
+```bash
+# 进入项目目录
+cd ~/grade_monitor
+
+# 首次构建并启动
+docker compose up -d --build
+
+# 查看日志
+docker logs -f gpa-monitor
+```
+
+### 3) 测试模式（可选）
+
+```bash
+docker compose run --rm gpa-monitor python /app/monitor.py --config /data/config.ini --test
+```
+
+### 4) 说明
+
+- 运行日志和缓存文件会写入 `./data/`
+- 配置文件通过 `./config.ini:/data/config.ini:ro` 挂载
+
+## 🔧 设置后台运行
+
+### 使用 systemd（推荐，生产环境）
+
+**优点：** 开机自启、崩溃自动重启、系统化管理
+
+```bash
+# 1. 编辑服务文件，修改用户名和路径
+nano grade-monitor.service
+
+# 确保这些路径正确：
+# User=你的用户名
+# WorkingDirectory=/home/你的用户名/grade_monitor
+# ExecStart=/home/你的用户名/grade_monitor/venv/bin/python3 /home/你的用户名/grade_monitor/monitor.py
+
+# 2. 复制服务文件到系统目录
+sudo cp grade-monitor.service /etc/systemd/system/
+
+# 3. 重新加载 systemd
+sudo systemctl daemon-reload
+
+# 4. 启动服务
+sudo systemctl start grade-monitor
+
+# 5. 查看状态
+sudo systemctl status grade-monitor
+
+# 6. 设置开机自启
+sudo systemctl enable grade-monitor
+```
+
+**systemd 常用命令：**
+```bash
+# 启动
+sudo systemctl start grade-monitor
+
+# 停止
+sudo systemctl stop grade-monitor
+
+# 重启
+sudo systemctl restart grade-monitor
+
+# 查看状态
+sudo systemctl status grade-monitor
+
+# 查看日志
+sudo journalctl -u grade-monitor -f
+
+# 开机自启
+sudo systemctl enable grade-monitor
+
+# 禁用自启
+sudo systemctl disable grade-monitor
+```
+
+
+## 📊 监控和维护
+
+### 查看日志
+
+```bash
+# 查看监控日志（程序自己的日志）
+tail -f ~/grade_monitor/monitor.log
+
+# 查看最后100行
+tail -n 100 ~/grade_monitor/monitor.log
+
+# 搜索关键词
+grep "新增课程" ~/grade_monitor/monitor.log
+
+# 查看系统日志（如果用systemd）
+sudo journalctl -u grade-monitor -f
+sudo journalctl -u grade-monitor --since "1 hour ago"
+```
+
+### 检查运行状态
+
+```bash
+# 方法1：查看进程
+ps aux | grep monitor.py
+
+# 方法2：查看日志时间戳
+ls -lh ~/grade_monitor/monitor.log
+
+# 方法3：systemd状态（如果用systemd）
+sudo systemctl status grade-monitor
+```
+
+## 🔒 安全建议
+
+### 1. 保护配置文件
+
+```bash
+# 设置文件权限（只有所有者可读写）
+chmod 600 config.ini
+
+# 查看权限
+ls -l config.ini
+# 应该显示：-rw------- 1 用户名 用户名
+```
+
+### 2. 不要上传敏感文件到 GitHub
+
+在 `.gitignore` 中添加：
+```
+config.ini
+*.log
+.last_*
+venv/
+```
+
+### 3. 定期检查日志
+
+```bash
+# 检查是否有异常
+grep -i "error\|fail\|warning" monitor.log
+
+# 检查登录情况
+grep "登录" monitor.log | tail -20
+```
+
+---
+
+# 快速更新指南
+
+## 🎯 本功能解决的问题
+
+**症状：** 程序运行几小时后出现：
+```
+[WARNING] 未能提取到成绩信息，返回原始文本
+[INFO] 成绩无变化（共 0 门课程）
+```
+
+**原因：** 登录会话过期，需要重新登录
+
+**解决：** ✅ 最新版本已自动检测并重新登录
+
+## 📦 更新方式
+
+### 方式1：完整更新（推荐）
+
+#### 在本地准备
+```bash
+# WSL或Git Bash中
+cd /mnt/e/50425/Documents/Github/GPA_Monitoring
+
+# 创建更新包
+tar -czf gpa_monitor.tar.gz \
+    monitor.py \
+    config.ini \
+    requirements.txt \
+    setup_python.sh \
+    diagnose.sh \
+    grade-monitor.service
+```
+
+#### 上传到服务器
+```bash
+scp gpa_monitor.tar.gz 用户名@服务器IP:~/
+```
+
+#### 在服务器上更新
+```bash
+# 停止服务
+systemctl stop grade-monitor
+
+# 备份旧文件
+cd ~/grade_monitor
+cp monitor.py monitor.py.backup.$(date +%Y%m%d)
+
+# 解压更新（会覆盖旧文件）
+tar -xzf ~/gpa_monitor.tar.gz -C ~/grade_monitor
+
+# 赋予执行权限
+chmod +x diagnose.sh
+
+# 重启服务
+systemctl restart grade-monitor
+
+# 查看日志（确认自动重新登录功能）
+tail -f monitor.log
+```
+
+### 方式2：仅更新主程序
+
+如果只想更新 monitor.py：
+
+```bash
+# 在本地（WSL）
+cd /mnt/e/50425/Documents/Github/GPA_Monitoring
+scp monitor.py 用户名@服务器IP:~/grade_monitor/
+
+# 在服务器上
+systemctl stop grade-monitor
+systemctl start grade-monitor
+tail -f ~/grade_monitor/monitor.log
+```
+
+## ✅ 验证更新成功
+
+查看日志，应该能看到：
+
+### 正常运行
+```
+[INFO] 开始新一轮检查
+[INFO] 获取成绩页面...
+[DEBUG] 找到成绩表格
+[INFO] 成功提取成绩信息，共 17 行
+[INFO] 共解析到 15 门课程
+[INFO] 成绩无变化（共 15 门课程）
+```
+
+### 会话过期时自动处理
+```
+[WARNING] 检测到会话过期，尝试重新登录...
+[INFO] 开始登录统一身份认证...
+[INFO] 登录成功！成功访问成绩页面
+[INFO] 重新登录成功，继续监控
+```
+
+## 💡 最佳实践
+
+1. **定期检查日志**（每天1-2次即可）
+   ```bash
+   tail -n 50 ~/grade_monitor/monitor.log
+   ```
+
+2. **不要频繁重启服务**
+   - 新版本会自动处理会话过期
+   - 只在真正出问题时才重启
+
+3. **保留备份**
+   ```bash
+   # 每次更新前都会自动备份
+   ls -lh ~/grade_monitor/monitor.py.backup.*
+   ```
+
+4. **合理设置检查间隔**
+   - 建议 120-300 秒
+   - 避免触发学校系统限流
+
+---
+
+# 故障排查指南
+
+## 🚨 问题一："未能提取到成绩信息，共 0 门课程"
+
+### 症状
+日志中反复出现：
+```
+[WARNING] 未能提取到成绩信息，返回原始文本
+[INFO] 成绩无变化（共 0 门课程）
+```
+
+### 快速诊断
+
+#### 步骤1：运行诊断工具
+```bash
+cd ~/grade_monitor
+./diagnose.sh
+```
+
+诊断工具会自动：
+- 检查 BeautifulSoup 是否安装
+- 运行测试模式
+- 分析测试结果
+- 提供修复建议
+
+#### 步骤2：检查 BeautifulSoup 安装
+```bash
+python3 -c "import bs4; print('BeautifulSoup4 已安装')"
+```
+
+如果报错，安装依赖：
+```bash
+pip3 install beautifulsoup4
+# 或完整安装所有依赖
+pip3 install -r requirements.txt
+```
+
+#### 步骤3：使用调试模式
+```bash
+cd ~/grade_monitor
+python3 monitor.py --test --debug
+```
+
+查看输出中是否有：
+- ✅ "找到成绩表格"
+- ✅ "找到 X 行成绩数据"
+- ✅ "共解析到 X 门课程"
+
+#### 步骤4：检查是否登录失效
+```bash
+grep "登录页面\|LOGIN_REQUIRED" ~/grade_monitor/monitor.log
+```
+
+如果有，重启服务重新登录：
+```bash
+systemctl restart grade-monitor
+```
+
+#### 步骤5：查看调试HTML文件
+```bash
+cd ~/grade_monitor
+
+# 检查文件是否存在
+ls -lh debug_page.html
+
+# 查看是否包含成绩表格
+grep -i "gridtable\|课程名称\|成绩" debug_page.html | head -5
+```
+
+### 解决方案
+
+**方案1：重新安装依赖并重启**
+```bash
+cd ~/grade_monitor
+pip3 install -r requirements.txt
+systemctl restart grade-monitor
+tail -f monitor.log
+```
+
+**方案2：启用调试模式监控**
+```bash
+# 编辑服务配置
+sudo nano /etc/systemd/system/grade-monitor.service
+
+# 修改 ExecStart 行添加 --debug 参数
+ExecStart=/usr/bin/python3 /home/yourusername/grade_monitor/monitor.py --debug
+
+# 重新加载并重启
+sudo systemctl daemon-reload
+sudo systemctl restart grade-monitor
+tail -f ~/grade_monitor/monitor.log
+```
+
+**方案3：如果是会话过期**
+最新版本会自动处理！代码会：
+1. 检测到 "LOGIN_REQUIRED" 时自动重新登录
+2. 记录日志：`[WARNING] 检测到会话过期，尝试重新登录...`
+3. 重新登录后继续监控
+
+**方案4：如果是网页结构变化**
+程序会自动保存 HTML 到 `debug_page.html`，查看这个文件：
+```bash
+# 查看 HTML 内容，确认是否有成绩表格
+cat debug_page.html | grep -i "gridtable\|dataList" -A 10
+```
+
+当前支持的表格选择器：
+- `<table class="gridtable">`
+- `<table id="dataList">`
+- 任何包含"课程名称"或"成绩"关键词的表格
+
+## ⚠️ 问题二："请不要过快点击"错误
+
+### 问题原因
+学校WebVPN系统有严格的访问频率限制，短时间内多次访问会被拦截。
+
+### 解决方案
+
+#### 1. 停止手动测试至少5分钟
+```bash
+# 如果在服务器上运行，请先停止程序
+ps aux | grep monitor.py
+kill <进程ID>
+
+# 等待至少5分钟后再重新测试
+```
+
+#### 2. 修改配置文件增加间隔
+```bash
+nano config.ini
+```
+
+修改为：
+```ini
+[monitor]
+# 将检查间隔改为5分钟（300秒）或更长
+CHECK_INTERVAL = 300
+
+# 增加请求延迟
+REQUEST_DELAY = 15
+
+# 增加重试间隔
+RETRY_DELAY = 60
+```
+
+#### 3. 使用正确的测试方式
+```bash
+# 测试前确保距离上次测试至少5分钟
+python3 monitor.py --test
+
+# 如果还是被拦截，等10分钟后再试
+```
+
+#### 4. 部署后不要频繁测试
+```bash
+# 部署systemd服务后，让它自动运行
+sudo systemctl start grade-monitor
+
+# 只通过日志查看运行情况
+tail -f monitor.log
+
+# 不要反复启停服务或手动测试
+```
+
+## 🔍 如何判断系统正常工作
+
+### 方法1：查看日志
+```bash
+tail -f ~/grade_monitor/monitor.log
+```
+
+正常日志应该类似：
+```
+2026-01-29 10:00:00 - INFO - 开始检查成绩变化...
+2026-01-29 10:00:05 - INFO - 登录成功！
+2026-01-29 10:00:10 - INFO - 成功获取成绩页面
+2026-01-29 10:00:12 - INFO - 未发现新课程
+2026-01-29 10:02:00 - INFO - 等待下次检查...
+```
+
+### 方法2：查看保存的成绩文件
+```bash
+cat ~/.last_grade_content.txt
+```
+
+如果文件包含完整的课程列表和GPA，说明系统工作正常。
+
+### 方法3：查看进程状态
+```bash
+ps aux | grep monitor.py
+```
+
+如果有进程在运行，说明程序正在监控中。
+
+## 📝 调试流程
+
+1. **启用调试模式运行一次测试：**
+   ```bash
+   cd ~/grade_monitor
+   python3 monitor.py --test --debug
+   ```
+
+2. **查看输出信息：**
+   - 是否显示 "找到成绩表格"？
+   - 是否显示 "找到 X 行成绩数据"？
+   - 是否显示 "共解析到 X 门课程"？
+
+3. **检查保存的文件：**
+   ```bash
+   # 如果生成了 debug_page.html
+   ls -lh debug_page.html
+   
+   # 查看是否包含成绩表格
+   grep -A 5 "gridtable\|dataList" debug_page.html
+   ```
+
+4. **如果是网页结构问题：**
+   - 将 `debug_page.html` 发给开发者
+   - 或者自己检查 HTML 中的表格结构
+
+---
+
+# 常见问题解决
+
+## 💡 最佳实践
+
+### 测试阶段
+1. **首次测试**：运行 `python3 monitor.py --test`
+2. **等待5分钟**
+3. **再次测试**：确认能正常获取成绩
+4. **等待10分钟**
+5. **部署服务**：配置systemd或使用tmux
+
+### 运行阶段
+1. **设置CHECK_INTERVAL为120秒或更长**
+2. **让程序自动运行，不要手动干预**
+3. **每天查看一次日志即可**
+4. **不要频繁重启服务**
+
+### 如果被持续拦截
+1. **停止所有监控程序**
+2. **等待至少30分钟**
+3. **将CHECK_INTERVAL改为600秒（10分钟）**
+4. **重新启动，让它慢慢运行**
+5. **确认稳定后，再逐步减少间隔**
+
+## 🛠️ 调试技巧
+
+### 查看实际响应内容
+```bash
+cat ~/grade_monitor/.debug_response.html
+```
+
+如果文件包含"请不要过快点击"，说明请求被拦截。
+
+### 检查登录状态
+```bash
+# 运行测试模式
+python3 monitor.py --test
+
+# 查看是否成功登录
+grep "登录成功" monitor.log
+```
+
+### 测试网络连接
+```bash
+# 测试是否能访问学校网站
+curl -I https://webvpn.neu.edu.cn
+
+# 测试SMTP邮件服务器
+nc -zv smtp.163.com 465
+```
+
+## 🔧 常见问题FAQ
+
+### Q1: 如何确认程序在运行？
+
+```bash
+# 方法1：查看进程
+ps aux | grep monitor.py
+
+# 方法2：查看日志最后几行
+tail monitor.log
+
+# 方法3：查看文件修改时间
+ls -lh monitor.log
+```
+
+### Q2: 程序报错"请不要过快点击"怎么办？
+
+编辑配置文件，增加检查间隔：
+```bash
+nano config.ini
+# 修改 CHECK_INTERVAL 为更大的值（如300秒）
+```
+
+### Q3: 如何在多台服务器部署？
+
+每台服务器重复部署步骤，注意：
+1. 每台服务器使用不同的监控账号（如果可能）
+2. 适当增加 CHECK_INTERVAL 避免同时访问
+3. 可以设置不同的邮件接收地址
+
+### Q4: 忘记 tmux 会话名怎么办？
+
+```bash
+# 列出所有会话
+tmux ls
+
+# 连接到第一个会话
+tmux attach
+```
+
+### Q5: 邮件发送失败怎么办？
+
+- 确认SMTP授权码正确（不是邮箱密码）
+- 检查服务器能否访问smtp.163.com（端口465）
+- 查看详细错误信息：`tail -f monitor.log`
+
+```bash
+# 测试网络连接
+telnet smtp.163.com 465
+# 或
+nc -zv smtp.163.com 465
+```
+
+### Q6: 权限不足怎么办？
+
+```bash
+# 修改文件所有者
+sudo chown -R username:username ~/grade_monitor
+
+# 修改执行权限
+chmod +x ~/grade_monitor/*.sh
+```
+
+## 💬 温馨提示
+
+1. **成绩更新频率不高**：学校不会每分钟更新成绩，建议CHECK_INTERVAL设为120-300秒
+2. **避免过度监控**：频繁访问可能被学校系统封禁IP
+3. **合理设置间隔**：既能及时发现新成绩，又不会触发限流
+4. **信任自动化**：部署后让程序自己运行，不需要频繁检查
+
+---
+
+# 服务管理
+
+## 🔄 重启服务
+
+### 使用 systemd
+
+```bash
+# 停止服务
+systemctl stop grade-monitor
+
+# 备份旧文件
+cd ~/grade_monitor
+cp monitor.py monitor.py.backup
+
+# 如果需要更新文件
+# tar -xzf ~/gpa_monitor.tar.gz -C ~/grade_monitor
+
+# 重启服务
+systemctl restart grade-monitor
+
+# 查看实时日志
+tail -f monitor.log
+
+# 或查看最近的日志（包含完整上下文）
+tail -n 100 monitor.log
+```
+
+### 使用 tmux
+
+```bash
+# 连接到会话
+tmux attach -t grade_monitor
+
+# 停止程序（Ctrl+C）
+
+# 重新运行
+source venv/bin/activate
+python3 monitor.py
+
+# 离开会话（Ctrl+B 然后 D）
+```
+
+### 使用 nohup
+
+```bash
+# 查找进程
+ps aux | grep monitor.py
+
+# 停止进程
+kill <进程ID>
+
+# 重新启动
+cd ~/grade_monitor
+source venv/bin/activate
+nohup python3 monitor.py > output.log 2>&1 &
+```
+
+## 📊 日志查看
+
+### 查看监控日志
+```bash
+# 实时查看
+tail -f ~/grade_monitor/monitor.log
+
+# 查看最后N行
+tail -n 50 ~/grade_monitor/monitor.log
+
+# 搜索关键词
+grep "新增课程\|错误\|warning" ~/grade_monitor/monitor.log
+```
+
+### 查看系统日志（systemd）
+```bash
+# 实时查看
+sudo journalctl -u grade-monitor -f
+
+# 查看最近1小时
+sudo journalctl -u grade-monitor --since "1 hour ago"
+
+# 查看今天的日志
+sudo journalctl -u grade-monitor --since today
+```
+
+## 🔍 状态检查
+
+```bash
+# 检查服务状态（systemd）
+sudo systemctl status grade-monitor
+
+# 检查进程
+ps aux | grep monitor.py
+
+# 检查最后一次检查时间
+ls -lh ~/grade_monitor/monitor.log
+
+# 查看保存的成绩
+cat ~/grade_monitor/.last_grade_content.txt
+```
+
+## 📦 完整更新流程
+
+```bash
+# 1. 在本地打包
+cd /mnt/e/50425/Documents/Github/GPA_Monitoring
+tar -czf gpa_monitor.tar.gz monitor.py config.ini requirements.txt setup_python.sh
+
+# 2. 上传到服务器
+scp gpa_monitor.tar.gz user@server:~/
+
+# 3. 在服务器上更新
+ssh user@server
+systemctl stop grade-monitor
+cd ~/grade_monitor
+cp monitor.py monitor.py.backup.$(date +%Y%m%d)
+tar -xzf ~/gpa_monitor.tar.gz
+systemctl restart grade-monitor
+
+# 4. 验证
+tail -f monitor.log
+```
+
+---
+
+# 历史BUG修复记录
+
+## BUG #001: 邮件通知课程列表不正确
+
+**修复日期：** 2026-01-21  
+**严重程度：** 高（数据不一致）  
+**修复状态：** ✅ 已修复
+
+### 问题描述
+
+**症状：**
+- 日志显示检测到2门新增课程：
+  - 马克思主义基本原理 (A3505000018)
+  - 软件需求分析与设计 (A0801050220)
+
+- 但邮件通知显示的是3门**完全不同**的课程：
+  - C++程序设计
+  - 体育(三) 乒乓球
+  - 概率论与数理统计
+
+### 根本原因
+
+代码逻辑错误：
+
+```python
+# 错误的实现
+if self.check_grade_changes(grade_info, grade_html):
+    courses_file = self.script_dir / '.last_courses.txt'
+    if courses_file.exists():
+        # ❌ 发送的是当前所有课程的前3门，而不是新增课程
+        self.send_email_notification(current_courses[:3])
+```
+
+**问题分析：**
+1. `check_grade_changes` 函数内部计算了新增课程列表 `new_courses`
+2. 但函数只返回 `True/False`，**没有返回新增课程列表**
+3. 主循环中使用了 `current_courses[:3]`（当前所有课程的前3门）
+4. 导致邮件中显示的课程与实际新增的课程不一致
+
+### 修复方案
+
+1. **修改函数签名**：返回元组 `(是否有变化: bool, 新增课程列表: list)`
+2. **返回新增课程列表**：`return (True, new_courses)`
+3. **更新调用代码**：使用真正的新增课程列表发送邮件
+
+### 修复效果
+
+**修复前：**
+```
+日志：检测到2门新增课程
+邮件：显示3门完全不同的课程 ❌
+```
+
+**修复后：**
+```
+日志：检测到2门新增课程
+邮件：准确显示这2门新增课程 ✅
+```
+
+---
+
+## 📞 获取帮助
+
+如果遇到问题：
+1. 先运行诊断工具：`./diagnose.sh`
+2. 查看本文档的故障排查部分
+3. 查看 `monitor.log` 了解详细错误
+4. 运行 `python3 monitor.py --test --debug` 测试
+5. 检查 `debug_page.html` 了解实际响应
+
+---
+
+## ✅ 部署检查清单
+
+- [ ] 文件已上传到服务器
+- [ ] config.ini配置正确（账号、密码、邮箱）
+- [ ] 运行setup_python.sh安装依赖
+- [ ] 测试模式运行成功
+- [ ] 成绩提取格式正确
+- [ ] 配置后台运行（systemd/tmux）
+- [ ] 服务正常启动
+- [ ] 日志输出正常
+- [ ] 收到测试邮件
+- [ ] 设置文件权限（chmod 600 config.ini）
+
+---
+
+**文档版本：** v2.0  
+**最后更新：** 2026-01-29  
+**维护者：** GitHub Copilot

monitor.py

@@ -26,6 +26,11 @@ from email.mime.multipart import MIMEMultipart
 from typing import Optional, Dict
 import signal
 
+# 数据目录（用于日志和运行时文件）
+_DEFAULT_DATA_DIR = Path(__file__).parent.resolve()
+DATA_DIR = Path(os.environ.get('GPA_DATA_DIR', str(_DEFAULT_DATA_DIR))).expanduser()
+DATA_DIR.mkdir(parents=True, exist_ok=True)
+
 # 配置日志
 logger = logging.getLogger(__name__)
 
@@ -40,7 +45,7 @@ if not logger.handlers:
     )
     
     # 文件处理器
-    file_handler = logging.FileHandler('monitor.log', encoding='utf-8')
+    file_handler = logging.FileHandler(DATA_DIR / 'monitor.log', encoding='utf-8')
     file_handler.setFormatter(formatter)
     logger.addHandler(file_handler)
     
@@ -67,10 +72,10 @@ class GradeMonitor:
         })
         
         # 文件路径
-        self.script_dir = Path(__file__).parent.absolute()
-        self.last_grade_file = self.script_dir / '.last_grade_hash.txt'
-        self.last_grade_html_file = self.script_dir / '.last_grade_page.html'
-        self.last_grade_content_file = self.script_dir / '.last_grade_content.txt'
+        self.data_dir = DATA_DIR
+        self.last_grade_file = self.data_dir / '.last_grade_hash.txt'
+        self.last_grade_html_file = self.data_dir / '.last_grade_page.html'
+        self.last_grade_content_file = self.data_dir / '.last_grade_content.txt'
         
         # 运行标志
         self.running = True
@@ -362,7 +367,7 @@ class GradeMonitor:
             if not result:
                 logger.warning("未能提取到成绩信息，页面可能结构异常")
                 # 保存HTML以便调试
-                debug_file = self.script_dir / 'debug_page.html'
+                debug_file = self.data_dir / 'debug_page.html'
                 debug_file.write_text(html, encoding='utf-8')
                 logger.info(f"已保存HTML到 {debug_file} 供调试")
                 
@@ -469,7 +474,7 @@ class GradeMonitor:
             logger.info("=" * 60)
             
             # 保存课程列表
-            courses_file = self.script_dir / '.last_courses.txt'
+            courses_file = self.data_dir / '.last_courses.txt'
             courses_file.write_text('\n'.join(current_courses), encoding='utf-8')
             
             # 计算哈希
@@ -478,7 +483,7 @@ class GradeMonitor:
             return (False, [])
         
         # 读取上次的课程列表
-        courses_file = self.script_dir / '.last_courses.txt'
+        courses_file = self.data_dir / '.last_courses.txt'
         if courses_file.exists():
             last_courses = courses_file.read_text(encoding='utf-8').strip().split('\n')
         else:
@@ -792,7 +797,7 @@ class GradeMonitor:
                 # 如果解析失败（0门课程）且之前有课程，可能是临时问题
                 if len(current_courses) == 0:
                     # 检查是否之前有课程记录
-                    courses_file = self.script_dir / '.last_courses.txt'
+                    courses_file = self.data_dir / '.last_courses.txt'
                     if courses_file.exists():
                         try:
                             previous_courses = courses_file.read_text(encoding='utf-8').strip().split('\n')

readme.md

@@ -54,6 +54,24 @@ python3 monitor.py
 # 按 Ctrl+B 然后按 D 离开会话
 ```
 
+## Docker 部署（推荐）
+
+> 运行日志和缓存文件会写入 `./data/`，配置文件挂载为只读。
+
+```bash
+# 1) 准备配置文件（同级目录下的 config.ini）
+# 2) 启动
+docker compose up -d --build
+
+# 查看日志
+docker logs -f gpa-monitor
+```
+
+**测试模式：**
+```bash
+docker compose run --rm gpa-monitor python /app/monitor.py --config /data/config.ini --test
+```
+
 ## 功能特点
 
 ✅ **智能检测** - 检测新增课程（而非简单的页面变化）  
@@ -193,4 +211,4 @@ tmux attach -t grade_monitor
 
 ## 许可证
 
-MIT License
+MIT License

修复说明_2026-01-21.md

@@ -1,202 +0,0 @@
-# 问题修复说明
-
-## 问题描述
-
-服务器运行时出现以下错误：
-```
-[WARNING] 未能提取到成绩信息，返回原始文本
-[INFO] 成绩无变化（共 0 门课程）
-```
-
-## 根本原因
-
-成绩提取函数 `extract_grade_info` 在某些情况下无法正确解析HTML页面，返回原始HTML文本，导致 `parse_courses` 函数无法从原始HTML中提取课程信息。
-
-可能的具体原因包括：
-1. BeautifulSoup 库未安装
-2. 登录会话失效，返回的是登录页面
-3. 学校网页结构发生变化
-4. 网络问题导致获取的HTML不完整
-
-## 修复内容
-
-### 1. 改进 `extract_grade_info` 函数 (monitor.py 第286-370行)
-
-**新增功能：**
-- ✅ 检测登录页面，返回特殊标记 `LOGIN_REQUIRED`
-- ✅ 支持多种表格选择器（`gridtable`, `dataList`, 关键词搜索）
-- ✅ 添加详细的调试日志（表头、行数等）
-- ✅ 自动保存问题HTML到 `debug_page.html` 便于排查
-- ✅ 提供成功提取的反馈信息
-
-**改进代码片段：**
-```python
-# 检查是否是登录页面
-if soup.find('input', {'name': 'username'}) or soup.find('input', {'name': 'password'}):
-    logger.error("检测到登录页面，可能需要重新登录")
-    return "LOGIN_REQUIRED"
-
-# 尝试多种方式查找成绩表格
-table = soup.find('table', {'class': 'gridtable'})
-if not table:
-    table = soup.find('table', {'id': 'dataList'})
-if not table:
-    # 尝试查找任何包含成绩相关标题的表格
-    for tbl in soup.find_all('table'):
-        headers = tbl.find_all('th')
-        if headers and any('课程名称' in th.get_text() or '成绩' in th.get_text() for th in headers):
-            table = tbl
-            logger.info("通过表头关键词找到成绩表格")
-            break
-```
-
-### 2. 改进 `parse_courses` 函数 (monitor.py 第347-378行)
-
-**新增功能：**
-- ✅ 检测 `LOGIN_REQUIRED` 标记
-- ✅ 检测未解析的原始HTML
-- ✅ 添加详细的解析日志
-- ✅ 统计解析的课程数量
-
-**改进代码片段：**
-```python
-# 检查是否需要重新登录
-if grade_text == "LOGIN_REQUIRED":
-    logger.warning("检测到登录失效，需要重新登录")
-    return []
-
-# 检查是否是原始HTML（未成功解析的标记）
-if '<html' in grade_text.lower() or '<body' in grade_text.lower():
-    logger.warning("检测到未解析的HTML内容，成绩提取可能失败")
-    logger.debug(f"文本前100字符: {grade_text[:100]}")
-    return []
-```
-
-### 3. 添加调试模式 (monitor.py 第743-797行)
-
-**新增命令行参数：**
-```bash
-python3 monitor.py --debug    # 启用详细日志
-```
-
-**功能：**
-- 显示详细的调试信息
-- 帮助快速定位问题
-- 不影响正常运行模式
-
-### 4. 创建诊断工具
-
-**新增文件：**
-1. **diagnose.sh** - 自动诊断脚本
-   - 检查依赖库安装
-   - 运行测试并分析结果
-   - 提供修复建议
-
-2. **故障排查指南.md** - 详细的排查文档
-   - 常见问题及解决方案
-   - 调试流程说明
-   - 联系支持信息
-
-3. **更新 常见问题解决.md** - 添加新问题说明
-4. **更新 readme.md** - 添加快速诊断指引
-
-## 使用方法
-
-### 方式1：自动诊断（推荐）
-
-```bash
-cd ~/grade_monitor
-chmod +x diagnose.sh
-./diagnose.sh
-```
-
-### 方式2：手动调试
-
-```bash
-# 1. 检查依赖
-pip3 install -r requirements.txt
-
-# 2. 运行调试模式
-python3 monitor.py --test --debug
-
-# 3. 查看输出
-cat .last_grade_content.txt
-cat debug_page.html | head -50
-
-# 4. 如果正常，重启服务
-systemctl restart grade-monitor
-```
-
-### 方式3：启用服务调试模式
-
-编辑服务配置：
-```bash
-sudo nano /etc/systemd/system/grade-monitor.service
-```
-
-修改启动命令：
-```ini
-ExecStart=/usr/bin/python3 /home/yourusername/grade_monitor/monitor.py --debug
-```
-
-重新加载：
-```bash
-sudo systemctl daemon-reload
-sudo systemctl restart grade-monitor
-```
-
-## 预期效果
-
-### 正常运行时的日志
-```
-[DEBUG] 找到总平均绩点: 总平均绩点：3.85
-[DEBUG] 找到成绩表格
-[DEBUG] 表头: ['学年学期', '课程代码', '课程序号', '课程名称', ...]
-[DEBUG] 找到 15 行成绩数据
-[INFO] 成功提取成绩信息，共 17 行
-[DEBUG] 开始解析成绩，共 17 行
-[DEBUG] 解析到课程: 高等数学A(1)
-[DEBUG] 解析到课程: 线性代数
-...
-[INFO] 共解析到 15 门课程
-[INFO] 成绩无变化（共 15 门课程）
-```
-
-### 出错时的日志
-```
-[WARNING] 未找到成绩表格
-[WARNING] 未能提取到成绩信息，页面可能结构异常
-[INFO] 已保存HTML到 /home/user/grade_monitor/debug_page.html 供调试
-[WARNING] 检测到未解析的HTML内容，成绩提取可能失败
-[DEBUG] 文本前100字符: <!DOCTYPE html><html><head>...
-[INFO] 共解析到 0 门课程
-```
-
-## 优势
-
-1. **更好的错误提示** - 明确告知问题原因
-2. **自动保存调试信息** - debug_page.html 便于排查
-3. **灵活的表格查找** - 支持多种网页结构
-4. **详细的日志** - 方便追踪每一步
-5. **完善的文档** - 提供多种解决方案
-
-## 注意事项
-
-1. **不要过度使用调试模式** - 生产环境可能不需要
-2. **定期检查 debug_page.html** - 了解实际获取的内容
-3. **及时更新表格选择器** - 如果学校网页结构变化
-4. **保护敏感信息** - debug_page.html 可能包含个人信息
-
-## 下一步
-
-如果问题仍未解决：
-1. 查看 `debug_page.html` 的实际内容
-2. 检查HTML中的表格结构
-3. 可能需要调整 `extract_grade_info` 中的选择器
-4. 咨询开发者或提交 Issue
-
----
-
-**版本：** 2026-01-21  
-**修复人员：** GitHub Copilot  
-**测试状态：** 待用户测试确认

修复说明_2026-01-22_重复日志和自动重登录.md

@@ -1,94 +0,0 @@
-# 修复说明 - 2026年1月22日
-
-## 修复的问题
-
-### 1. 日志重复输出问题
-**现象**：每条日志都会输出两次
-
-**原因**：`logging.basicConfig()` 配置会在模块每次被导入时重复添加处理器，导致日志重复输出。
-
-**解决方案**：
-- 使用 `if not logger.handlers:` 检查，确保处理器只被添加一次
-- 设置 `logger.propagate = False` 防止日志传播到根记录器
-- 使用显式的logger配置替代 `basicConfig`
-
-### 2. 连续异常时自动重新登录
-**现象**：当连续多次出现解析失败、获取页面失败或网络错误时，程序不会尝试重新登录，导致持续失败。
-
-**解决方案**：
-在以下场景达到3次连续失败时，自动触发重新登录：
-
-1. **获取成绩页面失败**
-   - 连续3次失败 → 尝试重新登录
-   - 登录成功 → 重置错误计数，继续监控
-   - 登录失败 → 继续累积错误计数
-
-2. **网络错误（页面过短）**
-   - 连续3次网络错误 → 尝试重新登录
-   - 登录成功 → 重置错误计数
-   - 登录失败 → 继续累积错误计数
-
-3. **解析课程失败（0门课程）**
-   - 连续3次解析失败 → 尝试重新登录
-   - 登录成功 → 重置错误计数
-   - 登录失败 → 发送通知，可能需要人工介入
-
-## 技术细节
-
-### 日志配置改进
-```python
-# 旧代码
-logging.basicConfig(...)
-logger = logging.getLogger(__name__)
-
-# 新代码
-logger = logging.getLogger(__name__)
-if not logger.handlers:
-    # 配置处理器
-    logger.propagate = False
-```
-
-### 重新登录逻辑
-```python
-if consecutive_errors >= 3:
-    logger.warning("⚠️  尝试重新登录以解决问题...")
-    if self.login():
-        logger.info("✓ 重新登录成功，重置错误计数")
-        consecutive_errors = 0
-        continue
-    else:
-        logger.error("✗ 重新登录失败")
-```
-
-## 使用建议
-
-1. **重启服务**：修改后需要重启服务使改动生效
-   ```bash
-   sudo systemctl restart grade-monitor
-   ```
-
-2. **查看日志**：确认日志不再重复
-   ```bash
-   sudo journalctl -u grade-monitor -f
-   # 或
-   tail -f monitor.log
-   ```
-
-3. **监控效果**：
-   - 日志应该只输出一次
-   - 连续3次异常会自动尝试重新登录
-   - 重新登录成功后会显示 "✓ 重新登录成功"
-
-## 预期效果
-
-- ✅ 日志不再重复输出
-- ✅ 连续3次异常自动重新登录
-- ✅ 重新登录成功后重置错误计数
-- ✅ 减少因登录会话过期导致的持续失败
-- ✅ 更好的容错性和自愈能力
-
-## 注意事项
-
-- 重新登录会记录在日志中，便于追踪
-- 如果重新登录失败，仍会继续累积错误计数
-- 达到5次最大连续错误后会发送邮件通知

常见问题解决.md

@@ -1,239 +0,0 @@
-# 常见问题解决方案
-
-## 🚨 "未能提取到成绩信息，共 0 门课程" 错误
-
-### 问题症状
-日志中反复出现：
-```
-[WARNING] 未能提取到成绩信息，返回原始文本
-[INFO] 成绩无变化（共 0 门课程）
-```
-
-### 快速诊断
-
-#### 1. 检查 BeautifulSoup 是否安装
-```bash
-python3 -c "import bs4; print('BeautifulSoup4 已安装')"
-```
-
-如果报错，安装依赖：
-```bash
-pip3 install beautifulsoup4
-# 或完整安装所有依赖
-pip3 install -r requirements.txt
-```
-
-#### 2. 使用调试模式查看详细信息
-```bash
-cd ~/grade_monitor
-python3 monitor.py --test --debug
-```
-
-查看输出中是否有：
-- ✅ "找到成绩表格"
-- ✅ "找到 X 行成绩数据"
-- ✅ "共解析到 X 门课程"
-
-如果都没有，继续下一步。
-
-#### 3. 检查是否登录失效
-查看日志是否有 "检测到登录页面" 错误：
-```bash
-grep "登录页面\|LOGIN_REQUIRED" ~/grade_monitor/monitor.log
-```
-
-如果有，重启服务重新登录：
-```bash
-systemctl restart grade-monitor
-```
-
-#### 4. 查看调试HTML文件
-程序会自动保存问题页面到 `debug_page.html`：
-```bash
-cd ~/grade_monitor
-
-# 检查文件是否存在
-ls -lh debug_page.html
-
-# 查看是否包含成绩表格
-grep -i "gridtable\|课程名称\|成绩" debug_page.html | head -5
-```
-
-### 解决方案
-
-**方案1：重新安装依赖并重启**
-```bash
-cd ~/grade_monitor
-pip3 install -r requirements.txt
-systemctl restart grade-monitor
-tail -f monitor.log
-```
-
-**方案2：启用调试模式监控**
-编辑服务配置：
-```bash
-sudo nano /etc/systemd/system/grade-monitor.service
-```
-
-修改 ExecStart 行：
-```ini
-ExecStart=/usr/bin/python3 /home/yourusername/grade_monitor/monitor.py --debug
-```
-
-重新加载并重启：
-```bash
-sudo systemctl daemon-reload
-sudo systemctl restart grade-monitor
-tail -f ~/grade_monitor/monitor.log
-```
-
-**方案3：如果是网页结构变化**
-查看详细排查指南：
-```bash
-cat ~/grade_monitor/故障排查指南.md
-```
-
----
-
-## ⚠️ "请不要过快点击" 错误
-
-### 问题原因
-学校WebVPN系统有严格的访问频率限制，短时间内多次访问会被拦截。
-
-### 解决方案
-
-#### 1. 停止手动测试至少5分钟
-```bash
-# 如果在服务器上运行，请先停止程序
-ps aux | grep monitor.py
-kill <进程ID>
-
-# 等待至少5分钟后再重新测试
-```
-
-#### 2. 修改配置文件增加间隔
-编辑 `config.ini`：
-```ini
-[monitor]
-# 将检查间隔改为5分钟（300秒）或更长
-CHECK_INTERVAL = 300
-
-# 增加请求延迟
-REQUEST_DELAY = 15
-
-# 增加重试间隔
-RETRY_DELAY = 60
-```
-
-#### 3. 使用正确的测试方式
-```bash
-# 测试前确保距离上次测试至少5分钟
-python3 monitor.py --test
-
-# 如果还是被拦截，等10分钟后再试
-```
-
-#### 4. 部署后不要频繁测试
-```bash
-# 部署systemd服务后，让它自动运行
-sudo systemctl start grade-monitor
-
-# 只通过日志查看运行情况
-tail -f monitor.log
-
-# 不要反复启停服务或手动测试
-```
-
-## 🔍 如何判断系统正常工作
-
-### 方法1：查看日志
-```bash
-tail -f ~/grade_monitor/monitor.log
-```
-
-正常日志应该类似：
-```
-2026-01-17 10:00:00 - INFO - 开始检查成绩变化...
-2026-01-17 10:00:05 - INFO - 登录成功！
-2026-01-17 10:00:10 - INFO - 成功获取成绩页面
-2026-01-17 10:00:12 - INFO - 未发现新课程
-2026-01-17 10:02:00 - INFO - 等待下次检查...
-```
-
-### 方法2：查看保存的成绩文件
-```bash
-cat ~/.last_grade_content.txt
-```
-
-如果文件包含完整的课程列表和GPA，说明系统工作正常。
-
-### 方法3：查看进程状态
-```bash
-ps aux | grep monitor.py
-```
-
-如果有进程在运行，说明程序正在监控中。
-
-## 📝 最佳实践
-
-### 测试阶段
-1. **首次测试**：运行 `python3 monitor.py --test`
-2. **等待5分钟**
-3. **再次测试**：确认能正常获取成绩
-4. **等待10分钟**
-5. **部署服务**：配置systemd或使用tmux
-
-### 运行阶段
-1. **设置CHECK_INTERVAL为120秒或更长**
-2. **让程序自动运行，不要手动干预**
-3. **每天查看一次日志即可**
-4. **不要频繁重启服务**
-
-### 如果被持续拦截
-1. **停止所有监控程序**
-2. **等待至少30分钟**
-3. **将CHECK_INTERVAL改为600秒（10分钟）**
-4. **重新启动，让它慢慢运行**
-5. **确认稳定后，再逐步减少间隔**
-
-## 🛠️ 调试技巧
-
-### 查看实际响应内容
-```bash
-cat ~/grade_monitor/.debug_response.html
-```
-
-如果文件包含"请不要过快点击"，说明请求被拦截。
-
-### 检查登录状态
-```bash
-# 运行测试模式
-python3 monitor.py --test
-
-# 查看是否成功登录
-grep "登录成功" monitor.log
-```
-
-### 测试网络连接
-```bash
-# 测试是否能访问学校网站
-curl -I https://webvpn.neu.edu.cn
-
-# 测试SMTP邮件服务器
-nc -zv smtp.163.com 465
-```
-
-## 💡 温馨提示
-
-1. **成绩更新频率不高**：学校不会每分钟更新成绩，建议CHECK_INTERVAL设为120-300秒
-2. **避免过度监控**：频繁访问可能被学校系统封禁IP
-3. **合理设置间隔**：既能及时发现新成绩，又不会触发限流
-4. **信任自动化**：部署后让程序自己运行，不需要频繁检查
-
-## 📞 仍然无法解决？
-
-1. 检查配置文件中的账号密码是否正确
-2. 确认能在浏览器中正常登录学校系统
-3. 查看 `.debug_response.html` 了解实际响应
-4. 将CHECK_INTERVAL增加到600秒（10分钟）
-5. 考虑只在特定时间段运行（如每天上午10点和下午3点）

快速更新指南.md

@@ -1,179 +0,0 @@
-# 快速更新指南 - 修复会话过期问题
-
-## 🎯 本次更新解决的问题
-
-**症状：** 程序运行几小时后出现：
-```
-[WARNING] 未能提取到成绩信息，返回原始文本
-[INFO] 成绩无变化（共 0 门课程）
-```
-
-**原因：** 登录会话过期，需要重新登录
-
-**解决：** ✅ 自动检测并重新登录
-
----
-
-## 📦 方式1：快速更新（推荐）
-
-### 在本地打包
-```bash
-cd /mnt/e/50425/Documents/Github/GPA_Monitoring
-chmod +x 打包.sh
-./打包.sh
-```
-
-### 上传到服务器
-```bash
-scp gpa_monitor.tar.gz 用户名@服务器IP:~/
-```
-
-### 在服务器上更新
-```bash
-# 停止服务
-systemctl stop grade-monitor
-
-# 备份
-cd ~/grade_monitor
-cp monitor.py monitor.py.backup.$(date +%Y%m%d)
-
-# 解压更新
-tar -xzf ~/gpa_monitor.tar.gz -C ~/grade_monitor
-
-# 赋予权限
-chmod +x diagnose.sh
-
-# 重启服务
-systemctl restart grade-monitor
-
-# 查看日志（确认自动重新登录功能）
-tail -f monitor.log
-```
-
----
-
-## 🔧 方式2：仅更新 monitor.py
-
-如果只想更新主程序文件：
-
-### 在本地
-```bash
-# WSL中
-cd /mnt/e/50425/Documents/Github/GPA_Monitoring
-scp monitor.py 用户名@服务器IP:~/grade_monitor/
-```
-
-### 在服务器上
-```bash
-systemctl stop grade-monitor
-systemctl start grade-monitor
-tail -f ~/grade_monitor/monitor.log
-```
-
----
-
-## ✅ 验证更新成功
-
-查看日志，应该能看到：
-
-### 正常运行
-```
-[INFO] 开始新一轮检查
-[INFO] 获取成绩页面...
-[DEBUG] 找到成绩表格
-[INFO] 成功提取成绩信息，共 17 行
-[INFO] 共解析到 15 门课程
-[INFO] 成绩无变化（共 15 门课程）
-```
-
-### 会话过期时自动处理
-```
-[WARNING] 检测到会话过期，尝试重新登录...
-[INFO] 开始登录统一身份认证...
-[INFO] 登录成功！成功访问成绩页面
-[INFO] 重新登录成功，继续监控
-```
-
----
-
-## 🔍 故障诊断
-
-如果更新后仍有问题：
-
-```bash
-cd ~/grade_monitor
-
-# 运行诊断工具
-./diagnose.sh
-
-# 或手动测试
-python3 monitor.py --test --debug
-
-# 查看生成的调试文件
-ls -lh debug_page.html
-cat .last_grade_content.txt
-```
-
----
-
-## 📋 更新内容详细列表
-
-1. **会话过期自动重新登录** (monitor.py 第697-718行)
-   - 检测 `LOGIN_REQUIRED` 状态
-   - 自动调用 `login()` 重新登录
-   - 记录详细日志
-
-2. **改进成绩提取** (monitor.py 第286-370行)
-   - 检测登录页面
-   - 支持多种表格选择器
-   - 自动保存 debug_page.html
-   - 添加详细调试日志
-
-3. **改进课程解析** (monitor.py 第375-405行)
-   - 检测登录失效
-   - 识别未解析的HTML
-   - 统计课程数量
-
-4. **新增调试模式**
-   - `python3 monitor.py --debug`
-   - 显示详细运行信息
-
-5. **新增诊断工具**
-   - `diagnose.sh` - 自动检测并给出建议
-   - `故障排查指南.md` - 详细排查步骤
-
----
-
-## 💡 最佳实践
-
-1. **定期检查日志**（每天1-2次即可）
-   ```bash
-   tail -n 50 ~/grade_monitor/monitor.log
-   ```
-
-2. **不要频繁重启服务**
-   - 新版本会自动处理会话过期
-   - 只在真正出问题时才重启
-
-3. **保留备份**
-   ```bash
-   # 每次更新前都会自动备份
-   ls -lh ~/grade_monitor/monitor.py.backup.*
-   ```
-
-4. **合理设置检查间隔**
-   - 建议 120-300 秒
-   - 避免触发学校系统限流
-
----
-
-## 🆘 需要帮助？
-
-1. 先运行诊断工具：`./diagnose.sh`
-2. 查看故障排查指南：`cat 故障排查指南.md`
-3. 查看详细修复说明：`cat 修复说明_2026-01-21.md`
-
----
-
-**更新日期：** 2026-01-21  
-**版本：** v2.0 - 自动会话恢复版

打包.sh

@@ -1,97 +0,0 @@
-#!/bin/bash
-
-# 成绩监控系统 - 打包脚本
-# 用途：打包项目文件准备上传到服务器
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-ARCHIVE_NAME="gpa_monitor.tar.gz"
-
-echo "========================================="
-echo "  成绩监控系统 - 打包工具"
-echo "========================================="
-echo ""
-
-cd "$SCRIPT_DIR"
-
-# 检查config.ini是否存在
-if [ ! -f "config.ini" ]; then
-    echo "⚠️  警告: 未找到 config.ini"
-    echo "   请先配置 config.ini 文件"
-    echo ""
-    read -p "是否继续打包？(y/n): " continue_pack
-    if [ "$continue_pack" != "y" ]; then
-        echo "已取消"
-        exit 0
-    fi
-fi
-
-echo "📦 正在打包必需文件..."
-echo ""
-
-# 打包必需文件
-tar -czf "$ARCHIVE_NAME" \
-    monitor.py \
-    config.ini \
-    requirements.txt \
-    setup_python.sh \
-    diagnose.sh \
-    grade-monitor.service \
-    readme.md \
-    "常见问题解决.md" \
-    "故障排查指南.md" \
-    "重启服务.md" \
-    "Debian服务器部署指南.md" \
-    "修复说明_2026-01-21.md" \
-    2>/dev/null
-
-if [ $? -eq 0 ]; then
-    echo "✓ 打包成功！"
-    echo ""
-    echo "压缩包信息："
-    ls -lh "$ARCHIVE_NAME"
-    echo ""
-    echo "📄 包含文件："
-    tar -tzf "$ARCHIVE_NAME"
-    echo ""
-    echo "========================================="
-    echo "✨ 本次更新内容（2026-01-21）："
-    echo "  1. ✅ 修复会话过期问题 - 自动重新登录"
-    echo "  2. ✅ 改进成绩提取 - 多种表格选择器"
-    echo "  3. ✅ 新增调试模式 - --debug 参数"
-    echo "  4. ✅ 新增诊断工具 - diagnose.sh"
-    echo "  5. ✅ 自动保存 debug_page.html 供排查"
-    echo ""
-    echo "========================================="
-    echo "📤 上传到服务器："
-    echo "   scp $ARCHIVE_NAME 用户名@服务器IP:~/"
-    echo ""
-    echo "🔧 服务器上部署更新："
-    echo "   # 停止服务"
-    echo "   systemctl stop grade-monitor"
-    echo ""
-    echo "   # 备份旧文件"
-    echo "   cd ~/grade_monitor"
-    echo "   cp monitor.py monitor.py.backup"
-    echo ""
-    echo "   # 解压新文件"
-    echo "   tar -xzf ~/gpa_monitor.tar.gz -C ~/grade_monitor"
-    echo ""
-    echo "   # 赋予执行权限"
-    echo "   chmod +x diagnose.sh"
-    echo ""
-    echo "   # 重启服务"
-    echo "   systemctl restart grade-monitor"
-    echo ""
-    echo "   # 查看日志"
-    echo "   tail -f monitor.log"
-    echo ""
-    echo "🔍 如果遇到问题："
-    echo "   cd ~/grade_monitor"
-    echo "   ./diagnose.sh"
-    echo ""
-    echo "详细说明: 修复说明_2026-01-21.md"
-    echo "========================================="
-else
-    echo "✗ 打包失败"
-    exit 1
-fi

故障排查指南.md

@@ -1,143 +0,0 @@
-# 故障排查指南
-
-## 问题：未能提取到成绩信息，共 0 门课程
-
-### 症状
-日志中出现以下警告信息：
-```
-[WARNING] 未能提取到成绩信息，返回原始文本
-[INFO] 成绩无变化（共 0 门课程）
-```
-
-### 可能的原因和解决方案
-
-#### 1. BeautifulSoup 未安装
-**检查方法：**
-```bash
-python3 -c "import bs4; print('BeautifulSoup4 已安装')"
-```
-
-**解决方案：**
-```bash
-pip3 install beautifulsoup4
-# 或
-pip3 install -r requirements.txt
-```
-
-#### 2. 登录会话失效
-**症状：** 日志中可能出现 "检测到登录页面" 的错误
-
-**解决方案：**
-```bash
-# 停止服务
-systemctl stop grade-monitor
-
-# 重新启动服务（会重新登录）
-systemctl start grade-monitor
-```
-
-#### 3. 网页结构变化
-**检查方法：**
-程序会自动保存 HTML 到 `debug_page.html`，查看这个文件：
-```bash
-# 查看 debug_page.html 是否存在
-ls -la ~/grade_monitor/debug_page.html
-
-# 查看 HTML 内容，确认是否有成绩表格
-grep -i "gridtable\|课程名称\|成绩" ~/grade_monitor/debug_page.html
-```
-
-**解决方案：**
-如果网页结构变化，可能需要修改 `monitor.py` 中的 `extract_grade_info` 函数。
-当前支持的表格选择器：
-- `<table class="gridtable">`
-- `<table id="dataList">`
-- 任何包含"课程名称"或"成绩"关键词的表格
-
-#### 4. 启用调试模式排查
-
-**临时测试（手动运行）：**
-```bash
-cd ~/grade_monitor
-python3 monitor.py --test --debug
-```
-
-**查看详细日志：**
-```bash
-# 启用调试模式修改服务配置
-sudo nano /etc/systemd/system/grade-monitor.service
-
-# 在 ExecStart 行添加 --debug 参数
-ExecStart=/usr/bin/python3 /home/yourusername/grade_monitor/monitor.py --debug
-
-# 重新加载并重启
-sudo systemctl daemon-reload
-sudo systemctl restart grade-monitor
-
-# 查看详细日志
-tail -f ~/grade_monitor/monitor.log
-```
-
-#### 5. 检查保存的文件
-```bash
-cd ~/grade_monitor
-
-# 查看上次提取的成绩内容
-cat .last_grade_content.txt
-
-# 查看上次保存的 HTML（如果存在）
-cat .last_grade_page.html | head -50
-
-# 查看调试 HTML（出错时自动保存）
-cat debug_page.html | head -50
-```
-
-### 调试流程
-
-1. **启用调试模式运行一次测试：**
-   ```bash
-   cd ~/grade_monitor
-   python3 monitor.py --test --debug
-   ```
-
-2. **查看输出信息：**
-   - 是否显示 "找到成绩表格"？
-   - 是否显示 "找到 X 行成绩数据"？
-   - 是否显示 "共解析到 X 门课程"？
-
-3. **检查保存的文件：**
-   ```bash
-   # 如果生成了 debug_page.html
-   ls -lh debug_page.html
-   
-   # 查看是否包含成绩表格
-   grep -A 5 "gridtable\|dataList" debug_page.html
-   ```
-
-4. **如果是网页结构问题：**
-   - 将 `debug_page.html` 发给开发者
-   - 或者自己检查 HTML 中的表格结构
-   - 修改 `extract_grade_info` 函数中的选择器
-
-### 常见问题
-
-**Q: 日志显示"未找到成绩表格"**
-A: 网页结构可能变化，需要查看 debug_page.html 确认实际的表格结构
-
-**Q: 日志显示"找到 0 行成绩数据"**
-A: 表格找到了但是为空，可能是：
-   - 登录失效，返回的是空表格
-   - 实际就是没有成绩数据
-
-**Q: 日志显示"检测到未解析的HTML内容"**
-A: BeautifulSoup 解析失败，返回了原始 HTML。检查：
-   1. BeautifulSoup 是否正确安装
-   2. HTML 格式是否正确（查看 debug_page.html）
-
-### 联系支持
-
-如果以上方法都无法解决问题，请提供：
-1. `monitor.log` 的最后 50 行
-2. `debug_page.html` 文件（如果存在）
-3. `.last_grade_content.txt` 文件内容
-4. 是否能手动登录并看到成绩页面

部署.md

@@ -1,516 +0,0 @@
-# 服务器部署指南
-
-本文档详细说明如何将成绩监控系统部署到Linux服务器上。
-
-## 📋 前置要求
-
-- Linux服务器（Debian/Ubuntu/CentOS等）
-- Python 3.7+
-- 服务器能访问外网
-- SSH访问权限
-
-## 📦 准备文件
-
-### 需要上传的文件
-
-```
-grade_monitor/
-├── monitor.py           # 主程序（必需）
-├── config.ini          # 配置文件（必需）
-├── requirements.txt    # Python依赖（必需）
-├── setup_python.sh     # 安装脚本（必需）
-└── readme.md          # 说明文档（可选）
-```
-
-### 打包文件
-
-在Windows本地执行：
-
-```powershell
-# 方法1：使用tar（需要WSL或Git Bash）
-tar -czf grade_monitor.tar.gz monitor.py config.ini requirements.txt setup_python.sh readme.md
-
-# 方法2：使用7-Zip或WinRAR手动打包
-```
-
-## 🚀 部署步骤
-
-### 步骤1：修改配置文件
-
-**在上传前**，确保 `config.ini` 中填入了正确的信息：
-
-```ini
-[login]
-USERNAME = 你的学号
-PASSWORD = 你的密码
-LOGIN_URL = ...
-GRADE_URL = ...
-
-[email]
-SENDER_EMAIL = your_email@163.com
-SENDER_PASSWORD = SMTP授权码
-RECEIVER_EMAIL = 接收通知的邮箱
-
-[monitor]
-CHECK_INTERVAL = 60
-REQUEST_DELAY = 5
-MAX_RETRIES = 3
-RETRY_DELAY = 10
-```
-
-### 步骤2：上传到服务器
-
-#### 方法A：使用SCP上传
-
-```bash
-# 上传打包文件
-scp grade_monitor.tar.gz username@server-ip:/home/username/
-
-# 或直接上传文件
-scp monitor.py config.ini requirements.txt setup_python.sh username@server-ip:/home/username/grade_monitor/
-```
-
-#### 方法B：使用SFTP上传
-
-```bash
-sftp username@server-ip
-put grade_monitor.tar.gz
-exit
-```
-
-#### 方法C：使用FTP客户端
-
-使用FileZilla、WinSCP等工具上传文件。
-
-### 步骤3：连接到服务器
-
-```bash
-ssh username@server-ip
-```
-
-### 步骤4：解压和安装
-
-```bash
-# 创建工作目录
-mkdir -p ~/grade_monitor
-cd ~/grade_monitor
-
-# 添加执行权限
-chmod +x setup_python.sh
-
-# 运行安装脚本
-./setup_python.sh
-```
-
-安装脚本会自动：
-- 更新apt包列表
-- 安装Python3和pip
-- 创建虚拟环境
-- 安装所需的Python包（requests、beautifulsoup4）
-
-### 步骤5：测试运行
-
-```bash
-# 激活虚拟环境
-source venv/bin/activate
-
-# 测试模式运行
-python3 monitor.py --test
-```
-
-**检查输出：**
-- 是否成功登录
-- 是否获取到成绩页面
-- 查看提取的成绩内容
-
-```bash
-# 查看提取的成绩
-cat .last_grade_content.txt
-
-# 应该看到类似这样的内容：
-# ============================================================
-# 总平均绩点：4.3471
-# ============================================================
-# 
-# 学年学期  |  课程代码  |  课程序号  |  课程名称  |  ...
-# --------------------------------------------------------
-# 2025-2026 秋季  |  A0801051020  |  A095478  |  C++程序设计  |  ...
-```
-
-## 🔄 后台运行方案
-
-### 方案A：使用systemd（推荐，适合长期运行）
-
-#### 1. 创建服务文件
-
-```bash
-sudo nano /etc/systemd/system/grade-monitor.service
-```
-
-#### 2. 填入以下内容
-
-```ini
-[Unit]
-Description=Grade Monitoring Service
-After=network.target
-
-[Service]
-Type=simple
-User=你的用户名
-WorkingDirectory=/home/你的用户名/grade_monitor
-ExecStart=/home/你的用户名/grade_monitor/venv/bin/python3 /home/你的用户名/grade_monitor/monitor.py
-Restart=always
-RestartSec=30
-StandardOutput=append:/home/你的用户名/grade_monitor/monitor.log
-StandardError=append:/home/你的用户名/grade_monitor/monitor.log
-
-[Install]
-WantedBy=multi-user.target
-```
-
-**注意：** 将上面的"你的用户名"替换为实际的Linux用户名
-
-#### 3. 启动服务
-
-```bash
-# 重载systemd配置
-sudo systemctl daemon-reload
-
-# 启用开机自启
-sudo systemctl enable grade-monitor
-
-# 启动服务
-sudo systemctl start grade-monitor
-
-# 查看服务状态
-sudo systemctl status grade-monitor
-```
-
-#### 4. 管理服务
-
-```bash
-# 查看日志
-sudo journalctl -u grade-monitor -f
-
-# 停止服务
-sudo systemctl stop grade-monitor
-
-# 重启服务
-sudo systemctl restart grade-monitor
-
-# 禁用开机自启
-sudo systemctl disable grade-monitor
-```
-
-### 方案B：使用tmux（简单，适合临时运行）
-
-#### 1. 安装tmux
-
-```bash
-# Debian/Ubuntu
-sudo apt install tmux
-
-# CentOS/RHEL
-sudo yum install tmux
-```
-
-#### 2. 创建会话并运行
-
-```bash
-# 创建新的tmux会话
-tmux new -s grade_monitor
-
-# 激活虚拟环境
-source venv/bin/activate
-
-# 运行程序
-python3 monitor.py
-```
-
-#### 3. 离开和重连会话
-
-```bash
-# 离开会话（程序继续运行）
-# 按键：Ctrl+B，然后按 D
-
-# 重新连接到会话
-tmux attach -t grade_monitor
-
-# 查看所有会话
-tmux ls
-
-# 关闭会话
-tmux kill-session -t grade_monitor
-```
-
-### 方案C：使用screen
-
-```bash
-# 安装screen
-sudo apt install screen
-
-# 创建新会话
-screen -S grade_monitor
-
-# 激活环境并运行
-source venv/bin/activate
-python3 monitor.py
-
-# 离开会话：Ctrl+A，然后按 D
-
-# 重新连接
-screen -r grade_monitor
-
-# 查看所有会话
-screen -ls
-```
-
-### 方案D：使用nohup（最简单）
-
-```bash
-# 激活虚拟环境
-source venv/bin/activate
-
-# 后台运行
-nohup python3 monitor.py > monitor.log 2>&1 &
-
-# 查看进程
-ps aux | grep monitor.py
-
-# 停止进程
-kill <进程ID>
-```
-
-## 📊 监控和维护
-
-### 查看运行状态
-
-```bash
-# 方法1：查看日志文件
-tail -f ~/grade_monitor/monitor.log
-
-# 方法2：查看systemd日志（如果使用systemd）
-sudo journalctl -u grade-monitor -n 50 -f
-
-# 方法3：查看进程
-ps aux | grep monitor.py
-```
-
-### 查看当前成绩
-
-```bash
-cd ~/grade_monitor
-cat .last_grade_content.txt
-```
-
-### 手动触发测试
-
-```bash
-cd ~/grade_monitor
-source venv/bin/activate
-python3 monitor.py --test
-```
-
-## 🔧 常见问题
-
-### 问题1：连接服务器失败
-
-**可能原因：**
-- SSH端口被防火墙拦截
-- 服务器IP或用户名错误
-- SSH密钥配置问题
-
-**解决方法：**
-```bash
-# 指定端口
-ssh -p 端口号 username@server-ip
-
-# 使用密钥
-ssh -i /path/to/key.pem username@server-ip
-```
-
-### 问题2：无法访问学校网站
-
-**可能原因：**
-- 服务器在校外，需要VPN
-- 防火墙拦截
-
-**解决方法：**
-- 使用校内服务器
-- 配置代理
-- 联系网络管理员
-
-### 问题3：pip安装失败
-
-**解决方法：**
-```bash
-# 更新pip
-pip install --upgrade pip
-
-# 使用国内镜像
-pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
-
-# 或使用清华源
-pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/
-```
-
-### 问题4：权限不足
-
-**解决方法：**
-```bash
-# 修改文件所有者
-sudo chown -R username:username ~/grade_monitor
-
-# 修改执行权限
-chmod +x ~/grade_monitor/*.sh
-```
-
-### 问题5：邮件发送失败
-
-**解决方法：**
-- 确认SMTP授权码正确（不是邮箱密码）
-- 检查服务器能否访问smtp.163.com（端口465）
-- 查看详细错误信息：`tail -f monitor.log`
-
-```bash
-# 测试网络连接
-telnet smtp.163.com 465
-# 或
-nc -zv smtp.163.com 465
-```
-
-## 🔐 安全建议
-
-### 1. 保护配置文件
-
-```bash
-# 限制config.ini权限
-chmod 600 ~/grade_monitor/config.ini
-
-# 确保只有自己能访问
-ls -la ~/grade_monitor/config.ini
-# 应显示：-rw------- 1 username username
-```
-
-### 2. 使用环境变量（可选）
-
-不在配置文件中存储明文密码，而是使用环境变量：
-
-```bash
-# 设置环境变量
-export GRADE_USERNAME="你的学号"
-export GRADE_PASSWORD="你的密码"
-export EMAIL_PASSWORD="SMTP授权码"
-
-# 添加到.bashrc使其永久生效
-echo 'export GRADE_USERNAME="你的学号"' >> ~/.bashrc
-echo 'export GRADE_PASSWORD="你的密码"' >> ~/.bashrc
-echo 'export EMAIL_PASSWORD="SMTP授权码"' >> ~/.bashrc
-```
-
-### 3. 定期更新
-
-```bash
-# 更新系统
-sudo apt update && sudo apt upgrade
-
-# 更新Python包
-cd ~/grade_monitor
-source venv/bin/activate
-pip install --upgrade requests beautifulsoup4
-```
-
-## 📱 监控建议
-
-### 设置监控脚本
-
-创建一个检查脚本 `check_status.sh`：
-
-```bash
-#!/bin/bash
-
-# 检查进程是否运行
-if pgrep -f "monitor.py" > /dev/null; then
-    echo "✓ 监控程序正在运行"
-else
-    echo "✗ 监控程序未运行！"
-    # 可以在这里添加重启逻辑
-    # systemctl start grade-monitor
-fi
-
-# 检查最近的日志
-echo ""
-echo "最近的日志："
-tail -n 5 ~/grade_monitor/monitor.log
-```
-
-### 定期检查（使用cron）
-
-```bash
-# 编辑crontab
-crontab -e
-
-# 添加以下行（每天检查一次）
-0 12 * * * /home/username/grade_monitor/check_status.sh
-```
-
-## 🎯 完整部署示例
-
-```bash
-# === 本地操作（Windows/WSL） ===
-cd E:\50425\Documents\Github\GPA_Monitoring
-tar -czf grade_monitor.tar.gz monitor.py config.ini requirements.txt setup_python.sh readme.md
-scp grade_monitor.tar.gz user@server.com:~/
-
-# === 服务器操作 ===
-ssh user@server.com
-
-# 解压和安装
-mkdir -p ~/grade_monitor
-cd ~/grade_monitor
-tar -xzf ../grade_monitor.tar.gz
-chmod +x setup_python.sh
-./setup_python.sh
-
-# 测试
-source venv/bin/activate
-python3 monitor.py --test
-cat .last_grade_content.txt
-
-# 配置systemd服务
-sudo nano /etc/systemd/system/grade-monitor.service
-# （填入服务配置）
-
-sudo systemctl daemon-reload
-sudo systemctl enable grade-monitor
-sudo systemctl start grade-monitor
-sudo systemctl status grade-monitor
-
-# 查看日志
-sudo journalctl -u grade-monitor -f
-```
-
-## ✅ 部署检查清单
-
-- [ ] 文件已上传到服务器
-- [ ] config.ini配置正确（账号、密码、邮箱）
-- [ ] 运行setup_python.sh安装依赖
-- [ ] 测试模式运行成功
-- [ ] 成绩提取格式正确
-- [ ] 配置后台运行（systemd/tmux/screen）
-- [ ] 服务正常启动
-- [ ] 日志输出正常
-- [ ] 收到测试邮件
-- [ ] 设置文件权限（chmod 600 config.ini）
-
-## 📞 获取帮助
-
-如果遇到问题：
-1. 查看 `monitor.log` 了解详细错误
-2. 运行 `python3 monitor.py --test` 测试
-3. 检查 `.debug_response.html` 了解实际响应
-4. 查看 `readme.md` 了解更多功能说明
-
----
-
-部署完成后，系统将自动监控成绩变化，有新课程成绩时会立即发送邮件通知！

重启服务.md

@@ -1,56 +0,0 @@
-# 停止服务
-systemctl stop grade-monitor
-
-# 备份旧文件
-cp monitor.py monitor.py.backup
-
-# 解压新文件（会覆盖）
-tar -xzf ~/gpa_monitor.tar.gz -C ~/grade_monitor --strip-components=0
-
-# 或者只替换 monitor.py
-# 你可以直接编辑：
-nano monitor.py
-
-# 重启服务
-systemctl restart grade-monitor
-
-# 查看实时日志
-tail -f monitor.log
-
-# 或查看最近的日志（包含完整上下文）
-tail -n 100 monitor.log
-
----
-
-## 常见问题：会话过期
-
-如果日志显示：
-```
-[WARNING] 未能提取到成绩信息，返回原始文本
-[INFO] 成绩无变化（共 0 门课程）
-```
-
-**原因：** 登录会话几小时后自动过期
-
-**解决：** 最新版本已自动处理！代码会：
-1. 检测到 "LOGIN_REQUIRED" 时自动重新登录
-2. 记录日志：`[WARNING] 检测到会话过期，尝试重新登录...`
-3. 重新登录后继续监控
-
-**手动重启（如果需要）：**
-```bash
-systemctl restart grade-monitor
-tail -f monitor.log
-```
-
-**调试模式（查看详细信息）：**
-```bash
-# 手动测试
-python3 monitor.py --test --debug
-
-# 或修改服务启用调试
-sudo nano /etc/systemd/system/grade-monitor.service
-# 在 ExecStart 添加 --debug 参数
-sudo systemctl daemon-reload
-sudo systemctl restart grade-monitor
-```

间歇性解析失败说明.md

@@ -1,194 +0,0 @@
-# 间歇性解析失败说明
-
-## 现象
-
-日志显示偶尔出现解析失败，但下一次检查又恢复正常：
-
-```
-17:34:05 - ✅ 成功提取成绩信息，共 14 行，解析到 8 门课程
-17:36:12 - ✅ 成功提取成绩信息，共 14 行，解析到 8 门课程
-17:38:12 - ❌ 未找到成绩表格，解析到 0 门课程
-17:40:12 - ✅ 成功提取成绩信息，共 14 行，解析到 8 门课程
-```
-
-## 原因分析
-
-这种**偶发性失败**通常是由以下原因造成的：
-
-### 1. 网络波动（最常见）
-- 数据包传输不完整
-- HTML内容被截断
-- 连接临时中断
-
-### 2. 服务器临时问题
-- 学校服务器负载高
-- 短暂的维护或重启
-- 数据库查询超时
-
-### 3. WebVPN不稳定
-- WebVPN代理服务波动
-- SSL握手失败
-- 重定向异常
-
-### 4. 时机问题
-- 正好在服务器更新数据时访问
-- 缓存失效瞬间
-- 负载均衡切换
-
-## 改进措施
-
-最新版本已添加**智能容错机制**：
-
-### 1. 识别网络错误
-```python
-# 检查HTML内容长度
-if len(html) < 100:
-    logger.warning(f"HTML内容过短({len(html)}字节)，可能是网络问题")
-    return "NETWORK_ERROR"
-```
-
-### 2. 自动重试
-当检测到临时性问题时：
-- ⚠️ 记录警告但不立即报错
-- ⏱️ 等待30秒后自动重试
-- 📊 只有连续3次失败才报警
-
-### 3. 智能判断
-```python
-# 如果解析到0门课程，但之前有课程记录
-if len(current_courses) == 0 and len(previous_courses) > 0:
-    logger.warning("可能是临时问题，30秒后重试")
-    time.sleep(30)
-    continue  # 重新检查
-```
-
-### 4. 保存诊断信息
-- 自动保存 `debug_page.html`
-- 记录HTML长度和摘要
-- 便于事后分析
-
-## 预期行为
-
-### 场景1：偶发性失败（正常）
-```
-[INFO] 成功提取成绩信息，共 14 行
-[INFO] 共解析到 8 门课程
-[INFO] 等待 120 秒...
-
-[WARNING] 未找到成绩表格
-[WARNING] ⚠️ 解析到0门课程，但之前有8门课程，可能是临时问题
-[INFO] 等待 30 秒后重试...
-
-[INFO] 成功提取成绩信息，共 14 行  ← 重试成功
-[INFO] 共解析到 8 门课程
-```
-
-### 场景2：持续失败（异常）
-```
-[WARNING] ⚠️ 解析到0门课程，可能是临时问题
-[WARNING] 连续异常: 1/5
-
-[WARNING] ⚠️ 解析到0门课程，可能是临时问题
-[WARNING] 连续异常: 2/5
-
-[WARNING] ⚠️ 解析到0门课程，可能是临时问题
-[WARNING] 连续异常: 3/5  ← 开始报警
-
-[ERROR] 连续 3 次无法解析课程（之前有8门课程）
-```
-
-## 判断标准
-
-### ✅ 无需担心的情况
-- 失败率 < 20%（每10次失败少于2次）
-- 失败后1-2次就恢复
-- 日志显示"等待30秒后重试"
-- 下次检查自动恢复正常
-
-### ⚠️ 需要关注的情况
-- 失败率 > 20%
-- 连续3次以上失败
-- 日志显示"连续异常"
-- 出现错误通知邮件
-
-### 🚨 需要处理的情况
-- 连续5次以上失败
-- 失败率 > 50%
-- 伴随"会话过期"错误
-- debug_page.html 显示登录页面
-
-## 统计失败率
-
-使用诊断工具检查：
-```bash
-cd ~/grade_monitor
-./diagnose.sh
-
-# 或手动统计
-echo "成功次数: $(grep -c '共解析到 [1-9]' monitor.log)"
-echo "失败次数: $(grep -c '共解析到 0 门课程' monitor.log)"
-```
-
-## 最佳实践
-
-### 1. 不要过度担心
-- 偶尔失败是**正常现象**
-- 程序已自动处理
-- 只要失败率低，无需干预
-
-### 2. 定期检查日志
-```bash
-# 查看最近的失败记录
-grep "未找到成绩表格\|共解析到 0 门课程" ~/grade_monitor/monitor.log | tail -10
-
-# 查看是否自动恢复
-tail -n 20 ~/grade_monitor/monitor.log
-```
-
-### 3. 调整检查间隔
-如果失败频繁，可以增加间隔：
-```ini
-[monitor]
-CHECK_INTERVAL = 180  # 从120改为180秒
-```
-
-### 4. 信任自动化
-- 程序会自动重试
-- 只有持续失败才报警
-- 收到邮件通知时再处理
-
-## 何时需要手动干预
-
-只在以下情况需要重启服务：
-
-1. **连续多次收到错误邮件**
-2. **日志显示持续登录失败**
-3. **debug_page.html 显示异常内容**
-4. **失败率持续超过50%**
-
-其他情况下，让程序自动处理即可。
-
-## 对比：改进前 vs 改进后
-
-### 改进前
-```
-17:38:12 - ❌ 未找到成绩表格，解析到 0 门课程
-17:38:12 - 成绩无变化（共 0 门课程）  ← 直接当作正常
-17:38:12 - 等待 120 秒...              ← 不重试
-17:40:12 - 开始新一轮检查              ← 2分钟后才重试
-```
-
-### 改进后
-```
-17:38:12 - ❌ 未找到成绩表格
-17:38:12 - ⚠️ 解析到0门课程，但之前有8门课程
-17:38:12 - 等待 30 秒后重试...        ← 智能判断
-17:38:42 - ✅ 成功提取成绩信息         ← 快速恢复
-```
-
----
-
-**总结：** 偶发性失败是网络应用的正常现象。新版本通过智能重试机制，将影响降到最低。只要失败率在合理范围（<20%），无需任何手动干预。
-
-**更新日期：** 2026-01-21  
-**版本：** v2.1 - 智能容错版