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

16 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
张宗平 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
张宗平 1a788a8278 移除 Docker 构建路线，改为 host 直装 Qt 5.14.2 + Qt Creator 4.11.0 
学生主要用 Windows，Docker 方案不再需要：删掉 tools/docker/ 及 README/HANDOFF/
CMakeLists 里的相关引用（含一处已失效的 docker_run.sh 死链接）。

install_qt_host.sh 现在同时装期号匹配的 Qt Creator 4.11.0：官方 .run 安装器
强制要求 Qt 账号登录且无 Skip 选项，改用 tools/extract_qtcreator_payload.py
直接从 .run 里定位、解出内嵌的 7z payload，绕开账号登录。提取逻辑先解到
staging 目录再原子替换到位，避免中途失败留下部分安装但被判定为"已装"；
候选 7z 复用同一临时文件，不会在磁盘上堆多份安装包大小的临时拷贝。
 2026-07-02 13:02:37 +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
张宗平 8e44203929 更新 HANDOFF：标注正文为历史记录，修正 §1/§2/§3 过时项 
正文 §1–§10 是完成前的过程记录，未随「全部完成」banner 同步重写。
本次核实发现其会误导新会话，做定向修正：
- banner 新增声明：§1–§10 为历史记录，旧目录名/旧状态/旧命令均过时，
  以 banner + README + 实际目录(p01/p03)为准；并附本次端到端核实结论
- §1 git 状态行：删除「尚未任何提交」的失实表述，改为以 git log 为准
- §2 仓库布局树：part1_cpp/→p01/、part3_qt_desktop/→p03/，补全 docs/ 与 ERRATA 条数
- §3 重生成命令：rm -rf part1_cpp build && gen_part1 → rm -rf p01 p03 build && gen_part1 && gen_part3

§4/§5 中保留的旧名属该节历史上下文（§5 即改名计划本身），已由 banner 统一标注。
 2026-06-30 16:31:32 +08:00
张宗平 b953bba8b2 修正 p03/ch11/rundata/file.txt：恢复生成器输出，消除幂等性偏差 
提交版内容 'line1: hello / line2: world' 恰好等于 qtextstream_io
运行时写入的产物（gen_part3.py:1169-1170），系误提交覆盖了生成器
ensure_rundata（:1306）产出的 'sample'。重生成后 git status 出现偏差，
故恢复为生成器输出，使 'rm -rf p01 p03 build && gen_part1/gen_part3' 真正幂等。

经核实（见本次 wiki 引用核验）：qtextstream_io 目标行为本身正确。
 2026-06-30 16:29:13 +08:00
张宗平 82d13516d7 新增 CLAUDE.md：项目工作流、构建命令、约定与红线 
按 CLAUDE.md 维护最佳实践浓缩 README/HANDOFF 中 agent 上手即需的信息：
- 纠正机构名（上程数据→四川大学）、补全损坏的 wiki 根页面链接
- 强调生成器驱动：p01/p03 源码由 tools/gen_*.py 产出，勿手改（会被重生成覆盖）
- 给出 Part1/Part3 构建+运行+offscreen 验证的可粘贴命令
- 目录深缩写约定、ASCII 目标名、C17/C++17 基线
- 四条红线（不改 wiki_data、必记 erratum、隔离 Qt 不碰系统 5.15、一文件一目标）
 2026-06-30 14:40:34 +08:00
张宗平 ec3433f0d0 update gitignore to exclude .env 2026-06-30 14:24:18 +08:00
张宗平 39644534ee 更新 HANDOFF：全部任务完成，标记当前状态 2026-06-30 14:17:56 +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