diff --git a/HANDOFF.md b/HANDOFF.md index b037806..41cd800 100644 --- a/HANDOFF.md +++ b/HANDOFF.md @@ -20,6 +20,12 @@ > 重新生成命令(幂等):`rm -rf p01 p03 build && python3 tools/gen_part1.py && python3 tools/gen_part3.py` +> ⚠️ **下文 §1–§10 为过程记录,未随本次完成同步重写**:其中出现的旧目录名 +> (`part1_cpp/`、`part3_qt_desktop/`)、旧状态(Part3「未开始」等)及 §3 的旧重生成 +> 命令均已**过时**。一切以本 banner、`README.md`、当前仓库实际目录(`p01/`、`p03/`)为准。 +> 2026-06-30 第三次会话已对全仓库脚本指引与 wiki 引用做端到端核实,结论:README 脚本全部 +> 有效、173 目标全绿、92 条 ERRATA 引用与实时 wiki 一致(详见本次会话记录)。 + --- ## 0. 任务总目标(来自用户原始需求) @@ -55,7 +61,8 @@ | `std_probe.py` + 多版本演示 + VERSION_NOTES.md | ❌ 未开始 | | 各章 README、SOURCE_PAGES.md、最终 clean build、git 提交 | ❌ 未开始 | -**git 状态**:仓库已 `git init`,但**尚未任何提交**(0 个 tracked 文件,所有内容 untracked)。 +**git 状态**(此表为历史快照,已被后续提交超越):首次提交为 `13b3ebb`(287 文件); +截至 2026-06-30 已有多次提交,HEAD 在 main 分支,工作区干净。以 `git log` 为准。 --- @@ -74,13 +81,15 @@ qt-course/ │ ├── docker/ # Dockerfile + docker_build_image/install_qt/build.sh │ └── wiki_data/ # 抓取的 wiki 正文+代码块(已拷入,生成器输入) ├── docs/ -│ └── ERRATA.md # 已记录 30 处修正(自动生成) -├── part1_cpp/ # 已生成 144 个目标(17 个 dir) -└── part3_qt_desktop/ # 空目录,待生成 +│ ├── ERRATA.md # Part1 代码修正记录(自动生成,72 条) +│ ├── ERRATA_part3.md # Part3 Qt 代码修正记录(自动生成,20 条) +│ ├── SOURCE_PAGES.md # pageId→章节映射表 +│ └── VERSION_NOTES.md # 版本相关概念验证记录 +├── p01/ # Part1:已生成 144 目标,深缩写 chNN/sNN(17 个 dir) +└── p03/ # Part3:已生成 29 目标,深缩写 chNN/sNN ``` -**Part1 当前目录形**(待用户要求改为深缩写,见 §5): -`part1_cpp/ch04_class_object/03_ctor_dtor/ctor_and_dtor.cpp` 等。 +**实际目录形**(深缩写已应用,见 §5):`p01/ch04/s03/ctor_and_dtor.cpp` 等。 --- @@ -89,8 +98,8 @@ qt-course/ ```bash cd /home/charles/workspaces/qt-course -# 重新生成 Part1 全部源码 + CMakeLists(幂等;每次改生成器后先 rm -rf part1_cpp) -rm -rf part1_cpp build && python3 tools/gen_part1.py +# 重新生成全部源码 + CMakeLists(幂等;每次改生成器后先 rm -rf p01 p03) +rm -rf p01 p03 build && python3 tools/gen_part1.py && python3 tools/gen_part3.py # 在宿主机配置+构建 Part1(无需 Qt) cmake -S . -B build -G Ninja -DBUILD_QT_PART=OFF -DCMAKE_BUILD_TYPE=Debug