v0.8.1 - Assembly BOM & Checklist
Release Notes: v0.8.1 - Assembly BOM & Checklist
Tag: v0.8.1-assembly-bom-checklist
Title: v0.8.1 - Assembly BOM & Checklist
Date: 2026-06-30
Overview
本次发布是 V8A（CadQuery Assembly 入门）的进阶篇，聚焦装配体的工程表达：
- BOM（Bill of Materials，零件清单）
- 爆炸图（Exploded View，教学性拉开组件位置）
- 装配检查清单（Assembly Checklist，结构化验证）
V8B 让读者理解"装配体 ≠ 几个 union 起来的实体"，而是需要被检查、拆解、归档的工程对象。
What's New
新增文档页面
| 文件 | 说明 |
|---|---|
examples/cadquery-assembly-bom-checklist.rst |
Assembly BOM 与检查清单（A-J 结构） |
页面结构（A-J 节）：
- A. 本页解决什么问题 — V8A 怎么组织多零件 → V8B 怎么被检查和归档
- B. 从 Assembly 到 BOM — 6 维度对比表
- C. 支架装配体 BOM 示例 — 4 组件 BOM 表格（编号/名称/数量/材料/作用/CadQuery 函数/检查要点）
- D. 爆炸图如何帮助理解装配 — 教学型表达
- E. 装配检查清单 — 8 类检查项
- F. CadQuery 代码补充 — BOM_DATA 结构化数据示例
- G. 装配体作品集归档 — 推荐归档清单
- H. 常见误区 — 8 条 V8B 特有误区
- I. 教学声明 — 教学性质
- J. 相关页面 — 5 个相关链接
新增资源包文件
| 文件 | 说明 |
|---|---|
assets/bracket-capstone/assembly/assembly-bom-template.md |
BOM 模板（含项目信息/BOM 表格/字段说明/同步要求） |
assets/bracket-capstone/assembly/assembly-checklist.md |
装配体检查清单（含 8 大类检查项 + 常见问题 + 完成签名） |
assets/bracket-capstone/assembly/assembly-notes-template.md |
装配说明模板（含组件关系/修改记录/导出记录/自评/CAM 关系） |
轻量增强现有代码
| 文件 | 更新内容 |
|---|---|
code/cadquery/bracket_assembly.py |
轻量增加 BOM_DATA（list of dict）+ print_bom() + total_bom_quantity() + main 中打印 BOM |
更新代码文档
| 文件 | 更新内容 |
|---|---|
code/cadquery/README.md |
加入 V8B 文件说明（BOM_DATA 与 Assembly 代码同步 + 资源包目录 + 作品集关联指南） |
新增 SVG 图示
| 文件 | 内容 | 尺寸 |
|---|---|---|
_static/diagrams/assembly-bom-relationship.svg |
Assembly 表达四件套（组件→BOM→检查清单→作品集归档） | 900×280 |
_static/diagrams/bracket-exploded-view.svg |
支架装配体教学爆炸图（4 组件 + 装配顺序编号 + 拆解箭头） | 900×460 |
导航更新
| 文件 | 更新内容 |
|---|---|
examples/index.rst |
新增"案例 R"（V8B）、推荐顺序 1→6、阅读顺序 20、toctree、对照表行 |
workflow-roadmap.rst |
新增任务 1.13（V8B）、CAD 设计工具列表更新 |
README.md |
版本号更新至 v0.8.1；新增"Assembly BOM 与检查清单"亮点；能力矩阵新增 V8B 行；快速入口新增 V8B 链接；版本演进新增 V8B 条目；教学亮点速览新增 V8B 条目 |
Build & Verification
| 项目 | 结果 |
|---|---|
| Build Command | sphinx-build -b html -W --keep-going . _build/html |
| Build Result | ✅ succeeded |
| Warning Count | 0 |
| py_compile (bracket_assembly.py) | ✅ OK（含新 BOM_DATA） |
| CadQuery import |
Related Pages
- V8A Assembly 入门：cadquery-assembly-intro
- V7D CadQuery 学习路径：cadquery-learning-path
- V6B 作品集模板：bracket-project-portfolio
- V6D 项目线收口：capstone-learning-path
Next Steps
候选方向：
- V8C — CadQuery 装配体进阶（约束、嵌套、动画演示）
- V9 — 第二 Capstone（带圆角/倒角/多特征的复杂零件）
- V9 — V6 作品集模板升级（加入 V8A/V8B 装配体补充）
- V9 — 真实软件截图（SolidWorks / FreeCAD / Fusion 360）
- V9 — 用 CadQuery 重做 V4B mini-lab（参数化立方体/圆柱体对比）
Teaching Notes
本版本是 V8 系列的第二篇：
- 不替代商业 CAD 装配设计工具
- 螺栓 / 销钉 / 材料是教学示意值
- 重点是让读者理解"装配体需要被检查和归档"
- BOM、爆炸图、检查清单是工程表达的基本功
Released by OpenClaw Agent (longxia2) on 2026-06-30.