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 等）本就
执行完即退出，不受影响。

tools/gen_part3.py

@@ -10,8 +10,9 @@
 #                      外壳包裹，必要时补所需 QWidget/QMainWindow 子类骨架。
 #        - 'snippet'   纯签名/单语句/伪代码，不单独建目标，折进各章 README 作文档。
 #    * 每个目标 = 一个独立 add_executable；开 AUTOMOC（Q_OBJECT 类需 moc）。
-#    * 离屏运行友好：每个目标注入一个 QTimer::singleShot 让程序 200ms 后自动退出，
-#      便于 QT_QPA_PLATFORM=offscreen 自动化验证（窗口类目标）。
+#    * 离屏运行友好：每个窗口类目标注入一个 QTimer::singleShot，仅当检测到
+#      QT_QPA_PLATFORM=offscreen 时才在 200ms 后自动退出；正常运行（有显示环境）
+#      窗口保持打开，不会自动关闭。
 #    * 资源依赖（:/images/*.png 等）用脚本生成的纯色占位 png + .qrc 提供，qt5_add_resources。
 #    * Qt 代码修正（笔误/平台/过时 API）每处 record_erratum 进 docs/ERRATA.md（透明可审计）。
 #
@@ -275,8 +276,11 @@ TARGET_DATAFILES = {
 #  外壳模板：把一个「片段」包成可运行的 Qt 程序
 # ==============================================================================
 AUTO_QUIT = (
-    "    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）\n"
-    "    QTimer::singleShot(200, &app, &QApplication::quit);\n"
+    "    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）200ms 后自动退出；\n"
+    "    // 正常运行（有显示环境）窗口保持打开，不自动退出。\n"
+    "    if (qgetenv(\"QT_QPA_PLATFORM\") == \"offscreen\") {\n"
+    "        QTimer::singleShot(200, &app, &QApplication::quit);\n"
+    "    }\n"
 )
 AUTO_QUIT_CORE = (
     "    QTimer::singleShot(0, &app, &QCoreApplication::quit);\n"
@@ -373,7 +377,7 @@ def header_comment(pid, idx, stem):
         f"//  原文片段：[{pid}:{idx}]\n"
         "//  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication\n"
         "//        外壳、include、修正笔误）。详见 docs/ERRATA.md。\n"
-        "//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>\n"
+        "//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）\n"
         "// ============================================================================\n\n"
     )