v0.9.2 - CadQuery Local Environment Guide
Release Notes: v0.9.2 - CadQuery Local Environment Guide
Tag: v0.9.2-cadquery-local-environment-guide
Title: v0.9.2 - CadQuery Local Environment Guide
Date: 2026-06-30
Overview
本次发布新增 CadQuery 本地环境配置指南与本地导出工作流。V9B 诊断了服务器端环境限制（OCCT 不可用），V9C 为读者提供在自己机器上运行 CadQuery 的完整路线。
What's New
新增页面
| 文件 | 说明 |
|---|---|
examples/cadquery-local-environment-guide.rst |
CadQuery 本地运行环境指南（A-J 结构） |
页面结构：
- A. 本页解决什么问题 — V9B 后续、本地运行路线
- B. 为什么 py_compile 通过不等于 CadQuery 可运行 — 语法检查 vs 运行依赖
- C. 推荐本地环境路线 — 路线 1（Python venv）+ 路线 2（Conda 推荐）
- D. 最小 smoke test — 最小验证代码
- E. 运行本项目示例 — 6 个 .py 推荐顺序
- F. 导出文件保存策略 — local-exports/ + .gitignore
- G. 导出后检查 — 8 项检查清单 + 自动化脚本
- H. 常见错误 — 9 条常见错误与解决方法
- I. 相关页面 — 9 个链接
- J. 相关脚本 — 5 个脚本文件
新增脚本文件
| 文件 | 说明 |
|---|---|
scripts/cadquery/smoke_test_cadquery.py |
最小环境验证（import + box + export） |
scripts/cadquery/run_plate_export.py |
导出 plate_with_hole 到 local-exports/ |
scripts/cadquery/verify_exports.py |
验证导出的 STEP/STL 文件格式 |
scripts/cadquery/README.md |
脚本使用说明 |
新增可选文件
| 文件 | 说明 |
|---|---|
environment-cadquery.yml |
Conda 环境配置示例（不影响 Sphinx 构建） |
.gitignore 更新
加入：
local-exports/*.step/*.stp/*.stlvenv-cadquery//cad-env/smoke_test.step/smoke_test.stl
现有页面更新
| 文件 | 更新内容 |
|---|---|
examples/cadquery-runtime-export-pilot.rst |
新增"下一步：本地运行环境指南" + 链接 |
examples/cadquery-learning-path.rst |
新增 V9C 本地环境指南说明 |
examples/cadquery-parametric-modeling.rst |
新增 V9C 本地导出说明 |
examples/index.rst |
新增案例 W（V9C）、推荐顺序 11、阅读顺序 25、toctree、对照表行 |
workflow-roadmap.rst |
新增 V9C 本地环境指南说明 |
README.md |
版本号、亮点、能力矩阵、快速入口、版本里程碑 |
Build & Verification
| 项目 | 结果 |
|---|---|
| Build Command | sphinx-build -b html -W --keep-going . _build/html |
| Build Result | ✅ succeeded |
| Warning Count | 0 |
| py_compile code/cadquery/*.py | ✅ 6/6 OK |
| py_compile scripts/cadquery/*.py | ✅ 4/4 OK |
| smoke_test 运行 | ❌ 环境受限（CadQuery 不可用），记录为环境限制 |
Teaching Notes
- 不要求服务器端能跑 CadQuery
- 不创建假 STEP/STL 文件
- 优先教学诚信
- 读者本地可按指南配置环境
Released by OpenClaw Agent (longxia2) on 2026-06-30.