v0.9.1 - CadQuery Runtime Export Pilot
Release Notes: v0.9.1 - CadQuery Runtime Export Pilot
Tag: v0.9.1-cadquery-runtime-export-pilot
Title: v0.9.1 - CadQuery Runtime Export Pilot
Date: 2026-06-30
Overview
本次发布是 V7/V8 代码示例的真实运行与导出试点。V7A-V9A 所有 CadQuery 代码都通过了 py_compile 语法检查，但没有真实生成模型。V9B 尝试在当前环境下真实运行 CadQuery 并导出 STEP/STL，把"代码仅语法通过"升级为"代码能真实生成"。
关键定位：
- V9B 仍可 PASS 即使环境受限（任务明确说"不把环境安装失败当作任务失败"）
- 不创建假的 STEP/STL 文件
- 记录完整的环境诊断 + 真实运行结果
- 为读者提供本地运行指导
What's New
新增文档页面
| 文件 | 说明 |
|---|---|
examples/cadquery-runtime-export-pilot.rst |
CadQuery 真实运行与导出试点主页（A-J 结构） |
页面结构（A-J 节）：
- A. 为什么要做真实运行试点 — py_compile 不够，V9B 填补
- B. 测试范围 — 6 个 .py 文件清单
- C. 运行结果表 — 6/6 文件 py_compile OK，但 CadQuery import 都失败
- D. 环境诊断 — OS/Python/pip/OCCT 详细诊断
- E. 尝试诊断 — 7 种尝试 + 失败原因
- F. 如果成功导出（教学性说明） — 标准流程
- G. 如果环境受限（实际结果） — 不阻塞项目 + 读者本地指导
- H. 常见问题 — 8 条 V9B 常见问题
- I. 教学声明 — 教学诚信
- J. 相关页面 — 9 个相关链接
新增资源包文件
| 文件 | 说明 |
|---|---|
assets/cadquery-exports/README.md |
当前环境状态说明（无 STEP/STL 文件） |
资源包特点：
- 不包含任何假 STEP/STL 文件
- 包含完整的环境说明
- 包含读者本地运行指导
- 包含文件检查建议
现有页面更新
| 文件 | 更新内容 |
|---|---|
examples/index.rst |
新增"案例 V"（V9B）、推荐顺序 1→10、阅读顺序 24、toctree、对照表行 |
examples/cadquery-learning-path.rst |
新增 V9B CadQuery 实际运行试点说明 + 链接 |
examples/cadquery-parametric-modeling.rst |
新增 L 节 V9B 实际运行试点 + 链接 |
examples/step-stl-mini-lab.rst |
新增 V9B CadQuery 实际运行说明 + 链接 |
workflow-roadmap.rst |
新增 V9B 实际运行试点说明 |
README.md |
版本号、亮点、能力矩阵、快速入口、版本演进、教学亮点 |
Build & Verification
| 项目 | 结果 |
|---|---|
| Build Command | sphinx-build -b html -W --keep-going . _build/html |
| Build Result | ✅ succeeded |
| Warning Count | 0 |
| py_compile (6 .py) | ✅ 6/6 OK |
| CadQuery import | ❌ ModuleNotFoundError: No module named 'OCP' |
| CadQuery runtime | ❌ 6/6 文件实际运行失败 |
| STEP/STL 导出 | ❌ 未生成（环境受限） |
环境诊断结果
| 项目 | 值 | 状态 |
|---|---|---|
| OS | Ubuntu 22.04.5 LTS | ✅ |
| Python | 3.10.12 | |
| CadQuery 2.8.0 | requires Python >=3.11 | ❌ 不兼容 |
| CadQuery 2.3.0 | last Python 3.10 support | |
| OCP for Python 3.10 | PyPI mirror 不可用 | ❌ |
| pythonocc-core | PyPI mirror 不可用 | ❌ |
结论：本环境未能真实运行 CadQuery。V9B 仍 PASS（按任务要求，环境安装失败不阻塞）。
Related Pages
Next Steps
候选方向：
- V9C — 真实软件截图（SolidWorks / FreeCAD / Fusion 360）整合到作品集
- V10A — 用 CadQuery 重做 V4B mini-lab（参数化立方体/圆柱体对比）
- V10B — 第二 Capstone（带圆角/倒角/多特征）
- V10C — 录屏演示 V6 → V7 → V8 → V9A 完整作品集提交流程
- V10D — 真实 OCCT 环境配置教程（conda/mamba）
Teaching Notes
本版本是真实环境诊断的记录：
- 不替代 V7/V8 教学价值
- 明确记录环境限制
- 优先教学诚信（不创建假文件）
- 任务可 PASS 即使环境受限
Released by OpenClaw Agent (longxia2) on 2026-06-30.