Merge pull request #10 from Awesome-Embedded-Learning-Studio/feat/standardize_widgets

feat(widget): status-led 中等档标杆改造 + 实例库双文档 pilot + 构建化简

Author: Charliechen114514

README.md

@@ -143,9 +143,9 @@ cd Tutorial_AwesomeQt
 
 | 控件 | 说明 |
 |------|------|
-| [`StatusLED`](widget/statusled/) | 状态指示灯，支持 4 种状态（Normal/Warning/Error/Offline）+ 闪烁动画 |
+| [`StatusLED`](widget/status-led/) | 状态指示灯，支持 4 种状态（Normal/Warning/Error/Offline）+ 闪烁动画 |
 
-**构建系统：** [`cmake/AwesomeQtWidgets.cmake`](cmake/AwesomeQtWidgets.cmake) 提供了 `awesomeqt_add_widget()` 等函数，支持 INDIVIDUAL（每个控件独立 `.so`）和 MERGED（合并为单一库）两种构建模式。
+**构建方式：** 每个控件是 STATIC 库 + 独立 demo，根 [`widget/CMakeLists.txt`](widget/CMakeLists.txt) 统一配置（C++17 / AUTOMOC / find_package Qt6）。`cd widget && cmake -B build && cmake --build build` 即可构建。
 
 ---
 

cmake/AwesomeQtWidgets.cmake

@@ -30,7 +30,7 @@ const VOLUMES: Volume[] = [
   { name: 'beginner-04-network', srcDir: 'beginner/04-qtnetwork', urlPrefix: '/beginner/04-qtnetwork' },
   { name: 'beginner-05-other', srcDir: 'beginner/05-other-modules', urlPrefix: '/beginner/05-other-modules' },
   { name: 'beginner-06-qml', srcDir: 'beginner/06-qml', urlPrefix: '/beginner/06-qml' },
-  { name: 'engineering-s1', srcDir: 'engineering/session1', urlPrefix: '/engineering/session1' },
+  { name: 'engineering-instances', srcDir: 'engineering/instances', urlPrefix: '/engineering/instances' },
   { name: 'advanced', srcDir: 'advanced', urlPrefix: '/advanced' },
   { name: 'expert', srcDir: 'expert', urlPrefix: '/expert' },
 ]

scripts/build.ts

@@ -25,5 +25,5 @@ export const navZh: DefaultTheme.NavItem[] = [
       { text: '06 · QML 现代界面', link: '/advanced/06-qml/' },
     ],
   },
-  { text: '项目实战', link: '/engineering/session1/' },
+  { text: '项目实战', link: '/engineering/' },
 ]

site/.vitepress/config/nav.ts

@@ -5,28 +5,28 @@
 ## 速览
 
 ```
-入门 137✅ · 进阶 134✅ · 专家 2/102（COW机制原理✅ + COW容器实战✅，见 expert.md）· 实例库 1·~1075（首波39见 instance-library.md）· examples 271✅
+入门 137✅ · 进阶 134✅ · 专家 2/102（01·02 COW 已审结，见 expert.md）· 实例库 1·status-led 中等档标杆✅(双文档pilot)·~1075 · examples 271✅
 ```
 
 ## 工作区 → 文件
 
 | 工作区 | 文件 | 内容 | 当下 |
 |---|---|---|---|
-| 专家层 | [expert.md](expert.md) | 102 篇源码拆解（每篇带 qt_src 行号证据） | ✅ 01 COW 落盘待作者审 |
-| 实例库 | [instance-library.md](instance-library.md) | widget/app/model/industrial 成品 + 两套文档 | ✅ 首波39 可产 |
+| 专家层 | [expert.md](expert.md) | 102 篇源码拆解（每篇带 qt_src 行号证据） | ✅ 01·02 COW 已审结 |
+| 实例库 | [instance-library.md](instance-library.md) | widget/app/model/industrial 成品 + 两套文档 | ✅ status-led pilot 产出·待验格式放量 |
 | 基建 | [infra.md](infra.md) | P0/P0.5/P1/P4 + widget 化简 + 地基债 | ✅ 能开干 |
 | embedded | [embedded.md](embedded.md) | Layer1 公共基础 + Layer2 板级 | ⚠ 生产方式待定 |
 | 延后 | [parked.md](parked.md) | community/translation/interactive/CI门… | 不投入 |
 
 ## 当下优先
 
-- 专家层：核实 01 篇落盘 → 推进后续
-- 实例库：status-led 改造 → 撑场批
-- 基建：widget/ 构建化简（决策已定、未落盘）
+- 专家层：01·02 已审结（gate 实质过）→ 推下一篇 qobject 元对象系统
+- 实例库：status-led 中等档标杆+双文档pilot✅ → 作者验格式放量 → 撑场批 toggle-switch
+- 基建：widget/ 构建化简✅ 已落盘（2026-06-14）→ P0 死链/风格扫描
 
 ## gate
 
-- 01 篇落盘待核实 → expert.md
+- ✅ 01·02 篇已审结（2026-06-13，gate 实质过）→ expert.md
 - embedded 生产方式待定 → embedded.md
 
 ## 全量实例清单（参考，非待办）

todo/README.md

@@ -2,20 +2,27 @@
 
 > 单点细节批量处理：扫出清单 → 逐个修。
 
-## widget/ 构建化简（主活·决策已定·未落盘）
-
-把 widget/ 从「发布库式」瘦身为「教学最小形态」。9 步（A4 须先于 A3，其余可调序）：
-1. **A4** 移 demo 子目录+重命名：`StatusLEDWindow.{h,cpp}`→`demo/status_led_window.{h,cpp}`、`main.cpp`→`demo/main.cpp`，改 include（类名不动）
-2. **A5** `src/status_led.cpp` 补 `#include <algorithm>`（真隐患·换发行版编不过）
-3. **A3** `statusled/CMakeLists.txt` 换 STATIC 库+demo+子目录自洽 AUTOMOC
-4. **A2** 根 `widget/CMakeLists.txt` 换 root-owns-config（砍 MERGE_MODE/install/cache 变量）
-5. **A1** 删 `cmake/AwesomeQtWidgets.cmake`(9.5k)+空 cmake/ 目录
-6. **B1** `.claude/example_style.md:110` 成员命名改尾下划线（`m_timer`→`led_size_`，代码零改动只改文档）
-7. **B2** 文件头统一 `@file`/`@brief`（禁 @author/@version/@date）
-8. **C1** 新增 `widget/README.md`（无「专门样本」提法）
-9. `.gitignore` 上移 widget/ 根 + 清旧产物 → **E1** `cd widget && cmake -B build && cmake --build build` 一次成功（/tmp 两轮实测过）
-
-边界：不做 SHARED/install/MERGE_MODE/双.so；不迁移 cmake 模块为专门样本；不改局部变量（camelCase 维持）。
+## widget/ 构建化简（✅ 已落盘 2026-06-14 · cmake 验证通过）
+
+把 widget/ 从「发布库式」瘦身为「教学最小形态」。9 步（A4 须先于 A3）已全部落盘：
+
+1. ✅ **A4** demo 子目录迁移：`StatusLEDWindow.{h,cpp}`→`demo/status_led_window.{h,cpp}`、`main.cpp`→`demo/main.cpp`，改 include（类名不动）
+2. ✅ **A5** `src/status_led.cpp` 补 `#include <algorithm>`
+3. ✅ **A3** `status-led/CMakeLists.txt` 换 STATIC 库 + `add_subdirectory(demo)`
+4. ✅ **A2** 根 `widget/CMakeLists.txt` 换 root-owns-config（砍 MERGE_MODE/install/cache）
+5. ✅ **A1** 删 `cmake/AwesomeQtWidgets.cmake` + 空 `cmake/` 目录
+6. ✅ **B1** `.claude/example_style.md` 成员命名改尾下划线（⚠ 见遗留①）
+7. ✅ **B2** 文件头统一 `@file`/`@brief`（删 @author/@version/@date）
+8. ✅ **C1** 新增 `widget/README.md`
+9. ✅ **E1** `cd widget && cmake -B build && cmake --build build` 一次成功（2026-06-14 实测）
+
+外加：目录重命名 `statusled`→`status-led`（instance-library kebab 拍板）；删冗余 `status-led/.gitignore`（根 `**/build/`·`**/.cache/` 已覆盖）。
+
+边界遵守：无 SHARED/install/MERGE_MODE/双.so；cmake 模块未迁为专门样本；局部变量 camelCase 未动。
+
+### 遗留（待作者定夺）
+
+- **①B1 命名规范与存量矛盾**：✅ 已决（2026-06-14）——采纳 (a) 维持现状。`example_style.md` 规范前瞻用尾下划线，`examples/` 存量 ~7674 处 `m_` 前缀不动（迁移收益低风险高）；新 example / 实例库按尾下划线生成。
 
 ## P0 清债
 - [ ] 死链校验（全库）

todo/infra.md

@@ -13,15 +13,15 @@
 ## 首波 39 件（已定 2026-06-12）
 
 ### 6 项已拍板
-1. statusled 降回 C++17（现 statusled/CMakeLists.txt:6 是 C++23 临时偏差）
+1. ✅ statusled 降回 C++17（widget 化简时已落，C++17 全局设在 widget/CMakeLists.txt）
 2. 控件命名统一 kebab：`widget/statusled/` → `widget/status-led/`
 3. model 先打穿 undo-redo-framework 作 reference，定范式再放量其余 17
 4. automotive-cluster 走纯 QtWidgets 自绘（不碰 QML，否则延后 QML Part6）
 5. industrial 整机允许 QtCharts，widget 单控件纯自绘
 6. industrial 链接 widget 库 .so 复用（speed-meter/circle-progress/line-chart 先落地）
 
 ### widget 栏（13·每族代表·自绘递进链）
-路径 `widget/<家族>/<控件名>/`。①status-led✅已落地 ②toggle-switch ③circle-progress ④speed-meter ⑤range-slider ⑥line-chart(纯QPainter) ⑦editable-table ⑧checkbox-tree ⑨checkbox-list ⑩log-viewer ⑪password-edit ⑫ip-edit(P1) ⑬fade-animation(P1)。未覆盖9族首波不碰：calendar/datetime/opengl/specialized/network-widget/data-display/multimedia/map/print。
+路径 `widget/<家族>/<控件名>/`。①status-led✅中等档标杆(颜色过渡+呼吸+Q_PROPERTY全+双文档pilot待验格式) ②toggle-switch ③circle-progress ④speed-meter ⑤range-slider ⑥line-chart(纯QPainter) ⑦editable-table ⑧checkbox-tree ⑨checkbox-list ⑩log-viewer ⑪password-edit ⑫ip-edit(P1) ⑬fade-animation(P1)。未覆盖9族首波不碰：calendar/datetime/opengl/specialized/network-widget/data-display/multimedia/map/print。
 
 ### app 栏（7旗舰+1拉伸·撑「真库不是片段」）
 路径 `app/<类目>/<应用名>/`。image-viewer★5 / sqlite-browser★5 / json-editor★4 / network-tool★4-5 / cpu-memory-monitor★4 / serial-tool★4-5(补入·嵌入式最高频) / tetris★4-5 / ~~audio-visualizer~~(拉伸·须先做模拟数据发生器)。
@@ -39,9 +39,9 @@
 
 ### 产出优先序（分批）
 
-> **[格式 gate]** status-led 改造时**同时产 Full + Handbook 两份样板** → 作者验过格式再放量（pilot 纪律，同专家道 01）｜ paradigm§3
+> **[格式 gate]** ✅ status-led 已产 Full 导览 + Handbook（入口+01/02/03+troubleshooting）两套样板（2026-06-14，落 `tutorial/engineering/instances/widget/status-led/`）→ 待作者验格式放量后续
 
-①阻断前置：status-led 改造(降C++17+重命名) + 确认 awesomeqt_add_widget 模板可批量抄
+①✅已完成：status-led 基建化简(降C++17+重命名+STATIC库) + 深度改造(中等档：颜色过渡 QPropertyAnimation + 呼吸 QVariantAnimation + Q_PROPERTY 全 + minimumSizeHint) + 双文档 pilot(成品导览 + 手搓手册 5 文件) → 作者验过格式再放量
 ②撑场批：status-led→toggle→circle→speed-meter→line-chart + image-viewer/sqlite-browser/serial-tool
 ③覆盖批：password/ip/range-slider/editable-table/checkbox-tree/list/log-viewer/fade + json-editor/network-tool/cpu-mem
 ④model reference：undo-redo-framework 1个→定范式→其余17放量