更新 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 统一标注。
This commit is contained in:
+17
-8
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user