1

readme.md

@@ -106,6 +106,44 @@ cat .last_grade_content.txt
 
 ## 故障排查
 
+### 快速诊断工具
+
+如果遇到问题，使用诊断脚本快速检查：
+```bash
+chmod +x diagnose.sh
+./diagnose.sh
+```
+
+该脚本会自动检查：
+- 依赖库是否安装
+- 能否成功提取成绩
+- 调试文件内容
+- 并提供修复建议
+
+### 问题：未能提取到成绩信息（共 0 门课程）
+
+**症状：** 日志显示 `[WARNING] 未能提取到成绩信息，返回原始文本`
+
+**快速修复：**
+```bash
+# 1. 检查并安装依赖
+pip3 install beautifulsoup4 requests
+
+# 2. 运行调试模式
+python3 monitor.py --test --debug
+
+# 3. 查看详细信息
+cat .last_grade_content.txt
+cat debug_page.html | head -50
+```
+
+**可能原因：**
+1. BeautifulSoup 库未安装
+2. 登录会话失效
+3. 网页结构变化
+
+**详细解决方案：** 查看 [故障排查指南.md](故障排查指南.md)
+
 ### 问题：登录失败
 
 **解决：**
@@ -125,6 +163,7 @@ cat .last_grade_content.txt
 **解决：**
 - 程序会自动增加等待时间
 - 可在 `config.ini` 中增大 `CHECK_INTERVAL`
+- 详见 [常见问题解决.md](常见问题解决.md)
 
 ## 配置说明