Skip to content

v0.8.2 - Assembly Placement Mini-lab

Choose a tag to compare

View all tags
@conanxin conanxin released this 30 Jun 13:14
v0.8.2-assembly-placement-mini-lab
3e993bc

Release Notes: v0.8.2 - Assembly Placement Mini-lab

Tag: v0.8.2-assembly-placement-mini-lab
Title: v0.8.2 - Assembly Placement Mini-lab
Date: 2026-06-30

Overview

本次发布是 V8A/V8B 的第三篇：Assembly 进阶 mini-lab。V8C 聚焦组件如何被精确放置、组织和检查：

  • Placement / Location —— 显式位置表达
  • 全局 vs 局部坐标系 —— 坐标系区别
  • Nested Assembly —— 把相关组件组织成子装配
  • 教学型干涉检查 —— 结构化方法判断装配关系

V8A → V8B → V8C 是递进关系：V8A 多零件表达 → V8B 记录归档 → V8C 精确放置和检查。

What's New

新增文档页面

文件 说明
examples/cadquery-assembly-placement-mini-lab.rst Assembly Placement mini-lab 主页（A-K 结构）

页面结构（A-K 节）：

  • A. 本页解决什么问题 — V8A → V8B → V8C 递进
  • B. Placement / Location 是什么 — 核心概念
  • C. 全局坐标系 vs 局部坐标系 — 5 类对比表
  • D. Nested Assembly / 子装配 — bolt_pair 子装配 + 教学型组织
  • E. 教学型代码示例 — PLACEMENT_TABLE + 子装配构造
  • F. 干涉检查与间隙检查的概念 — 教学型 ≠ 真实 OCCT 仿真
  • G. 装配关系检查表 — 7 类检查项
  • H. 与 V8A/V8B 的关系 — 递进路径
  • I. 常见误区 — 8 条 V8C 特有误区
  • J. 教学声明 — 教学性质
  • K. 相关页面 — 5 个相关链接

新增代码文件

文件 说明
code/cadquery/bracket_nested_assembly.py 嵌套装配体（bolt_pair 子装配 + PLACEMENT_TABLE）

代码特性：

  • PLACEMENT_TABLE：教学型 dict 定义每个组件的 placement
  • build_bolt_pair_subassembly()：构造 2 螺栓子装配
  • build_nested_assembly()：构造主装配（base + vertical + bolt_pair + pin）
  • 嵌套结构清晰：子装配的 Location 是相对主装配，子装配内零件的 Location 是相对子装配
  • 教学声明：teaching example / not for industrial production / not a real interference solver

新增资源包文件

文件 说明
assets/bracket-capstone/assembly/placement-checklist.md Placement 检查清单（坐标系 + 组件位置 + 子装配 + 展示 vs 真实）
assets/bracket-capstone/assembly/interference-check-notes-template.md 干涉检查记录模板（6 类检查项 + 总结表 + 教学说明）

更新代码文档

文件 更新内容
code/cadquery/README.md 加入 V8C 文件说明（与 V8A 区别 / 学习目标 / 与 V8B 关系 / 资源包 / 环境不可用时）

新增 SVG 图示

文件 内容 尺寸
_static/diagrams/assembly-placement-coordinates.svg Assembly 坐标系与 Placement 关系图（全局 vs 局部 vs PLACEMENT_TABLE） 900×360
_static/diagrams/nested-assembly-structure.svg 嵌套装配体结构图（主装配 + 3 单独零件 + 1 子装配） 900×360

导航更新

文件 更新内容
examples/index.rst 新增"案例 S"（V8C）、推荐顺序 1→7、阅读顺序 21、toctree、对照表行
workflow-roadmap.rst 新增任务 1.14（V8C）、CAD 设计工具列表更新
README.md 版本号更新至 v0.8.2；新增"Assembly Placement mini-lab"亮点；能力矩阵新增 V8C 行；快速入口新增 V8C 链接；版本演进新增 V8C 条目；教学亮点速览新增 V8C 条目

Build & Verification

项目 结果
Build Command sphinx-build -b html -W --keep-going . _build/html
Build Result ✅ succeeded
Warning Count 0
py_compile (bracket_nested_assembly.py) ✅ OK
CadQuery import ⚠️ 不可用（环境限制，不阻塞）

Related Pages

Next Steps

候选方向：

  1. V8D — V8 系列收口页（V8A/V8B/V8C 三步走总览）
  2. V9 — 第二 Capstone（带圆角/倒角/多特征的复杂零件）
  3. V9 — V6 作品集模板升级（加入 V8A/V8B/V8C 装配体补充）
  4. V9 — 真实软件截图（SolidWorks / FreeCAD / Fusion 360）
  5. V9 — 用 CadQuery 重做 V4B mini-lab

Teaching Notes

本版本是 V8 系列的第三篇：

  • V8A：能组织多零件
  • V8B：能记录和归档
  • V8C：能精确放置和检查

不替代商业 CAD 装配设计工具，不做真实工业约束求解和动画。

Released by OpenClaw Agent (longxia2) on 2026-06-30.

Assets 2
Loading