Qt 示例窗口默认不再自动退出，仅离屏验证时自动退出

p03/ 生成产物与 docs/teaching/examples/ 手工示例里的 QTimer::singleShot
自动退出逻辑，从"始终 200ms 后退出"改为"仅当 QT_QPA_PLATFORM=offscreen
时才退出"。正常运行（有显示环境）窗口保持打开，需手动关闭；离屏自动化
验证（tools/run_qt.sh + QT_QPA_PLATFORM=offscreen）行为不变。

p03/ 改动来自重新生成 tools/gen_part3.py（AUTO_QUIT 常量加 qgetenv 判断），
未手改生成产物。QCoreApplication 控制台风格示例（qfile_basic 等）本就
执行完即退出，不受影响。

docs/teaching/examples/model_view/qt_model_view_basics.cpp

@@ -3,7 +3,7 @@
 //  用途：方案书「C++方向 Day3」要求的 Model/View 模型视图架构，仓库 p03/ 原有
 //        wiki 抓取内容未覆盖这一点，故补一个最小示例。
 //  配套文档：docs/teaching/examples/model_view/README.md
-//  离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh qt_model_view_basics
+//  离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh qt_model_view_basics（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -53,8 +53,11 @@ int main(int argc, char* argv[]) {
     ModelViewDemo w;
     w.resize(280, 220);
     w.show();
-    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
-    QTimer::singleShot(200, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）200ms 后自动退出；
+    // 正常运行（有显示环境）窗口保持打开，不自动退出。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(200, &app, &QApplication::quit);
+    }
     return app.exec();
 }
 

docs/teaching/examples/property_animation/qt_property_animation.cpp

@@ -3,7 +3,7 @@
 //  用途：方案书「C++方向 Day4」要求的 QPropertyAnimation 动画框架，仓库 p03/
 //        原有 wiki 抓取内容未覆盖这一点，故补一个最小示例。
 //  配套文档：docs/teaching/examples/property_animation/README.md
-//  离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh qt_property_animation
+//  离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh qt_property_animation（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -32,7 +32,10 @@ int main(int argc, char* argv[]) {
     anim->start(QAbstractAnimation::DeleteWhenStopped);
 
     window.show();
-    // 离屏/自动化验证：动画时长 800ms，额外等 300ms 确保播放完再退出
-    QTimer::singleShot(1100, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）自动退出：动画时长 800ms，
+    // 额外等 300ms 确保播放完再退出；正常运行窗口保持打开，不自动退出。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(1100, &app, &QApplication::quit);
+    }
     return app.exec();
 }

docs/teaching/examples/qss_styling/qt_qss_styling.cpp

@@ -3,7 +3,7 @@
 //  用途：方案书「C++方向 Day2」要求的 QSS 界面美化，仓库 p03/ 原有 wiki 抓取内容
 //        未覆盖这一点，故补一个最小示例。
 //  配套文档：docs/teaching/examples/qss_styling/README.md
-//  离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh qt_qss_styling
+//  离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh qt_qss_styling（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -50,8 +50,11 @@ int main(int argc, char* argv[]) {
     StyledPanel panel;
     panel.resize(240, 160);
     panel.show();
-    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
-    QTimer::singleShot(200, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）200ms 后自动退出；
+    // 正常运行（有显示环境）窗口保持打开，不自动退出。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(200, &app, &QApplication::quit);
+    }
     return app.exec();
 }
 

docs/teaching/examples/state_machine/qt_state_machine.cpp

@@ -4,7 +4,7 @@
 //        不需要额外模块），仓库 p03/ 原有 wiki 抓取内容未覆盖这一点，故补一个
 //        最小示例：一个“红灯/绿灯”两态按钮，点击在两态间切换。
 //  配套文档：docs/teaching/examples/state_machine/README.md
-//  离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh qt_state_machine
+//  离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh qt_state_machine（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -39,9 +39,12 @@ int main(int argc, char* argv[]) {
 
     button.show();
 
-    // 离屏/自动化验证：100ms 后模拟一次点击（red -> green），
-    // 再等 200ms 确认状态机正常处理完过渡后自动退出
-    QTimer::singleShot(100, &button, [&button]() { button.click(); });
-    QTimer::singleShot(300, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）：100ms 后模拟一次点击
+    // （red -> green），再等 200ms 确认状态机正常处理完过渡后自动退出。
+    // 正常运行（有显示环境）需用户手动点击按钮切换状态，窗口保持打开。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(100, &button, [&button]() { button.click(); });
+        QTimer::singleShot(300, &app, &QApplication::quit);
+    }
     return app.exec();
 }