charles/scuc-qt-course
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
29 Commits 1 Branch 0 Tags
d3e2e50f0ec05f967bf3fd4e98662bb36ed1c2fa
Commit Graph

22 Commits

Author SHA1 Message Date
张宗平 d3e2e50f0e mainwindow_showcase 教学示例：补 Designer 双版本表单（mainwindow2）+ 表单维护 
- 新增 mainwindow2.{h,cpp,ui}：用 Qt Designer 生成的第二套 QMainWindow 表单
  （File/Edit/Help 菜单 + actionOpen/actionAbout_Me），供课堂对比「代码搭界面」
  与「Designer 拖界面」两条路线。
- 新增子目录 CMakeLists.txt：供单独打开该示例构建（顶层 add_subdirectory 不递归，
  与 lineedit_eye_toggle / mandelbrot_renderer 同模式）。
- mainwindow.ui / mainwindow.qrc：经 Designer 重新保存后的表单与资源清单维护
  （iconset 去掉 resource= 显式引用、属性顺序由 Designer 重排）。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-07-09 16:51:33 +08:00
张宗平 01b264fe97 Day4 教学示例补三个：QDialog 综合 / QLineEdit 小眼睛 / 文件 IO（+顶层构建注册） 
- qdialog_showcase：wiki「6 对话框 QDialog」6.2–6.5 综合演示。含两套实现：
  · Designer 表单版（dialog.{h,cpp,ui} + resources.qrc + source.gif，QMovie 播 GIF）
  · 纯代码版（qt_dialog_showcase.cpp，单文件，QWidget 布满按钮逐个演示 QDialog 行为）
- lineedit_eye_toggle：子类化 QLineEdit，paintEvent 自绘小眼睛、mouseEvent 命中切换
  echoMode，并与内置 clear button 动态避让（读 objectName=="clearButton" 子 widget 几何）。
  含独立子目录 CMakeLists.txt 供单独打开（顶层 add_subdirectory 不递归）。
- file_io_demo：QFile/QTextStream/QDataStream/QFileInfo/QDir/QTextCodec/QJson 五主题
  综合示例，每个按钮产出一个文件落到 demo_output/ 便于课堂手动查看。

构建注册：examples/CMakeLists.txt 用 add_teaching_example 注册前两个纯代码示例，
mandelbrot 多源文件单独 add_executable；calculator_mainwindow_qss 加 themes.qrc 与
AUTORCC；all_teaching_examples 依赖列表同步补齐。

附 lineedit_eye_toggle 设计文档（docs/superpowers/specs）。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-07-09 16:51:09 +08:00
张宗平 993aa30a1c Mandelbrot 教学示例增强：主线程渲染循环至 ≥1.5s，让界面冻结肉眼可感 
实测单帧 820×640@256 单线程仅约 70ms，远低于人眼可感阈值，直接算一帧看不出
「冻结」。故「主线程渲染」按钮改为自适应循环渲染直到累计 ≥ 1500ms（实测 ~23 帧 /
1506ms），上限 100 轮防止极慢机器卡死过久。冻结的本质是事件循环被占用，循环只是
模拟任意一个占着 GUI 线程不返回的耗时操作。

- mandelbrot_widget.cpp：onRenderOnMainThread 改 do-while 循环，标签加「· N 轮」
- README.md：补冻结时长说明与课堂演示技巧
- 设计文档同步：三段式对比章节更新实测数据与冻结本质解释
- 新增 docs/teaching/MULTITHREADING.md：多线程教学要点汇总

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-07-09 16:50:46 +08:00
张宗平 12950da129 QSS 教学示例重构：双主题样式抽离为外部 .qss 资源（QFile 运行时加载） 
把原先硬编码在 mainwindow.cpp 里的 kLightQss / kDarkQss 两个 C++ 字符串，
拆成独立的 themes/light.qss、themes/dark.qss，由 themes.qrc（AUTORCC）编译进
可执行文件，applyStyle() 用 QFile 读取后 qApp->setStyleSheet 应用。

教学要点（QSS 最佳实践）：
- 样式与逻辑彻底分离：设计师/非程序员可直接编辑 .qss，不必碰 C++；
- 开发期改 .qss 重跑即生效，不必改 C++ 重编译；
- 多主题物理分文件，编辑器对 .qss 有语法高亮。

README 同步更新差异表、最佳实践条目与目录结构。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-07-09 16:50:31 +08:00
张宗平 6773f9b29e Day4 教学示例：Mandelbrot 分形渲染器（QPainter 绘图 + 多线程 + 事件处理综合演示） 
三段式对比直击 Day4 slides「主线程耗时=冻结」痛点：主线程渲染冻结 / 后台单线程不卡但慢 / 后台多线程不卡且快。
- QThreadPool + QRunnable 分水平条带并行，排队信号槽回传，epoch 版本号防过期覆盖
- wheelEvent 缩放（鼠标为锚）+ mouseEvent 拖拽平移 + paintEvent 画 QImage
- 子目录自带独立 CMakeLists.txt，可单独构建/共享（双模式约定同 lineedit_eye_toggle）
- 配套 README（概念/走读/双构建/5 踩坑点/练习）+ 设计规格
- 已验证：独立工程 offscreen 运行 exit=0；主工程构建 exit=0（w64devkit g++16 + mingw73 Qt5.14.2）

注：主工程 examples/CMakeLists.txt 的接入（mandelbrot + lineedit_eye_toggle + qdialog + themes 原子接入）与顶层 CMakeLists 本地调试改动未一并提交，待整体确认后单独提交。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-07-09 09:01:29 +08:00
张宗平 05a685c952 Day3 教学示例：增强版计算器接入 + QMainWindow/QSS 两版参考实现 
- calculator_designer_ext（Day2 增强版：表达式求值 + 括号，递归下降解析器）接入 cmake
- calculator_mainwindow（Day3 上午）：增强版计算器装进 QMainWindow，
  菜单/状态栏/历史停靠窗，纯代码 + 显式 connect，与 mainwindow_showcase 形成坑卡对照
- calculator_mainwindow_qss（Day3 下午）：上午版 + QSS 双主题美化（按键分色/伪状态/深浅切换）
- 验证 mainwindow_showcase（QMainWindow 六大组件综合演示，.ui + .qrc）
- OUTLINE_4DAY.md / ASSIGNMENTS.md Day3 衔接增强版起点 + 参考实现指引
- 补提交 Day2 calculator/ 与 calculator_designer/ 参考实现（CMakeLists 已引用）
- 全量构建 28/28，4 目标离屏自测退出码 0

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-07 22:59:05 +08:00
张宗平 ea6f12e7ac PPT 版本幻灯片：生成器 + 5 天讲稿备注（已去 AI 味） 
- tools/teaching_ppt/gen.py：python-pptx 生成引擎（页面内容与讲稿数据分离，
  幂等可重生成）；tools/teaching_ppt/day1..5.py：每天的页面+讲稿数据
- docs/teaching/ppt/day1..5.pptx：5 份 PPT 产物，页面内容对应 slides/*.html，
  详细讲稿（建议时长/讲法/演示/互动/过渡）只写入演讲者备注，不进主页面
- 讲稿去 AI 味：破折号过度堆砌 152 处砍到 6 处（7.8‰ → 0.3‰）、
  升华腔（分水岭/点燃探索欲）清零、重复词（现场 26→11）替换；
  保留教学口语生动感（你们/当堂/点破/埋点/回指）与【过渡】悬念钩子
- 生成方式：python-pptx 在隔离 venv 装，不影响系统 Python；
  改 day*.py 的 notes 字段后重跑 gen.py 即可幂等重生成
 2026-07-05 16:08:13 +08:00
张宗平 0f81edcc74 幻灯片按 4 天版重排：Day1 全 C++、Day3 启用 ch05/ch06、Day5 综合案例 
- Day1：开训 + 全天 C++（PRETEST 摸底环节内联；★所有权/★编译 vs 链接错误新卡）
- Day2：Qt 入门 + 信号槽 → 计算器（★栈控件双重释放/★lambda 第五参数/
  ★重复 connect/★QString 中文编码，均链到坑点复现示例）
- Day3：QMainWindow/QDialog（p03/ch05、ch06 首次排课，☆两张新卡）+ 布局/控件/QSS
- Day4：事件/绘图/QTableWidget + 文件系统/JSON（★工作目录/★文件编码）
- Day5：综合案例全天（student_manager 走查 + QThread 提升 + 流程规范）
- index.html 同步 4+1 结构；相对链接脚本校验 0 失效
 2026-07-05 12:49:44 +08:00
张宗平 1053ebf41c 教案基准切换：新版 10 天安排 + 4 天版大纲（含中初级误区审计） 
- docs/SCHEDULE_2026_10DAY.md：2026-07-05 新版 10 天安排正式文本，
  取代 TRAINING_PLAN_2026.md 旧执行计划作为课堂设计基准
- docs/teaching/OUTLINE_4DAY.md：4 天讲授 + Day5 综合案例的正式教案大纲，
  含逐天设计、旧主题去向决策（QSS→Day3、JSON→Day4、QThread→Day5 提升）、
  中初级学员误区盲点审计（10 张新坑卡：所有权/编码路径/连接语义三主线）、
  项目就绪度与高阶兴趣钩子评估
- OUTLINE.md 顶部加基准变更横幅，5 天版保留作历史参照与回退预案
- 顺带收编两篇此前未跟踪的自学文档 MODERN_CPP.md / MODERN_CPP_20PLUS.md
  （大纲与幻灯片多处链接它们）
 2026-07-05 12:49:32 +08:00
张宗平 6d1895d696 教学示例补 5 个：3 个坑点复现 + QTableWidget + Day5 学员管理器参考实现 
- pitfall_stack_widget / pitfall_lambda_capture / pitfall_double_connect：
  默认跑正确写法（离屏验证退出码 0），--crash / --dangle 开关课堂现场触发
  真实崩溃/悬空访问
- table_widget：QTableWidget 单元格事件最小示例（新安排 Day4「表格事件」）
- student_manager：Day5 综合案例参考实现，离屏自测覆盖 JSON round-trip
  与 QThread 后台导入闭环
- 均接入 examples/CMakeLists.txt 的 add_teaching_example，手工维护区不影响生成器
 2026-07-05 12:49:20 +08:00
张宗平 6640baffae 堂前测试重做：C++98 双平行卷（A/B）+ 三级难度梯度 
原版 10 题单卷难度近似、缺梯度、无平行卷，区分度不足。新版改为两份等价
平行卷（防抄袭 / 可重测），按 L1 初级 / L2 中级 / L3 进阶三级分布，补齐
对象切片、菱形继承二义、const 与指针等真正能筛出高阶学员的考点；严格限定
C++98，不涉及现代特性。所有代码题输出经 g++ -std=c++98 -pedantic-errors
实测核实，修正了 B 卷第 2 题链式 << 求值顺序未定义的缺陷（改为三行输出）。
 2026-07-04 13:31:33 +08:00
张宗平 9765865d13 Day1 C++ 回顾补一小节：C++11/14/17/20+ 新标准巡礼 
原「C++ 环境搭建/高级程序回顾」只覆盖语言老知识点（namespace/重载/引用/
虚析构/模板），没有让学员感受到 C++ 这些年一直在大幅进化。新增一个概念性
知识点（无配套代码，同 Vcpkg 那一条的先例）：按标准列出 C++11→20 的核心
新特性（auto/智能指针/移动语义/lambda → concepts/ranges/协程/模块），
并提醒"新标准≠生产环境能直接用"，挂钩本仓库自身的 C++17 基线选择和
tools/std_probe.py。OUTLINE.md 表格行/核心概念条目与 day1.html 新增幻灯片
一一对应。
 2026-07-02 16:41:48 +08:00
张宗平 a6743fcea0 每个「讲」知识点补齐核心概念 + 常见的坑，幻灯片与大纲同步 
此前一版「讲」部分基本只是代码演示（贴代码 + 一句出处说明），没有讲透
知识点本身的原理。改为覆盖清单原则：每个知识点在大纲里至少固定两项——
核心概念（是什么/为什么，不只是怎么写）+ 常见的坑（注意事项/误区），
课堂实际讲解深度按学员反馈现场调整，但大纲必须列全，以免漏讲或退化成
纯代码演示。

- custom.css 新增 .concept-box/.pitfall-box 卡片样式
- day1–5.html 每个知识点前插入对应卡片，内容与 OUTLINE.md 的覆盖清单一一对应
 2026-07-02 16:25:46 +08:00
张宗平 ee902fb1e0 幻灯片 index.html 里的 markdown 引用补上可点击链接 
配套大纲、方案书全文此前只是纯文本 <code> 提及，无法点击跳转；改成
<a> 链接（相对路径），配合 serve.py 的 .md 自动渲染即可正常打开。
 2026-07-02 16:24:50 +08:00
张宗平 1f66098277 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 等）本就
执行完即退出，不受影响。
 2026-07-02 16:14:49 +08:00
张宗平 8c154f5844 add support knowledge 2026-07-02 13:43:21 +08:00
张宗平 83620c0cf5 教案对齐官方方案书：重写为 5 天 C++/Qt 教学设计，补齐 6 个 Qt 技术缺口示例 
- docs/teaching/OUTLINE.md、slides/day1-5.html、index.html：替换此前自定义的
  4 天方案，严格对齐 docs/TRAINING_PLAN_2026.md「C++方向」Day1-5 课堂内容
  （Day6-10 为纯项目实作，不在教案范围）
- docs/teaching/examples/：官方方案书要求但仓库 p03/(wiki 抓取内容) 未覆盖的
  QSS/Model-View/JSON/QThread/QPropertyAnimation/QStateMachine 六个技术点，
  各补一个最小可运行示例 + README 教学文档，均已离屏验证跑通；手工维护，
  不属于 gen_part3.py 生成产物
- 根 CMakeLists.txt：接入 docs/teaching/examples 构建（BUILD_QT_PART 分支内），
  不改动生成器管理的 p01/p03 CMakeLists
- 任务卡改为目标/验收标准/基础知识参考三段式模板，custom.css 配套新增样式
- docs/teaching/PRETEST.md：10 题 10 分钟 C++ 摸底测验，验证教案假定的受众
  基础是否成立，并与 OUTLINE.md §0 的分层预案挂钩
 2026-07-02 11:31:44 +08:00
张宗平 6bb38563b5 new training plan 2026-07-02 09:37:53 +08:00
张宗平 7395a01e3d serve.py 支持 .md 自动渲染成 HTML，加 no-store 避免缓存误判 
vendor marked.js (MIT, 单文件, 35KB) 用于客户端渲染；直接导航 .md 走
渲染视图，?raw=1 保留原始文本入口。所有响应加 Cache-Control: no-store，
避免讲义反复修改时浏览器展示改之前的旧缓存（看起来像“没修复”）。
 2026-07-01 17:51:39 +08:00
张宗平 5d1f34524e 修复 serve.py 未声明 charset 导致中文乱码 
http.server 的 guess_type() 从不附带 charset，直接导航到 .cpp/.md 等
文本文件时浏览器猜编码猜错，中文注释显示乱码。Content-Type 统一补
charset=utf-8。
 2026-07-01 17:35:14 +08:00
张宗平 b89819d5db 新增 4 天教案大纲 + reveal.js 交互幻灯片（docs/teaching/） 
大纲按「3天C++强化(含OOP)+1天Qt桌面」组织，讲:练≈1:2.7；每个知识点直接
链接仓库真实代码文件与 ERRATA/VERSION_NOTES 里记录的具体坑。幻灯片
vendor 了 reveal.js 5.2.1（核心+highlight插件），零 CDN 依赖，配 serve.py
本地起服务（仅绑定 127.0.0.1）供离线播放，代码链接可点开查看源码。
 2026-07-01 16:51:12 +08:00
张宗平 13b3ebbe14 课程代码仓库初始化：Part1 (144) + Part3 (29) 全量生成与验证 
把川大 wiki「02.Qt方向」课程代码整理为 CMake 管理的可编译运行项目。

Part1 C/C++ 强化 (p01/, 144 目标, host gcc/g++ 构建, 全绿):
- 修复全部编译失败：补 <cstring>/<fstream>/<iomanip>/<vector> 等缺失头
  (common_fix + infer_stl_includes 自动检测注入)、修正 pause() 壳注入
  (改检测已转换后的 pause 调用)、namespace 提升出函数体、const 成员函数
  正确性、dedupe 不再破坏函数重载集、K&R 隐式 int / 动态异常规范等
  C++17 移除特性的可编译等价改写。
- 目录采用深缩写 p01/ch04/s03/ (原 part1_cpp/ch04_class_object/03_ctor_dtor)。

Part3 Qt 桌面 (p03/, 29 目标, 隔离 Qt 5.14.2 构建, 全绿):
- gen_part3.py: Qt 外壳模板 (main+QApplication+show, QTimer 自动退出便于
  offscreen 验证)、AUTOMOC + .moc include、rewrite_* 处理散文混入/重载/
  资源依赖、生成占位 png/gif + .qrc + rundata 样例数据。
- 修正 QLable 笔误、全角分号、.→->、Windows 路径、QApplication 阻塞事件
  循环改为 QCoreApplication 等。

任务1 概念/版本验证:
- tools/std_probe.py: 跨 -std= 编译探针 (--pedantic-errors 让已废除特性硬失败)。
- tools/demo_versions/: K&R 隐式 int、三目左值、void* 转换、enum 赋整、
  const 经指针、动态异常规范 共 6 个跨版本演示。
- docs/VERSION_NOTES.md: 每条「原文说法→C17/C++17 是否成立→何版本成立→已验证」。

文档: 顶层 README、docs/SOURCE_PAGES.md (页面→目录映射)、
docs/ERRATA.md (Part1 修正)、docs/ERRATA_part3.md (Part3 修正)。
另修复 tools/run.sh / run_qt.sh 的 ${1:?...} 引号语法 bug。

隔离 Qt 验证: ldd 0 系统 Qt 引用; 173/173 目标全绿; p03 offscreen 运行通过。
 2026-06-30 14:16:55 +08:00