docs(showcase): four-capability README front section with session replay demos
- README.md / README.zh-CN.md: capability pillars (single part / assembly / reverse engineering / simulation) with case images and replay demo links - examples/demo_kit: config-driven single-file replay demo builder (generalized from u_link demo; app.js consumes per-case config payload) - examples/flange_plate: full single-part-modeling workflow case (agent session transcript + verifier scripts + 8-hole re-parameterization with guard rejection chain) + replay demo - examples/12_ap242_gmsh_volume_mesh: model.py rebuilt through the workflow (FTC feature blocks, named vars; volume rel 0.00e+00 vs legacy, FEM interface tags preserved) + REQUIREMENTS/BUILD_PLAN/verify + replay demo - examples/u_link_motor_mount/demo: committed single-file replay demo, rebuilt via demo_kit - examples/20_integrated_bldc_joint_actuator/render_showcase.py: assembled + staged cylindrical exploded views from the captured package - img/capability: showcase renders (BLDC assembly/exploded, bracket FEM von Mises, case ISO views)
@@ -48,9 +48,6 @@ design-docs/
|
||||
# Benchmark case collection (packaged offline for distribution)
|
||||
examples/u_link_motor_mount/cases/
|
||||
|
||||
# Client demo (single-file offline replay, generated by demo/src/build_demo.py)
|
||||
examples/u_link_motor_mount/demo/
|
||||
|
||||
examples/histcad/
|
||||
|
||||
# Research tool scan outputs (generated by tools/research scripts)
|
||||
|
||||
@@ -6,6 +6,106 @@
|
||||
|
||||
[中文说明](README.zh-CN.md)
|
||||
|
||||
## What Can It Do
|
||||
|
||||
Four capability pillars. Every case below is a **real, reproducible session**:
|
||||
the replay demos are single-file offline HTML pages that faithfully replay the
|
||||
full recorded conversation (user turns, agent thinking, every tool call and
|
||||
patch, role switches) next to the exported 3D model — open them directly in a
|
||||
browser.
|
||||
|
||||
### 1 · Single-Part Modeling
|
||||
|
||||
Parametric parts authored as readable [Feature Tree
|
||||
Convention](docs/skill/references/discipline/feature-tree-convention.md)
|
||||
feature blocks — named parameters with units, verifier-first staged modeling,
|
||||
deterministic face tags that survive re-parameterization, and synchronized
|
||||
`.scadpkg` / STEP AP242 / STL / editable FreeCAD exports.
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="33%" align="center" valign="top">
|
||||
<img src="img/capability/ulink_assembly.png" alt="u_link assembly"><br/>
|
||||
<b>Robotic-arm U-link + motor mount</b><br/>
|
||||
15 user turns · 601 tool calls · S1–S10 stages<br/>
|
||||
<a href="examples/u_link_motor_mount/demo/index.html">▶ Session replay demo</a>
|
||||
</td>
|
||||
<td width="33%" align="center" valign="top">
|
||||
<img src="img/capability/flange_iso.png" alt="Parametric flange plate"><br/>
|
||||
<b>Parametric flange plate</b><br/>
|
||||
8-bolt re-parameterization with live guard<br/>
|
||||
rejection (PCD 88 → 84.5 proven feasible)<br/>
|
||||
<a href="examples/flange_plate/demo/index.html">▶ Session replay demo</a>
|
||||
</td>
|
||||
<td width="33%" align="center" valign="top">
|
||||
<img src="img/capability/bracket_iso.png" alt="Ribbed L-bracket"><br/>
|
||||
<b>Ribbed L-bracket (FEM main model)</b><br/>
|
||||
legacy script re-built through the workflow,<br/>
|
||||
volume delta 0.00e+00, FEM tags preserved<br/>
|
||||
<a href="examples/12_ap242_gmsh_volume_mesh/demo/index.html">▶ Session replay demo</a>
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
### 2 · Assembly Modeling
|
||||
|
||||
Nested durable assemblies with explicit kinematics: gear meshes, revolute
|
||||
joints, and bearing interfaces are solved constraints, not eyeballed
|
||||
positions. Standard parts — involute gears, ball bearings (as subassemblies
|
||||
with individual balls), roller-chain sprockets, metric fasteners with real
|
||||
thread profiles — come from `scad.std.*` and compose into mechanisms that
|
||||
export to STEP, editable FreeCAD projects, and MJCF for physics engines.
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%" align="center" valign="top">
|
||||
<img src="img/capability/bldc_assembly.png" alt="BLDC joint actuator assembled"><br/>
|
||||
<b>Integrated BLDC joint actuator</b> — assembled<br/>
|
||||
29 components · 51 constraints, all solved · 20:1 two-stage planetary
|
||||
</td>
|
||||
<td width="50%" align="center" valign="top">
|
||||
<img src="img/capability/bldc_exploded.png" alt="BLDC joint actuator exploded"><br/>
|
||||
<b>Same model, exploded</b> — staged cylindrical explode<br/>
|
||||
stator, planets, carriers, bearings, housings all readable
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
Reproduce it: `uv run python examples/20_integrated_bldc_joint_actuator/main.py`
|
||||
builds the package from scratch; `render_showcase.py` renders the views above;
|
||||
`export_all.py` emits STEP / editable FCStd / MJCF.
|
||||
|
||||
### 3 · Reverse Engineering
|
||||
|
||||
Import a STEP, inspect its BREP in the browser, circle and annotate regions,
|
||||
and let an agent reconstruct a parametric editable model from the annotations —
|
||||
the whole human-agent session is recorded and replayable. Showcase video ships
|
||||
separately with the release.
|
||||
|
||||
### 4 · Simulation Plugins
|
||||
|
||||
The same parametric package feeds downstream solvers without manual rework:
|
||||
AP242 STEP into Gmsh for volume meshing and CalculiX for static FEM (boundary
|
||||
faces are selected by preserved `interface.*` tags, so simulation survives
|
||||
model revisions), and MJCF into MuJoCo for mechanism dynamics.
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%" align="center" valign="top">
|
||||
<img src="img/capability/ap242_gmsh_bracket_static_von_mises.png" alt="Bracket FEM von Mises"><br/>
|
||||
<b>L-bracket static FEM</b> — CalculiX von Mises<br/>
|
||||
meshed via Gmsh OpenCASCADE kernel from the AP242 export
|
||||
</td>
|
||||
<td width="50%" align="center" valign="top">
|
||||
<img src="img/capability/ap242_gmsh_bracket_stl_views.png" alt="Bracket views"><br/>
|
||||
<b>Four-bar linkage + MuJoCo</b> — virtual collision<br/>
|
||||
MJCF export straight from the assembly (video ships separately)
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
---
|
||||
|
||||
## Update Notes (2.0.4b3 development)
|
||||
|
||||
> **Beta release:** Validate generated definitions, assembly constraints, and
|
||||
|
||||
@@ -6,6 +6,97 @@
|
||||
|
||||
[English](README.md)
|
||||
|
||||
## 它能做什么
|
||||
|
||||
四块能力支柱。下面每个 case 都是**真实、可复现的会话**:回放 demo 是单文件离线
|
||||
HTML,忠实回放完整录制的对话(用户输入、Agent 思考、每一次工具调用与补丁、角色
|
||||
切换),旁边就是导出的 3D 模型 —— 浏览器直接打开即可。
|
||||
|
||||
### 1 · 单零件建模
|
||||
|
||||
以可读的[特征树规约](docs/skill/references/discipline/feature-tree-convention.md)
|
||||
特征块编写参数化零件 —— 带单位的命名参数、验证先行的分阶段建模、改参后仍然命中的
|
||||
确定性面标签,以及同步产出的 `.scadpkg` / STEP AP242 / STL / 可编辑 FreeCAD 工程。
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="33%" align="center" valign="top">
|
||||
<img src="img/capability/ulink_assembly.png" alt="U 形连杆装配"><br/>
|
||||
<b>机械臂 U 形连杆 + 电机安装槽</b><br/>
|
||||
15 轮用户输入 · 601 次工具调用 · S1–S10 阶段<br/>
|
||||
<a href="examples/u_link_motor_mount/demo/index.html">▶ 会话回放 demo</a>
|
||||
</td>
|
||||
<td width="33%" align="center" valign="top">
|
||||
<img src="img/capability/flange_iso.png" alt="参数化法兰盘"><br/>
|
||||
<b>参数化法兰盘</b><br/>
|
||||
8 孔改参 + 守卫当场拒绝演示<br/>
|
||||
(PCD 88 被拒 → 实证可行 84.5 交付)<br/>
|
||||
<a href="examples/flange_plate/demo/index.html">▶ 会话回放 demo</a>
|
||||
</td>
|
||||
<td width="33%" align="center" valign="top">
|
||||
<img src="img/capability/bracket_iso.png" alt="筋板 L 形支架"><br/>
|
||||
<b>筋板 L 形支架(FEM 主模型)</b><br/>
|
||||
legacy 脚本按工作流重建,新旧体积<br/>
|
||||
相对偏差 0.00e+00、FEM 标签保真<br/>
|
||||
<a href="examples/12_ap242_gmsh_volume_mesh/demo/index.html">▶ 会话回放 demo</a>
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
### 2 · 装配体建模
|
||||
|
||||
嵌套持久装配体 + 显式运动学:齿轮啮合、转动副、轴承接口都是被求解的约束,不是目测
|
||||
摆放。标准件 —— 渐开线齿轮、带滚珠的轴承子装配、滚子链轮、真实牙型公制紧固件 ——
|
||||
全部来自 `scad.std.*`,组合成机构后可导出 STEP、可编辑 FreeCAD 工程和面向物理引擎
|
||||
的 MJCF。
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%" align="center" valign="top">
|
||||
<img src="img/capability/bldc_assembly.png" alt="BLDC 关节执行器装配态"><br/>
|
||||
<b>一体化 BLDC 关节执行器</b> —— 装配态<br/>
|
||||
29 个组件 · 51 条约束全部解算 · 两级行星减速 20:1
|
||||
</td>
|
||||
<td width="50%" align="center" valign="top">
|
||||
<img src="img/capability/bldc_exploded.png" alt="BLDC 关节执行器爆炸图"><br/>
|
||||
<b>同一模型</b> —— 分级柱坐标爆炸图<br/>
|
||||
定子、行星轮、载架、轴承、壳体层次清晰可读
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
复现方式:`uv run python examples/20_integrated_bldc_joint_actuator/main.py`
|
||||
从零构建装配包;`render_showcase.py` 渲染上述视图;`export_all.py` 导出
|
||||
STEP / 可编辑 FCStd / MJCF。
|
||||
|
||||
### 3 · 逆向工程
|
||||
|
||||
导入 STEP,在浏览器里检查 BREP、圈点标注区域,agent 依据标注重建参数化可编辑模型
|
||||
—— 人机协作全程录制、可回放。展示视频随发布另行提供。
|
||||
|
||||
### 4 · 仿真插件
|
||||
|
||||
同一份参数化包直接喂给下游求解器,无需人工返工:AP242 STEP 进 Gmsh 体网格 +
|
||||
CalculiX 静力 FEM(边界面按保真的 `interface.*` 标签选取,仿真链在模型改版后依然
|
||||
成立),MJCF 进 MuJoCo 做机构动力学。
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%" align="center" valign="top">
|
||||
<img src="img/capability/ap242_gmsh_bracket_static_von_mises.png" alt="支架 FEM von Mises 云图"><br/>
|
||||
<b>L 形支架静力 FEM</b> —— CalculiX von Mises 云图<br/>
|
||||
经 Gmsh OpenCASCADE 内核从 AP242 导出体网格
|
||||
</td>
|
||||
<td width="50%" align="center" valign="top">
|
||||
<img src="img/capability/ap242_gmsh_bracket_stl_views.png" alt="支架四视图"><br/>
|
||||
<b>四连杆 + MuJoCo</b> —— 虚拟碰撞<br/>
|
||||
装配体直出 MJCF(视频随发布另行提供)
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
---
|
||||
|
||||
## 更新日志(2.0.4b3 开发中)
|
||||
|
||||
> **Beta 版本:** 用于生产前,请验证生成的定义、装配约束和制造几何。
|
||||
|
||||
@@ -0,0 +1,139 @@
|
||||
# BUILD_PLAN: ap242_gmsh_bracket 正式化重建
|
||||
|
||||
Datum(来自功能基准): 沿用 legacy 原点 = 竖壁底面中心(X 壁厚中面 / Y 宽度中面 / Z 底面);+X 壁厚方向(fixed_support 背面 x=-2),+Y 宽度方向(零件关于 XZ 面 y=0 对称),+Z 高度方向。等价重建不改基准——下游 interface 面坐标(x=-2 / z=4 / z=22.32)全部锚定此系。
|
||||
|
||||
构造策略(block-and-feature): 三块形体均为"完全含于基本形体"或"坐标已知的转录轮廓"——竖壁/横板是盒(FTC geometry tier 基元条款),三角筋是 legacy 坐标转录的 closed profile extrude(FTC 转录条款,`profile=geometry` 诚实标注),孔工具是圆柱基元(纯工具体条款)。理由:等价重建的忠实性优先,参数直接映射 legacy 命名常量(`scad.var` + unit);不强行 sketch 化(约束未知 = 转录,这正是 FTC 允许 geometry tier 的场景)。特征顺序按 feature-ordering:build 基体 → add 筋 → subtract 孔 → annotate 标签。
|
||||
|
||||
## 阶段划分
|
||||
|
||||
- **S1 L 形基体 + 双三角筋**
|
||||
- 输出边界: wall ∪ shelf ∪ rib×2 单实体(含筋-壁正重叠 x∈[0,2])。不含: 任何孔、任何 interface 标签。
|
||||
- 验证目标: 单 Solid、体积对解析值 10368(= 5760 壁 + 4480 板 − 640 壁∩板 + 2×486 筋 − 2×102 筋∩壁)偏差 <0.1%、bbox=[-2,-20,0]×[26,20,36]±0.05。
|
||||
- **S2 孔系 + 界面标签**
|
||||
- 输出边界: mount_hole×2 + load_hole 切除;role.structural_l_bracket + 5 个 interface.* 面标签。不含: 导出。
|
||||
- 验证目标: 体积 = S1 − 270.177(2×π·2.5²·4 + π·3²·4)±0.1% 且与 legacy 10097.790 差 <0.1%;圆柱面卡片与 legacy 逐项一致(r/axis/位置);interface 标签集合与 legacy 完全一致且各面面积/质心等价。
|
||||
- **S3 新旧等价验证 + 导出渲染**
|
||||
- 输出边界: 正式 model.py(FTC 特征块 + Var 参数 + 参数守卫)capture 主包;export_step/obj/stl 重跑;4 视图渲染 + 隔离视觉评审。
|
||||
- 验证目标: REQUIREMENTS V1–V5 全过;评审逐区域 match。
|
||||
- **S4(USER 第 2 轮)FCStd + 等价证据节**
|
||||
- 输出边界: export_fcstd.py 重跑产物;新旧等价证据(体积/包围盒/孔位实测/标签集合)成节写入本计划证据区。
|
||||
|
||||
## Verifier contracts(Role 3 逐阶段补填)
|
||||
|
||||
### S1
|
||||
`Verifier contract: L 基体+双筋 / Criteria: C1 单 Solid + V=解析 10368±0.1%(5760 壁 + 4480 板 − 640 壁∩板 + 972 双筋 − 204 筋∩壁); C2 bbox=[-2,-20,0]×[26,20,36]±0.05; C3 QL 可枚举(faces/edges 计数打印) / Script: verify/s1_verify.py`
|
||||
|
||||
Hypothesis 结果(verify/s1_hypothesis.py,已运行):
|
||||
- H1 采用: 正确体 volume=10368.000 与解析逐位一致,bbox 精确 [-2,-20,-0.0]×[26,20,36],双门 PASS
|
||||
- H2 known-bad: 无筋体 V=9600 → 体积门 FAIL ✓(bbox 门不区分——预期,体积门承载)
|
||||
- H3 known-bad: 筋平移出壁(x_offset=2,仅面接触)V=10572 → 体积门 FAIL ✓(面接触 union 可成体,体积门必须在场)
|
||||
- 结论: ±0.1% 体积带对三种形态有区分度,bbox 门辅助定位漂移 → 采纳
|
||||
|
||||
### S2
|
||||
`Verifier contract: 孔系+标签 / Criteria: C1 V=10097.823±0.1% 且 |V−legacy|/legacy<0.1%; C2 圆柱面恰 3 张且 r/axis/center 对 legacy 卡片(r±0.01/axis±0.01/center±0.05); C3 body 标签含 role.structural_l_bracket; C4 包 scene interface 集合=legacy 5 项且 area rel≤1e-4、centroid≤1e-3 mm / Script: verify/s2_verify.py`
|
||||
|
||||
Hypothesis 结果(verify/s2_hypothesis.py,已运行):
|
||||
- H1 采用: V=10097.7905 与 legacy 差 +4.9e-11 相对(位级一致);解析 10097.823 差 0.0003%(kernel 舍入)
|
||||
- H2 采用: 圆柱卡片 3/3 逐项命中 legacy(r=2.5×2 + 3.0,area 63.0604/75.3982 完全相同)
|
||||
- H3 known-bad: 半径扰动 +0.1 → 卡片比对 FAIL ✓
|
||||
- H4 修正后 known-bad: 匹配器 target 平移须**超出** 10mm 守卫带才被拒(首稿 +5mm 在带内仍命中唯一 -X 平面——守卫按参数工作的正确行为,探针设计错误而非模型错误);+15mm → "too distant: distance^2=361" 拒绝 ✓
|
||||
- 结论: 体积/卡片/守卫三路检查有区分度 → 采纳
|
||||
|
||||
### S3
|
||||
`Verifier contract: 新旧等价+导出 / Criteria: E1 新旧包体积 rel<0.1%; E2 bbox 轴差≤0.05mm; E3 interface 集合相等+area rel≤1e-4+centroid≤1e-3mm; E4 BREP inspect valid+solids=1+正体积; E5 双包新进程 read+validate 重开; E6 step/obj/stl 非空; 视觉: iso(35,45)/front(0,90)/top(90,0)/detail(30,120,zoom2.4) 4 渲染 + 隔离评审逐区域 match/mismatch/unreviewable / Script: verify/s3_equivalence.py + verify/s3_render.py`
|
||||
|
||||
Hypothesis 结果(verify/s3_hypothesis.py,已运行):
|
||||
- H1 体积门拒 +0.2% ✓;H2 bbox 门拒 +0.3mm ✓;H3 集合门拒改名标签 ✓;H4 面积门拒 +1% ✓
|
||||
- 结论: 四路等价门全部有区分度 → 采纳(门槛函数内联于 s3_equivalence.py 供假设脚本复用)
|
||||
|
||||
## Hypotheses(Role 4 逐阶段补填)
|
||||
|
||||
### S1
|
||||
`Hypothesis: scad.var 参数直供基元标量位 + _f() 求值派生元组坐标(hypotheses/s1_var_probe.py) / Result: Var 在 make_box/make_cylinder 标量位可求值(wall V=5760 精确);发现: unit-Var × unitless-Var 惰性构造但 .evaluate() 抛 UnitValidationError(mixes unit-declared with legacy)→ 派生值一律 _f() 进 plain-float 空间(z=36×0.62=22.32 精确) / Adopted: model.py # ---- params ---- 全 Var 化 + _f() 派生`
|
||||
|
||||
### S2
|
||||
`Hypothesis: 越界圆柱工具切除 + 匹配器打标(S1 已全链验证: build_stage("s2") 产出与 legacy 位级同体积) / Result: V=10097.790499; 卡片 r=[2.5,2.5,3.0]; interface 5/5 命中 / Adopted: model.py s2 特征块(mount-holes/load-hole subtract + role-name/interface-names annotate)`
|
||||
|
||||
### S3
|
||||
`Hypothesis: 导出+渲染走已封包产物(read_product_package→materialize 再渲染,图=交付物) / Result: step 66207B / obj 31976B (948 tri) / stl 47484B (948 tri); 4 渲染 33.8KB/9.1KB/12.1KB/18.1KB; E4 首跑败于检查器键名('solids'→counts 实为 'solid')——修复验证器非模型 / Adopted: verify/s3_render.py 视图集 (35,45)/(0,90)/(90,0)/(30,120,zoom2.4)`
|
||||
|
||||
## 阶段证据(Role 3 运行 verifier 后补填)
|
||||
|
||||
### S1 证据(verify/s1_verify.py 全 PASS,2026-09-05)
|
||||
- C1 volume=10368.000 = 解析(rel_err 0.000000);C2 bbox (-2,-20,-0.0)×(26,20,36) 精确;C3 ql faces=14 edges=36
|
||||
- 源运行(model.py main,含完整特征链与 capture)faces=17 / volume=10097.790 —— 与 legacy 完全一致(S2 门后续独立验证)
|
||||
- 注: FTC 源文件按特征块整体编写(@scad.part 主契约需要完整 builder),阶段门按 build_stage("s1") 边界执行,S2 特征块的验证契约在 S1 门关闭后才设计——串行纪律按"验证先行"实质执行
|
||||
|
||||
### S2 证据(verify/s2_verify.py 全 PASS,2026-09-05)
|
||||
- C1 volume=10097.790499,与 legacy 相对差 +4.94e-11(位级一致)
|
||||
- C2 圆柱面 3 张 r=[2.5, 2.5, 3.0] 全部命中 legacy 卡片
|
||||
- C3 body tags = [role.structural_l_bracket, solid.boolean.cut]
|
||||
- C4 interface 5/5:area 相对差 ≤5.3e-7、centroid 差 ≤4.5e-5 mm(fixed_support 1400.7301 / load_surface 835.7257 / load_hole 75.3982 / mount_hole 63.0604×2)
|
||||
|
||||
### S3 证据(verify/s3_equivalence.py 全 PASS,2026-09-05)
|
||||
- E5 双包新进程 read+validate 重开:ap242_gmsh_bracket@2.1.0 (new) vs @2.0.0 (legacy)
|
||||
- E1 体积 new=10097.790499 legacy=10097.790499 **rel=0.00e+00**(位级相同)
|
||||
- E2 bbox 逐位相同 max_delta=0.0000([-2.0035,-20,-0.0044]×[26,20,36])
|
||||
- E3 interface 集合相等(5 tags),面积/质心在阈内
|
||||
- E4 brep valid / solid=1 / closed_shell=1 open_shell=0 / 17 faces / 51 edges / volume 一致
|
||||
- E6 step 66207B、obj 31976B(948 tri)、stl 47484B(948 tri)
|
||||
- repair 记录: E4 首跑 AssertionError——检查器键名错误(期望 'solids',BRepInspection.counts 实为 'solid'+'closed_shell');属验证器缺陷,修复 s3_equivalence.py 后 PASS(模型未动)
|
||||
|
||||
### S3 视觉评审(隔离评审员逐区域判定,2026-09-05)
|
||||
评审机制: 隔离视觉模型(干净上下文,只收渲染图 + REQUIREMENTS 形状描述,无会话历史)。
|
||||
|
||||
| 视图 | 判定 | 评审员原话(节选) |
|
||||
| --- | --- | --- |
|
||||
| render_iso (35,45) | R1-R5 全 match, OVERALL pass | "R1 overall L-shape ... match - L-bracket with tall vertical wall and horizontal shelf, proportions consistent with 40 wide x 36 tall x 28 deep"; "R4 ... load hole visible in shelf ... mid-depth" |
|
||||
| render_front (0,90) | R1-R5 全 match, OVERALL pass | "R3 rib triangles: match — two right triangles visible ... symmetric placement at mid-height"; "R4 symmetry: match — mirror symmetry" |
|
||||
| render_top (90,0) | **首评 mismatch → 契约修正 → 复评 pass** | 首评: "R3: mismatch - rib footprints appear as full rectangles, not triangular, and they do not sit adjacent to the wall edge" |
|
||||
| render_detail (30,120) | R1-R6 全 match, OVERALL pass | "R3 wall hole ... match"; "R4 hole clipping rib top corner ... match"; "R5 shelf top flat adjacent to rib foot ... match" |
|
||||
|
||||
top-view mismatch 处置(不弱化检查、不改模型):
|
||||
1. 评审反馈转确定性谓词(geometric-validation 纪律): 实测新旧包筋斜面卡片**逐位相同**(2 faces area=67.5638 centers=(10.0374, ±11.11, 11.9626));S1 体积门 10368 精确值已钉死筋 x∈[0,18] 贴壁(含 102 mm³/筋 壁内重叠);安装孔穿筋顶角在 legacy 同样存在(体积位级相同为证)。
|
||||
2. 投影算术: XZ 三角形沿 Y 拉伸的筋在 -Z 正交投影下**只可能是矩形带**(斜面投影为矩形)——首评契约要求"三角影"是几何不可能的期望,属评审契约缺陷非模型缺陷。
|
||||
3. 修正契约(如实描述 -Z 投影应有的正确外观)后派**新**隔离评审: "R3: match - two 3-wide rectangular bands starting at the wall edge, ~2/3 of visible depth, centered y≈+/-11, symmetric ... R6: match - no unexpected elements. OVERALL: pass"。
|
||||
4. 侧发现(记录非缺陷): 筋斜面被安装孔咬角(理想 76.37 → 实际 67.56 mm²)——新旧完全一致,系 legacy 原生特征。
|
||||
|
||||
|
||||
### S4(USER 第 2 轮)
|
||||
`Verifier contract: FCStd+证据 / Criteria: F1 export_fcstd.py 重跑成功且产物非空; F2 FCStd 于 FreeCAD 运行时重开为可编辑特征树(文档对象≥5、非 App:: 基元特征≥5、App::Part 结果体体积与交付体积一致≤0.1%);SDK 新进程重开包校验并列体积; F3 本证据节写入 / Script: verify/s4_fcstd_check.py`
|
||||
|
||||
Hypothesis/发现(s4 期间,已运行):
|
||||
- F2 首版谓词"最大 sane 体积"错向:中间特征(MultiFuse 10368)> 最终结果,且 XZ/YZ_Plane 载有 1e152 垃圾 Volume——改为锁定唯一 App::Part 结果容器的 Shape.Volume(6.76e-11 命中)
|
||||
- FreeCAD 运行时 = /Applications/FreeCAD.app/Contents/Resources/bin/freecadcmd(SDK 自动发现);GUI 目检未执行(无 GUI 会话),以 CLI 重开+特征树枚举+体积对账代替(更强)
|
||||
|
||||
### S4 证据(verify/s4_fcstd_check.py 全 PASS,2026-09-05)
|
||||
- F1 FCStd 53537 bytes(export_fcstd.py 重跑,脚本未改一行)
|
||||
- F2 SDK 新进程重开 @2.1.0 volume=10097.790499;FreeCAD CLI 重开 26 objects / 15 editable(Spreadsheet 参数表 + Box×2 + Cylinder×3 + Extrusion 筋×2 + Fuse/MultiFuse + Cut×3 + App::Part 结果),结果体 10097.790499682898(rel 6.76e-11)
|
||||
|
||||
## 新旧版本几何等价证据(USER 第 2 轮要求,S4 补填)
|
||||
|
||||
**引用锚点**: 后续 FEM 结果请引用 `examples/out/ap242_gmsh_volume_mesh/ap242_gmsh_bracket.scadpkg`(md5 4866a6837c5b57aca225ffc1b7e37ec0,part `ap242_gmsh_bracket` @ revision **2.1.0**)。对照基线 = `examples/out/ap242_gmsh_volume_mesh/legacy_baseline/ap242_gmsh_bracket.scadpkg`(revision 2.0.0)。
|
||||
|
||||
| 项目 | legacy @2.0.0 | rebuilt @2.1.0 | 判定 |
|
||||
| --- | --- | --- | --- |
|
||||
| 体积 (mm³) | 10097.790499 | 10097.790499 | **rel = 0.00e+00**(位级相同)✓ |
|
||||
| 包围盒 (mm) | (-2.0035, -20.0000, -0.0044) → (26.0000, 20.0000, 36.0000) | 同左逐位 | max_delta = 0.0000 ✓ |
|
||||
| BREP | 17 faces / 51 edges | valid / solid=1 / closed_shell=1 / open_shell=0 / 17 faces | 单实体闭壳 ✓ |
|
||||
| interface 标签集合 | {fixed_support, load_surface, mount_hole_1, mount_hole_2, load_hole} | 同左(集合相等) | ✓ |
|
||||
|
||||
孔位/孔径实测(BRepAdaptor 圆柱面卡片,新旧逐项一致):
|
||||
|
||||
| 孔 | 半径 | 轴 | 位置 | 孔壁面积 mm² | 面心 |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| mount_hole_1 | 2.5 | +X | y=-11, z=22.32 | 63.0604 | (0.0075, -11, 22.3111) |
|
||||
| mount_hole_2 | 2.5 | +X | y=+11, z=22.32 | 63.0604 | (0.0075, +11, 22.3111) |
|
||||
| load_hole | 3.0 | +Z | x=12, y=0 | 75.3982 | (12, 0, 2) |
|
||||
|
||||
interface 面几何对账(面积 rel ≤5.3e-7、质心差 ≤4.5e-5 mm,远优于 export_fem_mesh 匹配阈值 area 1e-6/centroid 1e-5/bounds 0.05):
|
||||
|
||||
| 标签 | 面积 mm² | 质心 | 解析核对 |
|
||||
| --- | --- | --- | --- |
|
||||
| interface.fixed_support | 1400.7301 | (-2.0, 0, 17.8789) | =40×36−2π·2.5² |
|
||||
| interface.load_surface | 835.7257 | (14.5271, 0, 4.0) | =24×40−2·(16×3)−π·3² |
|
||||
| interface.load_hole | 75.3982 | (12, 0, 2.0) | =2π·3·4 |
|
||||
| interface.mount_hole_1/2 | 63.0604 | (0.0075, ∓11, 22.3111) | =2π·2.5·4(+孔-筋相交修正) |
|
||||
|
||||
侧记录: 筋斜面被安装孔咬角(67.5638 mm²/片,新旧逐位相同)——legacy 原生特征,非本次引入。export_step/export_obj/export_stl/export_fcstd 四脚本未改动、对 @2.1.0 包重跑全部通过。
|
||||
|
||||
@@ -0,0 +1,50 @@
|
||||
# Requirements: ap242_gmsh_bracket(L 形直角连接件 · 正式化重建)
|
||||
|
||||
- Inputs: 用户 prose 描述(本轮原文)+ 现有参考模型 `examples/12_ap242_gmsh_volume_mesh/model.py`(legacy 脚本,作为尺寸真值来源逐项核对)+ 下游脚本 `export_fem_mesh.py` / `export_step.py` / `export_fcstd.py` / `export_obj.py` / `export_stl.py`(运行契约来源)
|
||||
- Functional goals:
|
||||
1. 结构承载 L 形直角连接件:竖壁固定(fixed_support),横板承载(load_surface + load_hole),三角筋抗弯
|
||||
2. AP242/Gmsh FEM 工作流主模型:`interface.*` 面标签是下游 gmsh 物理组选面契约,必须原样保留
|
||||
3. 按 single-part-modeling 工作流 + Feature Tree Convention 正式化(特征块 + 命名参数),几何与 legacy 等价
|
||||
- Geometry targets(分区,已按 legacy model.py + 实测核对):
|
||||
1. **竖壁 wall**:box 4(X)×40(Y)×36(Z),X∈[-2,2]、Y∈[-20,20]、Z∈[0,36];背面平面 x=-2(法向 -X)→ `interface.fixed_support`
|
||||
2. **横板 shelf**:box 28(X)×40(Y)×4(Z),底面中心 (12,0,0) → X∈[-2,26]、Y∈[-20,20]、Z∈[0,4];顶面 z=4 → `interface.load_surface`(实测面积 835.7257 = 24×40 − 2×(16×3 筋底) − π·3²,质心 (14.5271, 0, 4))
|
||||
3. **三角筋 rib ×2**:XZ 平面直角三角形,顶点 (0,·,4)/(0,·,22)/(18,·,4)——竖边高 18(贴竖壁,嵌入壁内 x∈[0,2] 保证正重叠)、水平边深 18(x 0→18 落在横板上);厚 3,y 条带中心 y=±11(即 [9.5,12.5]/[-12.5,-9.5])
|
||||
4. **安装孔 mount_hole ×2**:⌀5(r=2.5),轴 +X,y=±11(孔距 22),z=0.62×36=22.32,贯穿竖壁(工具越界 x∈[-3,3])→ `interface.mount_hole_1`(y=-11)/ `interface.mount_hole_2`(y=+11)(实测孔壁面积 63.0604,孔心 (0.0075, ±11, 22.3111))
|
||||
5. **承载孔 load_hole**:⌀6(r=3.0),轴 +Z,x=12、y=0,贯穿横板(工具越界 z∈[-1,5])→ `interface.load_hole`(实测孔壁面积 75.3982 = 2π·3·4,孔心 (12, 0, 2))
|
||||
6. **整体角色标签**:`role.structural_l_bracket`(实体级)
|
||||
7. legacy 实测基线(verify/legacy_baseline_facts.json + verify/legacy_interface_facts.json):体积 10097.790499 mm³、面数 17、bbox≈[-2.004,-20,-0.004]×[26,20,36]
|
||||
- Units / coordinate convention: mm;原点 = 竖壁底面中心(壁厚中面 X=0、宽度中面 Y=0、底面 Z=0);+X 壁厚方向(背面 x=-2);+Y 宽度方向(零件关于 XZ 面 y=0 对称);+Z 高度方向;基面 z=0 = 竖壁/横板公共底面
|
||||
- Named parameters (Var)(与 legacy 常量一一对应,全部 mm):
|
||||
- `bracket_width = 40.0`(Y 向总宽)
|
||||
- `bracket_height = 36.0`(竖壁高)
|
||||
- `bracket_depth = 28.0`(横板 X 向深)
|
||||
- `plate_thickness = 4.0`(壁/板厚)
|
||||
- `mount_hole_radius = 2.5`(安装孔 ⌀5)
|
||||
- `mount_hole_spacing = 22.0`(孔距)
|
||||
- `mount_hole_height_ratio = 0.62`(孔高 = ratio×36 = 22.32)
|
||||
- `load_hole_radius = 3.0`(承载孔 ⌀6)
|
||||
- `load_hole_x = 12.0`(承载孔 X 位)
|
||||
- `rib_thickness = 3.0` / `rib_height = 18.0` / `rib_depth = 18.0`
|
||||
- `rib_offset_y = 11.0`(筋中心 y=±offset)ASSUMED default(legacy 字面量 11.0;= mount_hole_spacing/2 同位)
|
||||
- revision `2.0.0 → 2.1.0` ASSUMED default("升一版"取 minor bump,正式化重建属结构性变更)
|
||||
- Fastening & mounting: 2×⌀5 安装孔沿 +X 贯穿竖壁(螺栓插入方向 +X,头侧 x=-2 背面),固定于机架 → fixed_support 即竖壁背面;⌀6 承载孔沿 +Z 贯穿横板(吊挂/紧固载荷)
|
||||
Envelope math: 安装孔边距:孔心 y=±11 距侧边 |11−2.5|=8.5 ≥ r ✓;距顶 36−22.32=13.68−2.5=11.18 ✓;两孔间净距 22−5=17 ✓;承载孔距横板前端 26−12−3=11、距筋带外缘 y=9.5−3=6.5 ✓(legacy 已验证布局,本次等价重建不改)
|
||||
- Service conditions: FEM 用例(CalculiX)以 interface.* 为边界条件接口——fixed_support 全约束、load_surface/孔承载(工况由下游 run_calculix.py 定义;本模型不声明强度结论)
|
||||
- Export targets: `.scadpkg`(必须,路径 out/ap242_gmsh_volume_mesh/ap242_gmsh_bracket.scadpkg 不变)+ STEP(AP242)+ OBJ + STL + FCStd(第 2 轮用户补充);export_*.py 脚本不改、重跑必须通过
|
||||
- Verification intent(验收前写定):
|
||||
- V1 新旧体积偏差 < 0.1%(对 legacy_baseline 实测 10097.790499)
|
||||
- V2 interface 标签集合完全一致 = {fixed_support, load_surface, mount_hole_1, mount_hole_2, load_hole},且各标签面面积/质心与 legacy 实测一致(面积相对差 ≤1e-6 量级、质心 ≤1e-5 mm,同 export_fem_mesh 匹配阈值量级)
|
||||
- V3 BREP 单实体、闭壳、正体积(外置 inspect)
|
||||
- V4 孔位/孔径实测:⌀5×2 @ (y=±11, z=22.32) 轴 X;⌀6 @ (x=12, y=0) 轴 Z;bbox 三向与 legacy 一致(±0.05)
|
||||
- V5 scadpkg 新进程重开校验(read+validate);export_step/export_obj/export_stl 重跑通过
|
||||
- V6 视觉:4 视图渲染(iso/front/top/detail 筋+安装孔特写),隔离评审逐区域 match/mismatch/unreviewable
|
||||
- Ask-or-Record ledger(批量一问,用户已按上稿预答):
|
||||
| item | asked/assumed | answer/value |
|
||||
| --- | --- | --- |
|
||||
| 几何等价判据 | asked (批量) | 用户预答:体积 <0.1% + 标签集合完全一致(上稿第 2 条) |
|
||||
| interface.* 标签处置 | asked (批量) | 用户预答:原样保留,下游 FEM 依赖(上稿第 3 条) |
|
||||
| 运行契约 | asked (批量) | 用户预答:包路径/part id 不变、revision 升一版、export_* 不改重跑通过(上稿第 4 条) |
|
||||
| 验证方式 | asked (批量) | 用户预答:外置 verify 脚本五项(上稿第 5 条) |
|
||||
| rib_offset_y=11 | assumed | legacy 字面量 -11/+11;取 |11|=spacing/2 记为命名参数 |
|
||||
| revision 2.1.0 | assumed | minor bump(正式化重建为结构性变更) |
|
||||
| rib 轮廓 tier | assumed | geometry tier(FTC 转录条款:坐标已知的既有几何转录,profile=geometry 诚实标注) |
|
||||
@@ -0,0 +1,16 @@
|
||||
# 会话回放 Demo(单文件离线)
|
||||
|
||||
**打开方式:直接双击 `index.html`**(离线可用、无需服务器;数据、three.js、STL、渲染图全部内联,约 0.9 MB)。
|
||||
|
||||
把 `../session_transcript.md`(L 形直角连接件 single-part-modeling 正式化重建)
|
||||
**忠实回放**成可交互页面:2 轮用户输入、49 次工具调用、9 次角色切换,右侧 three.js
|
||||
实时渲染最终单实体支架。看点是新旧几何等价对账:体积相对偏差 0.00e+00、包围盒逐位
|
||||
相同、5 个 `interface.*` FEM 标签面积 rel ≤ 5.3e-7,FCStd 特征树经 CLI 重开验证。
|
||||
|
||||
## 重新生成(仓库根目录)
|
||||
|
||||
```bash
|
||||
python3 examples/12_ap242_gmsh_volume_mesh/demo/build.py
|
||||
```
|
||||
|
||||
构建器与转录格式见 [`examples/demo_kit/`](../../demo_kit/)。
|
||||
@@ -0,0 +1,81 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Rebuild the ap242_gmsh_volume_mesh (L-bracket) replay demo with demo_kit.
|
||||
|
||||
Run from the repository root:
|
||||
|
||||
python3 examples/12_ap242_gmsh_volume_mesh/demo/build.py
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
HERE = Path(__file__).resolve().parent # demo/
|
||||
ROOT = HERE.parent # 12_ap242_gmsh_volume_mesh/
|
||||
KIT = ROOT.parent / "demo_kit"
|
||||
sys.path.insert(0, str(KIT))
|
||||
|
||||
from build_demo import build_case # noqa: E402
|
||||
|
||||
build_case({
|
||||
"root": ROOT,
|
||||
"stl": {
|
||||
"path": ROOT.parent / "out" / "ap242_gmsh_volume_mesh" / "ap242_gmsh_bracket.stl",
|
||||
"name": "ap242_gmsh_bracket.stl",
|
||||
"note": "948 三角面 · 单实体 L 形支架",
|
||||
"gl_cap": "ap242_gmsh_bracket · FEM 接口标签保留 · 会话自动导出(scadpkg / STEP / FCStd / STL)",
|
||||
},
|
||||
"imgs": [
|
||||
{"key": "iso", "path": ROOT.parent / "out" / "ap242_gmsh_volume_mesh" / "render_iso.png", "cap": "等轴测视图"},
|
||||
{"key": "front", "path": ROOT.parent / "out" / "ap242_gmsh_volume_mesh" / "render_front.png", "cap": "正视图"},
|
||||
{"key": "top", "path": ROOT.parent / "out" / "ap242_gmsh_volume_mesh" / "render_top.png", "cap": "俯视图"},
|
||||
{"key": "detail", "path": ROOT.parent / "out" / "ap242_gmsh_volume_mesh" / "render_detail.png", "cap": "筋板 + 安装孔区特写"},
|
||||
],
|
||||
"params": [
|
||||
["bracket_width / height / depth", "40 / 36 / 28 mm", "外形包络(宽 / 高 / 深)"],
|
||||
["plate_thickness", "4 mm", "竖壁与横板壁厚"],
|
||||
["mount_hole_radius", "2.5 mm", "安装孔半径(⌀5,tol 0.1)"],
|
||||
["mount_hole_spacing", "22 mm", "安装孔孔距(跨筋对称)"],
|
||||
["mount_hole_height_ratio", "0.62", "安装孔高度 = 0.62 × bracket_height"],
|
||||
["load_hole_radius / load_hole_x", "3.0 mm / 12 mm", "横板承载孔(⌀6)半径与 x 位置"],
|
||||
["rib_thickness / height / depth", "3 / 18 / 18 mm", "双三角筋板(geometry tier 轮廓)"],
|
||||
["rib_offset_y", "11 mm", "筋板对称偏置(legacy 字面量,已核对)"],
|
||||
["cut_overshoot", "1 mm", "孔刀超出量(切穿保证)"],
|
||||
["revision", "2.0.0 → 2.1.0", "工作流正式化重建,几何逐位等价"],
|
||||
],
|
||||
"tags": [
|
||||
"interface.fixed_support",
|
||||
"interface.load_surface",
|
||||
"interface.mount_hole_1",
|
||||
"interface.mount_hole_2",
|
||||
"interface.load_hole",
|
||||
"role.structural_l_bracket",
|
||||
],
|
||||
"tags_note": "FEM 接口标签集合与 legacy 版逐位一致(面积 rel ≤ 5.3e-7)——下游 Gmsh 网格 / CalculiX 边界条件按标签选面,重建不破坏仿真链。",
|
||||
"artifacts": {
|
||||
"files": [
|
||||
["ap242_gmsh_bracket.scadpkg", "1.07 MB", "SimpleCAD 原生产品包 @2.1.0"],
|
||||
["ap242_gmsh_bracket.step", "66 KB", "STEP AP242 · 1382 实体"],
|
||||
["ap242_gmsh_bracket.FCStd", "53 KB", "FreeCAD 可编辑特征树 · 26 对象 / 15 特征"],
|
||||
["ap242_gmsh_bracket.obj / .stl", "32 / 47 KB", "网格导出(948 三角面)"],
|
||||
["render_*.png", "×4", "等轴 / 正视 / 俯视 / 筋板特写"],
|
||||
],
|
||||
"scripts": [
|
||||
"s1_verify", "s2_verify", "s3_equivalence", "s3_render", "s4_fcstd_check",
|
||||
"s1/s2/s3_hypothesis", "s0_legacy_probe",
|
||||
],
|
||||
"notes": [
|
||||
"新旧几何等价:体积 rel = 0.00e+00,包围盒逐位相同",
|
||||
"四个下游导出脚本(step/obj/stl/fcstd)对 2.1.0 包零改动重跑通过",
|
||||
],
|
||||
},
|
||||
"about": [
|
||||
"<b>这是什么。</b>把一个已有的 legacy 建模脚本按 single-part-modeling 工作流完整正式化的会话回放:需求确认 → 总体规划 → 分阶段验证先行重建 → 新旧几何等价对账 → FCStd 可编辑性核验。Agent 在 {tools} 次工具调用中完成。",
|
||||
"<b>左侧对话</b>逐条回放全部 {N} 条消息,与 session_transcript.md 一一对应,未做删改。",
|
||||
"<b>等价是怎么证的</b>:体积相对偏差 0.00e+00、包围盒逐位相同、17 面/51 边拓扑、5 个 interface.* 标签面积 rel ≤ 5.3e-7、双包新进程重开——重建没有偷偷改变任何一个 FEM 边界面。",
|
||||
"<b>右侧 3D</b> 是会话最终导出的 {stlName}({stlTris} 三角面),three.js 实时渲染,可拖拽旋转 / 缩放 / 平移。",
|
||||
],
|
||||
"highlights": "① 验证先行({allPass} 次 ALL PASS);② FEM 接口标签跨版本保真,仿真链零破坏;③ FCStd 特征树 15 个可编辑特征经 CLI 重开+体积对账验证;④ 4 次检查器自身缺陷被如实记录并修复(含 1 次评审契约修正链)。",
|
||||
"subtitle": "· legacy 脚本的工作流化 + 几何等价对账",
|
||||
"extra_stat": ["0.00e+00", "新旧体积相对偏差"],
|
||||
})
|
||||
@@ -0,0 +1,99 @@
|
||||
"""Role 1 input classification: measure the existing legacy bracket model.
|
||||
|
||||
Read-only inspection of the provided reference model (examples/12/.../model.py
|
||||
before formalization). Produces verify/legacy_baseline_facts.json used later by
|
||||
the S3 equivalence verifier. No new geometry is authored here.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import importlib.util
|
||||
import json
|
||||
from pathlib import Path
|
||||
|
||||
import simplecadapi as scad
|
||||
from OCP.BRepAdaptor import BRepAdaptor_Surface
|
||||
from OCP.BRepBndLib import BRepBndLib
|
||||
from OCP.Bnd import Bnd_Box
|
||||
from OCP.GeomAbs import GeomAbs_SurfaceType
|
||||
|
||||
HERE = Path(__file__).resolve().parent
|
||||
MODEL = HERE.parent / "model.py"
|
||||
FACTS_OUT = HERE.parent / "verify" / "legacy_baseline_facts.json"
|
||||
|
||||
|
||||
def load_module(path: Path):
|
||||
spec = importlib.util.spec_from_file_location("legacy_bracket_model", path)
|
||||
module = importlib.util.module_from_spec(spec)
|
||||
spec.loader.exec_module(module)
|
||||
return module
|
||||
|
||||
|
||||
def bbox_of(solid: scad.Solid) -> dict:
|
||||
box = Bnd_Box()
|
||||
box.SetGap(0.0)
|
||||
BRepBndLib.AddOptimal_s(solid.wrapped, box, True, False)
|
||||
xmin, ymin, zmin, xmax, ymax, zmax = box.Get()
|
||||
return {
|
||||
"min": [round(v, 6) for v in (xmin, ymin, zmin)],
|
||||
"max": [round(v, 6) for v in (xmax, ymax, zmax)],
|
||||
}
|
||||
|
||||
|
||||
def cylinder_cards(body: scad.Solid) -> list[dict]:
|
||||
cards = []
|
||||
sel = scad.ql.faces().where(scad.ql.prop("geom.type", "==", "CYLINDER"))
|
||||
for face in sel.resolve(body):
|
||||
adaptor = BRepAdaptor_Surface(face.wrapped)
|
||||
if adaptor.GetType() != GeomAbs_SurfaceType.GeomAbs_Cylinder:
|
||||
continue
|
||||
cylinder = adaptor.Cylinder()
|
||||
axis = cylinder.Axis().Direction()
|
||||
location = cylinder.Location()
|
||||
center = face.get_center()
|
||||
cards.append(
|
||||
{
|
||||
"center": [round(center.x, 4), round(center.y, 4), round(center.z, 4)],
|
||||
"area": round(face.get_area(), 4),
|
||||
"radius": round(cylinder.Radius(), 4),
|
||||
"axis": [round(axis.X(), 4), round(axis.Y(), 4), round(axis.Z(), 4)],
|
||||
"axis_loc": [round(location.X(), 4), round(location.Y(), 4), round(location.Z(), 4)],
|
||||
}
|
||||
)
|
||||
return cards
|
||||
|
||||
|
||||
def main() -> None:
|
||||
module = load_module(MODEL)
|
||||
result = module.build_bracket()
|
||||
body = result.part.body
|
||||
|
||||
faces = scad.ql.faces().resolve(body)
|
||||
volume = body.get_volume()
|
||||
tags = scad.list_tags(shape=body)
|
||||
facts = {
|
||||
"volume": round(volume, 6),
|
||||
"face_count": len(faces),
|
||||
"bbox": bbox_of(body),
|
||||
"tags": tags,
|
||||
"cylinders": cylinder_cards(body),
|
||||
"material": {
|
||||
"id": result.part.material.material_id if getattr(result.part, "material", None) else None,
|
||||
},
|
||||
"part_id": result.part.part_id,
|
||||
"name": result.part.name,
|
||||
}
|
||||
print("part", facts["part_id"], facts["name"])
|
||||
print("volume", facts["volume"])
|
||||
print("faces", facts["face_count"])
|
||||
print("bbox", facts["bbox"])
|
||||
print("tags", tags)
|
||||
for card in facts["cylinders"]:
|
||||
print("cyl", card)
|
||||
FACTS_OUT.parent.mkdir(parents=True, exist_ok=True)
|
||||
FACTS_OUT.write_text(json.dumps(facts, indent=2))
|
||||
print("facts_json", FACTS_OUT)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
@@ -0,0 +1,65 @@
|
||||
"""S1 Role 4 hypothesis: Var-declared params feed primitive calls.
|
||||
|
||||
Checks: (a) scad.var values evaluate in scalar argument positions of
|
||||
make_box_rsolid / make_cylinder_rsolid; (b) tuple argument positions
|
||||
(bottom_face_center) need plain floats -> derive via .evaluate();
|
||||
(c) resulting dims match the legacy plain-float build exactly.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import simplecadapi as scad
|
||||
|
||||
WIDTH = scad.var("bracket_width", 40.0, unit="mm")
|
||||
HEIGHT = scad.var("bracket_height", 36.0, unit="mm")
|
||||
RATIO = scad.var("mount_hole_height_ratio", 0.62)
|
||||
RADIUS = scad.var("mount_hole_radius", 2.5, unit="mm", tolerance=0.1)
|
||||
|
||||
|
||||
def _f(scalar) -> float:
|
||||
"""Evaluate any ScalarLike (Var/Expr/float) to a plain canonical float."""
|
||||
return float(scalar.evaluate()) if hasattr(scalar, "evaluate") else float(scalar)
|
||||
|
||||
|
||||
def main() -> None:
|
||||
with scad.GraphSession(graph_id="s1_var_probe"):
|
||||
# (a) Var in scalar positions, expression arithmetic stays lazy
|
||||
wall = scad.make_box_rsolid(
|
||||
width=scad.var("plate_thickness", 4.0, unit="mm"),
|
||||
height=WIDTH,
|
||||
depth=HEIGHT,
|
||||
bottom_face_center=(0.0, 0.0, 0.0),
|
||||
)
|
||||
volume = wall.get_volume()
|
||||
print("wall volume", volume)
|
||||
assert abs(volume - 4.0 * 40.0 * 36.0) < 1e-9, volume
|
||||
|
||||
# (b) finding: unit-declared Var * unitless Var builds lazily, but
|
||||
# .evaluate() raises UnitValidationError ("mixes unit-declared
|
||||
# variables with legacy variables"). Derived values must be
|
||||
# computed in plain-float space via _f().
|
||||
try:
|
||||
float((HEIGHT * RATIO).evaluate())
|
||||
raise SystemExit("expected UnitValidationError was not raised")
|
||||
except SystemExit:
|
||||
raise
|
||||
except Exception as error: # noqa: BLE001 - probing documented failure
|
||||
print("mixed-unit expr rejected at evaluate():", type(error).__name__)
|
||||
z = _f(HEIGHT) * _f(RATIO)
|
||||
center = (0.0, 0.0, z)
|
||||
tool = scad.make_cylinder_rsolid(
|
||||
radius=RADIUS,
|
||||
height=10.0,
|
||||
bottom_face_center=center,
|
||||
axis=(1.0, 0.0, 0.0),
|
||||
)
|
||||
tool_volume = tool.get_volume()
|
||||
print("tool volume", tool_volume, "center z", center)
|
||||
assert abs(tool_volume - 3.141592653589793 * 2.5 * 2.5 * 10.0) < 1e-6
|
||||
assert abs(center[2] - 22.32) < 1e-9, center
|
||||
|
||||
print("H1 ADOPTED: Var ok in scalar positions; derived coords via plain-float _f()")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
@@ -1,4 +1,10 @@
|
||||
"""Build a named single-solid L-bracket for STEP and Gmsh workflows."""
|
||||
"""Formalized single-solid L-bracket for STEP and Gmsh workflows.
|
||||
|
||||
Rebuilt per the single-part-modeling workflow and the Feature Tree
|
||||
Convention (block-structured features, named parameters). Geometry and
|
||||
FEM interface tags are equivalent to the legacy direct-script version;
|
||||
equivalence evidence lives in verify/ (external verification policy).
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
@@ -11,28 +17,155 @@ OUT_DIR = Path(__file__).resolve().parents[1] / "out" / "ap242_gmsh_volume_mesh"
|
||||
PACKAGE_PATH = OUT_DIR / "ap242_gmsh_bracket.scadpkg"
|
||||
CACHE = scad.CachePolicy(root=OUT_DIR / ".cache")
|
||||
|
||||
BRACKET_WIDTH = 40.0
|
||||
BRACKET_HEIGHT = 36.0
|
||||
BRACKET_DEPTH = 28.0
|
||||
PLATE_THICKNESS = 4.0
|
||||
MOUNT_HOLE_RADIUS = 2.5
|
||||
MOUNT_HOLE_SPACING = 22.0
|
||||
LOAD_HOLE_RADIUS = 3.0
|
||||
LOAD_HOLE_X = 12.0
|
||||
RIB_THICKNESS = 3.0
|
||||
RIB_HEIGHT = 18.0
|
||||
RIB_DEPTH = 18.0
|
||||
# ---- params ----
|
||||
BRACKET_WIDTH = scad.var("bracket_width", 40.0, unit="mm")
|
||||
BRACKET_HEIGHT = scad.var("bracket_height", 36.0, unit="mm")
|
||||
BRACKET_DEPTH = scad.var("bracket_depth", 28.0, unit="mm")
|
||||
PLATE_THICKNESS = scad.var("plate_thickness", 4.0, unit="mm")
|
||||
MOUNT_HOLE_RADIUS = scad.var("mount_hole_radius", 2.5, unit="mm", tolerance=0.1)
|
||||
MOUNT_HOLE_SPACING = scad.var("mount_hole_spacing", 22.0, unit="mm")
|
||||
MOUNT_HOLE_HEIGHT_RATIO = scad.var("mount_hole_height_ratio", 0.62)
|
||||
LOAD_HOLE_RADIUS = scad.var("load_hole_radius", 3.0, unit="mm", tolerance=0.1)
|
||||
LOAD_HOLE_X = scad.var("load_hole_x", 12.0, unit="mm")
|
||||
RIB_THICKNESS = scad.var("rib_thickness", 3.0, unit="mm")
|
||||
RIB_HEIGHT = scad.var("rib_height", 18.0, unit="mm")
|
||||
RIB_DEPTH = scad.var("rib_depth", 18.0, unit="mm")
|
||||
RIB_OFFSET_Y = scad.var("rib_offset_y", 11.0, unit="mm")
|
||||
CUT_OVERSHOOT = scad.var("cut_overshoot", 1.0, unit="mm")
|
||||
TAG_MATCH_MAX_DISTANCE = 10.0 # face-matcher selection-parameter guard (mm)
|
||||
|
||||
|
||||
def _tag_closest_face(
|
||||
def _f(scalar) -> float:
|
||||
"""Evaluate a ScalarLike to a plain canonical float.
|
||||
|
||||
Unit-declared vars cannot mix with unitless vars inside one expression
|
||||
(UnitValidationError at evaluate()), so every derived coordinate is
|
||||
computed here in plain-float space.
|
||||
"""
|
||||
return float(scalar.evaluate()) if hasattr(scalar, "evaluate") else float(scalar)
|
||||
|
||||
|
||||
def _assert_params() -> None:
|
||||
"""Design-parameter feasibility guards (geometry checks live in verify/)."""
|
||||
t = _f(PLATE_THICKNESS)
|
||||
width = _f(BRACKET_WIDTH)
|
||||
height = _f(BRACKET_HEIGHT)
|
||||
depth = _f(BRACKET_DEPTH)
|
||||
spacing = _f(MOUNT_HOLE_SPACING)
|
||||
mount_r = _f(MOUNT_HOLE_RADIUS)
|
||||
ratio = _f(MOUNT_HOLE_HEIGHT_RATIO)
|
||||
load_r = _f(LOAD_HOLE_RADIUS)
|
||||
load_x = _f(LOAD_HOLE_X)
|
||||
rib_t = _f(RIB_THICKNESS)
|
||||
rib_h = _f(RIB_HEIGHT)
|
||||
rib_d = _f(RIB_DEPTH)
|
||||
rib_y = _f(RIB_OFFSET_Y)
|
||||
|
||||
assert 0.0 < 2.0 * t < min(width, height, depth), "plate thickness must fit all spans"
|
||||
assert 2.0 * mount_r < spacing, "mount holes would merge"
|
||||
assert spacing / 2.0 + mount_r < width / 2.0, "mount holes outside wall width"
|
||||
assert 0.0 < ratio < 1.0, "mount hole height ratio must be in (0, 1)"
|
||||
hole_z = ratio * height
|
||||
assert mount_r < hole_z < height - mount_r, "mount hole outside wall height"
|
||||
assert -t / 2.0 + load_r < load_x < depth - t / 2.0 - load_r, "load hole outside shelf footprint"
|
||||
assert load_r < t / 2.0 + rib_y - rib_t / 2.0, "load hole would reach rib band"
|
||||
assert 2.0 * rib_y - rib_t > 0.0, "ribs would overlap at the symmetry plane"
|
||||
assert rib_y - rib_t / 2.0 > load_r, "ribs would collide with the load hole"
|
||||
assert rib_h + t <= height, "rib would overtop the wall"
|
||||
assert rib_d <= depth - t, "rib would overrun the shelf depth"
|
||||
assert _f(CUT_OVERSHOOT) > 0.0, "cut overshoot must be positive"
|
||||
|
||||
|
||||
def _wall_body() -> scad.Solid:
|
||||
"""Feature-block helper: the vertical mounting wall (basic box form)."""
|
||||
return scad.make_box_rsolid(
|
||||
width=PLATE_THICKNESS,
|
||||
height=BRACKET_WIDTH,
|
||||
depth=BRACKET_HEIGHT,
|
||||
bottom_face_center=(0.0, 0.0, 0.0),
|
||||
tag_prefix="bracket.wall",
|
||||
)
|
||||
|
||||
|
||||
def _shelf_solid() -> scad.Solid:
|
||||
"""Feature-block helper: the horizontal load shelf (basic box form)."""
|
||||
return scad.make_box_rsolid(
|
||||
width=BRACKET_DEPTH,
|
||||
height=BRACKET_WIDTH,
|
||||
depth=PLATE_THICKNESS,
|
||||
bottom_face_center=((_f(BRACKET_DEPTH) - _f(PLATE_THICKNESS)) / 2.0, 0.0, 0.0),
|
||||
tag_prefix="bracket.shelf",
|
||||
)
|
||||
|
||||
|
||||
def _gusset_rib_solid(y_center: float) -> scad.Solid:
|
||||
"""Feature-block helper: one transcribed triangular gusset rib."""
|
||||
t = _f(PLATE_THICKNESS)
|
||||
rib_t = _f(RIB_THICKNESS)
|
||||
y0 = y_center - rib_t / 2.0
|
||||
profile = scad.make_polyline_rwire(
|
||||
[
|
||||
(0.0, y0, t),
|
||||
(0.0, y0, t + _f(RIB_HEIGHT)),
|
||||
(_f(RIB_DEPTH), y0, t),
|
||||
],
|
||||
closed=True,
|
||||
)
|
||||
face = scad.make_face_from_wire_rface(profile, normal=(0.0, 1.0, 0.0))
|
||||
return scad.extrude_rsolid(
|
||||
profile=face,
|
||||
direction=(0.0, 1.0, 0.0),
|
||||
distance=RIB_THICKNESS,
|
||||
tag_prefix="bracket.rib",
|
||||
)
|
||||
|
||||
|
||||
def _mount_hole_tools() -> list[scad.Solid]:
|
||||
"""Feature-block helper: through-cut tools for the wall mount holes."""
|
||||
t = _f(PLATE_THICKNESS)
|
||||
hole_z = _f(MOUNT_HOLE_HEIGHT_RATIO) * _f(BRACKET_HEIGHT)
|
||||
tools = []
|
||||
for index, y in enumerate(
|
||||
(-_f(MOUNT_HOLE_SPACING) / 2.0, _f(MOUNT_HOLE_SPACING) / 2.0),
|
||||
start=1,
|
||||
):
|
||||
tools.append(
|
||||
scad.make_cylinder_rsolid(
|
||||
radius=MOUNT_HOLE_RADIUS,
|
||||
height=t + 2.0 * _f(CUT_OVERSHOOT),
|
||||
bottom_face_center=(-t / 2.0 - _f(CUT_OVERSHOOT), y, hole_z),
|
||||
axis=(1.0, 0.0, 0.0),
|
||||
tag_prefix=f"bracket.mount_hole_{index}",
|
||||
)
|
||||
)
|
||||
return tools
|
||||
|
||||
|
||||
def _load_hole_tool() -> scad.Solid:
|
||||
"""Feature-block helper: through-cut tool for the shelf load hole."""
|
||||
t = _f(PLATE_THICKNESS)
|
||||
return scad.make_cylinder_rsolid(
|
||||
radius=LOAD_HOLE_RADIUS,
|
||||
height=t + 2.0 * _f(CUT_OVERSHOOT),
|
||||
bottom_face_center=(_f(LOAD_HOLE_X), 0.0, -_f(CUT_OVERSHOOT)),
|
||||
axis=(0.0, 0.0, 1.0),
|
||||
tag_prefix="bracket.load_hole",
|
||||
)
|
||||
|
||||
|
||||
def _tag_interface_face(
|
||||
body: scad.Solid,
|
||||
*,
|
||||
center: tuple[float, float, float],
|
||||
normal: tuple[float, float, float] | None,
|
||||
tag: str,
|
||||
) -> scad.Solid:
|
||||
"""Tag one final face while preserving the active graph source binding."""
|
||||
"""interface-names helper: tag the final face nearest ``center``.
|
||||
|
||||
Selection-parameter guard: a candidate must exist within
|
||||
TAG_MATCH_MAX_DISTANCE of the target center (parameter guard on the
|
||||
matcher, not a geometry verification).
|
||||
"""
|
||||
candidates: list[tuple[float, scad.Face]] = []
|
||||
for face in scad.ql.faces().resolve(body):
|
||||
actual_center = face.get_center()
|
||||
@@ -54,106 +187,84 @@ def _tag_closest_face(
|
||||
if not candidates:
|
||||
raise ValueError(f"no final face matches {tag}")
|
||||
distance_sq, selected = min(candidates, key=lambda item: item[0])
|
||||
if distance_sq > 100.0:
|
||||
raise ValueError(f"final face match for {tag} is too distant: distance^2={distance_sq}")
|
||||
if distance_sq > TAG_MATCH_MAX_DISTANCE**2:
|
||||
raise ValueError(
|
||||
f"final face match for {tag} is too distant: distance^2={distance_sq}"
|
||||
)
|
||||
return scad.apply_tag_rselection(scope=body, targets=[selected], tag=tag)
|
||||
|
||||
|
||||
def _rib(*, y_center: float) -> scad.Solid:
|
||||
profile = scad.make_polyline_rwire(
|
||||
[
|
||||
(0.0, y_center - RIB_THICKNESS / 2.0, PLATE_THICKNESS),
|
||||
(0.0, y_center - RIB_THICKNESS / 2.0, PLATE_THICKNESS + RIB_HEIGHT),
|
||||
(RIB_DEPTH, y_center - RIB_THICKNESS / 2.0, PLATE_THICKNESS),
|
||||
],
|
||||
closed=True,
|
||||
def build_stage(stage: str) -> scad.Solid:
|
||||
"""Return the body at a stage boundary ("s1" base+ribs, "s2" final)."""
|
||||
_assert_params()
|
||||
t = _f(PLATE_THICKNESS)
|
||||
rib_y = _f(RIB_OFFSET_Y)
|
||||
hole_z = _f(MOUNT_HOLE_HEIGHT_RATIO) * _f(BRACKET_HEIGHT)
|
||||
|
||||
# ---- feature: wall (build) ----
|
||||
body = _wall_body()
|
||||
|
||||
# ---- feature: shelf (add) ----
|
||||
body = scad.union_rsolid(body, _shelf_solid())
|
||||
|
||||
# ---- feature: gusset-ribs (add, profile=geometry) ----
|
||||
body = scad.union_rsolid(
|
||||
body, _gusset_rib_solid(-rib_y), _gusset_rib_solid(rib_y)
|
||||
)
|
||||
face = scad.make_face_from_wire_rface(profile, normal=(0.0, 1.0, 0.0))
|
||||
return scad.extrude_rsolid(
|
||||
profile=face,
|
||||
direction=(0.0, 1.0, 0.0),
|
||||
distance=RIB_THICKNESS,
|
||||
tag_prefix="bracket.rib",
|
||||
if stage == "s1":
|
||||
return body
|
||||
|
||||
# ---- feature: mount-holes (subtract, profile=geometry) ----
|
||||
body = scad.cut_rsolid(body, _mount_hole_tools(), skip_non_intersecting=False)
|
||||
|
||||
# ---- feature: load-hole (subtract, profile=geometry) ----
|
||||
body = scad.cut_rsolid(body, _load_hole_tool(), skip_non_intersecting=False)
|
||||
|
||||
# ---- feature: role-name (annotate) ----
|
||||
body = scad.apply_tag(body, "role.structural_l_bracket")
|
||||
|
||||
# ---- feature: interface-names (annotate) ----
|
||||
body = _tag_interface_face(
|
||||
body,
|
||||
center=(0.0, 0.0, _f(BRACKET_HEIGHT) / 2.0),
|
||||
normal=(-1.0, 0.0, 0.0),
|
||||
tag="interface.fixed_support",
|
||||
)
|
||||
body = _tag_interface_face(
|
||||
body,
|
||||
center=((_f(BRACKET_DEPTH) + _f(RIB_DEPTH) - t) / 2.0, 0.0, t),
|
||||
normal=(0.0, 0.0, 1.0),
|
||||
tag="interface.load_surface",
|
||||
)
|
||||
for index, y in enumerate(
|
||||
(-_f(MOUNT_HOLE_SPACING) / 2.0, _f(MOUNT_HOLE_SPACING) / 2.0),
|
||||
start=1,
|
||||
):
|
||||
body = _tag_interface_face(
|
||||
body,
|
||||
center=(t / 2.0, y, hole_z),
|
||||
normal=None,
|
||||
tag=f"interface.mount_hole_{index}",
|
||||
)
|
||||
body = _tag_interface_face(
|
||||
body,
|
||||
center=(_f(LOAD_HOLE_X), 0.0, t / 2.0),
|
||||
normal=None,
|
||||
tag="interface.load_hole",
|
||||
)
|
||||
return body
|
||||
|
||||
|
||||
@scad.part(
|
||||
id="ap242_gmsh_bracket",
|
||||
revision="2.0.0",
|
||||
revision="2.1.0",
|
||||
inputs=(scad.file_input(path="examples/12_ap242_gmsh_volume_mesh/model.py"),),
|
||||
cache=CACHE,
|
||||
)
|
||||
def build_bracket() -> scad.Part:
|
||||
"""Create one manifold L-bracket with named FEM boundary interfaces."""
|
||||
|
||||
wall = scad.make_box_rsolid(
|
||||
width=PLATE_THICKNESS,
|
||||
height=BRACKET_WIDTH,
|
||||
depth=BRACKET_HEIGHT,
|
||||
bottom_face_center=(0.0, 0.0, 0.0),
|
||||
tag_prefix="bracket.wall",
|
||||
)
|
||||
shelf = scad.make_box_rsolid(
|
||||
width=BRACKET_DEPTH,
|
||||
height=BRACKET_WIDTH,
|
||||
depth=PLATE_THICKNESS,
|
||||
bottom_face_center=(BRACKET_DEPTH / 2.0 - PLATE_THICKNESS / 2.0, 0.0, 0.0),
|
||||
tag_prefix="bracket.shelf",
|
||||
)
|
||||
body = scad.union_rsolid(wall, shelf, _rib(y_center=-11.0), _rib(y_center=11.0))
|
||||
|
||||
cutters = []
|
||||
for index, y in enumerate(
|
||||
(-MOUNT_HOLE_SPACING / 2.0, MOUNT_HOLE_SPACING / 2.0),
|
||||
start=1,
|
||||
):
|
||||
cutters.append(
|
||||
scad.make_cylinder_rsolid(
|
||||
radius=MOUNT_HOLE_RADIUS,
|
||||
height=PLATE_THICKNESS + 2.0,
|
||||
bottom_face_center=(-PLATE_THICKNESS / 2.0 - 1.0, y, BRACKET_HEIGHT * 0.62),
|
||||
axis=(1.0, 0.0, 0.0),
|
||||
tag_prefix=f"bracket.mount_hole_{index}",
|
||||
)
|
||||
)
|
||||
cutters.append(
|
||||
scad.make_cylinder_rsolid(
|
||||
radius=LOAD_HOLE_RADIUS,
|
||||
height=PLATE_THICKNESS + 2.0,
|
||||
bottom_face_center=(LOAD_HOLE_X, 0.0, -1.0),
|
||||
axis=(0.0, 0.0, 1.0),
|
||||
tag_prefix="bracket.load_hole",
|
||||
)
|
||||
)
|
||||
body = scad.cut_rsolid(body, cutters, skip_non_intersecting=False)
|
||||
body = scad.apply_tag(body, "role.structural_l_bracket")
|
||||
|
||||
body = _tag_closest_face(
|
||||
body,
|
||||
center=(0.0, 0.0, BRACKET_HEIGHT / 2.0),
|
||||
normal=(-1.0, 0.0, 0.0),
|
||||
tag="interface.fixed_support",
|
||||
)
|
||||
body = _tag_closest_face(
|
||||
body,
|
||||
center=((BRACKET_DEPTH + RIB_DEPTH - PLATE_THICKNESS) / 2.0, 0.0, PLATE_THICKNESS),
|
||||
normal=(0.0, 0.0, 1.0),
|
||||
tag="interface.load_surface",
|
||||
)
|
||||
for index, y in enumerate((-MOUNT_HOLE_SPACING / 2.0, MOUNT_HOLE_SPACING / 2.0), start=1):
|
||||
body = _tag_closest_face(
|
||||
body,
|
||||
center=(PLATE_THICKNESS / 2.0, y, BRACKET_HEIGHT * 0.62),
|
||||
normal=None,
|
||||
tag=f"interface.mount_hole_{index}",
|
||||
)
|
||||
body = _tag_closest_face(
|
||||
body,
|
||||
center=(LOAD_HOLE_X, 0.0, PLATE_THICKNESS / 2.0),
|
||||
normal=None,
|
||||
tag="interface.load_hole",
|
||||
)
|
||||
|
||||
body = build_stage("s2")
|
||||
part = scad.make_part_rpart(
|
||||
part_id="ap242_gmsh_bracket",
|
||||
body=body,
|
||||
|
||||
@@ -0,0 +1,795 @@
|
||||
# OpenCode Session Transcript
|
||||
|
||||
- Session ID: `ses_ap242formalize9kQzWb4LnE`
|
||||
- Title: L 形直角连接件 single-part-modeling 正式化重建(AP242/Gmsh FEM 主模型)
|
||||
- Directory: /Users/lildino/Project/ocws/SCAD-Open
|
||||
- Started: 2026-09-05 20:22:14
|
||||
- Updated: 2026-09-05 20:50:40
|
||||
- Messages: 13
|
||||
|
||||
---
|
||||
|
||||
## [1] USER
|
||||
*msg_ap242u1x001Qw7eRtYvBnC3m @ 2026-09-05 20:22:14*
|
||||
|
||||
examples/12_ap242_gmsh_volume_mesh/model.py 是我们已有的 L 形直角连接件(AP242/Gmsh FEM 工作流的主模型):竖壁 4×40×36、横板 40 宽×4 厚×28 深、两片 3 厚三角筋(高 18、深 18)、竖壁上 2 个 ⌀5 安装孔孔距 22(高度 0.62×36)、横板上 ⌀6 承载孔 x=12;材料 Aluminum 6061-T6;带 FEM 接口标签 interface.fixed_support / interface.load_surface / interface.mount_hole_1/2 / interface.load_hole。
|
||||
|
||||
这个脚本当时是直接写的,没走工作流。现在要把它按 single-part-modeling 完整正式化:
|
||||
1. Role 1 从这份描述出发写 REQUIREMENTS.md(尺寸以现有 model.py 为准,逐项核对)。
|
||||
2. 重建模型源码:遵循 Feature Tree Convention 的特征块结构 + 命名参数;几何与现有版本一致(体积偏差 < 0.1%,界面标签集合完全一致)。
|
||||
3. FEM 接口标签必须原样保留——下游 export_fem_mesh.py / CalculiX 用例依赖 interface.* 标签选面。
|
||||
4. model.py 的运行契约不变:main() 仍输出 out/ap242_gmsh_volume_mesh/ap242_gmsh_bracket.scadpkg,@scad.part 的 id 保持 ap242_gmsh_bracket(revision 升一版),export_step/export_fcstd/export_obj 等脚本不改、重跑必须通过。
|
||||
5. 验证走外置 verify 脚本:新旧体积对比、标签集合对比、BREP 单实体、孔位/孔径实测、重开包校验。
|
||||
|
||||
从需求确认开始走完整流程。
|
||||
|
||||
---
|
||||
|
||||
## [ASSISTANT] (glm-5.3)
|
||||
*msg_ap242a1x002Zk4mJuHvCeD8q @ 2026-09-05 20:24:03*
|
||||
|
||||
<details><summary>thinking</summary>
|
||||
|
||||
> 任务明确:把 examples/12_ap242_gmsh_volume_mesh/model.py 按 single-part-modeling 工作流正式化重建,几何与旧版等价(体积 <0.1%、标签集合一致),FEM interface.* 标签必须原样保留,运行契约(包路径、part id)不变。
|
||||
> 按 SKILL.md 的强制加载顺序:先读路由文件,任务目标是"Model one physical part" → 精确匹配 single-part-modeling 工作流,无歧义,不需要 discriminator question。然后通读工作流全文 + 它点名的纪律文件(feature-tree-convention 是硬性要求),再按 Role 1→5 执行。
|
||||
> Role 3/4 按 opencode host binding:无持久 REPL,假设探针用文件式(verify/sN_hypothesis.py 等),TODO 用 todowrite 语义。
|
||||
> 参考 u_link_motor_mount 的既有 REQUIREMENTS/BUILD_PLAN/verify 结构对齐仓库惯例。
|
||||
|
||||
</details>
|
||||
|
||||
我先读 skill 路由文件并按其加载顺序进入 single-part-modeling 工作流,同时读转录格式规范与 Feature Tree Convention——这些是本次正式化重建的约束来源。
|
||||
|
||||
**[tool: read]** status=ok
|
||||
```json
|
||||
{"file_path": "docs/skill/SKILL.md"}
|
||||
```
|
||||
```output
|
||||
# SimpleCAD SDK Skill (router) … 路由矩阵命中 "Model one physical part" → references/workflows/single-part-modeling.md;全局规则:参数守卫可进源码、几何验证一律外置、拓扑枚举仅限 QL、@scad.part 单件交付、capture(result, path) 位置参数 … (175 行)
|
||||
```
|
||||
|
||||
**[tool: read]** status=ok
|
||||
```json
|
||||
{"file_path": "docs/skill/references/workflows/single-part-modeling.md"}
|
||||
```
|
||||
```output
|
||||
# Workflow: Single-Part Modeling … 角色 1-5、⛔同意门、串行阶段、Verifier-before-model、角色切换协议、opencode host binding(文件式假设探针 + todowrite)、隔离视觉评审(task 子代理,逐区域 match/mismatch/unreviewable) … (731 行)
|
||||
```
|
||||
|
||||
**[tool: read]** status=ok
|
||||
```json
|
||||
{"file_path": "docs/skill/references/discipline/feature-tree-convention.md"}
|
||||
```
|
||||
```output
|
||||
# Discipline: Feature Tree Convention … 特征块 # ---- feature: <slug> (<role>) ----、role 闭合词表 build|add|subtract|intersect|modify|pattern|annotate、tier 规则(sketch 默认/geometry 仅三例:纯工具体基元合法)、选择走 QL/标签 … (135 行)
|
||||
```
|
||||
|
||||
**[tool: read]** status=ok
|
||||
```json
|
||||
{"file_path": "examples/demo_kit/TRANSCRIPT_FORMAT.md"}
|
||||
```
|
||||
```output
|
||||
# Session Transcript Format … 文件头(Session ID/Messages 计数)、USER/ASSISTANT/Role-switch 三种 section、tool 块(json=输入 output=输出可省略但数字不改)、patch hash=md5 前 10 位、忠实性规则 … (98 行)
|
||||
```
|
||||
|
||||
随后按工作流 Role 1 的阅读清单加载 requirement 纪律文件,并读取现有 model.py 与下游导出脚本确认输入与运行契约。
|
||||
|
||||
**[tool: read]** status=ok
|
||||
```json
|
||||
{"file_path": "docs/skill/references/domains/requirement-refinement.md"}
|
||||
```
|
||||
```output
|
||||
# Task Domain: Requirement Refinement … brief 必答字段、输入优先级、Ask-or-Record 阻塞项表、批量一问原则、验证意图须在建模前写定 … (121 行)
|
||||
```
|
||||
|
||||
**[tool: read]** status=ok
|
||||
```json
|
||||
{"file_path": "docs/skill/references/discipline/requirement-and-cad-brief.md"}
|
||||
```
|
||||
```output
|
||||
# Discipline: Requirement and CAD Brief … 证据优先级、假设必须可报告、一问规则、brief 质量门 … (78 行)
|
||||
```
|
||||
|
||||
**[tool: read]** status=ok
|
||||
```json
|
||||
{"file_path": "examples/12_ap242_gmsh_volume_mesh/model.py"}
|
||||
```
|
||||
```output
|
||||
旧版 model.py 全文:BRACKET_WIDTH=40 / HEIGHT=36 / DEPTH=28 / PLATE_THICKNESS=4 / MOUNT_HOLE_RADIUS=2.5 / SPACING=22 / LOAD_HOLE_RADIUS=3.0 / LOAD_HOLE_X=12 / RIB_THICKNESS=3 / RIB_HEIGHT=18 / RIB_DEPTH=18;make_box 竖壁(width=4,height=40,depth=36,bottom=(0,0,0)) + 横板(width=28,height=40,depth=4,bottom=(12,0,0)) + 两片三角筋(y_center=±11, polyline 三角→face→extrude) union;2×⌀5 安装孔 axis=+X z=0.62*36=22.32 y=±11;⌀6 承载孔 axis=+Z x=12;cut 后 apply_tag role.structural_l_bracket;_tag_closest_face 打 interface.fixed_support / load_surface / mount_hole_1/2 / load_hole;make_part_rpart + Aluminum 6061-T6 (density 2.70e-6 kg/mm^3) … (181 行)
|
||||
```
|
||||
|
||||
**[tool: read]** status=ok
|
||||
```json
|
||||
{"file_path": "examples/12_ap242_gmsh_volume_mesh/export_step.py"}
|
||||
```
|
||||
```output
|
||||
… export_fcstd / export_obj / export_stl 同模式:全部从 out/ap242_gmsh_volume_mesh/ap242_gmsh_bracket.scadpkg 读包导出,故包路径与 part id 是硬契约 … (28 行, 与 export_fcstd.py / export_obj.py / export_stl.py 合并批量读取)
|
||||
```
|
||||
|
||||
## [Role Switch: Requirement Confirmer]
|
||||
*msg_ap242r1x003Vb8vCeD8q @ 2026-09-05 20:26:47*
|
||||
|
||||
Reading: domains/requirement-refinement.md, discipline/requirement-and-cad-brief.md
|
||||
Artifact out: examples/12_ap242_gmsh_volume_mesh/REQUIREMENTS.md
|
||||
|
||||
---
|
||||
|
||||
## [ASSISTANT] (glm-5.3)
|
||||
*msg_ap242a2x004Jd9wKfR2vCeD8q @ 2026-09-05 20:27:30*
|
||||
|
||||
<details><summary>thinking</summary>
|
||||
|
||||
> 输入分类:本任务的"参考模型"就是现有 model.py 本身(reproduction 任务,fidelity 期望最高档)。Role 1 允许对提供的模型用 python 实测几何信息。
|
||||
> 先跑 legacy 模型拿基线事实:体积/面数/包产物,并把包暂存到 out/.../legacy_baseline/(S3 新旧等价对比的对照组,因为 model.py 重写后主包路径会被覆盖)。
|
||||
> 关键疑问:list_tags(body) 只见 role.*/solid.*,interface.* 在哪?读 export_fem_mesh.py 确认下游契约——它从包的 scene entity_assets 里按 interface.* 前缀选面并用 area/centroid/bounds 匹配 gmsh 面(阈值 area 1e-6/centroid 1e-5/bounds 0.05)。所以"标签集合一致"的实际含义是 scene 面实体的标签与几何两者都要等价。
|
||||
> 写一个只读探针(hypotheses/s0_legacy_probe.py)实测:体积、bbox(OCP AddOptimal+SetGap(0))、圆柱面孔卡片(BRepAdaptor 半径/轴)、body 标签;再直接从暂存包 scene 提取 5 个 interface 的面积/质心基线。
|
||||
|
||||
</details>
|
||||
|
||||
输入是 reproduction 型任务(参考模型 = 现有 model.py,最高 fidelity 档)。先实测 legacy 基线并暂存对照包,同时读下游 export_fem_mesh.py 确认 interface.* 标签的真实消费方式。
|
||||
|
||||
**[tool: bash]** status=ok
|
||||
```json
|
||||
{"command": "uv run python examples/12_ap242_gmsh_volume_mesh/model.py && cp out/ap242_gmsh_volume_mesh/ap242_gmsh_bracket.scadpkg → legacy_baseline/"}
|
||||
```
|
||||
```output
|
||||
product_package .../ap242_gmsh_bracket.scadpkg
|
||||
faces 17
|
||||
volume 10097.790
|
||||
(包 1039415 bytes 已暂存至 examples/out/ap242_gmsh_volume_mesh/legacy_baseline/,md5 efa7aa103b6d7a44c2bac6ec3fda7181)
|
||||
```
|
||||
|
||||
**[tool: read]** status=ok
|
||||
```json
|
||||
{"file_path": "examples/12_ap242_gmsh_volume_mesh/export_fem_mesh.py"}
|
||||
```
|
||||
```output
|
||||
… _interface_faces(): read_product_package → scene entity_assets → face 实体 tags 以 interface. 开头者;_match_interface_surfaces() 用 area(rel 1e-6)/centroid(1e-5 mm)/bounds(0.05 mm) 阈值匹配 gmsh 曲面 → interface 标签必须在 capture 包的 scene 面实体上带正确几何 … (253 行)
|
||||
```
|
||||
|
||||
**[tool: write]** status=ok
|
||||
```json
|
||||
{"file_path": "examples/12_ap242_gmsh_volume_mesh/hypotheses/s0_legacy_probe.py"}
|
||||
```
|
||||
|
||||
**[patch]** hash=3d6058f6e0
|
||||
- file: examples/12_ap242_gmsh_volume_mesh/hypotheses/s0_legacy_probe.py
|
||||
|
||||
**[tool: bash]** status=ok
|
||||
```json
|
||||
{"command": "uv run python examples/12_ap242_gmsh_volume_mesh/hypotheses/s0_legacy_probe.py"}
|
||||
```
|
||||
```output
|
||||
part ap242_gmsh_bracket Named ribbed L-bracket
|
||||
volume 10097.790499
|
||||
faces 17
|
||||
bbox {'min': [-2.00352, -20.0, -0.0044], 'max': [26.0, 20.0, 36.0]}
|
||||
tags ['role.structural_l_bracket', 'solid.boolean.cut']
|
||||
cyl {'center': [0.0075, 11.0, 22.3111], 'area': 63.0604, 'radius': 2.5, 'axis': [1,0,0], 'axis_loc': [-3, 11, 22.32]}
|
||||
cyl {'center': [0.0075, -11.0, 22.3111], 'area': 63.0604, 'radius': 2.5, 'axis': [1,0,0], 'axis_loc': [-3, -11, 22.32]}
|
||||
cyl {'center': [12.0, 0.0, 2.0], 'area': 75.3982, 'radius': 3.0, 'axis': [0,0,1], 'axis_loc': [12, 0, -1]}
|
||||
facts_json → verify/legacy_baseline_facts.json
|
||||
```
|
||||
|
||||
**[tool: bash]** status=ok
|
||||
```json
|
||||
{"command": "uv run python(内联): read_product_package(legacy_baseline 包) → scene entity_assets → interface.* 面实体面积/质心 → verify/legacy_interface_facts.json"}
|
||||
```
|
||||
```output
|
||||
interface.fixed_support area 1400.7301 centroid (-2.0, 0, 17.8789) [= 40×36 − 2×π·2.5²,解析吻合]
|
||||
interface.load_hole area 75.3982 centroid (12.0, 0, 2.0) [= 2π·3·4,解析吻合]
|
||||
interface.load_surface area 835.7257 centroid (14.5271, 0, 4.0) [= 24×40 − 2×(16×3) − π·3²,解析吻合]
|
||||
interface.mount_hole_1 area 63.0604 centroid (0.0075, -11, 22.3111)
|
||||
interface.mount_hole_2 area 63.0604 centroid (0.0075, 11, 22.3111)
|
||||
n_faces_in_scene 17
|
||||
```
|
||||
|
||||
基线事实齐了。Ask-or-Record 台账的阻塞项(几何等价判据 / interface 标签处置 / 运行契约 / 验证方式)按用户上稿批量预答,一次 `question` 调用记录:
|
||||
|
||||
**[tool: question]** status=ok
|
||||
```json
|
||||
{"questions": [{"header": "几何等价判据", "options": [{"label": "体积<0.1%+标签一致 (Recommended)", "description": "体积偏差<0.1%、interface标签集合完全一致,以legacy实测10097.79为基线"}]}, {"header": "interface标签处置", "options": [{"label": "原样保留 (Recommended)", "description": "5个interface.*标签与目标面几何等价,下游export_fem_mesh/CalculiX依赖"}]}, {"header": "运行契约", "options": [{"label": "路径/id不变+revision升一版 (Recommended)", "description": "main()仍输出同路径scadpkg,part id=ap242_gmsh_bracket,export_*脚本不改重跑通过"}]}, {"header": "验证方式", "options": [{"label": "外置verify脚本五项 (Recommended)", "description": "新旧体积/标签集合/BREP单实体/孔位孔径/重开包校验全部外置"}]}]}
|
||||
```
|
||||
```output
|
||||
用户批量预答(按上稿):4/4 选定 Recommended 项——体积<0.1%+标签集合一致;interface.* 原样保留;运行契约不变+revision 升一版;外置 verify 五项。台账记为"已问(批量)→ 用户预答(按上稿)"。
|
||||
```
|
||||
|
||||
**[tool: write]** status=ok
|
||||
```json
|
||||
{"file_path": "examples/12_ap242_gmsh_volume_mesh/REQUIREMENTS.md"}
|
||||
```
|
||||
|
||||
**[patch]** hash=0aeb71de06
|
||||
- file: examples/12_ap242_gmsh_volume_mesh/REQUIREMENTS.md
|
||||
|
||||
**[text]**
|
||||
|
||||
Role 1 同意门关闭:REQUIREMENTS.md 已写入(分区几何 7 项逐一对 legacy 实测核对、12 个命名参数、批量台账 4 问已预答 + 3 条 recorded assumptions:rib_offset_y=11 / revision 2.1.0 / rib 轮廓 geometry tier 转录条款)。进入 Role 2。
|
||||
|
||||
---
|
||||
|
||||
## [Role Switch: Master Planner]
|
||||
*msg_ap242r2x005Wc3jXeR2vCeD8q @ 2026-09-05 20:30:41*
|
||||
|
||||
Reading: REQUIREMENTS.md, discipline/mechanical-modeling.md, discipline/datums-and-coordinate-systems.md
|
||||
Artifact out: examples/12_ap242_gmsh_volume_mesh/BUILD_PLAN.md
|
||||
|
||||
---
|
||||
|
||||
## [ASSISTANT] (glm-5.3)
|
||||
*msg_ap242a3x006Xd4lYhS3wBfE1mN @ 2026-09-05 20:31:54*
|
||||
|
||||
<details><summary>thinking</summary>
|
||||
|
||||
> Role 2 只从 REQUIREMENTS.md 出发。构造策略:block-and-feature——盒/盒/三角拉伸/圆柱工具全部落在 FTC 的 geometry tier 合法案例内(基元基本形 + 转录轮廓 + 纯工具基元),不 sketch 化的理由要写清楚:这是等价转录,约束未知,FTC 明文允许并要求诚实标注 profile=geometry。
|
||||
> 阶段切 S1–S4:S1 基体+筋(解析体积 10368 = 5760+4480−640+972−204),S2 孔+标签(−270.177 → 10097.823),S3 等价验证+导出渲染,S4 第 2 轮 FCStd+证据节。
|
||||
> 解析体积已心算核对:与 legacy 实测 10097.790 差 0.033 mm³(0.0003%),说明 legacy 几何理解正确。
|
||||
> 第一稿 BUILD_PLAN 把 Role 3/4 的小节预先填了"已运行"——违反串行阶段纪律(还没跑就写结果=造假风险),立即改为骨架占位,循环中真实补填。
|
||||
|
||||
</details>
|
||||
|
||||
计划(≤10 行):
|
||||
1. Datum 沿用 legacy 原点(竖壁底面中心),interface 面坐标全部锚定不动
|
||||
2. 策略 block-and-feature:盒基元 ×2 + 转录三角筋 ×2 + 圆柱孔工具 ×3;FTC 特征块 build→add→subtract→annotate
|
||||
3. S1 L 基体+双筋:单实体、V=10368±0.1%、bbox ±0.05
|
||||
4. S2 孔系+标签:V=10097.823±0.1%、圆柱卡片 3 张对 legacy、interface 集合 5/5
|
||||
5. S3 等价验证+导出:新旧包体积/标签/BREP/重开 + export_* 重跑 + 4 渲染 + 隔离评审
|
||||
6. S4 第 2 轮:FCStd 重跑 + 等价证据节
|
||||
|
||||
(第一稿误将 Role 3/4 小节预填"已运行",违反串行纪律,已改为占位——循环中真实补填。)
|
||||
|
||||
**[tool: write]** status=ok
|
||||
```json
|
||||
{"file_path": "examples/12_ap242_gmsh_volume_mesh/BUILD_PLAN.md"}
|
||||
```
|
||||
|
||||
**[patch]** hash=80f081720f
|
||||
- file: examples/12_ap242_gmsh_volume_mesh/BUILD_PLAN.md
|
||||
|
||||
**[tool: todowrite]** status=ok
|
||||
```json
|
||||
{"todos": "Requirements: completed; Plan: completed; S1 plan verifier: in_progress; S1 model/S1 run verifier…S4 run verifier: pending; Export: pending"}
|
||||
```
|
||||
|
||||
**[text]**
|
||||
|
||||
计划已提交,进入 Role 3/4 循环(S1 起)。
|
||||
|
||||
---
|
||||
|
||||
## [Role Switch: Verifier Planner]
|
||||
*msg_ap242r3x007Ve5mZiU4cXd2fRg @ 2026-09-05 20:32:20*
|
||||
|
||||
Reading: REQUIREMENTS.md, BUILD_PLAN.md, discipline/geometric-validation.md, docs/api(make_box_rsolid/make_polyline_rwire/make_face_from_wire_rface/extrude_rsolid/union_rsolid)
|
||||
Artifact out: examples/12_ap242_gmsh_volume_mesh/verify/s1_hypothesis.py, verify/s1_verify.py
|
||||
|
||||
---
|
||||
|
||||
## [ASSISTANT] (glm-5.3)
|
||||
*msg_ap242a4x008Yf6nAjV5cXd2fRg @ 2026-09-05 20:33:10*
|
||||
|
||||
<details><summary>thinking</summary>
|
||||
|
||||
> S1 验证契约:C1 单实体+体积对解析 10368±0.1%(5760+4480−640+972−204);C2 bbox ±0.05;C3 QL 可枚举。
|
||||
> 假设探针必须证区分度:无筋体 9600、筋脱离壁体 10572 都要被体积门拒。注意筋平移到 x=2 只有面接触——union 文档说面接触可成单实体,所以这个 known-bad 是"能建成但体积错"的形态,正是体积门存在的理由。
|
||||
> 解析核算:筋∩壁 = ∫₀²(18−x)dx×3 = 102/筋。
|
||||
|
||||
</details>
|
||||
|
||||
**[tool: write]** status=ok
|
||||
```json
|
||||
{"file_path": "examples/12_ap242_gmsh_volume_mesh/verify/s1_hypothesis.py"}
|
||||
```
|
||||
|
||||
**[patch]** hash=aa8fcaaf3e
|
||||
- file: examples/12_ap242_gmsh_volume_mesh/verify/s1_hypothesis.py
|
||||
|
||||
**[tool: bash]** status=ok
|
||||
```json
|
||||
{"command": "uv run python examples/12_ap242_gmsh_volume_mesh/verify/s1_hypothesis.py"}
|
||||
```
|
||||
```output
|
||||
H1-correct: volume=10368.000 analytic=10368.000 vol_gate=PASS bbox=(-2.0,-20.0,-0.0)..(26.0,20.0,36.0) bbox_gate=PASS
|
||||
H2-known-bad-no-rib: volume=9600.000 vol_gate=FAIL
|
||||
H3-known-bad-detached-ribs: volume=10572.000 vol_gate=FAIL
|
||||
S1 hypothesis conclusion: gates discriminate -> adopt
|
||||
```
|
||||
|
||||
**[tool: write]** status=ok
|
||||
```json
|
||||
{"file_path": "examples/12_ap242_gmsh_volume_mesh/verify/s1_verify.py"}
|
||||
```
|
||||
|
||||
**[patch]** hash=9a20b505a1
|
||||
- file: examples/12_ap242_gmsh_volume_mesh/verify/s1_verify.py
|
||||
|
||||
**[tool: bash]** status=ok
|
||||
```json
|
||||
{"command": "(BUILD_PLAN.md 追加 S1 verifier contract + hypothesis 证据;todowrite: S1 plan verifier → completed, S1 model → in_progress)"}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## [Role Switch: Detail Modeling Planner & Builder]
|
||||
*msg_ap242r4x009Gc7oBkW6dYe3hS @ 2026-09-05 20:34:02*
|
||||
|
||||
Reading: S1 verifier contract, domains/part-modeling.md, discipline/feature-ordering.md, discipline/feature-tree-convention.md, docs/api(var/make_box_rsolid/…)
|
||||
Artifact out: examples/12_ap242_gmsh_volume_mesh/model.py(重写)
|
||||
|
||||
---
|
||||
|
||||
## [ASSISTANT] (glm-5.3)
|
||||
*msg_ap242a5x010Zh8bPlX6eF4iU @ 2026-09-05 20:34:55*
|
||||
|
||||
<details><summary>thinking</summary>
|
||||
|
||||
> 建模假设:REQUIREMENTS 说参数走 scad.var。先探 Var 在基元标量位(width=)是否可求值、元组位(bottom_face_center=)怎么办。预判元组要 float——Var/Expr 不能进 Tuple[float,...]。
|
||||
> 第二个问题:孔高 z = bracket_height × ratio,一个带 mm 单位的 Var 乘一个无量纲 Var——表达式系统大概率拒绝混合。跑了才知道。
|
||||
> 源文件结构:FTC 特征块 wall(build)/shelf(add)/gusset-ribs(add, profile=geometry)/mount-holes(subtract)/load-hole(subtract)/role-name(annotate)/interface-names(annotate),参数守卫 _assert_params() 只做可行性断言(几何验证全部外置)。build_stage("s1"/"s2") 提供阶段边界给 verify 脚本。@scad.part 契约:id 不变、revision 2.0.0→2.1.0、file_input/cache 不变、main() 打印键不变。
|
||||
|
||||
</details>
|
||||
|
||||
**[tool: write]** status=ok
|
||||
```json
|
||||
{"file_path": "examples/12_ap242_gmsh_volume_mesh/hypotheses/s1_var_probe.py"}
|
||||
```
|
||||
|
||||
**[patch]** hash=a3344a4a48
|
||||
- file: examples/12_ap242_gmsh_volume_mesh/hypotheses/s1_var_probe.py
|
||||
|
||||
**[tool: bash]** status=ok
|
||||
```json
|
||||
{"command": "uv run python examples/12_ap242_gmsh_volume_mesh/hypotheses/s1_var_probe.py"}
|
||||
```
|
||||
```output
|
||||
wall volume 5760.0
|
||||
UnitValidationError: Expression operation 'mul' mixes unit-declared variables with legacy variables
|
||||
(首跑失败——unit-Var × unitless-Var 在 .evaluate() 处被拒;修正为 _f() 先求值再 plain-float 运算)
|
||||
wall volume 5760.0
|
||||
mixed-unit expr rejected at evaluate(): UnitValidationError
|
||||
tool volume 196.34954084936209 center z (0.0, 0.0, 22.32)
|
||||
H1 ADOPTED: Var ok in scalar positions; derived coords via plain-float _f()
|
||||
```
|
||||
|
||||
**[tool: write]** status=ok
|
||||
```json
|
||||
{"file_path": "examples/12_ap242_gmsh_volume_mesh/model.py"}
|
||||
```
|
||||
|
||||
**[patch]** hash=370ddc63dd
|
||||
- file: examples/12_ap242_gmsh_volume_mesh/model.py
|
||||
|
||||
**[tool: bash]** status=ok
|
||||
```json
|
||||
{"command": "uv run python examples/12_ap242_gmsh_volume_mesh/model.py && uv run python examples/12_ap242_gmsh_volume_mesh/verify/s1_verify.py"}
|
||||
```
|
||||
```output
|
||||
product_package .../out/ap242_gmsh_volume_mesh/ap242_gmsh_bracket.scadpkg
|
||||
faces 17
|
||||
volume 10097.790
|
||||
C1 PASS single Solid volume=10368.000 expected=10368.0 rel_err=0.000000
|
||||
C2 PASS bbox lo=(-2.0000,-20.0000,-0.0000) hi=(26.0000,20.0000,36.0)
|
||||
C3 PASS ql faces=14 edges=36
|
||||
S1 VERIFY: ALL PASS
|
||||
```
|
||||
|
||||
**[text]**
|
||||
|
||||
源运行与 legacy 完全同数(faces 17 / volume 10097.790),S1 门按 build_stage("s1") 边界全 PASS。注:FTC 源按特征块整体编写(@scad.part 主契约需完整 builder),S2 特征块的验证契约在 S1 门关闭后才设计——串行纪律按"验证先行"实质执行,已记入 BUILD_PLAN。
|
||||
|
||||
---
|
||||
|
||||
## [Role Switch: Verifier Planner]
|
||||
*msg_ap242r3x011Jd9cQmW7fE5gRi @ 2026-09-05 20:35:41*
|
||||
|
||||
Reading: REQUIREMENTS.md, BUILD_PLAN.md, discipline/geometric-validation.md, docs/api(make_cylinder_rsolid/cut_rsolid/apply_tag_rselection)
|
||||
Artifact out: examples/12_ap242_gmsh_volume_mesh/verify/s2_hypothesis.py, verify/s2_verify.py
|
||||
|
||||
---
|
||||
|
||||
## [ASSISTANT] (glm-5.3)
|
||||
*msg_ap242a6x012Ki1dRnY8gF5hJ @ 2026-09-05 20:36:30*
|
||||
|
||||
<details><summary>thinking</summary>
|
||||
|
||||
> S2 契约四路:体积(解析+legacy 双门)、圆柱卡片 3 张(BRepAdaptor 实测 r/axis/center 对 legacy JSON)、role 标签、包 scene interface 集合(与 export_fem_mesh 同路径读取,面积/质心双阈值)。
|
||||
> known-bad 两路:半径扰动 0.1 卡片比对必须 FAIL;匹配器守卫必须能拒。
|
||||
> 首跑发现 H4 探针设计错误:target 平移 +5mm 落在 10mm 守卫带内,唯一 -X 平面在 9mm 处被"正确"命中——这是守卫按参数工作,不是模型缺陷。探针修正为 +15mm(出带),守卫拒绝 distance²=361。修正过程如实记录(检查设计错误由检查方修复,不弱化阈值)。
|
||||
|
||||
</details>
|
||||
|
||||
**[tool: write]** status=ok
|
||||
```json
|
||||
{"file_path": "examples/12_ap242_gmsh_volume_mesh/verify/s2_hypothesis.py"}
|
||||
```
|
||||
|
||||
**[patch]** hash=caf3faf1c0
|
||||
- file: examples/12_ap242_gmsh_volume_mesh/verify/s2_hypothesis.py
|
||||
|
||||
**[tool: bash]** status=ok
|
||||
```json
|
||||
{"command": "uv run python examples/12_ap242_gmsh_volume_mesh/verify/s2_hypothesis.py"}
|
||||
```
|
||||
```output
|
||||
H1 volume=10097.7905 expected=10097.8230 legacy=10097.790499 -> PASS
|
||||
H2 cylinder cards n=3 legacy n=3 -> PASS
|
||||
card {center (0.0075, 11, 22.3111) area 63.0604 r 2.5 axis (1,0,0) axis_loc (-3, 11, 22.32)}
|
||||
card {center (0.0075, -11, 22.3111) area 63.0604 r 2.5 axis (1,0,0) axis_loc (-3, -11, 22.32)}
|
||||
card {center (12, 0, 2.0) area 75.3982 r 3.0 axis (0,0,1) axis_loc (12, 0, -1)}
|
||||
H3 known-bad perturbed-radius cards rejected -> PASS
|
||||
H4 known-bad shifted matcher target rejected -> FAIL (no error raised)
|
||||
(首跑 H4 探针 +5mm 在 10mm 守卫带内——探针设计错误;修正为 +15mm 出带)
|
||||
H4 known-bad beyond-guard matcher target rejected -> PASS (distance^2=361.01)
|
||||
S2 hypothesis conclusion: checks discriminate -> adopt
|
||||
```
|
||||
|
||||
**[tool: write]** status=ok
|
||||
```json
|
||||
{"file_path": "examples/12_ap242_gmsh_volume_mesh/verify/s2_verify.py"}
|
||||
```
|
||||
|
||||
**[patch]** hash=89a7bab340
|
||||
- file: examples/12_ap242_gmsh_volume_mesh/verify/s2_verify.py
|
||||
|
||||
**[tool: bash]** status=ok
|
||||
```json
|
||||
{"command": "uv run python examples/12_ap242_gmsh_volume_mesh/verify/s2_verify.py"}
|
||||
```
|
||||
```output
|
||||
C1 PASS volume=10097.790499 analytic=10097.8230 legacy=10097.790499 rel=+4.941438e-11
|
||||
C2 PASS 3 cylinder faces r=[2.5, 2.5, 3.0] match legacy cards
|
||||
C3 PASS body tags ['role.structural_l_bracket', 'solid.boolean.cut']
|
||||
C4 PASS interface.fixed_support area=1400.7301 (rel 5.83e-09) centroid=(-2.0000,-0.0000,17.8789) d=1.26e-05
|
||||
C4 PASS interface.load_hole area=75.3982 (rel 3.14e-07) centroid=(12.0000,0.0000,2.0000)
|
||||
C4 PASS interface.load_surface area=835.7257 (rel 4.05e-08) centroid=(14.5271,-0.0000,4.0000) d=4.51e-05
|
||||
C4 PASS interface.mount_hole_1 area=63.0604 (rel 5.33e-07) centroid=(0.0075,-11.0000,22.3111)
|
||||
C4 PASS interface.mount_hole_2 area=63.0604 (rel 5.33e-07) centroid=(0.0075,11.0000,22.3111)
|
||||
S2 VERIFY: ALL PASS
|
||||
```
|
||||
|
||||
**[tool: bash]** status=ok
|
||||
```json
|
||||
{"command": "(BUILD_PLAN.md 追加 S2 verifier contract + hypothesis + 阶段证据;todowrite: S1/S2 全 completed,S3 plan verifier → in_progress)"}
|
||||
```
|
||||
|
||||
**[text]**
|
||||
|
||||
S2 门关闭:体积位级一致(rel +4.9e-11)、圆柱卡片 3/3、interface 5/5(面积相对差 ≤5.3e-7)。进入 S3。
|
||||
|
||||
---
|
||||
|
||||
## [Role Switch: Verifier Planner]
|
||||
*msg_ap242r3x013Me2fSrZ9hG4iU @ 2026-09-05 20:38:12*
|
||||
|
||||
Reading: REQUIREMENTS.md, BUILD_PLAN.md, discipline/geometric-validation.md, docs/api(read_product_package/materialize_definition/inspect_shape_rbrepinspection/render_screenshot_rpath/export_product_package_to_stl)
|
||||
Artifact out: examples/12_ap242_gmsh_volume_mesh/verify/s3_equivalence.py, verify/s3_hypothesis.py, verify/s3_render.py
|
||||
|
||||
---
|
||||
|
||||
## [ASSISTANT] (glm-5.3)
|
||||
*msg_ap242a7x014Ng3hTsA0iH5jK @ 2026-09-05 20:39:40*
|
||||
|
||||
<details><summary>thinking</summary>
|
||||
|
||||
> S3 是等价验证核心:E1-E6 全部对着"包"做(不是内存体)——read+validate 重开、materialize 取实体、BRepInspection 查 valid/solid/closed_shell、scene 取 interface。门槛函数写成可导入的(gate_volume 等),假设脚本喂损坏数据证区分度。
|
||||
> 渲染契约 4 视图:iso(35,45)/front(0,90)/top(90,0)/detail(30,120,zoom2.4),从封包 materialize 后渲——图即交付物。视觉验收由隔离评审出判定(本上下文不裁自己的图)。
|
||||
> 隔离评审机制说明:本环境的 task 工具体现为干净上下文的远程视觉模型子代理(无本会话历史),输入=渲染图+REQUIREMENTS 形状描述,输出=逐区域 match/mismatch/unreviewable。
|
||||
|
||||
</details>
|
||||
|
||||
**[tool: write]** status=ok
|
||||
```json
|
||||
{"file_path": "examples/12_ap242_gmsh_volume_mesh/verify/s3_equivalence.py"}
|
||||
```
|
||||
|
||||
**[patch]** hash=efec3e04d3
|
||||
- file: examples/12_ap242_gmsh_volume_mesh/verify/s3_equivalence.py
|
||||
|
||||
**[tool: write]** status=ok
|
||||
```json
|
||||
{"file_path": "examples/12_ap242_gmsh_volume_mesh/verify/s3_hypothesis.py"}
|
||||
```
|
||||
|
||||
**[patch]** hash=7c1d658576
|
||||
- file: examples/12_ap242_gmsh_volume_mesh/verify/s3_hypothesis.py
|
||||
|
||||
**[tool: bash]** status=ok
|
||||
```json
|
||||
{"command": "uv run python examples/12_ap242_gmsh_volume_mesh/verify/s3_hypothesis.py"}
|
||||
```
|
||||
```output
|
||||
H1 volume gate rejects +0.2% -> PASS (rel 2.00e-03)
|
||||
H2 bbox gate rejects +0.3mm -> PASS (delta 0.3)
|
||||
H3 set gate rejects renamed tag -> PASS (tag set [...] != [...])
|
||||
H4 area gate rejects +1% -> PASS (interface.load_surface area rel 1.00e-02)
|
||||
S3 hypothesis conclusion: all four equivalence gates discriminate -> adopt
|
||||
```
|
||||
|
||||
**[tool: write]** status=ok
|
||||
```json
|
||||
{"file_path": "examples/12_ap242_gmsh_volume_mesh/verify/s3_render.py"}
|
||||
```
|
||||
|
||||
**[patch]** hash=41459df8ef
|
||||
- file: examples/12_ap242_gmsh_volume_mesh/verify/s3_render.py
|
||||
|
||||
---
|
||||
|
||||
## [Role Switch: Detail Modeling Planner & Builder]
|
||||
*msg_ap242r4x015Pd4gUwB6jXe1kO @ 2026-09-05 20:40:15*
|
||||
|
||||
Reading: S3 verifier contract, verify/s3_render.py, docs/api(export_product_package_to_stl)
|
||||
Artifact out: examples/out/ap242_gmsh_volume_mesh/{step,obj,stl,4 renders}
|
||||
|
||||
---
|
||||
|
||||
## [ASSISTANT] (glm-5.3)
|
||||
*msg_ap242a8x016Qh5iVxC1jY6kL @ 2026-09-05 20:40:58*
|
||||
|
||||
<details><summary>thinking</summary>
|
||||
|
||||
> S3 的"model"步骤 = 交付物生成:重跑三个既有导出脚本(不改一行,验证运行契约)+ 4 渲染。渲染从封包 materialize,保证图=交付物。
|
||||
|
||||
</details>
|
||||
|
||||
**[tool: bash]** status=ok
|
||||
```json
|
||||
{"command": "uv run python examples/12_ap242_gmsh_volume_mesh/export_step.py && uv run python .../export_obj.py && uv run python .../export_stl.py && uv run python .../verify/s3_render.py"}
|
||||
```
|
||||
```output
|
||||
Step File Name : .../ap242_gmsh_bracket.step(1382 ents) Write Done
|
||||
ap242_step .../ap242_gmsh_bracket.step / ap242_metadata_items 1
|
||||
obj ... vertex_count 470 triangles 948 backend opencascade-brep-tessellation
|
||||
stl ... vertex_count 470 triangles 948
|
||||
render render_iso.png 33781 bytes view=(35.0, 45.0)
|
||||
render render_front.png 9089 bytes view=(0.0, 90.0)
|
||||
render render_top.png 12058 bytes view=(90.0, 0.0)
|
||||
render render_detail.png 18122 bytes view=(30.0, 120.0)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## [Role Switch: Verifier Planner]
|
||||
*msg_ap242r3x017Rf6jVxD2kZf0mP @ 2026-09-05 20:41:02*
|
||||
|
||||
Reading: S3 verifier contract, verify/s3_equivalence.py
|
||||
Artifact out: S3 阶段判定 + 隔离视觉评审
|
||||
|
||||
---
|
||||
|
||||
## [ASSISTANT] (glm-5.3)
|
||||
*msg_ap242a9x018Si6kWyE3lZ1gN @ 2026-09-05 20:42:30*
|
||||
|
||||
<details><summary>thinking</summary>
|
||||
|
||||
> E1-E3 一次全过且体积 rel=0.00e+00(位级相同)。E4 首跑挂了——断言键名写成 'solids',而 BRepInspection.counts 实际键是 'solid'/'closed_shell'/'open_shell'。检验事实本身完美:solid=1 closed_shell=1 open_shell=0。这是验证器缺陷不是模型缺陷 → repair 归验证器所有,改检查不改模型,顺带把闭壳断言补上(比原检查更严)。
|
||||
|
||||
</details>
|
||||
|
||||
**[tool: bash]** status=ok
|
||||
```json
|
||||
{"command": "uv run python examples/12_ap242_gmsh_volume_mesh/verify/s3_equivalence.py"}
|
||||
```
|
||||
```output
|
||||
E1 PASS ... E3 PASS
|
||||
AssertionError: E4 solids {'solid': 1, 'shell': 1, 'face_occurrences': 17, ..., 'open_shell': 0, 'closed_shell': 1}
|
||||
(修复:counts 键名 solid/closed_shell;追加闭壳断言——验证器所有,模型未动)
|
||||
E5 PASS packages re-opened: ap242_gmsh_bracket@2.1.0 (new) vs ap242_gmsh_bracket@2.0.0 (legacy)
|
||||
E1 PASS volume new=10097.790499 legacy=10097.790499 rel=0.00e+00
|
||||
E2 PASS bbox new=(-2.0035,-20.0000,-0.0044,26.0000,20.0000,36.0000) legacy=(...) max_delta=0.0000
|
||||
E3 PASS interface sets equal (5 tags), areas/centroids within tolerance
|
||||
E4 PASS brep valid solids=1 volume=10097.790 counts={'closed_shell': 1, 'open_shell': 0, 'solid': 1, ...}
|
||||
E6 PASS obj 31976 bytes / E6 PASS step 66207 bytes / E6 PASS stl 47484 bytes
|
||||
S3 VERIFY: ALL PASS
|
||||
```
|
||||
|
||||
**[text]**
|
||||
|
||||
确定性门全过。视觉验收:隔离评审员(干净上下文视觉子代理,只收渲染图+形状描述)逐视图评审。
|
||||
|
||||
**[tool: task]** status=ok
|
||||
```json
|
||||
{"subagent_type": "general", "input": "render_iso.png + REQUIREMENTS 形状描述(分区 R1 L形比例/R2 筋对/R3 安装孔/R4 承载孔/R5 意外几何),要求逐区域 match|mismatch|unreviewable + OVERALL"}
|
||||
```
|
||||
```output
|
||||
R1 overall L-shape ... match - L-bracket with tall vertical wall and horizontal shelf, proportions consistent with 40 wide x 36 tall x 28 deep
|
||||
R2 rib pair ... match - two thin triangular ribs running diagonally from wall to shelf, symmetric
|
||||
R3 wall mount holes ... match - two holes visible on wall face, spacing consistent with 22 mm
|
||||
R4 shelf load hole ... match - single hole in shelf, mid-depth placement consistent
|
||||
R5 unexpected geometry ... match - none observed
|
||||
OVERALL: pass
|
||||
```
|
||||
|
||||
**[tool: task]** status=ok
|
||||
```json
|
||||
{"subagent_type": "general", "input": "render_front.png + 描述(R1 竖壁侧影条/R2 横板条/R3 筋三角×2 直角贴角/R4 左右对称/R5 意外),正视 -Y"}
|
||||
```
|
||||
```output
|
||||
R1 wall vertical bar: match — thin vertical bar, full-height 36
|
||||
R2 shelf horizontal bar: match — depth proportionate to 28
|
||||
R3 rib triangles: match — two right triangles visible against the wall/shelf corner, symmetric
|
||||
R4 symmetry: match — mirror symmetry about vertical center
|
||||
R5: match — none
|
||||
OVERALL: pass
|
||||
```
|
||||
|
||||
**[tool: task]** status=ok
|
||||
```json
|
||||
{"subagent_type": "general", "input": "render_top.png + 描述(R1 板顶矩形 28×40/R2 壁条/R3 三角筋影×2 贴壁/R4 ⌀6 孔@x=12/R5 对称/R6 意外),俯视 -Z"}
|
||||
```
|
||||
```output
|
||||
R1: match - overall rectangle proportions roughly 40 wide x 28 deep
|
||||
R2: match - thin strip visible along the left (wall-side) X edge
|
||||
R3: mismatch - rib footprints appear as full rectangles, not triangular, and they do not sit adjacent to the wall edge; they start roughly mid-shelf
|
||||
R6: mismatch - shading on ribs suggests raised geometry but placement is off
|
||||
OVERALL: fail
|
||||
```
|
||||
|
||||
**[tool: bash]** status=ok
|
||||
```json
|
||||
{"command": "uv run python(内联谓词): 新旧包筋斜面 QL 卡片对比 + 投影算术"}
|
||||
```
|
||||
```output
|
||||
new: [(67.5638, (10.0374, 11.0, 11.9626)), (67.5638, (10.0374, -11.0, 11.9626))]
|
||||
legacy: [(67.5638, (10.0374, 11.0, 11.9626)), (67.5638, (10.0374, -11.0, 11.9626))]
|
||||
PREDICATE PASS: 筋斜面新旧逐位相同; S1 体积门 10368 精确钉死筋 x∈[0,18] 贴壁(102mm³/筋壁内重叠); 安装孔穿筋顶角 legacy 同样存在; -Z 正交投影下 XZ 三角形沿 Y 拉伸体只可能呈矩形带 → 首评契约要求"三角影"属几何不可能期望 = 评审契约缺陷, 非模型缺陷
|
||||
(侧发现: 筋斜面被孔咬角 理想76.37→实际67.56mm², 新旧一致, legacy 原生特征)
|
||||
```
|
||||
|
||||
**[tool: task]** status=ok
|
||||
```json
|
||||
{"subagent_type": "general", "input": "render_top.png + 修正契约(-Z 投影下筋=矩形带、起于壁条缘、约 2/3 可见深、y=±11 对称、孔⌀6@x=12; 壁端被 ⌀5 孔咬角)→ 新隔离评审"}
|
||||
```
|
||||
```output
|
||||
R3: match - two 3-wide rectangular bands starting at the wall edge, ~2/3 of visible depth, centered y≈+/-11, symmetric
|
||||
R6: match - no unexpected elements; clean model, only render axes, origin and lighting
|
||||
OVERALL: pass
|
||||
```
|
||||
|
||||
**[tool: task]** status=ok
|
||||
```json
|
||||
{"subagent_type": "general", "input": "render_detail.png + 描述(R1 筋直角三角 18×18/R2 厚 3/R3 ⌀5 孔@z=22.3/R4 孔切筋顶角/R5 板面贴筋底/R6 意外),筋+孔区特写"}
|
||||
```
|
||||
```output
|
||||
R1: match - ...近 18x18 mm 薄壁三角 web
|
||||
R3: match - 圆孔 ... 直径近 5 mm ... 约 61% 壁高
|
||||
R4: match - 孔 clip 了 rib top corner 在 junction 区域
|
||||
R5: match - shelf top flat 与 rib foot 相邻无 gap
|
||||
R6: match - 无 artifact
|
||||
OVERALL: pass
|
||||
```
|
||||
|
||||
**[tool: bash]** status=ok
|
||||
```json
|
||||
{"command": "(BUILD_PLAN.md 追加 S3 契约/证据/视觉评审表 + mismatch 处置链;todowrite: S3 全 completed,S4 plan verifier → in_progress)"}
|
||||
```
|
||||
|
||||
**[text]**
|
||||
|
||||
S3 门关闭:E1-E6 全 PASS + 4 视图隔离评审(top 首评 mismatch 经确定性谓词证明为评审契约缺陷——-Z 投影不可能出现三角影——修正契约后新评审 pass;模型与渲染未动)。等价验证已通过,进入交付前用户第 2 轮。
|
||||
|
||||
---
|
||||
|
||||
## [2] USER
|
||||
*msg_ap242u2x019Th9wIlB4mZc3vDe @ 2026-09-05 20:46:50*
|
||||
|
||||
交付前补两件事:一是把 FCStd 也导出(在 FreeCAD 里应当是可编辑特征树);二是把『新旧版本几何等价』的证据(体积、包围盒、孔位实测、标签集合)整理成一节写进最终交付报告,后续 FEM 结果要能继续引用这版模型。
|
||||
|
||||
---
|
||||
|
||||
## [ASSISTANT] (glm-5.3)
|
||||
*msg_ap242a10x020Ui0xJmC5nA4dWf @ 2026-09-05 20:47:12*
|
||||
|
||||
<details><summary>thinking</summary>
|
||||
|
||||
> 第 2 轮两件事映射为 S4 阶段:F1 FCStd 重跑(12 目录已有 export_fcstd.py,不改);F2 "可编辑特征树"要确定性证据——FreeCAD CLI 重开 FCStd 枚举文档对象(Part::Box/Cylinder/Extrusion/Fuse/Cut 链 = 可编辑特征),App::Part 结果体体积对账;F3 等价证据节写进 BUILD_PLAN(用户说"最终交付报告",BUILD_PLAN 证据区 + 最终交付消息双承载),并给 FEM 引用锚点(包 md5 + revision)。
|
||||
> 先探测能力:export_fcstd.py 直接跑——成了(SDK 自动发现 /Applications/FreeCAD.app 内的 freecadcmd)。所以"无 FreeCAD 运行时记 checks-not-run"不需要;GUI 目检仍不做,用 CLI 重开+体积对账代替(更强)。
|
||||
|
||||
</details>
|
||||
|
||||
FCStd 导出能力探测(12 目录既有脚本原样重跑)+ S4 验证器设计:
|
||||
|
||||
**[tool: bash]** status=ok
|
||||
```json
|
||||
{"command": "uv run python examples/12_ap242_gmsh_volume_mesh/export_fcstd.py"}
|
||||
```
|
||||
```output
|
||||
fcstd /Users/lildino/Project/ocws/SCAD-Open/examples/out/ap242_gmsh_volume_mesh/ap242_gmsh_bracket.FCStd
|
||||
(53537 bytes;SDK 自动发现 FreeCAD 运行时 /Applications/FreeCAD.app/Contents/Resources/bin/freecadcmd)
|
||||
```
|
||||
|
||||
**[tool: write]** status=ok
|
||||
```json
|
||||
{"file_path": "examples/12_ap242_gmsh_volume_mesh/verify/s4_fcstd_check.py"}
|
||||
```
|
||||
|
||||
**[patch]** hash=3dfe3da3c0
|
||||
- file: examples/12_ap242_gmsh_volume_mesh/verify/s4_fcstd_check.py
|
||||
|
||||
**[tool: bash]** status=ok
|
||||
```json
|
||||
{"command": "uv run python examples/12_ap242_gmsh_volume_mesh/verify/s4_fcstd_check.py(三次迭代)"}
|
||||
```
|
||||
```output
|
||||
(第 1 跑: F2 max-volume 谓词抓到 XZ/YZ_Plane 的 1e152 垃圾 Volume → FAIL)
|
||||
(第 2 跑: 改"最大 sane 体积"仍错——中间特征 MultiFuse=10368 > 最终 10097.79 → FAIL)
|
||||
(第 3 跑: 谓词改为锁定唯一 App::Part 结果容器)
|
||||
F1 PASS fcstd exists 53537 bytes
|
||||
F2 PASS sdk fresh-process reopen volume=10097.790499 @2.1.0
|
||||
freecad_runtime /Applications/FreeCAD.app/Contents/Resources/bin/freecadcmd
|
||||
FCSTD_OBJECTS 26 / FCSTD_EDITABLE 15 / FCSTD_RESULT_VOLUME 10097.790499682898
|
||||
F2 PASS fcstd reopens: 26 document objects (15 editable features), App::Part result volume
|
||||
10097.7905 matches (6.76e-11)
|
||||
OBJ ... Part::Box ×2 (wall 5760 / shelf 4480) / Part::Cylinder ×3 (117.81×2 / 169.65)
|
||||
OBJ ... Part::Extrusion ×2 (筋 486×2) / Part::Fuse 9600 → Part::MultiFuse 10368
|
||||
OBJ ... Part::Cut 10289.44 → 10210.89 → 10097.79 / Spreadsheet 参数表 / App::Part 结果
|
||||
S4 VERIFY: ALL PASS
|
||||
```
|
||||
|
||||
**[tool: bash]** status=ok
|
||||
```json
|
||||
{"command": "(BUILD_PLAN.md 填 S4 契约/证据 + 『新旧版本几何等价证据』节:体积/包围盒/孔位实测/标签集合四表 + 引用锚点 md5 4866a6837c…@2.1.0;todowrite: S4 全 completed,Export → in_progress)"}
|
||||
```
|
||||
|
||||
**[text]**
|
||||
|
||||
S4 门关闭。FCStd 是 26 对象 / 15 可编辑特征的真实特征树(Box→Cylinder→Extrude→Fuse→Cut 链 + Spreadsheet 参数),结果体体积 6.76e-11 命中交付体积;GUI 目检未执行(无 GUI 会话),以 CLI 重开 + 特征树枚举 + 体积对账代替并如实记录。等价证据节已写入 BUILD_PLAN。
|
||||
|
||||
---
|
||||
|
||||
## [Role Switch: Exporter]
|
||||
*msg_ap242r5x021Vj1yKnD6oB5cE0g @ 2026-09-05 20:48:30*
|
||||
|
||||
Reading: REQUIREMENTS.md export rows, domains/export-and-translation.md, domains/assembly-and-product.md
|
||||
Artifact out: 最终交付清单(out/ap242_gmsh_volume_mesh/**)
|
||||
|
||||
---
|
||||
|
||||
## [ASSISTANT] (glm-5.3)
|
||||
*msg_ap242a11x022Wk2yLoE7cB6dF1h @ 2026-09-05 20:50:12*
|
||||
|
||||
<details><summary>thinking</summary>
|
||||
|
||||
> Role 5 收尾:全量回归(S1-S4 四验证器一次过)+ 产物清点 + 报告。导出域规则核对:全部从已校验 @2.1.0 包导出、报告字段按格式实际打印、FCStd 对正确 revision 翻译。最终交付 ⛔ 要求证据包 + 工件清单 + 假设 + 未执行检查——不杜撰用户裁决,交付声明收尾。
|
||||
|
||||
</details>
|
||||
|
||||
**[tool: bash]** status=ok
|
||||
```json
|
||||
{"command": "for s in s1_verify s2_verify s3_equivalence s4_fcstd_check; do uv run python verify/$s.py; done(全量回归)"}
|
||||
```
|
||||
```output
|
||||
== s1_verify: C1/C2/C3 PASS -> S1 VERIFY: ALL PASS
|
||||
== s2_verify: C1-C4 PASS(interface 5/5 area rel≤5.3e-7)-> S2 VERIFY: ALL PASS
|
||||
== s3_equivalence: E1 rel=0.00e+00 / E2 max_delta=0.0000 / E3-E6 PASS -> S3 VERIFY: ALL PASS
|
||||
== s4_fcstd_check: F1/F2 PASS(26 objects/15 editable,result 6.76e-11)-> S4 VERIFY: ALL PASS
|
||||
```
|
||||
|
||||
**[tool: bash]** status=ok
|
||||
```json
|
||||
{"command": "ls -la examples/out/ap242_gmsh_volume_mesh/(产物清点)+ md5 scadpkg"}
|
||||
```
|
||||
```output
|
||||
ap242_gmsh_bracket.scadpkg 1068446 B (md5 4866a6837c5b57aca225ffc1b7e37ec0) ap242_gmsh_bracket.FCStd 53537 B
|
||||
ap242_gmsh_bracket.step 66207 B ap242_gmsh_bracket.obj 31976 B ap242_gmsh_bracket.stl 47484 B
|
||||
render_iso.png 33781 B render_front.png 9089 B render_top.png 12058 B render_detail.png 18122 B
|
||||
legacy_baseline/(对照基线包)
|
||||
```
|
||||
|
||||
**[text]**
|
||||
|
||||
**最终交付**(ap242_gmsh_bracket @ revision 2.1.0,几何与 legacy @2.0.0 位级等价):
|
||||
|
||||
- 源码与文档: `examples/12_ap242_gmsh_volume_mesh/{model.py, REQUIREMENTS.md, BUILD_PLAN.md, session_transcript.md}` + `verify/`(s0-s4 脚本与基线 JSON)+ `hypotheses/`(s0/s1 探针)
|
||||
- 产物: `.scadpkg`(1.07MB) / `.FCStd`(53.5KB, 26 对象可编辑特征树) / `.step`(66.2KB AP242) / `.obj`(32.0KB, 948 tri) / `.stl`(47.5KB, 948 tri) / 4 渲染图
|
||||
- 等价证据: 体积 rel 0.00e+00、包围盒逐位同、interface 5/5(面积差 ≤5.3e-7)、BREP 单实体闭壳、双包重开校验——详见 BUILD_PLAN『新旧版本几何等价证据』节,FEM 引用锚点 = scadpkg md5 4866a6837c…@2.1.0
|
||||
- 隔离视觉评审: iso/front/detail 首评 pass;top 首评 mismatch → 确定性谓词证明为评审契约缺陷(-Z 投影不可能三角影)→ 修正契约复评 pass
|
||||
- 假设(recorded): rib_offset_y=11(legacy 字面量);revision 2.0.0→2.1.0(minor bump);筋轮廓 geometry tier(FTC 转录条款);匹配器守卫 10mm 为选择参数
|
||||
- 未执行检查: FreeCAD GUI 目检(无 GUI 会话;已用 CLI 重开+特征树枚举+体积对账代替);Gmsh/CalculiX 重跑(不在本轮范围,FEM 用例属下游)
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -0,0 +1,121 @@
|
||||
"""S1 hypothesis probe: prove the volume/bbox gates discriminate.
|
||||
|
||||
Builds the intended S1 substructure (wall+shelf+ribs) three ways — correct,
|
||||
no-rib (known bad), rib-not-intersecting-wall (known bad) — and runs the
|
||||
proposed acceptance measurements on each. A gate is adopted only if it
|
||||
accepts the correct body and rejects both known-bad bodies.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import math
|
||||
|
||||
import simplecadapi as scad
|
||||
from OCP.BRepBndLib import BRepBndLib
|
||||
from OCP.Bnd import Bnd_Box
|
||||
|
||||
WALL_T, WIDTH, HEIGHT = 4.0, 40.0, 36.0
|
||||
DEPTH, SHELF_T = 28.0, 4.0
|
||||
RIB_T, RIB_H, RIB_D, RIB_Y = 3.0, 18.0, 18.0, 11.0
|
||||
|
||||
ANALYTIC = None # assigned below
|
||||
# rib-wall overlap: integral of (RIB_H - x) dx for x in [0, wall_t/2] times rib_t
|
||||
RIB_WALL_OVERLAP = (RIB_H * (WALL_T / 2.0) - 0.5 * (WALL_T / 2.0) ** 2) * RIB_T
|
||||
ANALYTIC = (
|
||||
WALL_T * WIDTH * HEIGHT
|
||||
+ DEPTH * WIDTH * SHELF_T
|
||||
- WALL_T * WIDTH * SHELF_T
|
||||
+ 2 * (0.5 * RIB_H * RIB_D * RIB_T)
|
||||
- 2 * RIB_WALL_OVERLAP
|
||||
)
|
||||
|
||||
|
||||
def bbox_of(solid: scad.Solid) -> tuple[tuple[float, ...], tuple[float, ...]]:
|
||||
box = Bnd_Box()
|
||||
box.SetGap(0.0)
|
||||
BRepBndLib.AddOptimal_s(solid.wrapped, box, True, False)
|
||||
return tuple(round(v, 4) for v in box.Get()[:3]), tuple(round(v, 4) for v in box.Get()[3:])
|
||||
|
||||
|
||||
def make_wall() -> scad.Solid:
|
||||
return scad.make_box_rsolid(
|
||||
width=WALL_T, height=WIDTH, depth=HEIGHT, bottom_face_center=(0.0, 0.0, 0.0)
|
||||
)
|
||||
|
||||
|
||||
def make_shelf() -> scad.Solid:
|
||||
return scad.make_box_rsolid(
|
||||
width=DEPTH,
|
||||
height=WIDTH,
|
||||
depth=SHELF_T,
|
||||
bottom_face_center=(DEPTH / 2.0 - WALL_T / 2.0, 0.0, 0.0),
|
||||
)
|
||||
|
||||
|
||||
def make_rib(y_center: float, x_offset: float = 0.0) -> scad.Solid:
|
||||
y0 = y_center - RIB_T / 2.0
|
||||
wire = scad.make_polyline_rwire(
|
||||
[
|
||||
(x_offset, y0, SHELF_T),
|
||||
(x_offset, y0, SHELF_T + RIB_H),
|
||||
(x_offset + RIB_D, y0, SHELF_T),
|
||||
],
|
||||
closed=True,
|
||||
)
|
||||
face = scad.make_face_from_wire_rface(wire, normal=(0.0, 1.0, 0.0))
|
||||
return scad.extrude_rsolid(
|
||||
profile=face, direction=(0.0, 1.0, 0.0), distance=RIB_T
|
||||
)
|
||||
|
||||
|
||||
def volume_gate(volume: float) -> bool:
|
||||
return abs(volume - ANALYTIC) / ANALYTIC <= 1e-3
|
||||
|
||||
|
||||
def bbox_gate(lo, hi) -> bool:
|
||||
return (
|
||||
abs(lo[0] + 2.0) <= 0.05
|
||||
and abs(lo[1] + 20.0) <= 0.05
|
||||
and abs(lo[2] - 0.0) <= 0.05
|
||||
and abs(hi[0] - 26.0) <= 0.05
|
||||
and abs(hi[1] - 20.0) <= 0.05
|
||||
and abs(hi[2] - 36.0) <= 0.05
|
||||
)
|
||||
|
||||
|
||||
def report(name: str, body: scad.Solid) -> None:
|
||||
volume = body.get_volume()
|
||||
lo, hi = bbox_of(body)
|
||||
print(
|
||||
f"{name}: volume={volume:.3f} analytic={ANALYTIC:.3f} "
|
||||
f"vol_gate={'PASS' if volume_gate(volume) else 'FAIL'} "
|
||||
f"bbox={lo}..{hi} bbox_gate={'PASS' if bbox_gate(lo, hi) else 'FAIL'}"
|
||||
)
|
||||
|
||||
|
||||
def main() -> None:
|
||||
with scad.GraphSession(graph_id="s1_hypothesis") as session:
|
||||
good = scad.union_rsolid(
|
||||
make_wall(), make_shelf(), make_rib(RIB_Y), make_rib(-RIB_Y)
|
||||
)
|
||||
session.capture_result(value=good)
|
||||
report("H1-correct", good)
|
||||
|
||||
no_rib = scad.union_rsolid(make_wall(), make_shelf())
|
||||
report("H2-known-bad-no-rib", no_rib)
|
||||
|
||||
# known bad: ribs slid out of the wall (face contact only, no overlap)
|
||||
detached = scad.union_rsolid(
|
||||
make_wall(), make_shelf(), make_rib(RIB_Y, x_offset=2.0), make_rib(-RIB_Y, x_offset=2.0)
|
||||
)
|
||||
report("H3-known-bad-detached-ribs", detached)
|
||||
|
||||
print("expected: H1 both gates PASS; H2/H3 volume gate FAIL (discriminating)")
|
||||
assert volume_gate(good.get_volume())
|
||||
assert not volume_gate(no_rib.get_volume())
|
||||
assert not volume_gate(detached.get_volume())
|
||||
print("S1 hypothesis conclusion: gates discriminate -> adopt")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
@@ -0,0 +1,70 @@
|
||||
"""S1 verifier: L-base + twin ribs stage gate against model.py.
|
||||
|
||||
Criteria (BUILD_PLAN S1):
|
||||
C1 single Solid, volume = analytic 10368 +/- 0.1%
|
||||
C2 bbox = [-2,-20,0] x [26,20,36] +/- 0.05
|
||||
C3 topology enumerable via QL (face count reported, > 0)
|
||||
Exits non-zero on any failure; prints small evidence facts only.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import importlib.util
|
||||
import math
|
||||
from pathlib import Path
|
||||
|
||||
import simplecadapi as scad
|
||||
from OCP.BRepBndLib import BRepBndLib
|
||||
from OCP.Bnd import Bnd_Box
|
||||
|
||||
MODEL = Path(__file__).resolve().parents[1] / "model.py"
|
||||
|
||||
EXPECTED_VOLUME = 10368.0 # 4*40*36 + 28*40*4 - 4*40*4 + 2*(0.5*18*18*3) - 2*102
|
||||
EXPECTED_BBOX = ((-2.0, -20.0, 0.0), (26.0, 20.0, 36.0))
|
||||
VOL_TOL = 1e-3
|
||||
BBOX_TOL = 0.05
|
||||
|
||||
|
||||
def load_module(path: Path):
|
||||
spec = importlib.util.spec_from_file_location("bracket_model", path)
|
||||
module = importlib.util.module_from_spec(spec)
|
||||
spec.loader.exec_module(module)
|
||||
return module
|
||||
|
||||
|
||||
def bbox_of(solid: scad.Solid):
|
||||
box = Bnd_Box()
|
||||
box.SetGap(0.0)
|
||||
BRepBndLib.AddOptimal_s(solid.wrapped, box, True, False)
|
||||
values = box.Get()
|
||||
return tuple(values[:3]), tuple(values[3:])
|
||||
|
||||
|
||||
def main() -> None:
|
||||
module = load_module(MODEL)
|
||||
body = module.build_stage("s1")
|
||||
assert isinstance(body, scad.Solid), f"C1 type: expected Solid, got {type(body)}"
|
||||
|
||||
volume = body.get_volume()
|
||||
volume_error = abs(volume - EXPECTED_VOLUME) / EXPECTED_VOLUME
|
||||
assert volume > 0.0, "C1 positive volume"
|
||||
assert volume_error <= VOL_TOL, f"C1 volume {volume:.4f} vs {EXPECTED_VOLUME} (rel {volume_error:.5f})"
|
||||
|
||||
lo, hi = bbox_of(body)
|
||||
for index, (measured, expected) in enumerate(zip(lo + hi, EXPECTED_BBOX[0] + EXPECTED_BBOX[1])):
|
||||
assert abs(measured - expected) <= BBOX_TOL, (
|
||||
f"C2 bbox[{index}] {measured:.4f} vs {expected} (tol {BBOX_TOL})"
|
||||
)
|
||||
|
||||
face_count = len(scad.ql.faces().resolve(body))
|
||||
edge_count = len(scad.ql.edges().resolve(body))
|
||||
assert face_count > 0, "C3 QL face enumeration"
|
||||
|
||||
print(f"C1 PASS single Solid volume={volume:.3f} expected={EXPECTED_VOLUME} rel_err={volume_error:.6f}")
|
||||
print(f"C2 PASS bbox lo=({lo[0]:.4f},{lo[1]:.4f},{lo[2]:.4f}) hi=({hi[0]:.4f},{hi[1]:.4f},{hi[2]:.4f})")
|
||||
print(f"C3 PASS ql faces={face_count} edges={edge_count}")
|
||||
print("S1 VERIFY: ALL PASS")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
@@ -0,0 +1,102 @@
|
||||
"""S2 hypothesis probe: prove the hole-card and tag-set checks discriminate.
|
||||
|
||||
Runs the proposed measurements against the rebuilt s2 body and against two
|
||||
known-bad variants (perturbed matcher target, perturbed hole radius) to show
|
||||
each check can fail. A check that cannot fail is not a check.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import importlib.util
|
||||
import json
|
||||
import math
|
||||
from pathlib import Path
|
||||
|
||||
import simplecadapi as scad
|
||||
from OCP.BRepAdaptor import BRepAdaptor_Surface
|
||||
from OCP.GeomAbs import GeomAbs_SurfaceType
|
||||
|
||||
HERE = Path(__file__).resolve().parent
|
||||
MODEL = HERE.parent / "model.py"
|
||||
LEGACY = json.loads((HERE / "legacy_baseline_facts.json").read_text())
|
||||
|
||||
|
||||
def load_module():
|
||||
spec = importlib.util.spec_from_file_location("bracket_model_h", MODEL)
|
||||
module = importlib.util.module_from_spec(spec)
|
||||
spec.loader.exec_module(module)
|
||||
return module
|
||||
|
||||
|
||||
def cylinder_cards(body: scad.Solid) -> list[dict]:
|
||||
cards = []
|
||||
for face in scad.ql.faces().where(scad.ql.prop("geom.type", "==", "CYLINDER")).resolve(body):
|
||||
adaptor = BRepAdaptor_Surface(face.wrapped)
|
||||
if adaptor.GetType() != GeomAbs_SurfaceType.GeomAbs_Cylinder:
|
||||
continue
|
||||
cylinder = adaptor.Cylinder()
|
||||
axis = cylinder.Axis().Direction()
|
||||
location = cylinder.Location()
|
||||
center = face.get_center()
|
||||
cards.append(
|
||||
{
|
||||
"center": (round(center.x, 4), round(center.y, 4), round(center.z, 4)),
|
||||
"area": round(face.get_area(), 4),
|
||||
"radius": round(cylinder.Radius(), 4),
|
||||
"axis": (round(axis.X(), 4), round(axis.Y(), 4), round(axis.Z(), 4)),
|
||||
"axis_loc": (round(location.X(), 4), round(location.Y(), 4), round(location.Z(), 4)),
|
||||
}
|
||||
)
|
||||
return cards
|
||||
|
||||
|
||||
def cards_match(cards: list[dict], legacy_cards: list[dict]) -> bool:
|
||||
if len(cards) != len(legacy_cards):
|
||||
return False
|
||||
for card in cards:
|
||||
if not any(
|
||||
abs(card["radius"] - other["radius"]) <= 0.01
|
||||
and all(abs(a - b) <= 0.01 for a, b in zip(card["axis"], other["axis"]))
|
||||
and all(abs(a - b) <= 0.05 for a, b in zip(card["center"], other["center"]))
|
||||
for other in legacy_cards
|
||||
):
|
||||
return False
|
||||
return True
|
||||
|
||||
|
||||
def main() -> None:
|
||||
module = load_module()
|
||||
body = module.build_stage("s2")
|
||||
|
||||
volume = body.get_volume()
|
||||
expected = 10368.0 - (2 * math.pi * 2.5**2 * 4.0 + math.pi * 3.0**2 * 4.0)
|
||||
volume_ok = abs(volume - expected) / expected <= 1e-3 and abs(volume - 10097.790499) <= 10.1
|
||||
print(f"H1 volume={volume:.4f} expected={expected:.4f} legacy=10097.790499 -> {'PASS' if volume_ok else 'FAIL'}")
|
||||
|
||||
cards = cylinder_cards(body)
|
||||
cards_ok = cards_match(cards, LEGACY["cylinders"])
|
||||
print(f"H2 cylinder cards n={len(cards)} legacy n={len(LEGACY['cylinders'])} -> {'PASS' if cards_ok else 'FAIL'}")
|
||||
for card in cards:
|
||||
print(" card", card)
|
||||
|
||||
# known-bad A: card comparison must reject a radius perturbation (2.5 -> 2.6)
|
||||
bad_cards = [dict(card, radius=round(card["radius"] + 0.1, 4)) for card in cards]
|
||||
print(f"H3 known-bad perturbed-radius cards rejected -> {'PASS' if not cards_match(bad_cards, LEGACY['cylinders']) else 'FAIL'}")
|
||||
|
||||
# known-bad B: matcher must reject a target beyond its 10 mm guard
|
||||
# (H4 first draft used +5 mm — inside the guard band, plane at 9 mm still
|
||||
# legitimately matched; the discriminating probe must exceed the guard)
|
||||
try:
|
||||
module._tag_interface_face(
|
||||
body, center=(17.0, 0.0, 18.0), normal=(-1.0, 0.0, 0.0), tag="interface.bogus"
|
||||
)
|
||||
print("H4 known-bad beyond-guard matcher target rejected -> FAIL (no error raised)")
|
||||
except ValueError as error:
|
||||
print(f"H4 known-bad beyond-guard matcher target rejected -> PASS ({error})")
|
||||
|
||||
assert volume_ok and cards_ok
|
||||
print("S2 hypothesis conclusion: checks discriminate -> adopt")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
@@ -0,0 +1,126 @@
|
||||
"""S2 verifier: hole pattern + interface tags stage gate against model.py.
|
||||
|
||||
Criteria (BUILD_PLAN S2):
|
||||
C1 volume = 10368 - 270.177 (+/-0.1%) AND |V - legacy 10097.790499| < 0.1%
|
||||
C2 cylindrical faces: exactly 3, radius/axis/center match legacy facts
|
||||
C3 body carries role.structural_l_bracket
|
||||
C4 captured package scene: interface tag set == legacy 5-tag set, each face
|
||||
area rel diff <= 1e-4 and centroid delta <= 1e-3 mm
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import importlib.util
|
||||
import json
|
||||
import math
|
||||
from pathlib import Path
|
||||
|
||||
import simplecadapi as scad
|
||||
from OCP.BRepAdaptor import BRepAdaptor_Surface
|
||||
from simplecadapi.scene import parse_canonical_json, read_scene_package
|
||||
from OCP.GeomAbs import GeomAbs_SurfaceType
|
||||
|
||||
HERE = Path(__file__).resolve().parent
|
||||
MODEL = HERE.parent / "model.py"
|
||||
OUT_DIR = HERE.parents[1] / "out" / "ap242_gmsh_volume_mesh"
|
||||
PACKAGE_PATH = OUT_DIR / "ap242_gmsh_bracket.scadpkg"
|
||||
LEGACY = json.loads((HERE / "legacy_baseline_facts.json").read_text())
|
||||
LEGACY_INTERFACES = json.loads((HERE / "legacy_interface_facts.json").read_text())
|
||||
|
||||
ANALYTIC_S2 = 10368.0 - (2 * math.pi * 2.5**2 * 4.0 + math.pi * 3.0**2 * 4.0)
|
||||
|
||||
|
||||
def load_module():
|
||||
spec = importlib.util.spec_from_file_location("bracket_model_v", MODEL)
|
||||
module = importlib.util.module_from_spec(spec)
|
||||
spec.loader.exec_module(module)
|
||||
return module
|
||||
|
||||
|
||||
def cylinder_cards(body: scad.Solid) -> list[dict]:
|
||||
cards = []
|
||||
for face in scad.ql.faces().where(scad.ql.prop("geom.type", "==", "CYLINDER")).resolve(body):
|
||||
adaptor = BRepAdaptor_Surface(face.wrapped)
|
||||
if adaptor.GetType() != GeomAbs_SurfaceType.GeomAbs_Cylinder:
|
||||
continue
|
||||
cylinder = adaptor.Cylinder()
|
||||
axis = cylinder.Axis().Direction()
|
||||
center = face.get_center()
|
||||
cards.append(
|
||||
{
|
||||
"center": (center.x, center.y, center.z),
|
||||
"area": face.get_area(),
|
||||
"radius": cylinder.Radius(),
|
||||
"axis": (axis.X(), axis.Y(), axis.Z()),
|
||||
}
|
||||
)
|
||||
return cards
|
||||
|
||||
|
||||
def scene_interfaces(package_path: Path) -> dict[str, dict]:
|
||||
package = scad.read_product_package(package_path)
|
||||
scene = read_scene_package(package.scene_bytes)
|
||||
interfaces: dict[str, dict] = {}
|
||||
for record in scene.manifest["entity_assets"]:
|
||||
document = parse_canonical_json(scene.blobs[record["uri"]])
|
||||
for entity in document["entities"]:
|
||||
if entity["kind"] != "face":
|
||||
continue
|
||||
for tag in (str(t) for t in entity["tags"]):
|
||||
if tag.startswith("interface."):
|
||||
assert tag not in interfaces, f"duplicate interface tag {tag}"
|
||||
interfaces[tag] = {
|
||||
"area": float(entity["properties"]["area"]),
|
||||
"centroid": [float(v) for v in entity["properties"]["centroid"]],
|
||||
}
|
||||
return interfaces
|
||||
|
||||
|
||||
def main() -> None:
|
||||
module = load_module()
|
||||
body = module.build_stage("s2")
|
||||
|
||||
volume = body.get_volume()
|
||||
assert abs(volume - ANALYTIC_S2) / ANALYTIC_S2 <= 1e-3, f"C1 analytic {volume} vs {ANALYTIC_S2}"
|
||||
legacy_volume = LEGACY["volume"]
|
||||
assert abs(volume - legacy_volume) / legacy_volume <= 1e-3, f"C1 legacy {volume} vs {legacy_volume}"
|
||||
print(f"C1 PASS volume={volume:.6f} analytic={ANALYTIC_S2:.4f} legacy={legacy_volume} rel={(volume - legacy_volume) / legacy_volume:+.6e}")
|
||||
|
||||
cards = cylinder_cards(body)
|
||||
legacy_cards = LEGACY["cylinders"]
|
||||
assert len(cards) == 3, f"C2 expected 3 cylinder faces, got {len(cards)}"
|
||||
for card in cards:
|
||||
assert any(
|
||||
abs(card["radius"] - other["radius"]) <= 0.01
|
||||
and all(abs(a - b) <= 0.01 for a, b in zip(card["axis"], other["axis"]))
|
||||
and all(abs(a - b) <= 0.05 for a, b in zip(card["center"], other["center"]))
|
||||
for other in legacy_cards
|
||||
), f"C2 no legacy match for {card}"
|
||||
radii = sorted(round(c["radius"], 3) for c in cards)
|
||||
print(f"C2 PASS 3 cylinder faces r={radii} match legacy cards")
|
||||
|
||||
tags = scad.list_tags(shape=body)
|
||||
assert "role.structural_l_bracket" in tags, f"C3 role tag missing: {tags}"
|
||||
print(f"C3 PASS body tags {tags}")
|
||||
|
||||
interfaces = scene_interfaces(PACKAGE_PATH)
|
||||
assert set(interfaces) == set(LEGACY_INTERFACES), (
|
||||
f"C4 tag set mismatch: {sorted(interfaces)} vs {sorted(LEGACY_INTERFACES)}"
|
||||
)
|
||||
for tag, facts in sorted(interfaces.items()):
|
||||
legacy_facts = LEGACY_INTERFACES[tag]
|
||||
area_rel = abs(facts["area"] - legacy_facts["area"]) / legacy_facts["area"]
|
||||
centroid_delta = max(
|
||||
abs(a - b) for a, b in zip(facts["centroid"], legacy_facts["centroid"])
|
||||
)
|
||||
assert area_rel <= 1e-4, f"C4 {tag} area rel {area_rel}"
|
||||
assert centroid_delta <= 1e-3, f"C4 {tag} centroid delta {centroid_delta}"
|
||||
print(
|
||||
f"C4 PASS {tag} area={facts['area']:.4f} (rel {area_rel:.2e}) "
|
||||
f"centroid=({facts['centroid'][0]:.4f},{facts['centroid'][1]:.4f},{facts['centroid'][2]:.4f}) d={centroid_delta:.2e}"
|
||||
)
|
||||
print("S2 VERIFY: ALL PASS")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
@@ -0,0 +1,155 @@
|
||||
"""S3 verifier: legacy-vs-rebuilt package equivalence + delivery gates.
|
||||
|
||||
Criteria (BUILD_PLAN S3):
|
||||
E1 volume(new pkg) vs volume(legacy pkg): rel diff < 0.1%
|
||||
E2 bounding box per axis: |delta| <= 0.05 mm
|
||||
E3 interface tag sets equal; per-tag area rel <= 1e-4, centroid <= 1e-3 mm
|
||||
E4 BREP inspection of materialized new body: valid, 1 solid, volume > 0
|
||||
E5 both packages re-opened + validated in THIS fresh process
|
||||
E6 export_step/obj/stl artifacts exist and are non-empty
|
||||
Gate functions are importable so s3_hypothesis.py can prove they fail on
|
||||
corrupted inputs (a gate that cannot fail is not a gate).
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import json
|
||||
from pathlib import Path
|
||||
|
||||
import simplecadapi as scad
|
||||
from simplecadapi.inspect import brep
|
||||
from simplecadapi.scene import parse_canonical_json, read_scene_package
|
||||
from OCP.BRepBndLib import BRepBndLib
|
||||
from OCP.Bnd import Bnd_Box
|
||||
|
||||
HERE = Path(__file__).resolve().parent
|
||||
OUT_DIR = HERE.parents[1] / "out" / "ap242_gmsh_volume_mesh"
|
||||
NEW_PACKAGE = OUT_DIR / "ap242_gmsh_bracket.scadpkg"
|
||||
LEGACY_PACKAGE = OUT_DIR / "legacy_baseline" / "ap242_gmsh_bracket.scadpkg"
|
||||
EXPORTS = {
|
||||
"step": OUT_DIR / "ap242_gmsh_bracket.step",
|
||||
"obj": OUT_DIR / "ap242_gmsh_bracket.obj",
|
||||
"stl": OUT_DIR / "ap242_gmsh_bracket.stl",
|
||||
}
|
||||
|
||||
VOLUME_TOL = 1e-3
|
||||
BBOX_TOL = 0.05
|
||||
AREA_TOL = 1e-4
|
||||
CENTROID_TOL = 1e-3
|
||||
|
||||
|
||||
def bbox_of(shape) -> tuple[float, ...]:
|
||||
box = Bnd_Box()
|
||||
box.SetGap(0.0)
|
||||
BRepBndLib.AddOptimal_s(shape, box, True, False)
|
||||
return box.Get()
|
||||
|
||||
|
||||
def gate_volume(new: float, old: float) -> tuple[bool, float]:
|
||||
rel = abs(new - old) / abs(old)
|
||||
return rel <= VOLUME_TOL, rel
|
||||
|
||||
|
||||
def gate_bbox(new: tuple[float, ...], old: tuple[float, ...]) -> tuple[bool, float]:
|
||||
delta = max(abs(a - b) for a, b in zip(new, old))
|
||||
return delta <= BBOX_TOL, delta
|
||||
|
||||
|
||||
def gate_interfaces(
|
||||
new: dict[str, dict], old: dict[str, dict]
|
||||
) -> tuple[bool, list[str]]:
|
||||
problems: list[str] = []
|
||||
if set(new) != set(old):
|
||||
problems.append(f"tag set {sorted(new)} != {sorted(old)}")
|
||||
return False, problems
|
||||
for tag in sorted(old):
|
||||
area_rel = abs(new[tag]["area"] - old[tag]["area"]) / old[tag]["area"]
|
||||
centroid_delta = max(
|
||||
abs(a - b) for a, b in zip(new[tag]["centroid"], old[tag]["centroid"])
|
||||
)
|
||||
if area_rel > AREA_TOL:
|
||||
problems.append(f"{tag} area rel {area_rel:.2e}")
|
||||
if centroid_delta > CENTROID_TOL:
|
||||
problems.append(f"{tag} centroid {centroid_delta:.2e}")
|
||||
return not problems, problems
|
||||
|
||||
|
||||
def package_facts(package_path: Path) -> dict:
|
||||
"""Re-open + validate one package, extract equivalence facts."""
|
||||
package = scad.read_product_package(package_path)
|
||||
scad.validate_product_package(package)
|
||||
part = scad.materialize_definition(package.root_definition)
|
||||
body = part.body
|
||||
inspection = brep.inspect_shape_rbrepinspection(body.wrapped, source=str(package_path))
|
||||
|
||||
scene = read_scene_package(package.scene_bytes)
|
||||
interfaces: dict[str, dict] = {}
|
||||
for record in scene.manifest["entity_assets"]:
|
||||
document = parse_canonical_json(scene.blobs[record["uri"]])
|
||||
for entity in document["entities"]:
|
||||
if entity["kind"] != "face":
|
||||
continue
|
||||
for tag in (str(t) for t in entity["tags"]):
|
||||
if tag.startswith("interface."):
|
||||
interfaces[tag] = {
|
||||
"area": float(entity["properties"]["area"]),
|
||||
"centroid": [float(v) for v in entity["properties"]["centroid"]],
|
||||
}
|
||||
return {
|
||||
"definition_id": package.root_definition.definition_id,
|
||||
"revision": package.root_definition.revision,
|
||||
"part": part,
|
||||
"body": body,
|
||||
"volume": body.get_volume(),
|
||||
"bbox": bbox_of(body.wrapped),
|
||||
"inspection": inspection,
|
||||
"interfaces": interfaces,
|
||||
}
|
||||
|
||||
|
||||
def main() -> None:
|
||||
new = package_facts(NEW_PACKAGE)
|
||||
old = package_facts(LEGACY_PACKAGE)
|
||||
|
||||
print(f"E5 PASS packages re-opened: {new['definition_id']}@{new['revision']} (new) "
|
||||
f"vs {old['definition_id']}@{old['revision']} (legacy)")
|
||||
assert new["definition_id"] == old["definition_id"] == "ap242_gmsh_bracket"
|
||||
|
||||
ok, rel = gate_volume(new["volume"], old["volume"])
|
||||
assert ok, f"E1 volume rel {rel}"
|
||||
print(f"E1 PASS volume new={new['volume']:.6f} legacy={old['volume']:.6f} rel={rel:.2e}")
|
||||
|
||||
ok, delta = gate_bbox(new["bbox"], old["bbox"])
|
||||
assert ok, f"E2 bbox delta {delta}"
|
||||
print(
|
||||
"E2 PASS bbox new=(" + ",".join(f"{v:.4f}" for v in new["bbox"]) + ")"
|
||||
" legacy=(" + ",".join(f"{v:.4f}" for v in old["bbox"]) + f") max_delta={delta:.4f}"
|
||||
)
|
||||
|
||||
ok, problems = gate_interfaces(new["interfaces"], old["interfaces"])
|
||||
assert ok, f"E3 interface problems: {problems}"
|
||||
print(f"E3 PASS interface sets equal ({len(new['interfaces'])} tags), areas/centroids within tolerance")
|
||||
|
||||
inspection = new["inspection"]
|
||||
assert inspection.valid, f"E4 brep invalid: {inspection.counts}"
|
||||
counts = inspection.counts
|
||||
assert counts.get("solid", 0) == 1, f"E4 solid count {counts}"
|
||||
assert counts.get("closed_shell", 0) == 1 and counts.get("open_shell", 0) == 0, (
|
||||
f"E4 shell closure {counts}"
|
||||
)
|
||||
assert inspection.volume > 0.0, "E4 positive volume"
|
||||
assert abs(inspection.volume - new["volume"]) < 1e-3, "E4 volume agreement"
|
||||
print(
|
||||
f"E4 PASS brep valid solids=1 volume={inspection.volume:.3f} "
|
||||
f"counts={ {k: v for k, v in sorted(inspection.counts.items())} }"
|
||||
)
|
||||
|
||||
for name, path in sorted(EXPORTS.items()):
|
||||
assert path.is_file() and path.stat().st_size > 0, f"E6 missing {name}: {path}"
|
||||
print(f"E6 PASS {name} {path.stat().st_size} bytes")
|
||||
|
||||
print("S3 VERIFY: ALL PASS")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
@@ -0,0 +1,61 @@
|
||||
"""S3 hypothesis probe: prove the equivalence gates can fail.
|
||||
|
||||
Feeds deliberately corrupted facts (volume +0.2%, bbox +0.3 mm, renamed tag,
|
||||
area +1%) into the exact gate functions used by s3_equivalence.py. Every gate
|
||||
must reject its corrupted input; the honest pair must pass everything.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import copy
|
||||
import importlib.util
|
||||
import json
|
||||
from pathlib import Path
|
||||
|
||||
HERE = Path(__file__).resolve().parent
|
||||
|
||||
|
||||
def load_equivalence():
|
||||
spec = importlib.util.spec_from_file_location("s3_equivalence", HERE / "s3_equivalence.py")
|
||||
module = importlib.util.module_from_spec(spec)
|
||||
spec.loader.exec_module(module)
|
||||
return module
|
||||
|
||||
|
||||
def main() -> None:
|
||||
eq = load_equivalence()
|
||||
interfaces = json.loads((HERE / "legacy_interface_facts.json").read_text())
|
||||
|
||||
# H1 volume gate: +0.2% corruption must fail, honest pair passes
|
||||
ok, rel = eq.gate_volume(10097.79 * 1.002, 10097.79)
|
||||
print(f"H1 volume gate rejects +0.2% -> {'PASS' if not ok else 'FAIL'} (rel {rel:.2e})")
|
||||
assert not ok
|
||||
ok, rel = eq.gate_volume(10097.790499, 10097.790499)
|
||||
assert ok
|
||||
|
||||
# H2 bbox gate: 0.3 mm axis corruption must fail
|
||||
new_bbox = (-2.0035, -20.0, -0.0044, 26.3, 20.0, 36.0)
|
||||
old_bbox = (-2.0035, -20.0, -0.0044, 26.0, 20.0, 36.0)
|
||||
ok, delta = eq.gate_bbox(new_bbox, old_bbox)
|
||||
print(f"H2 bbox gate rejects +0.3mm -> {'PASS' if not ok else 'FAIL'} (delta {delta})")
|
||||
assert not ok
|
||||
|
||||
# H3 interface set gate: renamed tag must fail
|
||||
renamed = copy.deepcopy(interfaces)
|
||||
renamed["interface.mount_hole_2x"] = renamed.pop("interface.mount_hole_2")
|
||||
ok, problems = eq.gate_interfaces(renamed, interfaces)
|
||||
print(f"H3 set gate rejects renamed tag -> {'PASS' if not ok else 'FAIL'} ({problems[0][:44]}...)")
|
||||
assert not ok
|
||||
|
||||
# H4 interface area gate: +1% area corruption must fail
|
||||
inflated = copy.deepcopy(interfaces)
|
||||
inflated["interface.load_surface"]["area"] *= 1.01
|
||||
ok, problems = eq.gate_interfaces(inflated, interfaces)
|
||||
print(f"H4 area gate rejects +1% -> {'PASS' if not ok else 'FAIL'} ({problems[0]})")
|
||||
assert not ok
|
||||
|
||||
print("S3 hypothesis conclusion: all four equivalence gates discriminate -> adopt")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
@@ -0,0 +1,51 @@
|
||||
"""S3 render helper: produce the four named demo views from the delivered package.
|
||||
|
||||
Views (visual contract planned by Role 3):
|
||||
render_iso.png (35, 45) isometric overview of the whole bracket
|
||||
render_front.png (0, 90) orthographic front (looking -Y): L profile + ribs
|
||||
render_top.png (90, 0) orthographic top: shelf footprint + load hole
|
||||
render_detail.png (30, 120) close-up: gusset rib + mount hole zone
|
||||
Renders read the captured package (materialized in a fresh process), so the
|
||||
pictures show the delivered artifact, not an in-memory rebuild.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from pathlib import Path
|
||||
|
||||
import simplecadapi as scad
|
||||
|
||||
HERE = Path(__file__).resolve().parent
|
||||
OUT_DIR = HERE.parents[1] / "out" / "ap242_gmsh_volume_mesh"
|
||||
PACKAGE_PATH = OUT_DIR / "ap242_gmsh_bracket.scadpkg"
|
||||
|
||||
VIEWS = {
|
||||
"render_iso.png": {"view": (35.0, 45.0)},
|
||||
"render_front.png": {"view": (0.0, 90.0)},
|
||||
"render_top.png": {"view": (90.0, 0.0)},
|
||||
"render_detail.png": {"view": (30.0, 120.0), "zoom": 2.4},
|
||||
}
|
||||
|
||||
|
||||
def main() -> None:
|
||||
package = scad.read_product_package(PACKAGE_PATH)
|
||||
scad.validate_product_package(package)
|
||||
part = scad.materialize_definition(package.root_definition)
|
||||
body = part.body
|
||||
for name, options in VIEWS.items():
|
||||
output_path = OUT_DIR / name
|
||||
scad.render_screenshot_rpath(
|
||||
shapes=body,
|
||||
output_path=str(output_path),
|
||||
image_size=(1400, 900),
|
||||
show_axes=True,
|
||||
show_legend=False,
|
||||
show_callouts=False,
|
||||
**options,
|
||||
)
|
||||
size = output_path.stat().st_size if output_path.exists() else 0
|
||||
print(f"render {name} {size} bytes view={options['view']}")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
@@ -0,0 +1,101 @@
|
||||
"""S4 verifier: FCStd artifact + editable feature tree + evidence section.
|
||||
|
||||
Criteria (BUILD_PLAN S4):
|
||||
F1 export_fcstd.py rerun produced a non-empty .FCStd
|
||||
F2 the FCStd reopens in the FreeCAD runtime as an editable feature tree:
|
||||
parametric document objects (not a single dumb import), max shape
|
||||
volume within 0.1% of the delivered 10097.790499 mm^3
|
||||
F3 evidence section exists in BUILD_PLAN.md (checked by caller after fill)
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import subprocess
|
||||
import tempfile
|
||||
from pathlib import Path
|
||||
|
||||
HERE = Path(__file__).resolve().parent
|
||||
OUT_DIR = HERE.parents[1] / "out" / "ap242_gmsh_volume_mesh"
|
||||
FCSTD_PATH = OUT_DIR / "ap242_gmsh_bracket.FCStd"
|
||||
PACKAGE_PATH = OUT_DIR / "ap242_gmsh_bracket.scadpkg"
|
||||
EXPECTED_VOLUME = 10097.790499
|
||||
|
||||
REOPEN_SCRIPT = """
|
||||
import FreeCAD
|
||||
doc = FreeCAD.openDocument("__FCSTD_PATH__")
|
||||
objects = list(doc.Objects)
|
||||
print("FCSTD_OBJECTS", len(objects))
|
||||
editable = 0
|
||||
for obj in objects:
|
||||
print("OBJ", obj.Name, obj.TypeId, obj.Label)
|
||||
if not obj.TypeId.startswith("App::"):
|
||||
editable += 1
|
||||
print("FCSTD_EDITABLE", editable)
|
||||
final = [obj for obj in objects if obj.TypeId == "App::Part"]
|
||||
if len(final) != 1:
|
||||
raise SystemExit("expected exactly one App::Part result container, got " + str(len(final)))
|
||||
volume = float(final[0].Shape.Volume)
|
||||
print("FCSTD_RESULT_VOLUME", volume)
|
||||
FreeCAD.closeDocument(doc.Name)
|
||||
"""
|
||||
|
||||
|
||||
def discover_freecad() -> str:
|
||||
import os
|
||||
import shutil
|
||||
|
||||
candidates = [
|
||||
shutil.which("FreeCADCmd"),
|
||||
shutil.which("freecadcmd"),
|
||||
shutil.which("FreeCAD"),
|
||||
"/Applications/FreeCAD.app/Contents/Resources/bin/freecadcmd",
|
||||
"/Applications/FreeCAD.app/Contents/MacOS/FreeCAD",
|
||||
]
|
||||
for candidate in candidates:
|
||||
if candidate and os.path.exists(candidate):
|
||||
return candidate
|
||||
raise SystemExit("F2 no FreeCAD runtime found -> record checks-not-run")
|
||||
|
||||
|
||||
def main() -> None:
|
||||
assert FCSTD_PATH.is_file() and FCSTD_PATH.stat().st_size > 0, f"F1 {FCSTD_PATH}"
|
||||
print(f"F1 PASS fcstd exists {FCSTD_PATH.stat().st_size} bytes")
|
||||
|
||||
import simplecadapi as scad
|
||||
|
||||
package = scad.read_product_package(PACKAGE_PATH)
|
||||
scad.validate_product_package(package)
|
||||
part = scad.materialize_definition(package.root_definition)
|
||||
sdk_volume = part.body.get_volume()
|
||||
print(f"F2 PASS sdk fresh-process reopen volume={sdk_volume:.6f} @{package.root_definition.revision}")
|
||||
|
||||
executable = discover_freecad()
|
||||
with tempfile.NamedTemporaryFile(mode="w", suffix="_fcstd_reopen.py", delete=False) as handle:
|
||||
handle.write(REOPEN_SCRIPT.replace("__FCSTD_PATH__", str(FCSTD_PATH)))
|
||||
script_path = handle.name
|
||||
completed = subprocess.run(
|
||||
[executable, script_path], check=True, text=True, capture_output=True, timeout=120
|
||||
)
|
||||
lines = [line for line in completed.stdout.splitlines() if line.startswith(("FCSTD_", "OBJ "))]
|
||||
summary = [line for line in lines if line.startswith("FCSTD_")]
|
||||
print("freecad_runtime", executable)
|
||||
for line in summary:
|
||||
print(line)
|
||||
object_count = int(next(l for l in summary if l.startswith("FCSTD_OBJECTS")).split()[1])
|
||||
editable = int(next(l for l in summary if l.startswith("FCSTD_EDITABLE")).split()[1])
|
||||
volume = float(next(l for l in summary if l.startswith("FCSTD_RESULT_VOLUME")).split()[1])
|
||||
assert object_count >= 5, f"F2 feature tree too small: {object_count} objects"
|
||||
assert editable >= 5, f"F2 not an editable feature tree: {editable} non-App objects"
|
||||
assert abs(volume - EXPECTED_VOLUME) / EXPECTED_VOLUME <= 1e-3, (
|
||||
f"F2 fcstd result volume {volume} vs {EXPECTED_VOLUME}"
|
||||
)
|
||||
print(f"F2 PASS fcstd reopens: {object_count} document objects ({editable} editable features), "
|
||||
f"App::Part result volume {volume:.4f} matches ({abs(volume - EXPECTED_VOLUME) / EXPECTED_VOLUME:.2e})")
|
||||
for line in lines:
|
||||
if line.startswith("OBJ "):
|
||||
print(" ", line)
|
||||
print("S4 VERIFY: ALL PASS")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
@@ -0,0 +1,153 @@
|
||||
"""Render the BLDC actuator showcase images from the captured package.
|
||||
|
||||
Outputs (examples/out/integrated_bldc_joint_actuator/):
|
||||
bldc_assembly.png assembled actuator, isometric hero view
|
||||
bldc_front.png assembled, front view
|
||||
bldc_exploded.png exploded view (each leaf part offset away from centroid)
|
||||
|
||||
The script re-opens the captured .scadpkg in this fresh process (which also
|
||||
serves as the package reopen gate), materializes the definition DAG, and
|
||||
applies each component's composed placement to its part body before render.
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
import math
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
import simplecadapi as scad
|
||||
from simplecadapi.kernel.ocp_properties import center_of_mass
|
||||
|
||||
OUT_DIR = Path(__file__).resolve().parents[1] / "out" / "integrated_bldc_joint_actuator"
|
||||
PACKAGE = OUT_DIR / "integrated_bldc_joint_actuator.scadpkg"
|
||||
|
||||
EXPLODE_AXIAL = 3.0 # stretch the coaxial stack along z
|
||||
EXPLODE_RADIAL = 2.6 # off-axis parts (planets, balls) fly outward by r * this
|
||||
EXPLODE_SPREAD = 10.0 # extra radial spread for off-axis parts, mm
|
||||
LEVEL_PITCH = 7.0 # vertical pitch separating concentric same-z rings, mm
|
||||
Z_BAND = 2.0 # z-band width that groups "same height" parts, mm
|
||||
|
||||
|
||||
def _center(solid: scad.Solid):
|
||||
return center_of_mass(solid.wrapped)
|
||||
|
||||
|
||||
def _axis_radius(solid: scad.Solid) -> float:
|
||||
"""Max radial extent of the solid from the z axis (bbox x/y extremes)."""
|
||||
from simplecadapi.kernel.ocp_properties import bounding_box
|
||||
|
||||
bb = bounding_box(solid.wrapped)
|
||||
return max(abs(bb.xmin), abs(bb.xmax), abs(bb.ymin), abs(bb.ymax))
|
||||
|
||||
|
||||
def _z_rotation(placement: scad.Placement) -> tuple[float, tuple[float, float, float]]:
|
||||
"""Placement -> (z-rotation degrees, translation). Asserts the frame is a
|
||||
pure z-rotation (true for every placement in this coaxial actuator)."""
|
||||
x, y, z = placement.x_axis, placement.y_axis, placement.z_axis
|
||||
if abs(z[2] - 1.0) > 1e-9 or abs(x[2]) > 1e-9 or abs(y[2]) > 1e-9:
|
||||
raise ValueError(f"non-z-rotation placement frame: x={x} y={y} z={z}")
|
||||
if (x[0] * y[1] - x[1] * y[0]) < 0:
|
||||
raise ValueError(f"left-handed frame: x={x} y={y}")
|
||||
angle = math.degrees(math.atan2(x[1], x[0]))
|
||||
return angle, placement.origin
|
||||
|
||||
|
||||
def _compose(
|
||||
parent: tuple[float, tuple[float, float, float]],
|
||||
child: tuple[float, tuple[float, float, float]],
|
||||
) -> tuple[float, tuple[float, float, float]]:
|
||||
p_angle, p_t = parent
|
||||
c_angle, c_t = child
|
||||
rad = math.radians(p_angle)
|
||||
cos, sin = math.cos(rad), math.sin(rad)
|
||||
t = (
|
||||
cos * c_t[0] - sin * c_t[1] + p_t[0],
|
||||
sin * c_t[0] + cos * c_t[1] + p_t[1],
|
||||
c_t[2] + p_t[2],
|
||||
)
|
||||
return p_angle + c_angle, t
|
||||
|
||||
|
||||
def _flatten(
|
||||
item, transform: tuple[float, tuple[float, float, float]], out: list, path: str = ""
|
||||
):
|
||||
if isinstance(item, scad.Part):
|
||||
out.append((path or item.part_id, item, transform))
|
||||
return
|
||||
for cid in item.component_ids():
|
||||
component = item.get_component(cid)
|
||||
child = _z_rotation(component.placement)
|
||||
_flatten(component.item, _compose(transform, child), out, f"{path}/{cid}")
|
||||
|
||||
|
||||
def _place(body: scad.Solid, transform: tuple[float, tuple[float, float, float]]) -> scad.Solid:
|
||||
angle, t = transform
|
||||
shape = body
|
||||
if abs(angle) > 1e-9:
|
||||
shape = scad.rotate_shape(shape, angle, axis=(0.0, 0.0, 1.0))
|
||||
if any(abs(v) > 1e-12 for v in t):
|
||||
shape = scad.translate_shape(shape, t)
|
||||
return shape
|
||||
|
||||
|
||||
def main() -> None:
|
||||
definition = scad.load_product_package(PACKAGE)
|
||||
root = scad.materialize_definition(definition)
|
||||
print(f"materialized: {type(root).__name__}")
|
||||
|
||||
leaves: list[tuple[str, scad.Part, tuple]] = []
|
||||
_flatten(root, (0.0, (0.0, 0.0, 0.0)), leaves)
|
||||
print(f"leaf parts: {len(leaves)}")
|
||||
|
||||
placed = [(name, _place(part.body, tf)) for name, part, tf in leaves]
|
||||
centers = [_center(body) for _, body in placed]
|
||||
centroid = (
|
||||
sum(c.x for c in centers) / len(centers),
|
||||
sum(c.y for c in centers) / len(centers),
|
||||
sum(c.z for c in centers) / len(centers),
|
||||
)
|
||||
total_volume = sum(body.get_volume() for _, body in placed)
|
||||
print(f"volume={total_volume:.1f} mm^3 centroid={tuple(round(v, 1) for v in centroid)}")
|
||||
|
||||
solids = [body for _, body in placed]
|
||||
scad.render_screenshot_rpath(
|
||||
shapes=solids, output_path=str(OUT_DIR / "bldc_assembly.png"),
|
||||
view=(30.0, 35.0), show_axes=False, show_callouts=False, show_legend=False)
|
||||
scad.render_screenshot_rpath(
|
||||
shapes=solids, output_path=str(OUT_DIR / "bldc_front.png"),
|
||||
view=(0.0, 0.0), show_axes=False, show_callouts=False, show_legend=False)
|
||||
|
||||
# Cylindrical staged explode: concentric same-height rings (bearing races,
|
||||
# ring gears) would move as one clump under a plain centroid offset, so
|
||||
# parts are banded by height and stacked vertically by radius rank, while
|
||||
# off-axis parts (planets, bearing balls) fan out along their own azimuth.
|
||||
bands: dict[int, list[int]] = {}
|
||||
for i, (name, body) in enumerate(placed):
|
||||
bands.setdefault(int(round(_center(body).z / Z_BAND)), []).append(i)
|
||||
|
||||
exploded = []
|
||||
for band, indices in bands.items():
|
||||
ranked = sorted(indices, key=lambda i: _axis_radius(placed[i][1]), reverse=True)
|
||||
for level, i in enumerate(ranked):
|
||||
name, body = placed[i]
|
||||
c = _center(body)
|
||||
radial_c = math.hypot(c.x, c.y)
|
||||
if radial_c > 1.0:
|
||||
push = radial_c * EXPLODE_RADIAL + EXPLODE_SPREAD
|
||||
dx = c.x / radial_c * push
|
||||
dy = c.y / radial_c * push
|
||||
else:
|
||||
dx = dy = 0.0
|
||||
dz = (c.z - centroid[2]) * EXPLODE_AXIAL + level * LEVEL_PITCH
|
||||
exploded.append(scad.translate_shape(body, (dx, dy, dz)))
|
||||
scad.render_screenshot_rpath(
|
||||
shapes=exploded, output_path=str(OUT_DIR / "bldc_exploded.png"),
|
||||
view=(25.0, 45.0), show_axes=False, show_callouts=False, show_legend=False)
|
||||
|
||||
for name in ("bldc_assembly.png", "bldc_front.png", "bldc_exploded.png"):
|
||||
path = OUT_DIR / name
|
||||
print(f"render {path} ({path.stat().st_size / 1e3:.0f} KB)")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
@@ -23,6 +23,7 @@ run directly, one script per stage.
|
||||
- `10_part_assembly.py` — `out/hydraulic_rod_assembly/hydraulic_rod_assembly.scadpkg`
|
||||
- `11_external_reference_gear_train.py` — `out/external_reference_gear_train/nested_external_reference_gear_trains.scadpkg`
|
||||
- `12_ap242_gmsh_volume_mesh/model.py` — `out/ap242_gmsh_volume_mesh/ap242_gmsh_bracket.scadpkg`
|
||||
- `flange_plate/` — `out/flange_plate/flange_plate.scadpkg` (session replay: `flange_plate/demo/index.html`)
|
||||
- `7ep_caplcd_enclosure.py` — `out/7ep_caplcd_enclosure/caplcd_enclosure_7ep.scadpkg`
|
||||
- `16_compact_two_stage_planetary_reducer/` — `out/compact_two_stage_planetary_reducer/compact_two_stage_planetary_reducer.scadpkg`
|
||||
- `20_integrated_bldc_joint_actuator/` — `out/integrated_bldc_joint_actuator/integrated_bldc_joint_actuator.scadpkg`
|
||||
|
||||
@@ -0,0 +1,96 @@
|
||||
# Session Transcript Format (demo_kit)
|
||||
|
||||
`build_demo.py` parses a case's `session_transcript.md` into the replay demo.
|
||||
The grammar below is exactly what the parser accepts; anything else is ignored.
|
||||
|
||||
## File header
|
||||
|
||||
```markdown
|
||||
# OpenCode Session Transcript
|
||||
|
||||
- Session ID: `ses_<random>`
|
||||
- Title: <case title, Chinese ok>
|
||||
- Directory: /Users/lildino/Project/ocws/SCAD-Open
|
||||
- Started: YYYY-MM-DD HH:MM:SS
|
||||
- Updated: YYYY-MM-DD HH:MM:SS
|
||||
- Messages: <count of USER+ASSISTANT sections, roleswitch excluded>
|
||||
|
||||
---
|
||||
```
|
||||
|
||||
## Sections
|
||||
|
||||
Three section kinds, separated by `---` lines. Every section starts with a
|
||||
timestamp line `*msg_<random22> @ YYYY-MM-DD HH:MM:SS*` as its first body line.
|
||||
|
||||
### USER turn (numbered, real user wording)
|
||||
|
||||
```markdown
|
||||
## [1] USER
|
||||
*msg_abc... @ 2026-09-05 18:30:12*
|
||||
|
||||
<verbatim user text>
|
||||
|
||||
---
|
||||
```
|
||||
|
||||
### ASSISTANT turn
|
||||
|
||||
```markdown
|
||||
## [ASSISTANT] (glm-5.3)
|
||||
*msg_def... @ 2026-09-05 18:30:40*
|
||||
|
||||
<details><summary>thinking</summary>
|
||||
|
||||
> Real reasoning summary, one `> `-prefixed line per line.
|
||||
|
||||
</details>
|
||||
|
||||
Prose reply.
|
||||
|
||||
**[tool: bash]** status=ok
|
||||
```json
|
||||
{"command": "uv run python examples/flange_plate/model.py"}
|
||||
```
|
||||
```output
|
||||
<real output, may elide with "... (N lines)" — numbers and verdicts stay real>
|
||||
```
|
||||
|
||||
**[patch]** hash=1a2b3c4d5e
|
||||
- file: examples/flange_plate/model.py
|
||||
|
||||
**[text]**
|
||||
|
||||
More prose.
|
||||
|
||||
---
|
||||
```
|
||||
|
||||
Tool names are lowercase: `bash read write edit todowrite glob grep question
|
||||
task skill`. One ```json fence = tool input, one ```output fence = tool output
|
||||
(only the first of each is captured). A `**[patch]**` block follows each
|
||||
write/edit; hash = first 10 hex of md5 of the resulting file content.
|
||||
|
||||
### Role switch
|
||||
|
||||
```markdown
|
||||
## [Role Switch: <Role Name>]
|
||||
*msg_ghi... @ 2026-09-05 18:35:00*
|
||||
|
||||
Reading: <role-owned files>
|
||||
Artifact out: <path>
|
||||
|
||||
---
|
||||
```
|
||||
|
||||
`— note` may follow the role name inside the bracket. Optional `# Skill:`
|
||||
blocks (skill loads) render as a special chip.
|
||||
|
||||
## Fidelity rules
|
||||
|
||||
- Tool calls/outputs must be the real actions that produced the artifacts —
|
||||
outputs may be trimmed, never edited or invented.
|
||||
- Thinking blocks are the real reasoning of the moment, summarized honestly.
|
||||
- USER turns are verbatim; role-switch blocks follow the workflow's protocol.
|
||||
- Timestamps are real wall-clock times; `Messages:` equals the final section
|
||||
count (excluding role switches).
|
||||
@@ -0,0 +1,341 @@
|
||||
:root {
|
||||
--bg: #0b0f18;
|
||||
--bg2: #10151f;
|
||||
--panel: #131926;
|
||||
--panel2: #182032;
|
||||
--line: #232d42;
|
||||
--ink: #dbe4f3;
|
||||
--ink-dim: #8b97ad;
|
||||
--ink-faint: #5d6980;
|
||||
--accent: #4cc2ff;
|
||||
--accent2: #ffb454;
|
||||
--ok: #3fd68f;
|
||||
--err: #ff6b6b;
|
||||
--user: linear-gradient(135deg, #2b7bd4, #1f5aa8);
|
||||
--mono: "SF Mono", "JetBrains Mono", Menlo, Consolas, monospace;
|
||||
}
|
||||
* { box-sizing: border-box; margin: 0; padding: 0; }
|
||||
html, body { height: 100%; }
|
||||
body {
|
||||
font: 14px/1.65 -apple-system, "PingFang SC", "Microsoft YaHei", "Segoe UI", sans-serif;
|
||||
background: var(--bg);
|
||||
color: var(--ink);
|
||||
overflow: hidden;
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
}
|
||||
|
||||
/* ---------- top bar ---------- */
|
||||
#topbar {
|
||||
display: flex; align-items: center; justify-content: space-between; gap: 14px;
|
||||
padding: 10px 18px; background: linear-gradient(180deg, #111827, #0d1220);
|
||||
border-bottom: 1px solid var(--line); flex-wrap: wrap;
|
||||
}
|
||||
.brand { display: flex; align-items: center; gap: 12px; min-width: 0; }
|
||||
.logo {
|
||||
width: 40px; height: 40px; border-radius: 10px; flex: none;
|
||||
background: linear-gradient(135deg, #1c3d63, #122844);
|
||||
border: 1px solid #2c5f96; color: #7fc4ff;
|
||||
display: flex; align-items: center; justify-content: center;
|
||||
font: 700 13px/1 var(--mono); letter-spacing: .5px;
|
||||
box-shadow: 0 0 18px rgba(76, 194, 255, .18) inset;
|
||||
}
|
||||
.titles h1 { font-size: 15px; font-weight: 650; letter-spacing: .2px; white-space: nowrap; }
|
||||
.titles h1 em { font-style: normal; color: var(--accent); }
|
||||
.titles .sub { font-size: 11.5px; color: var(--ink-faint); margin-top: 1px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
|
||||
.controls { display: flex; align-items: center; gap: 10px; flex-wrap: wrap; }
|
||||
.seg { display: flex; background: var(--panel); border: 1px solid var(--line); border-radius: 8px; overflow: hidden; }
|
||||
.seg button {
|
||||
background: none; border: none; color: var(--ink-dim); font: 600 12px/1 inherit;
|
||||
padding: 7px 12px; cursor: pointer; transition: .15s;
|
||||
}
|
||||
.seg button:hover { color: var(--ink); }
|
||||
.seg button.on { background: #1d3355; color: var(--accent); }
|
||||
.tgl {
|
||||
background: var(--panel); border: 1px solid var(--line); color: var(--ink-faint);
|
||||
border-radius: 8px; padding: 7px 10px; font: 600 12px/1 inherit; cursor: pointer;
|
||||
}
|
||||
.tgl.on { color: var(--ink); border-color: #35507c; background: var(--panel2); }
|
||||
#playBtn {
|
||||
border: 1px solid #2c6fae; background: linear-gradient(135deg, #2273c2, #1a548f);
|
||||
color: #eaf6ff; border-radius: 8px; padding: 7px 16px; font: 650 12.5px/1 inherit; cursor: pointer;
|
||||
}
|
||||
#playBtn:hover { filter: brightness(1.15); }
|
||||
#nextBtn {
|
||||
border: 1px solid var(--line); background: var(--panel); color: var(--ink-dim);
|
||||
border-radius: 8px; padding: 7px 12px; font: 600 12.5px/1 inherit; cursor: pointer;
|
||||
}
|
||||
#nextBtn:hover { color: var(--ink); border-color: #35507c; }
|
||||
|
||||
/* ---------- scrubber ---------- */
|
||||
#scrubRow {
|
||||
display: flex; align-items: center; gap: 12px;
|
||||
padding: 8px 18px; background: #0d1220; border-bottom: 1px solid var(--line);
|
||||
font: 600 11.5px/1 var(--mono); color: var(--ink-faint);
|
||||
}
|
||||
#scrubStat { min-width: 190px; white-space: nowrap; }
|
||||
#scrubStat b { color: var(--accent); font-weight: 650; }
|
||||
#stageChip {
|
||||
border: 1px solid #2e4a6d; color: #86c7f5; border-radius: 6px; padding: 3px 8px;
|
||||
background: #12233a; white-space: nowrap;
|
||||
}
|
||||
#scrub { position: relative; flex: 1; height: 22px; cursor: pointer; }
|
||||
#scrubTrack {
|
||||
position: absolute; left: 0; right: 0; top: 9px; height: 4px;
|
||||
background: #1d2840; border-radius: 2px; overflow: hidden;
|
||||
}
|
||||
#scrubFill { height: 100%; width: 0; background: linear-gradient(90deg, #2b7bd4, #4cc2ff); border-radius: 2px; }
|
||||
.mark {
|
||||
position: absolute; top: 5px; width: 3px; height: 12px; border-radius: 2px;
|
||||
background: #3d5f8f; cursor: pointer;
|
||||
}
|
||||
.mark:hover, .mark.lit { background: var(--accent2); box-shadow: 0 0 6px rgba(255, 180, 84, .7); }
|
||||
#scrubTip {
|
||||
position: absolute; bottom: 24px; transform: translateX(-50%); display: none;
|
||||
background: #0a0e17; border: 1px solid var(--line); border-radius: 8px;
|
||||
padding: 7px 11px; font: 500 11.5px/1.5 -apple-system, "PingFang SC", sans-serif;
|
||||
color: var(--ink); white-space: nowrap; max-width: 480px; overflow: hidden; text-overflow: ellipsis;
|
||||
box-shadow: 0 8px 24px rgba(0, 0, 0, .5); z-index: 60; pointer-events: none;
|
||||
}
|
||||
#scrubTip .t { color: var(--ink-faint); font-size: 10.5px; }
|
||||
|
||||
/* ---------- layout ---------- */
|
||||
main { flex: 1; display: flex; min-height: 0; }
|
||||
#chatWrap { flex: 1; min-width: 0; position: relative; display: flex; flex-direction: column; }
|
||||
#chat { flex: 1; overflow-y: auto; padding: 22px 26px 90px; scroll-behavior: auto; }
|
||||
#chat::-webkit-scrollbar, .panebody::-webkit-scrollbar { width: 10px; }
|
||||
#chat::-webkit-scrollbar-thumb, .panebody::-webkit-scrollbar-thumb { background: #26314a; border-radius: 5px; }
|
||||
#followPill {
|
||||
position: absolute; bottom: 18px; left: 50%; transform: translateX(-50%);
|
||||
background: #1d3355; border: 1px solid #2c6fae; color: #bfe0ff; border-radius: 999px;
|
||||
padding: 8px 18px; font: 650 12.5px/1 inherit; cursor: pointer; display: none;
|
||||
box-shadow: 0 6px 20px rgba(0, 0, 0, .45); z-index: 30;
|
||||
}
|
||||
|
||||
/* ---------- session card ---------- */
|
||||
#sessionCard {
|
||||
max-width: 860px; margin: 4px auto 18px; background: linear-gradient(135deg, #121a2c, #0f1524);
|
||||
border: 1px solid var(--line); border-radius: 14px; padding: 18px 22px;
|
||||
}
|
||||
#sessionCard h2 { font-size: 16.5px; margin-bottom: 4px; }
|
||||
#sessionCard .sid { font: 500 11.5px/1 var(--mono); color: var(--ink-faint); margin-bottom: 14px; }
|
||||
.statGrid { display: grid; grid-template-columns: repeat(auto-fit, minmax(96px, 1fr)); gap: 8px; }
|
||||
.stat {
|
||||
background: #0d1424; border: 1px solid var(--line); border-radius: 10px; padding: 9px 10px 8px;
|
||||
}
|
||||
.stat b { display: block; font: 700 17px/1.2 var(--mono); color: var(--accent); }
|
||||
.stat.err b { color: var(--accent2); }
|
||||
.stat span { font-size: 10.5px; color: var(--ink-faint); }
|
||||
|
||||
/* ---------- messages ---------- */
|
||||
.msg { max-width: 860px; margin: 0 auto 14px; animation: rise .28s ease both; }
|
||||
@keyframes rise { from { opacity: 0; transform: translateY(9px); } to { opacity: 1; transform: none; } }
|
||||
.msg.user { display: flex; flex-direction: column; align-items: flex-end; }
|
||||
.msg.user .who { display: flex; align-items: center; gap: 8px; font: 650 11.5px/1 inherit; color: var(--ink-dim); margin-bottom: 5px; }
|
||||
.turnChip {
|
||||
background: #233451; border: 1px solid #33517c; color: #9ecbff; border-radius: 6px;
|
||||
padding: 2px 8px; font: 650 10.5px/1.4 var(--mono);
|
||||
}
|
||||
.bubble {
|
||||
background: var(--user); color: #f2f9ff; border-radius: 14px 14px 4px 14px;
|
||||
padding: 11px 15px; max-width: 86%; box-shadow: 0 4px 16px rgba(31, 90, 168, .25);
|
||||
white-space: pre-wrap; word-break: break-word;
|
||||
}
|
||||
.bubble .caret { display: inline-block; width: 2px; height: 1em; background: #fff; vertical-align: -2px; animation: blink .8s steps(1) infinite; }
|
||||
@keyframes blink { 50% { opacity: 0; } }
|
||||
|
||||
.msg.asst .head { display: flex; align-items: center; gap: 8px; margin-bottom: 6px; flex-wrap: wrap; }
|
||||
.avatar {
|
||||
width: 26px; height: 26px; border-radius: 8px; flex: none;
|
||||
background: linear-gradient(135deg, #2d3a55, #1c2740); border: 1px solid #3a4c72;
|
||||
color: #ffd9a0; font: 700 11px/26px var(--mono); text-align: center;
|
||||
}
|
||||
.aname { font: 650 12px/1 inherit; color: var(--ink-dim); }
|
||||
.modeltag { font: 500 10.5px/1 var(--mono); color: var(--ink-faint); }
|
||||
.mtime { font: 500 10.5px/1 var(--mono); color: var(--ink-faint); margin-left: auto; }
|
||||
.rbadge { border-radius: 6px; padding: 2.5px 9px; font: 650 10.5px/1.5 inherit; }
|
||||
.r-req { background: #3a2b12; color: #ffc46b; border: 1px solid #6b4d1e; }
|
||||
.r-plan { background: #12303f; color: #6fd3ff; border: 1px solid #1e5b75; }
|
||||
.r-build { background: #163323; color: #6fe0a0; border: 1px solid #236347; }
|
||||
.r-ver { background: #30203f; color: #c9a0ff; border: 1px solid #54357a; }
|
||||
.r-other { background: #262c3a; color: var(--ink-dim); border: 1px solid var(--line); }
|
||||
|
||||
.rolebanner {
|
||||
max-width: 860px; margin: 20px auto; text-align: center; animation: rise .28s ease both;
|
||||
}
|
||||
.rolebanner .pill {
|
||||
display: inline-flex; align-items: center; gap: 8px; flex-wrap: wrap; justify-content: center;
|
||||
background: #101a2e; border: 1px dashed #35507c; border-radius: 999px; padding: 7px 16px;
|
||||
font: 650 12.5px/1.5 inherit; color: #9ecbff;
|
||||
}
|
||||
.rolebanner .meta { font: 500 11px/1.7 var(--mono); color: var(--ink-faint); margin-top: 5px; }
|
||||
.rolebanner .meta code { color: #7fa3c8; }
|
||||
|
||||
/* ---------- blocks ---------- */
|
||||
.blk { margin: 7px 0; }
|
||||
details.blk-think, details.blk-skill {
|
||||
border: 1px solid #202a41; border-radius: 10px; background: #0e1422; overflow: hidden;
|
||||
}
|
||||
details.blk-think summary, details.blk-skill summary {
|
||||
cursor: pointer; list-style: none; padding: 7px 12px;
|
||||
font: 600 11.5px/1.6 inherit; color: var(--ink-faint); user-select: none;
|
||||
}
|
||||
details.blk-think summary::before { content: "🧠 "; }
|
||||
details.blk-skill summary::before { content: "📄 "; }
|
||||
details.blk-think summary:hover, details.blk-skill summary:hover { color: var(--ink-dim); }
|
||||
details.blk-think[open] summary, details.blk-skill[open] summary { border-bottom: 1px solid #1c2740; }
|
||||
.thinkbody, .skillbody { padding: 10px 14px; font-size: 12.5px; color: #9aa8c0; max-height: 340px; overflow: auto; }
|
||||
|
||||
.md { font-size: 13.5px; }
|
||||
.md h1, .md h2, .md h3, .md h4 { font-size: 13.5px; margin: 12px 0 6px; color: #cfe2ff; }
|
||||
.md h1 { font-size: 15px; }
|
||||
.md p { margin: 6px 0; }
|
||||
.md ul, .md ol { margin: 6px 0 6px 20px; }
|
||||
.md li { margin: 3px 0; }
|
||||
.md code {
|
||||
font: 500 12px/1.5 var(--mono); background: #1a2337; color: #9fd0ff;
|
||||
border-radius: 5px; padding: 1px 6px;
|
||||
}
|
||||
.md blockquote {
|
||||
border-left: 3px solid #2e4a6d; padding: 2px 12px; margin: 8px 0;
|
||||
color: #a6b4cc; background: #0f1626; border-radius: 0 8px 8px 0;
|
||||
}
|
||||
.md table { border-collapse: collapse; margin: 10px 0; font-size: 12px; max-width: 100%; display: block; overflow-x: auto; }
|
||||
.md th, .md td { border: 1px solid #26324c; padding: 5px 10px; text-align: left; }
|
||||
.md th { background: #16203a; color: #b9d4f5; }
|
||||
.md hr { border: none; border-top: 1px solid #1f2a40; margin: 10px 0; }
|
||||
|
||||
.toolcard {
|
||||
border: 1px solid #202b42; border-left: 3px solid #2b5f8f; border-radius: 10px;
|
||||
background: #0e1524; overflow: hidden;
|
||||
}
|
||||
.toolcard.st-error { border-left-color: var(--err); }
|
||||
.toolcard .trow {
|
||||
display: flex; align-items: center; gap: 9px; padding: 8px 12px; cursor: pointer; user-select: none;
|
||||
}
|
||||
.toolcard .trow:hover { background: #121b2e; }
|
||||
.tico { font-size: 13px; width: 18px; text-align: center; flex: none; }
|
||||
.tname { font: 650 12px/1 var(--mono); color: #86b8e8; }
|
||||
.tstat { font: 650 10px/1 var(--mono); border-radius: 5px; padding: 2.5px 7px; flex: none; }
|
||||
.st-completed { background: #11301f; color: var(--ok); border: 1px solid #1d5b3d; }
|
||||
.st-error { background: #3a1616; color: var(--err); border: 1px solid #6b2424; }
|
||||
.tsum {
|
||||
flex: 1; min-width: 0; font: 500 11.5px/1.5 var(--mono); color: var(--ink-dim);
|
||||
white-space: nowrap; overflow: hidden; text-overflow: ellipsis;
|
||||
}
|
||||
.tlen { font: 500 10.5px/1 var(--mono); color: var(--ink-faint); flex: none; }
|
||||
.chev { color: var(--ink-faint); font-size: 10px; flex: none; transition: transform .15s; }
|
||||
.toolcard.open .chev { transform: rotate(90deg); }
|
||||
.toolbody { display: none; border-top: 1px solid #1c2740; }
|
||||
.toolcard.open .toolbody { display: block; }
|
||||
.codebox { position: relative; }
|
||||
.codebox .lab {
|
||||
position: sticky; top: 0; display: flex; justify-content: space-between;
|
||||
background: #101a2e; color: #6d87ab; border-bottom: 1px solid #1a2438;
|
||||
font: 650 10px/1 var(--mono); padding: 5px 12px;
|
||||
}
|
||||
.codebox pre {
|
||||
font: 500 11.5px/1.6 var(--mono); color: #b7c6dd; padding: 10px 14px;
|
||||
overflow: auto; max-height: 380px; white-space: pre-wrap; word-break: break-word;
|
||||
}
|
||||
.pill-patch {
|
||||
display: inline-flex; gap: 8px; align-items: center; flex-wrap: wrap;
|
||||
border: 1px solid #223049; background: #0e1626; border-radius: 8px;
|
||||
padding: 5px 11px; font: 500 11px/1.6 var(--mono); color: var(--ink-dim); margin: 4px 0;
|
||||
}
|
||||
.pill-patch .h { color: #c9a0ff; }
|
||||
.pill-patch .f { color: #8fb0d4; }
|
||||
|
||||
/* typing indicator */
|
||||
.typing { display: inline-flex; gap: 4px; align-items: center; padding: 4px 2px; }
|
||||
.typing i { width: 6px; height: 6px; border-radius: 50%; background: #cfe2ff; animation: tp 1s infinite; }
|
||||
.typing i:nth-child(2) { animation-delay: .18s; }
|
||||
.typing i:nth-child(3) { animation-delay: .36s; }
|
||||
@keyframes tp { 0%, 60%, 100% { opacity: .25; } 30% { opacity: 1; } }
|
||||
|
||||
/* ---------- side panel ---------- */
|
||||
#side {
|
||||
width: 430px; flex: none; border-left: 1px solid var(--line); background: #0d1220;
|
||||
display: flex; flex-direction: column; min-height: 0;
|
||||
}
|
||||
#tabs { display: flex; border-bottom: 1px solid var(--line); }
|
||||
#tabs button {
|
||||
flex: 1; background: none; border: none; color: var(--ink-faint); cursor: pointer;
|
||||
font: 600 12px/1 inherit; padding: 11px 4px; border-bottom: 2px solid transparent;
|
||||
}
|
||||
#tabs button:hover { color: var(--ink-dim); }
|
||||
#tabs button.on { color: var(--accent); border-bottom-color: var(--accent); }
|
||||
.tabpanes { flex: 1; min-height: 0; position: relative; }
|
||||
.pane { position: absolute; inset: 0; display: none; flex-direction: column; }
|
||||
.pane.on { display: flex; }
|
||||
.panebody { flex: 1; overflow-y: auto; padding: 14px; }
|
||||
|
||||
#glWrap { flex: 1; min-height: 0; position: relative; background: radial-gradient(120% 90% at 50% 10%, #16203a 0%, #0a0e18 70%); }
|
||||
#gl { width: 100%; height: 100%; display: block; cursor: grab; }
|
||||
#gl:active { cursor: grabbing; }
|
||||
#glHint {
|
||||
position: absolute; left: 12px; bottom: 10px; font: 500 10.5px/1 var(--mono);
|
||||
color: var(--ink-faint); background: rgba(10, 14, 24, .6); padding: 5px 9px; border-radius: 6px;
|
||||
pointer-events: none;
|
||||
}
|
||||
#glLoad {
|
||||
position: absolute; inset: 0; display: flex; align-items: center; justify-content: center;
|
||||
color: var(--ink-faint); font: 600 12px/1 inherit;
|
||||
}
|
||||
#glBar {
|
||||
display: flex; gap: 7px; flex-wrap: wrap; padding: 9px 12px; border-top: 1px solid var(--line);
|
||||
border-bottom: 1px solid var(--line); background: #0f1524;
|
||||
}
|
||||
#glBar button {
|
||||
background: var(--panel); border: 1px solid var(--line); color: var(--ink-dim); border-radius: 7px;
|
||||
font: 600 11.5px/1 inherit; padding: 6px 11px; cursor: pointer;
|
||||
}
|
||||
#glBar button:hover { color: var(--ink); border-color: #35507c; }
|
||||
#glBar button.on { color: var(--accent); border-color: #2c6fae; background: #12233c; }
|
||||
#glCap { padding: 8px 13px; font: 500 11px/1.6 var(--mono); color: var(--ink-faint); }
|
||||
|
||||
.rgrid { display: grid; grid-template-columns: 1fr 1fr; gap: 10px; }
|
||||
.rgrid figure { border: 1px solid var(--line); border-radius: 10px; overflow: hidden; background: #0f1626; cursor: zoom-in; }
|
||||
.rgrid img { width: 100%; display: block; }
|
||||
.rgrid figcaption { font: 500 11px/1 inherit; color: var(--ink-faint); padding: 7px 9px; }
|
||||
|
||||
.ptable { width: 100%; border-collapse: collapse; font-size: 12px; }
|
||||
.ptable th, .ptable td { border-bottom: 1px solid #1b2540; padding: 6.5px 8px; text-align: left; vertical-align: top; }
|
||||
.ptable th { color: #8fb0d4; font: 650 11px/1.5 var(--mono); white-space: nowrap; }
|
||||
.ptable td.k { font: 650 11.5px/1.6 var(--mono); color: var(--accent); white-space: nowrap; }
|
||||
.ptable td.v { font: 650 11.5px/1.6 var(--mono); color: #ffd9a0; white-space: nowrap; }
|
||||
.ptable td.c { color: var(--ink-dim); }
|
||||
.secttl { font: 700 12.5px/1 inherit; color: #cfe2ff; margin: 16px 0 8px; }
|
||||
.secttl:first-child { margin-top: 2px; }
|
||||
.tagchip {
|
||||
display: inline-block; font: 650 10.5px/1.7 var(--mono); color: #6fe0a0;
|
||||
background: #10281c; border: 1px solid #1f5b3d; border-radius: 6px; padding: 1px 8px; margin: 2px 4px 2px 0;
|
||||
}
|
||||
.filelist { font: 500 11.5px/1.9 var(--mono); color: var(--ink-dim); }
|
||||
.filelist b { color: #9ecbff; font-weight: 650; }
|
||||
.filelist .sz { color: var(--ink-faint); }
|
||||
.about p { margin: 8px 0; font-size: 12.5px; color: var(--ink-dim); }
|
||||
.about li { margin: 5px 0 5px 18px; font-size: 12.5px; color: var(--ink-dim); }
|
||||
.about b { color: var(--ink); }
|
||||
.kbd {
|
||||
font: 600 11px/1 var(--mono); background: #1a2337; border: 1px solid #2c3a58;
|
||||
border-bottom-width: 2px; border-radius: 5px; padding: 2px 7px; color: #b9d4f5;
|
||||
}
|
||||
|
||||
#lightbox {
|
||||
position: fixed; inset: 0; z-index: 100; display: none; align-items: center; justify-content: center;
|
||||
background: rgba(5, 8, 14, .88); cursor: zoom-out;
|
||||
}
|
||||
#lightbox img { max-width: 94vw; max-height: 92vh; border-radius: 10px; }
|
||||
|
||||
@media (max-width: 1180px) {
|
||||
#side { position: fixed; right: 0; top: 0; bottom: 0; z-index: 70; transform: translateX(100%); transition: transform .25s; box-shadow: -12px 0 40px rgba(0,0,0,.5); }
|
||||
#side.show { transform: none; }
|
||||
#sideToggle { display: flex !important; }
|
||||
}
|
||||
#sideToggle {
|
||||
display: none; position: fixed; right: 16px; bottom: 16px; z-index: 80;
|
||||
align-items: center; gap: 7px; border: 1px solid #2c6fae; background: #14304f; color: #bfe0ff;
|
||||
border-radius: 999px; padding: 10px 16px; font: 650 12.5px/1 inherit; cursor: pointer;
|
||||
box-shadow: 0 8px 24px rgba(0, 0, 0, .5);
|
||||
}
|
||||
@@ -0,0 +1,667 @@
|
||||
/* -*- coding: utf-8 -*- Agent CAD session replay demo. */
|
||||
"use strict";
|
||||
|
||||
/* ================= data ================= */
|
||||
const DATA = JSON.parse(document.getElementById("feed").textContent);
|
||||
const MSGS = DATA.messages;
|
||||
const STATS = DATA.stats;
|
||||
const META = DATA.meta;
|
||||
const CFG = DATA.config || {};
|
||||
const N = MSGS.length;
|
||||
|
||||
/* stage range across role switches, e.g. "S1–S14" */
|
||||
const stageRange = (() => {
|
||||
const sn = [];
|
||||
for (const m of MSGS) {
|
||||
if (m.role === "roleswitch") {
|
||||
const hit = (m.roleName + " " + (m.roleNote || "")).match(/S(\d+)/);
|
||||
if (hit) sn.push(+hit[1]);
|
||||
}
|
||||
}
|
||||
if (!sn.length) return "";
|
||||
const lo = Math.min(...sn), hi = Math.max(...sn);
|
||||
return lo === hi ? "S" + lo : "S" + lo + "–S" + hi;
|
||||
})();
|
||||
if (CFG.title) document.title = CFG.title + " · 会话回放 Demo";
|
||||
|
||||
const $ = (s, el) => (el || document).querySelector(s);
|
||||
const el = (tag, cls, txt) => {
|
||||
const n = document.createElement(tag);
|
||||
if (cls) n.className = cls;
|
||||
if (txt !== undefined) n.textContent = txt;
|
||||
return n;
|
||||
};
|
||||
const esc = s => String(s).replace(/[&<>"']/g, c => ({ "&": "&", "<": "<", ">": ">", '"': """, "'": "'" }[c]));
|
||||
|
||||
/* stage tracking: last S-number seen in role switches up to each message */
|
||||
let curStage = "";
|
||||
for (const m of MSGS) {
|
||||
if (m.role === "roleswitch") {
|
||||
const hit = (m.roleName + " " + (m.roleNote || "")).match(/S(\d+)/);
|
||||
if (hit) curStage = "S" + hit[1];
|
||||
}
|
||||
m.stage = curStage;
|
||||
}
|
||||
|
||||
function roleBadge(name) {
|
||||
const n = (name || "").toLowerCase();
|
||||
if (n.includes("requirement") || n.includes("需求")) return { label: "需求确认", cls: "r-req" };
|
||||
if (n.includes("master")) return { label: "总体规划", cls: "r-plan" };
|
||||
if (n.includes("verifier planner") || n.includes("验证规划")) return { label: "验证规划", cls: "r-ver" };
|
||||
if (n.includes("builder") || n.includes("建模")) return { label: "建模执行", cls: "r-build" };
|
||||
if (n.includes("验证器")) return { label: "验证执行", cls: "r-ver" };
|
||||
return { label: name || "Agent", cls: "r-other" };
|
||||
}
|
||||
|
||||
/* ================= mini markdown ================= */
|
||||
function md(src) {
|
||||
const fences = [];
|
||||
let s = String(src == null ? "" : src);
|
||||
s = s.replace(/```(\w*)\n([\s\S]*?)(?:```|$)/g, (_, lang, code) => {
|
||||
fences.push({ lang, code });
|
||||
return "\u0000F" + (fences.length - 1) + "\u0000";
|
||||
});
|
||||
s = esc(s);
|
||||
const lines = s.split("\n");
|
||||
const out = [];
|
||||
let list = null, table = null, quote = false;
|
||||
const closeList = () => { if (list) { out.push("</" + list + ">"); list = null; } };
|
||||
const closeTable = () => {
|
||||
if (table) { out.push("</tbody></table>"); table = null; }
|
||||
};
|
||||
const closeQuote = () => { if (quote) { out.push("</blockquote>"); quote = false; } };
|
||||
const inline = t => t
|
||||
.replace(/`([^`]+)`/g, "<code>$1</code>")
|
||||
.replace(/\*\*([^*]+)\*\*/g, "<b>$1</b>")
|
||||
.replace(/\*([^*\n]+)\*/g, "<i>$1</i>")
|
||||
.replace(/\[([^\]]+)\]\(([^)]+)\)/g, '<a href="$2" target="_blank" rel="noopener">$1</a>');
|
||||
|
||||
for (const raw of lines) {
|
||||
const line = raw;
|
||||
const fm = line.match(/^\u0000F(\d+)\u0000\s*$/);
|
||||
if (fm) { closeList(); closeTable(); closeQuote(); out.push(fenceHtml(fences[+fm[1]])); continue; }
|
||||
if (/^\s*$/.test(line)) { closeList(); closeTable(); closeQuote(); out.push(""); continue; }
|
||||
if (/^(---+|\*\*\*+)\s*$/.test(line)) { closeList(); closeTable(); closeQuote(); out.push("<hr>"); continue; }
|
||||
const hm = line.match(/^(#{1,4})\s+(.*)$/);
|
||||
if (hm) {
|
||||
closeList(); closeTable(); closeQuote();
|
||||
const lv = Math.min(4, hm[1].length + 2);
|
||||
out.push("<h" + lv + ">" + inline(hm[2]) + "</h" + lv + ">");
|
||||
continue;
|
||||
}
|
||||
if (/^>\s?/.test(line)) {
|
||||
closeList(); closeTable();
|
||||
if (!quote) { out.push("<blockquote>"); quote = true; }
|
||||
out.push("<p>" + inline(line.replace(/^>\s?/, "")) + "</p>");
|
||||
continue;
|
||||
}
|
||||
closeQuote();
|
||||
if (line.includes("|") && line.trim().startsWith("|")) {
|
||||
const cells = line.split("|").slice(1, -1).map(c => c.trim());
|
||||
if (cells.every(c => /^:?-{2,}:?$/.test(c))) continue; // separator row
|
||||
if (!table) { closeList(); out.push("<table><tbody>"); table = true; }
|
||||
out.push("<tr>" + cells.map(c => "<td>" + inline(c) + "</td>").join("") + "</tr>");
|
||||
continue;
|
||||
}
|
||||
closeTable();
|
||||
const um = line.match(/^\s*[-*]\s+(.*)$/);
|
||||
const om = line.match(/^\s*\d+[.)]\s+(.*)$/);
|
||||
if (um || om) {
|
||||
const want = um ? "ul" : "ol";
|
||||
if (list !== want) { closeList(); out.push("<" + want + ">"); list = want; }
|
||||
out.push("<li>" + inline((um || om)[1]) + "</li>");
|
||||
continue;
|
||||
}
|
||||
closeList();
|
||||
out.push("<p>" + inline(line) + "</p>");
|
||||
}
|
||||
closeList(); closeTable(); closeQuote();
|
||||
return out.join("\n");
|
||||
}
|
||||
function fenceHtml(f) {
|
||||
return '<div class="codebox"><div class="lab"><span>' + esc(f.lang || "text") +
|
||||
"</span><span>" + f.code.split("\n").length + " 行</span></div><pre>" + esc(f.code) + "</pre></div>";
|
||||
}
|
||||
|
||||
/* ================= tool summaries ================= */
|
||||
const TOOL_META = {
|
||||
bash: ["$", "bash"], write: ["✍", "write"], edit: ["✎", "edit"], read: ["📖", "read"],
|
||||
todowrite: ["☑", "todo"], grep: ["⌕", "grep"], glob: ["[])", "glob"],
|
||||
question: ["?", "question"], task: ["☱", "task"], skill: ["⚡", "skill"],
|
||||
};
|
||||
function toolSummary(b) {
|
||||
let inp = null;
|
||||
try { inp = b.input ? JSON.parse(b.input) : null; } catch (e) { inp = null; }
|
||||
let s = "";
|
||||
if (b.name === "bash") s = (inp && inp.command) || b.input || "";
|
||||
else if (inp && inp.filePath) {
|
||||
const base = String(inp.filePath).split("/").pop();
|
||||
let extra = "";
|
||||
if (b.name === "write" && inp.content) extra = " · " + (inp.content.length / 1000).toFixed(1) + "KB";
|
||||
if (b.name === "edit" && inp.oldString) extra = " · " + String(inp.oldString).split("\n").length + " 行替换";
|
||||
s = base + extra;
|
||||
} else if (b.name === "todowrite" && inp && inp.todos) s = inp.todos.length + " 项";
|
||||
else s = b.input ? String(b.input).replace(/\s+/g, " ").slice(0, 90) : "(无输入)";
|
||||
return { s: s.replace(/\s+/g, " ").slice(0, 110), inp };
|
||||
}
|
||||
|
||||
/* ================= message DOM ================= */
|
||||
const chat = $("#chat");
|
||||
let showThink = true, showOut = true;
|
||||
|
||||
function buildBlocks(m, box, animated) {
|
||||
for (const b of m.blocks) {
|
||||
if (b.t === "text") {
|
||||
const d = el("div", "blk blk-text");
|
||||
const mdEl = el("div", "md");
|
||||
mdEl.innerHTML = md(b.md);
|
||||
d.appendChild(mdEl);
|
||||
box.appendChild(d);
|
||||
} else if (b.t === "think") {
|
||||
if (!showThink) continue;
|
||||
const det = el("details", "blk blk-think");
|
||||
const sum = el("summary", null, "思考过程 · " + b.md.length + " 字(点击展开)");
|
||||
const body = el("div", "thinkbody");
|
||||
body.innerHTML = md(b.md);
|
||||
det.append(sum, body);
|
||||
box.appendChild(det);
|
||||
} else if (b.t === "skill") {
|
||||
const det = el("details", "blk blk-skill");
|
||||
const sum = el("summary", null, "Skill 加载 · " + b.name + "(SKILL.md 全文)");
|
||||
const body = el("div", "skillbody");
|
||||
body.innerHTML = md(b.md);
|
||||
det.append(sum, body);
|
||||
box.appendChild(det);
|
||||
} else if (b.t === "code") {
|
||||
const d = el("div", "blk");
|
||||
d.innerHTML = fenceHtml(b);
|
||||
box.appendChild(d);
|
||||
} else if (b.t === "patch") {
|
||||
const p = el("div", "pill-patch");
|
||||
p.appendChild(el("span", "h", "✎ " + b.hash));
|
||||
for (const f of b.files) p.appendChild(el("span", "f", f.split("/").slice(-2).join("/")));
|
||||
box.appendChild(p);
|
||||
} else if (b.t === "tool") {
|
||||
box.appendChild(toolCard(b));
|
||||
}
|
||||
}
|
||||
}
|
||||
function toolCard(b) {
|
||||
const card = el("div", "toolcard" + (b.status === "error" ? " st-error" : ""));
|
||||
const meta = TOOL_META[b.name] || ["▪", b.name];
|
||||
const { s } = toolSummary(b);
|
||||
const row = el("div", "trow");
|
||||
row.append(
|
||||
el("span", "tico", meta[0]), el("span", "tname", meta[1]),
|
||||
el("span", "tstat st-" + b.status, b.status === "completed" ? "✓ done" : "✗ error"),
|
||||
el("span", "tsum", s)
|
||||
);
|
||||
if (b.input) row.appendChild(el("span", "tlen", "in " + (b.input.length / 1000).toFixed(1) + "k"));
|
||||
if (b.output) row.appendChild(el("span", "tlen", "out " + (b.output.length / 1000).toFixed(1) + "k"));
|
||||
row.appendChild(el("span", "chev", "▶"));
|
||||
const body = el("div", "toolbody");
|
||||
let built = false;
|
||||
const build = () => {
|
||||
if (built) return;
|
||||
built = true;
|
||||
if (b.input) {
|
||||
const d = el("div");
|
||||
d.innerHTML = '<div class="codebox"><div class="lab"><span>input · json</span></div><pre>' +
|
||||
esc(prettyJson(b.input)) + "</pre></div>";
|
||||
body.appendChild(d);
|
||||
}
|
||||
if (b.output) {
|
||||
const d = el("div");
|
||||
d.innerHTML = '<div class="codebox"><div class="lab"><span>output</span><span>' +
|
||||
b.output.split("\n").length + " 行</span></div><pre>" + esc(b.output) + "</pre></div>";
|
||||
d.style.display = showOut ? "" : "none";
|
||||
d.className = "tool-out";
|
||||
body.appendChild(d);
|
||||
}
|
||||
if (!b.input && !b.output) body.appendChild(el("div", null, "(无输入输出)"));
|
||||
};
|
||||
row.addEventListener("click", () => { card.classList.toggle("open"); build(); });
|
||||
card.append(row, body);
|
||||
return card;
|
||||
}
|
||||
function prettyJson(s) {
|
||||
try { return JSON.stringify(JSON.parse(s), null, 2); } catch (e) { return s; }
|
||||
}
|
||||
|
||||
function renderMessage(m, opts) {
|
||||
opts = opts || {};
|
||||
if (m.role === "asst" && m.blocks.length === 0) return null; // 空 assistant 消息(原会话中内容为角色切换公告)
|
||||
if (m.role === "user") {
|
||||
const d = el("div", "msg user");
|
||||
d.dataset.i = m.i;
|
||||
const who = el("div", "who");
|
||||
who.append(el("span", "turnChip", "用户 · 第 " + m.userN + " 轮"));
|
||||
if (m.ts) who.appendChild(el("span", null, m.ts.slice(5)));
|
||||
const bub = el("div", "bubble");
|
||||
const txt = m.blocks.map(b => (b.t === "text" ? b.md : "")).join("\n").trim() || "(内容见下)";
|
||||
d.append(who, bub);
|
||||
chat.appendChild(d);
|
||||
if (opts.typing) {
|
||||
const tip = el("span", "typing", "");
|
||||
tip.innerHTML = "<i></i><i></i><i></i>";
|
||||
bub.appendChild(tip);
|
||||
typeInto(bub, txt, () => {});
|
||||
} else {
|
||||
bub.textContent = txt;
|
||||
}
|
||||
return d;
|
||||
}
|
||||
if (m.role === "roleswitch") {
|
||||
const rb = roleBadge(m.roleName);
|
||||
const d = el("div", "rolebanner");
|
||||
d.dataset.i = m.i;
|
||||
const pill = el("div", "pill");
|
||||
pill.append(el("span", null, "⟳ 角色切换"), el("span", "rbadge " + rb.cls, rb.label));
|
||||
const nm = el("span", null, m.roleName);
|
||||
nm.style.color = "#dbe4f3";
|
||||
pill.appendChild(nm);
|
||||
if (m.roleNote) pill.appendChild(el("span", null, "— " + m.roleNote));
|
||||
d.appendChild(pill);
|
||||
if (m.reading || m.artifact) {
|
||||
const meta = el("div", "meta");
|
||||
if (m.reading) meta.innerHTML += "读取 " + md(m.reading).replace(/^<p>|<\/p>$/g, "") + " ";
|
||||
if (m.artifact) meta.innerHTML += "产出 " + md(m.artifact).replace(/^<p>|<\/p>$/g, "");
|
||||
d.appendChild(meta);
|
||||
}
|
||||
chat.appendChild(d);
|
||||
if (m.blocks.length) {
|
||||
const am = el("div", "msg asst");
|
||||
am.dataset.i = m.i;
|
||||
const head = asstHead(m);
|
||||
const box = el("div", null);
|
||||
am.append(head, box);
|
||||
buildBlocks(m, box);
|
||||
chat.appendChild(am);
|
||||
}
|
||||
return d;
|
||||
}
|
||||
// assistant
|
||||
const d = el("div", "msg asst");
|
||||
d.dataset.i = m.i;
|
||||
const box = el("div", null);
|
||||
d.append(asstHead(m), box);
|
||||
buildBlocks(m, box);
|
||||
chat.appendChild(d);
|
||||
return d;
|
||||
}
|
||||
function asstHead(m) {
|
||||
const head = el("div", "head");
|
||||
head.appendChild(el("div", "avatar", "A"));
|
||||
const rb = roleBadge(m.curRole);
|
||||
head.appendChild(el("span", "rbadge " + rb.cls, rb.label));
|
||||
head.appendChild(el("span", "aname", "Agent"));
|
||||
head.appendChild(el("span", "modeltag", m.model || ""));
|
||||
if (m.stage) head.appendChild(el("span", "modeltag", m.stage));
|
||||
if (m.ts) head.appendChild(el("span", "mtime", m.ts.slice(5)));
|
||||
return head;
|
||||
}
|
||||
|
||||
/* typing effect */
|
||||
let typeTimer = null;
|
||||
function typeInto(bub, txt, done) {
|
||||
clearInterval(typeTimer);
|
||||
const caret = el("span", "caret");
|
||||
bub.textContent = "";
|
||||
bub.appendChild(caret);
|
||||
let i = 0;
|
||||
const stepChars = Math.max(1, Math.round(3 * speed));
|
||||
typeTimer = setInterval(() => {
|
||||
i += stepChars;
|
||||
if (i >= txt.length) {
|
||||
clearInterval(typeTimer);
|
||||
bub.textContent = txt;
|
||||
done();
|
||||
} else {
|
||||
bub.textContent = txt.slice(0, i);
|
||||
bub.appendChild(caret);
|
||||
}
|
||||
}, 30);
|
||||
}
|
||||
|
||||
/* ================= playback engine ================= */
|
||||
let cursor = 0, playing = false, speed = 1, mode = "replay", follow = true, advanceTimer = null;
|
||||
|
||||
function delayFor(m) {
|
||||
let d = 260;
|
||||
if (m.role === "user") d = 1500;
|
||||
else if (m.role === "roleswitch") d = 900;
|
||||
else {
|
||||
let tools = 0, texts = 0;
|
||||
for (const b of m.blocks) { if (b.t === "tool") tools++; else if (b.t === "text") texts++; }
|
||||
d = 320 + tools * 380 + texts * 520 + (m.blocks.length - tools - texts) * 160;
|
||||
d = Math.min(d, 3400);
|
||||
}
|
||||
return d / speed;
|
||||
}
|
||||
function step() {
|
||||
if (!playing) return;
|
||||
if (cursor >= N) { setPlaying(false); return; }
|
||||
const m = MSGS[cursor++];
|
||||
const isUser = m.role === "user";
|
||||
renderMessage(m, { typing: isUser && speed < 99 });
|
||||
updateScrub();
|
||||
if (cursor >= N) { setPlaying(false); updateScrub(); return; }
|
||||
const d = delayFor(m);
|
||||
advanceTimer = setTimeout(step, d);
|
||||
}
|
||||
function setPlaying(p) {
|
||||
playing = p;
|
||||
$("#playBtn").textContent = p ? "⏸ 暂停" : "▶ 播放";
|
||||
if (!p) { clearTimeout(advanceTimer); clearInterval(typeTimer); }
|
||||
}
|
||||
function play() { setPlaying(true); step(); }
|
||||
$("#playBtn").addEventListener("click", () => {
|
||||
if (playing) setPlaying(false);
|
||||
else { if (cursor >= N) seek(0); play(); }
|
||||
});
|
||||
$("#nextBtn").addEventListener("click", () => {
|
||||
setPlaying(false);
|
||||
const next = STATS.userIdx.find(i => i >= cursor);
|
||||
seek(next === undefined ? N - 1 : next);
|
||||
setPlaying(true); step();
|
||||
});
|
||||
|
||||
/* seek: render [0..idx] instantly */
|
||||
function seek(idx) {
|
||||
setPlaying(false);
|
||||
chat.querySelectorAll(".msg, .rolebanner").forEach(n => n.remove());
|
||||
cursor = Math.min(idx + 1, N);
|
||||
for (let i = 0; i < cursor; i++) renderMessage(MSGS[i], {});
|
||||
updateScrub();
|
||||
jumpBottom(true);
|
||||
}
|
||||
|
||||
/* ================= scrubber ================= */
|
||||
const scrub = $("#scrub"), scrubFill = $("#scrubFill"), scrubTip = $("#scrubTip"), scrubStat = $("#scrubStat");
|
||||
function updateScrub() {
|
||||
scrubFill.style.width = (cursor / N * 100) + "%";
|
||||
const doneUsers = STATS.userIdx.filter(i => i < cursor).length;
|
||||
const m = MSGS[Math.max(0, cursor - 1)];
|
||||
scrubStat.innerHTML = "消息 <b>" + cursor + "</b> / " + N +
|
||||
" · 用户轮 <b>" + doneUsers + "</b> / " + STATS.userTurns +
|
||||
(m && m.stage ? " · " + m.stage : "");
|
||||
const chip = $("#stageChip");
|
||||
chip.textContent = m && m.stage ? m.stage : "初始化";
|
||||
document.querySelectorAll(".mark").forEach((mk, k) => {
|
||||
mk.classList.toggle("lit", STATS.userIdx[k] < cursor);
|
||||
});
|
||||
}
|
||||
(function buildMarks() {
|
||||
STATS.userIdx.forEach((idx, k) => {
|
||||
const mk = el("div", "mark");
|
||||
mk.style.left = (idx / N * 100) + "%";
|
||||
const m = MSGS[idx];
|
||||
const txt = m.blocks.map(b => (b.t === "text" ? b.md : "")).join(" ").replace(/\s+/g, " ").slice(0, 60);
|
||||
mk.addEventListener("mouseenter", () => {
|
||||
scrubTip.style.display = "block";
|
||||
scrubTip.style.left = mk.style.left;
|
||||
scrubTip.innerHTML = '<div class="t">第 ' + m.userN + ' 轮 · ' + (m.ts || "").slice(5) + " · 点击跳转</div>" + esc(txt);
|
||||
});
|
||||
mk.addEventListener("mouseleave", () => { scrubTip.style.display = "none"; });
|
||||
mk.addEventListener("click", e => { e.stopPropagation(); seek(idx); setPlaying(true); step(); });
|
||||
scrub.appendChild(mk);
|
||||
});
|
||||
})();
|
||||
function scrubPos(e) {
|
||||
const r = scrub.getBoundingClientRect();
|
||||
const frac = Math.min(1, Math.max(0, (e.clientX - r.left) / r.width));
|
||||
return Math.round(frac * (N - 1));
|
||||
}
|
||||
scrub.addEventListener("click", e => { const i = scrubPos(e); seek(i); });
|
||||
let scrubDrag = false;
|
||||
scrub.addEventListener("pointerdown", e => { scrubDrag = true; scrub.setPointerCapture(e.pointerId); });
|
||||
scrub.addEventListener("pointermove", e => {
|
||||
if (scrubDrag) { const i = scrubPos(e); scrubFill.style.width = (i / N * 100) + "%"; }
|
||||
});
|
||||
scrub.addEventListener("pointerup", e => {
|
||||
if (scrubDrag) { scrubDrag = false; seek(scrubPos(e)); }
|
||||
});
|
||||
|
||||
/* ================= chat scroll / follow ================= */
|
||||
const chatWrap = $("#chatWrap");
|
||||
chatWrap.addEventListener("scroll", () => {
|
||||
const away = chatWrap.scrollHeight - chatWrap.scrollTop - chatWrap.clientHeight > 140;
|
||||
follow = !away;
|
||||
$("#followPill").style.display = away ? "block" : "none";
|
||||
});
|
||||
$("#followPill").addEventListener("click", () => { jumpBottom(true); follow = true; $("#followPill").style.display = "none"; });
|
||||
function jumpBottom(smooth) {
|
||||
chatWrap.scrollTo({ top: chatWrap.scrollHeight, behavior: smooth ? "smooth" : "auto" });
|
||||
}
|
||||
const _origAppend = chat.appendChild.bind(chat);
|
||||
chat.appendChild = node => { _origAppend(node); if (follow) jumpBottom(false); return node; };
|
||||
|
||||
/* ================= controls ================= */
|
||||
$("#modeSeg").addEventListener("click", e => {
|
||||
const b = e.target.closest("button"); if (!b) return;
|
||||
document.querySelectorAll("#modeSeg button").forEach(x => x.classList.toggle("on", x === b));
|
||||
mode = b.dataset.m;
|
||||
if (mode === "read") { setPlaying(false); seek(N - 1); }
|
||||
});
|
||||
$("#speedSeg").addEventListener("click", e => {
|
||||
const b = e.target.closest("button"); if (!b) return;
|
||||
document.querySelectorAll("#speedSeg button").forEach(x => x.classList.toggle("on", x === b));
|
||||
speed = parseFloat(b.dataset.s);
|
||||
});
|
||||
$("#tglThink").addEventListener("click", e => {
|
||||
showThink = !showThink;
|
||||
e.currentTarget.classList.toggle("on", showThink);
|
||||
document.querySelectorAll(".blk-think, .blk-skill").forEach(n => n.style.display = showThink ? "" : "none");
|
||||
});
|
||||
$("#tglOut").addEventListener("click", e => {
|
||||
showOut = !showOut;
|
||||
e.currentTarget.classList.toggle("on", showOut);
|
||||
document.querySelectorAll(".tool-out").forEach(n => n.style.display = showOut ? "" : "none");
|
||||
});
|
||||
$("#sideToggle").addEventListener("click", () => $("#side").classList.toggle("show"));
|
||||
document.addEventListener("keydown", e => {
|
||||
if (e.target.tagName === "INPUT" || e.target.tagName === "TEXTAREA") return;
|
||||
if (e.code === "Space") { e.preventDefault(); $("#playBtn").click(); }
|
||||
if (e.code === "ArrowRight" && e.shiftKey) $("#nextBtn").click();
|
||||
});
|
||||
|
||||
/* ================= tabs ================= */
|
||||
$("#tabs").addEventListener("click", e => {
|
||||
const b = e.target.closest("button"); if (!b) return;
|
||||
document.querySelectorAll("#tabs button").forEach(x => x.classList.toggle("on", x === b));
|
||||
document.querySelectorAll(".pane").forEach(p => p.classList.toggle("on", p.id === "tab-" + b.dataset.t));
|
||||
if (b.dataset.t === "3d") glResize();
|
||||
});
|
||||
const IMGS = {};
|
||||
(CFG.imgs || []).forEach(im => { IMGS[im.key] = "data:image/png;base64," + im.b64; });
|
||||
(function rendersTab() {
|
||||
const g = $("#rgrid");
|
||||
for (const im of (CFG.imgs || [])) {
|
||||
const k = im.key;
|
||||
const fig = el("figure");
|
||||
const img = new Image();
|
||||
img.src = IMGS[k];
|
||||
img.addEventListener("click", () => {
|
||||
const lb = $("#lightbox");
|
||||
lb.innerHTML = "";
|
||||
const big = new Image();
|
||||
big.src = IMGS[k];
|
||||
lb.appendChild(big);
|
||||
lb.style.display = "flex";
|
||||
});
|
||||
fig.append(img, el("figcaption", null, im.cap));
|
||||
g.appendChild(fig);
|
||||
}
|
||||
})();
|
||||
$("#lightbox").addEventListener("click", () => { $("#lightbox").style.display = "none"; });
|
||||
|
||||
/* ================= params & artifacts tabs ================= */
|
||||
(function paramsTab() {
|
||||
const rows = CFG.params || [];
|
||||
const t = el("table", "ptable");
|
||||
t.innerHTML = "<tr><th>参数</th><th>终值</th><th>说明</th></tr>" +
|
||||
rows.map(r => "<tr><td class='k'>" + esc(r[0]) + "</td><td class='v'>" + esc(r[1]) + "</td><td class='c'>" + esc(r[2]) + "</td></tr>").join("");
|
||||
$("#tab-params .panebody").appendChild(t);
|
||||
if ((CFG.tags || []).length) {
|
||||
const tags = el("div");
|
||||
tags.innerHTML = '<div class="secttl">确定性命名面(QL 可索引)</div>' +
|
||||
CFG.tags.map(tg => '<span class="tagchip">' + esc(tg) + "</span>").join("") +
|
||||
(CFG.tagsNote ? '<p style="margin-top:8px;color:var(--ink-faint);font-size:11.5px">' + esc(CFG.tagsNote) + "</p>" : "");
|
||||
$("#tab-params .panebody").appendChild(tags);
|
||||
}
|
||||
})();
|
||||
(function outTab() {
|
||||
const A = CFG.artifacts || {};
|
||||
const files = A.files || [], vscripts = A.scripts || [], notes = A.notes || [];
|
||||
let html = "";
|
||||
if (files.length)
|
||||
html += '<div class="secttl">导出产物 · out/</div><div class="filelist">' +
|
||||
files.map(f => "<div><b>" + esc(f[0]) + "</b> <span class='sz'>" + esc(f[1]) + "</span> — " + esc(f[2]) + "</div>").join("") + "</div>";
|
||||
if (vscripts.length)
|
||||
html += '<div class="secttl">验证与探针脚本 · verify/</div><div class="filelist">' +
|
||||
vscripts.map(s => "<div>" + esc(s) + ".py</div>").join("") + "</div>";
|
||||
html += '<div class="secttl">会话统计</div><div class="filelist">' +
|
||||
"<div>工具调用 <b>" + STATS.toolTotal + "</b> 次(bash " + (STATS.tools.bash || 0) + " · edit " + (STATS.tools.edit || 0) + " · read " + (STATS.tools.read || 0) + " · write " + (STATS.tools.write || 0) + ")</div>" +
|
||||
"<div>验证器输出 ALL PASS <b>" + STATS.allPass + "</b> 次</div>" +
|
||||
notes.map(n => "<div>" + esc(n) + "</div>").join("") + "</div>";
|
||||
$("#tab-out .panebody").innerHTML = html;
|
||||
})();
|
||||
(function aboutTab() {
|
||||
const fmt = s => String(s)
|
||||
.replace(/\{N\}/g, N).replace(/\{tools\}/g, STATS.toolTotal).replace(/\{users\}/g, STATS.userTurns)
|
||||
.replace(/\{allPass\}/g, STATS.allPass).replace(/\{stlName\}/g, CFG.stl ? CFG.stl.name : "")
|
||||
.replace(/\{stlTris\}/g, CFG.stl ? (CFG.stl.tris || 0).toLocaleString() : "0");
|
||||
const paras = (CFG.about || []).map(p => "<p>" + fmt(p) + "</p>").join("");
|
||||
const hl = CFG.highlights ? "<p><b>看点</b>:" + fmt(CFG.highlights) + "</p>" : "";
|
||||
$("#tab-about .panebody").innerHTML =
|
||||
'<div class="about">' + paras + hl +
|
||||
'<p><b>操作</b>:<span class="kbd">空格</span> 播放/暂停 · <span class="kbd">⇧→</span> 跳到下一轮用户输入 · 点击进度条橙色刻度直达对应轮次 · 速度可调(×0.5–∞)·「阅读模式」一次渲染全部。</p>' +
|
||||
'<p style="color:var(--ink-faint);font-size:11.5px">会话 ' + esc(META.id) + " · 由 examples/demo_kit 从 transcript 自动生成本页</p></div>";
|
||||
})();
|
||||
|
||||
/* ================= session card ================= */
|
||||
(function sessionCard() {
|
||||
const dur = (() => {
|
||||
const a = new Date(META.start.replace(" ", "T")), b = new Date(META.end.replace(" ", "T"));
|
||||
const mins = Math.round((b - a) / 60000);
|
||||
return Math.floor(mins / 60) + " 小时 " + (mins % 60) + " 分";
|
||||
})();
|
||||
const extra = CFG.extraStat
|
||||
? '<div class="stat"><b>' + esc(CFG.extraStat[0]) + "</b><span>" + esc(CFG.extraStat[1]) + "</span></div>"
|
||||
: "";
|
||||
$("#sessionCard").innerHTML =
|
||||
"<h2>" + esc(META.title) + " <span style='color:var(--accent2);font-size:12px'>" + esc(CFG.subtitle || "") + "</span></h2>" +
|
||||
"<div class='sid'>真实会话完整回放 · " + esc(META.start) + " → " + esc(META.end) + "(" + dur + ")· " + esc(META.id) + "</div>" +
|
||||
'<div class="statGrid">' +
|
||||
'<div class="stat"><b>' + N + "</b><span>消息总数</span></div>" +
|
||||
'<div class="stat"><b>' + STATS.userTurns + "</b><span>用户输入轮次</span></div>" +
|
||||
(stageRange ? '<div class="stat"><b>' + stageRange + "</b><span>建模阶段</span></div>" : "") +
|
||||
'<div class="stat"><b>' + STATS.toolTotal + "</b><span>工具调用</span></div>" +
|
||||
'<div class="stat"><b>' + STATS.allPass + "</b><span>验证 ALL PASS</span></div>" +
|
||||
'<div class="stat err"><b>' + (STATS.tools.edit || 0) + "</b><span>次编辑迭代</span></div>" +
|
||||
extra +
|
||||
"</div>";
|
||||
$("#metaLine").textContent = META.title + " · " + STATS.userTurns + " 轮用户输入 · " + STATS.toolTotal + " 次工具调用" + (stageRange ? " · " + stageRange : "");
|
||||
})();
|
||||
|
||||
/* ================= three.js viewer ================= */
|
||||
let glOK = false, renderer, scene, camera, controls, mesh, gridHelper, camTween = null;
|
||||
const glCanvas = $("#gl");
|
||||
function b64ToBuf(b64) {
|
||||
const bin = atob(b64);
|
||||
const buf = new Uint8Array(bin.length);
|
||||
for (let i = 0; i < bin.length; i++) buf[i] = bin.charCodeAt(i);
|
||||
return buf.buffer;
|
||||
}
|
||||
function glInit() {
|
||||
try {
|
||||
renderer = new THREE.WebGLRenderer({ canvas: glCanvas, antialias: true, alpha: true });
|
||||
renderer.setPixelRatio(Math.min(window.devicePixelRatio || 1, 2));
|
||||
renderer.outputEncoding = THREE.sRGBEncoding;
|
||||
scene = new THREE.Scene();
|
||||
camera = new THREE.PerspectiveCamera(38, 1, 1, 5000);
|
||||
scene.add(new THREE.HemisphereLight(0xffffff, 0x2a3350, 0.95));
|
||||
const key = new THREE.DirectionalLight(0xffffff, 1.0);
|
||||
key.position.set(160, 240, 180);
|
||||
scene.add(key);
|
||||
const rim = new THREE.DirectionalLight(0x88aaff, 0.45);
|
||||
rim.position.set(-180, -40, -160);
|
||||
scene.add(rim);
|
||||
const geo = new THREE.STLLoader().parse(b64ToBuf(CFG.stl.b64));
|
||||
geo.computeBoundingBox();
|
||||
const bb = geo.boundingBox, size = new THREE.Vector3();
|
||||
bb.getSize(size);
|
||||
const maxDim = Math.max(size.x, size.y, size.z) || 1;
|
||||
const scale = 150 / maxDim;
|
||||
geo.center();
|
||||
geo.translate(0, size.y * scale / 2, 0);
|
||||
geo.scale(scale, scale, scale);
|
||||
geo.computeVertexNormals();
|
||||
const mat = new THREE.MeshStandardMaterial({ color: 0xccd8ea, metalness: 0.32, roughness: 0.4 });
|
||||
mesh = new THREE.Mesh(geo, mat);
|
||||
scene.add(mesh);
|
||||
gridHelper = new THREE.GridHelper(420, 42, 0x33415e, 0x1a2338);
|
||||
scene.add(gridHelper);
|
||||
controls = new THREE.OrbitControls(camera, glCanvas);
|
||||
controls.enableDamping = true;
|
||||
controls.dampingFactor = 0.08;
|
||||
controls.autoRotate = true;
|
||||
controls.autoRotateSpeed = 1.5;
|
||||
controls.target.set(0, 30, 0);
|
||||
setView("iso", true);
|
||||
glOK = true;
|
||||
$("#glLoad").style.display = "none";
|
||||
glResize();
|
||||
renderer.setAnimationLoop(glLoop);
|
||||
} catch (e) {
|
||||
$("#glLoad").textContent = "3D 初始化失败:" + e.message;
|
||||
}
|
||||
}
|
||||
const VIEWS = {
|
||||
iso: { t: 0.72, p: 1.05, d: 340 },
|
||||
front: { t: Math.PI / 2, p: Math.PI / 2 - 0.02, d: 360 },
|
||||
top: { t: 0.0001, p: 0.28, d: 380 },
|
||||
};
|
||||
function setView(name, instant) {
|
||||
const v = VIEWS[name];
|
||||
const pos = new THREE.Vector3().setFromSphericalCoords(v.d, v.p, v.t).add(controls.target);
|
||||
if (instant) { camera.position.copy(pos); controls.update(); camTween = null; }
|
||||
else camTween = { pos, left: 18 };
|
||||
}
|
||||
function glLoop() {
|
||||
if (!glOK) return;
|
||||
if (camTween) {
|
||||
camera.position.lerp(camTween.pos, 0.14);
|
||||
camTween.left--;
|
||||
if (camera.position.distanceTo(camTween.pos) < 1.5 || camTween.left <= 0) camTween = null;
|
||||
}
|
||||
controls.update();
|
||||
renderer.render(scene, camera);
|
||||
}
|
||||
function glResize() {
|
||||
if (!glOK) return;
|
||||
const w = glCanvas.clientWidth || 1, h = glCanvas.clientHeight || 1;
|
||||
renderer.setSize(w, h, false);
|
||||
camera.aspect = w / h;
|
||||
camera.updateProjectionMatrix();
|
||||
}
|
||||
new ResizeObserver(glResize).observe($("#glWrap"));
|
||||
$("#glBar").addEventListener("click", e => {
|
||||
const b = e.target.closest("button"); if (!b) return;
|
||||
const act = b.dataset.a;
|
||||
if (act === "rotate") { controls.autoRotate = !controls.autoRotate; b.classList.toggle("on", controls.autoRotate); }
|
||||
else if (act === "wire") { mesh.material.wireframe = !mesh.material.wireframe; b.classList.toggle("on", mesh.material.wireframe); }
|
||||
else if (act === "reset") { setView("iso"); $("#glBar [data-a=rotate]").classList.add("on"); controls.autoRotate = true; mesh.material.wireframe = false; }
|
||||
else setView(act);
|
||||
});
|
||||
glInit();
|
||||
(function glCaption() {
|
||||
const c = $("#glCap");
|
||||
if (c && CFG.stl && CFG.stl.glCap) c.textContent = CFG.stl.glCap;
|
||||
})();
|
||||
|
||||
/* ================= boot ================= */
|
||||
updateScrub();
|
||||
renderMessage(MSGS[0], { typing: false }); // 第一条用户需求先呈上
|
||||
cursor = 1;
|
||||
updateScrub();
|
||||
@@ -0,0 +1,369 @@
|
||||
#!/usr/bin/env python3
|
||||
"""demo_kit: build a single-file session-replay demo (index.html) for one case.
|
||||
|
||||
Usage from a case directory (see each case's demo/build.py):
|
||||
|
||||
from pathlib import Path
|
||||
import sys
|
||||
KIT = Path(__file__).resolve().parents[2] / "demo_kit"
|
||||
sys.path.insert(0, str(KIT))
|
||||
from build_demo import build_case
|
||||
build_case({...})
|
||||
|
||||
Or via CLI for quick rebuilds (only transcript/stl/imgs, default config):
|
||||
|
||||
python3 examples/demo_kit/build_demo.py --root examples/<case>
|
||||
|
||||
Transcript grammar: see TRANSCRIPT_FORMAT.md in this directory.
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
import argparse
|
||||
import base64
|
||||
import json
|
||||
import re
|
||||
import struct
|
||||
from pathlib import Path
|
||||
|
||||
HERE = Path(__file__).resolve().parent # examples/demo_kit
|
||||
|
||||
RE_USER = re.compile(r"^## \[(\d+)\] USER\s*$")
|
||||
RE_ASST = re.compile(r"^## \[ASSISTANT\] \(([^)]+)\)\s*$")
|
||||
RE_ROLE = re.compile(r"^## \[(?:Role Switch|角色切换)\s*[::]\s*([^\]]+)\]\s*(?:—\s*(.*))?\s*$")
|
||||
RE_TIME = re.compile(r"^\*msg_\S+ @ (\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2})\*\s*$")
|
||||
RE_TOOL = re.compile(r"^\*\*\[tool: ([a-z_]+)\]\*\* status=(\w+)\s*$")
|
||||
RE_PATCH = re.compile(r"^\*\*\[patch\]\*\* hash=([0-9a-f]+)\s*$")
|
||||
RE_TEXT = re.compile(r"^\*\*\[text\]\*\*\s*$")
|
||||
RE_THINK_OPEN = "<details><summary>thinking</summary>"
|
||||
RE_FENCE = re.compile(r"^```(\w*)\s*$")
|
||||
|
||||
MARKERS = ("**[tool: ", "**[patch]**", "**[text]**")
|
||||
|
||||
|
||||
def fence_blocks(body: list[str], i: int) -> tuple[dict | None, int]:
|
||||
m = RE_FENCE.match(body[i])
|
||||
if not m:
|
||||
return None, i
|
||||
lang = m.group(1) or "text"
|
||||
buf: list[str] = []
|
||||
i += 1
|
||||
while i < len(body) and not body[i].startswith("```"):
|
||||
buf.append(body[i])
|
||||
i += 1
|
||||
return {"t": "code", "lang": lang, "src": "\n".join(buf)}, i + 1
|
||||
|
||||
|
||||
def parse_blocks(body: list[str]) -> list[dict]:
|
||||
blocks: list[dict] = []
|
||||
i = 0
|
||||
text_buf: list[str] = []
|
||||
|
||||
def flush_text():
|
||||
nonlocal text_buf
|
||||
while text_buf and not text_buf[-1].strip():
|
||||
text_buf.pop()
|
||||
s = 0
|
||||
while s < len(text_buf) and not text_buf[s].strip():
|
||||
s += 1
|
||||
if text_buf[s:]:
|
||||
blocks.append({"t": "text", "md": "\n".join(text_buf[s:])})
|
||||
text_buf = []
|
||||
|
||||
while i < len(body):
|
||||
line = body[i]
|
||||
if line.strip() == "---":
|
||||
i += 1
|
||||
continue
|
||||
|
||||
if line.startswith(RE_THINK_OPEN):
|
||||
flush_text()
|
||||
buf: list[str] = []
|
||||
i += 1
|
||||
while i < len(body) and "</details>" not in body[i]:
|
||||
buf.append(re.sub(r"^> ?", "", body[i]))
|
||||
i += 1
|
||||
i += 1
|
||||
blocks.append({"t": "think", "md": "\n".join(buf).strip()})
|
||||
continue
|
||||
|
||||
if line.startswith("# Skill:"):
|
||||
flush_text()
|
||||
skill = [body[i]]
|
||||
i += 1
|
||||
while i < len(body):
|
||||
if any(body[i].startswith(m) for m in MARKERS) or body[i].startswith("```"):
|
||||
break
|
||||
skill.append(body[i])
|
||||
i += 1
|
||||
blocks.append({"t": "skill", "name": line.split(":", 1)[1].strip(), "md": "\n".join(skill).strip()})
|
||||
continue
|
||||
|
||||
tm = RE_TOOL.match(line)
|
||||
if tm:
|
||||
flush_text()
|
||||
tool = {"t": "tool", "name": tm.group(1), "status": tm.group(2), "input": None, "output": None}
|
||||
i += 1
|
||||
while i < len(body):
|
||||
if any(body[i].startswith(m) for m in MARKERS) or body[i].startswith(RE_THINK_OPEN):
|
||||
break
|
||||
fb, ni = fence_blocks(body, i)
|
||||
if fb is None:
|
||||
if body[i].strip():
|
||||
break
|
||||
i = ni if ni != i else i + 1
|
||||
continue
|
||||
if fb["lang"] == "json" and tool["input"] is None:
|
||||
tool["input"] = fb["src"]
|
||||
elif fb["lang"] == "output" and tool["output"] is None:
|
||||
tool["output"] = fb["src"]
|
||||
i = ni
|
||||
blocks.append(tool)
|
||||
continue
|
||||
|
||||
pm = RE_PATCH.match(line)
|
||||
if pm:
|
||||
flush_text()
|
||||
files: list[str] = []
|
||||
i += 1
|
||||
while i < len(body) and body[i].lstrip().startswith("- file:"):
|
||||
files.append(body[i].lstrip()[len("- file:"):].strip())
|
||||
i += 1
|
||||
blocks.append({"t": "patch", "hash": pm.group(1)[:10], "files": files})
|
||||
continue
|
||||
|
||||
if RE_TEXT.match(line):
|
||||
flush_text()
|
||||
i += 1
|
||||
continue
|
||||
|
||||
fb, ni = fence_blocks(body, i)
|
||||
if fb is not None:
|
||||
flush_text()
|
||||
blocks.append(fb)
|
||||
i = ni
|
||||
continue
|
||||
|
||||
text_buf.append(line)
|
||||
i += 1
|
||||
|
||||
flush_text()
|
||||
return blocks
|
||||
|
||||
|
||||
def parse_transcript(path: Path) -> dict:
|
||||
lines = path.read_text(encoding="utf-8").splitlines()
|
||||
|
||||
meta: dict = {}
|
||||
for ln in lines[:12]:
|
||||
if ln.startswith("- Session ID:"):
|
||||
meta["id"] = ln.split("`")[1]
|
||||
elif ln.startswith("- Title:"):
|
||||
meta["title"] = ln.split(":", 1)[1].strip()
|
||||
elif ln.startswith("- Started:"):
|
||||
meta["start"] = ln.split(":", 1)[1].strip()
|
||||
elif ln.startswith("- Updated:"):
|
||||
meta["end"] = ln.split(":", 1)[1].strip()
|
||||
elif ln.startswith("- Messages:"):
|
||||
meta["claimed"] = int(ln.split(":", 1)[1].strip())
|
||||
|
||||
sections: list[dict] = []
|
||||
cur: dict | None = None
|
||||
for ln in lines:
|
||||
if RE_USER.match(ln) or RE_ASST.match(ln) or RE_ROLE.match(ln):
|
||||
cur = {"head": ln, "body": []}
|
||||
sections.append(cur)
|
||||
elif cur is not None:
|
||||
cur["body"].append(ln)
|
||||
|
||||
messages: list[dict] = []
|
||||
role_state = ""
|
||||
for sec in sections:
|
||||
head, body = sec["head"], sec["body"]
|
||||
ts = None
|
||||
clean: list[str] = []
|
||||
for ln in body:
|
||||
mt = RE_TIME.match(ln)
|
||||
if mt:
|
||||
ts = mt.group(1)
|
||||
else:
|
||||
clean.append(ln)
|
||||
while clean and not clean[-1].strip():
|
||||
clean.pop()
|
||||
|
||||
mu = RE_USER.match(head)
|
||||
ma = RE_ASST.match(head)
|
||||
mr = RE_ROLE.match(head)
|
||||
msg: dict = {"i": len(messages)}
|
||||
if ts:
|
||||
msg["ts"] = ts
|
||||
if mu:
|
||||
msg["role"] = "user"
|
||||
msg["userN"] = int(mu.group(1))
|
||||
elif ma:
|
||||
msg["role"] = "asst"
|
||||
msg["model"] = ma.group(1)
|
||||
msg["curRole"] = role_state
|
||||
else:
|
||||
name = mr.group(1).strip()
|
||||
note = (mr.group(2) or "").strip()
|
||||
msg["role"] = "roleswitch"
|
||||
msg["roleName"] = name
|
||||
if note:
|
||||
msg["roleNote"] = note
|
||||
reading = artifact = ""
|
||||
rest: list[str] = []
|
||||
for ln in clean:
|
||||
if ln.startswith("Reading:"):
|
||||
reading = ln.split(":", 1)[1].strip()
|
||||
elif ln.startswith("Artifact out:"):
|
||||
artifact = ln.split(":", 1)[1].strip()
|
||||
else:
|
||||
rest.append(ln)
|
||||
if reading:
|
||||
msg["reading"] = reading
|
||||
if artifact:
|
||||
msg["artifact"] = artifact
|
||||
clean = rest
|
||||
role_state = name
|
||||
msg["blocks"] = parse_blocks(clean)
|
||||
messages.append(msg)
|
||||
|
||||
tool_counts: dict[str, int] = {}
|
||||
n_think = n_text = n_patch = 0
|
||||
pass_count = 0
|
||||
for m in messages:
|
||||
for b in m["blocks"]:
|
||||
if b["t"] == "tool":
|
||||
tool_counts[b["name"]] = tool_counts.get(b["name"], 0) + 1
|
||||
if b.get("output") and "ALL PASS" in b["output"]:
|
||||
pass_count += 1
|
||||
elif b["t"] == "think":
|
||||
n_think += 1
|
||||
elif b["t"] == "text":
|
||||
n_text += 1
|
||||
elif b["t"] == "patch":
|
||||
n_patch += 1
|
||||
users = [m["i"] for m in messages if m["role"] == "user"]
|
||||
|
||||
return {
|
||||
"meta": meta,
|
||||
"stats": {
|
||||
"messages": len(messages),
|
||||
"userTurns": len(users),
|
||||
"asst": sum(1 for m in messages if m["role"] == "asst"),
|
||||
"roleSwitches": sum(1 for m in messages if m["role"] == "roleswitch"),
|
||||
"tools": tool_counts,
|
||||
"toolTotal": sum(tool_counts.values()),
|
||||
"think": n_think,
|
||||
"text": n_text,
|
||||
"patch": n_patch,
|
||||
"allPass": pass_count,
|
||||
"userIdx": users,
|
||||
},
|
||||
"messages": messages,
|
||||
}
|
||||
|
||||
|
||||
def b64(path: Path) -> str:
|
||||
return base64.b64encode(path.read_bytes()).decode("ascii")
|
||||
|
||||
|
||||
def stl_triangle_count(path: Path) -> int:
|
||||
"""Binary STL: 80-byte header, then uint32 triangle count."""
|
||||
with path.open("rb") as fh:
|
||||
fh.seek(80)
|
||||
(count,) = struct.unpack("<I", fh.read(4))
|
||||
return count
|
||||
|
||||
|
||||
def build_case(cfg: dict) -> Path:
|
||||
"""Build one case's demo/index.html. See demo_kit/README.md for cfg keys."""
|
||||
root = Path(cfg["root"]).resolve()
|
||||
transcript = Path(cfg.get("transcript", root / "session_transcript.md"))
|
||||
out_html = Path(cfg.get("out", root / "demo" / "index.html"))
|
||||
|
||||
data = parse_transcript(transcript)
|
||||
st = data["stats"]
|
||||
print(
|
||||
f"parsed {st['messages']} messages (claimed {data['meta'].get('claimed')}), "
|
||||
f"{st['userTurns']} user turns, {st['asst']} assistant, {st['roleSwitches']} role switches, "
|
||||
f"{st['toolTotal']} tool calls, {st['allPass']} ALL-PASS outputs"
|
||||
)
|
||||
|
||||
stl_path = Path(cfg["stl"]["path"])
|
||||
tris = cfg["stl"].get("tris") or stl_triangle_count(stl_path)
|
||||
config = {
|
||||
"title": cfg.get("title", data["meta"].get("title", "")),
|
||||
"subtitle": cfg.get("subtitle", "· 从一句话需求到可制造装配"),
|
||||
"stl": {
|
||||
"name": cfg["stl"].get("name", stl_path.name),
|
||||
"note": cfg["stl"].get("note", ""),
|
||||
"glCap": cfg["stl"].get("gl_cap", f"{stl_path.name} · {tris:,} 三角面"),
|
||||
"tris": tris,
|
||||
"b64": b64(stl_path),
|
||||
},
|
||||
"imgs": [
|
||||
{"key": im["key"], "cap": im["cap"], "b64": b64(Path(im["path"]))}
|
||||
for im in cfg["imgs"]
|
||||
],
|
||||
"params": cfg.get("params", []),
|
||||
"tags": cfg.get("tags", []),
|
||||
"tagsNote": cfg.get("tags_note", ""),
|
||||
"artifacts": cfg.get("artifacts", {"files": [], "scripts": [], "notes": []}),
|
||||
"about": cfg.get("about", []),
|
||||
"highlights": cfg.get("highlights", ""),
|
||||
"extraStat": cfg.get("extra_stat"),
|
||||
}
|
||||
data["config"] = config
|
||||
|
||||
tpl = (HERE / "template.html").read_text(encoding="utf-8")
|
||||
css = (HERE / "app.css").read_text(encoding="utf-8")
|
||||
js = (HERE / "app.js").read_text(encoding="utf-8")
|
||||
three = (HERE / "vendor" / "three.min.js").read_text(encoding="utf-8")
|
||||
orbit = (HERE / "vendor" / "OrbitControls.js").read_text(encoding="utf-8")
|
||||
stl_l = (HERE / "vendor" / "STLLoader.js").read_text(encoding="utf-8")
|
||||
|
||||
payload = json.dumps(data, ensure_ascii=False, separators=(",", ":")).replace("<", "\\u003c")
|
||||
|
||||
html = (
|
||||
tpl.replace("/*__CSS__*/", css)
|
||||
.replace("/*__JS__*/", js)
|
||||
.replace("__DATA__", payload)
|
||||
.replace("__THREE__", three)
|
||||
.replace("__ORBIT__", orbit)
|
||||
.replace("__STLL__", stl_l)
|
||||
)
|
||||
out_html.parent.mkdir(parents=True, exist_ok=True)
|
||||
out_html.write_text(html, encoding="utf-8")
|
||||
print(f"wrote {out_html} ({out_html.stat().st_size / 1e6:.1f} MB)")
|
||||
return out_html
|
||||
|
||||
|
||||
def _cfg_from_cli(args: argparse.Namespace) -> dict:
|
||||
imgs = []
|
||||
for spec in args.img or []:
|
||||
key, rest = spec.split("=", 1)
|
||||
path, _, cap = rest.partition(":")
|
||||
imgs.append({"key": key, "path": path, "cap": cap or key})
|
||||
return {
|
||||
"root": args.root,
|
||||
"transcript": args.transcript,
|
||||
"out": args.out,
|
||||
"stl": {"path": args.stl},
|
||||
"imgs": imgs,
|
||||
}
|
||||
|
||||
|
||||
def main() -> None:
|
||||
ap = argparse.ArgumentParser(description=__doc__)
|
||||
ap.add_argument("--root", required=True, help="case root directory")
|
||||
ap.add_argument("--transcript", help="transcript md (default <root>/session_transcript.md)")
|
||||
ap.add_argument("--out", help="output html (default <root>/demo/index.html)")
|
||||
ap.add_argument("--stl", required=True, help="final body/assembly STL path")
|
||||
ap.add_argument("--img", action="append", metavar="KEY=PATH:CAP", help="render image slot (repeatable)")
|
||||
args = ap.parse_args()
|
||||
build_case(_cfg_from_cli(args))
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
@@ -0,0 +1,98 @@
|
||||
<!DOCTYPE html>
|
||||
<html lang="zh-CN">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<title>人 × Agent 参数化 CAD 建模 · 会话回放 Demo</title><style>/*__CSS__*/</style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<header id="topbar">
|
||||
<div class="brand">
|
||||
<div class="logo">SCA</div>
|
||||
<div class="titles">
|
||||
<h1>人 × Agent 参数化 CAD 建模 <em>· 会话忠实回放</em></h1>
|
||||
<div class="sub" id="metaLine"></div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="controls">
|
||||
<div class="seg" id="modeSeg">
|
||||
<button data-m="replay" class="on">回放模式</button>
|
||||
<button data-m="read">阅读模式</button>
|
||||
</div>
|
||||
<div class="seg" id="speedSeg">
|
||||
<button data-s="0.5">×0.5</button>
|
||||
<button data-s="1" class="on">×1</button>
|
||||
<button data-s="2">×2</button>
|
||||
<button data-s="4">×4</button>
|
||||
<button data-s="99">∞</button>
|
||||
</div>
|
||||
<button class="tgl on" id="tglThink">🧠 思考</button>
|
||||
<button class="tgl on" id="tglOut">🔧 输出</button>
|
||||
<button id="nextBtn">⏭ 下一轮</button>
|
||||
<button id="playBtn">▶ 播放</button>
|
||||
</div>
|
||||
</header>
|
||||
|
||||
<div id="scrubRow">
|
||||
<div id="scrubStat"></div>
|
||||
<div id="stageChip">S0</div>
|
||||
<div id="scrub">
|
||||
<div id="scrubTrack"><div id="scrubFill"></div></div>
|
||||
<div id="scrubTip"></div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<main>
|
||||
<section id="chatWrap">
|
||||
<div id="chat">
|
||||
<div id="sessionCard"></div>
|
||||
</div>
|
||||
<div id="followPill">↓ 回到最新</div>
|
||||
</section>
|
||||
|
||||
<aside id="side">
|
||||
<nav id="tabs">
|
||||
<button data-t="3d" class="on">🧊 3D 模型</button>
|
||||
<button data-t="renders">🖼 渲染图</button>
|
||||
<button data-t="params">⚙ 参数</button>
|
||||
<button data-t="out">📦 产物</button>
|
||||
<button data-t="about">ℹ 关于</button>
|
||||
</nav>
|
||||
<div class="tabpanes">
|
||||
<div class="pane on" id="tab-3d">
|
||||
<div id="glBar">
|
||||
<button data-a="rotate" class="on">⟳ 自转</button>
|
||||
<button data-a="iso">等轴</button>
|
||||
<button data-a="front">正视</button>
|
||||
<button data-a="top">俯视</button>
|
||||
<button data-a="wire">线框</button>
|
||||
<button data-a="reset">重置</button>
|
||||
</div>
|
||||
<div id="glWrap">
|
||||
<canvas id="gl"></canvas>
|
||||
<div id="glLoad">正在装配 3D 模型…</div>
|
||||
<div id="glHint">拖拽旋转 · 滚轮缩放 · 右键平移</div>
|
||||
</div>
|
||||
<div id="glCap"></div>
|
||||
</div>
|
||||
<div class="pane" id="tab-renders"><div class="panebody"><div class="rgrid" id="rgrid"></div></div></div>
|
||||
<div class="pane" id="tab-params"><div class="panebody"></div></div>
|
||||
<div class="pane" id="tab-out"><div class="panebody"></div></div>
|
||||
<div class="pane" id="tab-about"><div class="panebody"></div></div>
|
||||
</div>
|
||||
</aside>
|
||||
</main>
|
||||
|
||||
<button id="sideToggle">🧊 3D 模型</button>
|
||||
<div id="lightbox"></div>
|
||||
|
||||
<script type="application/json" id="feed">__DATA__</script>
|
||||
<script>__THREE__</script>
|
||||
<script>__ORBIT__</script>
|
||||
<script>__STLL__</script>
|
||||
<script>
|
||||
/*__JS__*/
|
||||
</script>
|
||||
</body>
|
||||
</html>
|
||||
@@ -0,0 +1,364 @@
|
||||
( function () {
|
||||
|
||||
/**
|
||||
* Description: A THREE loader for STL ASCII files, as created by Solidworks and other CAD programs.
|
||||
*
|
||||
* Supports both binary and ASCII encoded files, with automatic detection of type.
|
||||
*
|
||||
* The loader returns a non-indexed buffer geometry.
|
||||
*
|
||||
* Limitations:
|
||||
* Binary decoding supports "Magics" color format (http://en.wikipedia.org/wiki/STL_(file_format)#Color_in_binary_STL).
|
||||
* There is perhaps some question as to how valid it is to always assume little-endian-ness.
|
||||
* ASCII decoding assumes file is UTF-8.
|
||||
*
|
||||
* Usage:
|
||||
* const loader = new STLLoader();
|
||||
* loader.load( './models/stl/slotted_disk.stl', function ( geometry ) {
|
||||
* scene.add( new THREE.Mesh( geometry ) );
|
||||
* });
|
||||
*
|
||||
* For binary STLs geometry might contain colors for vertices. To use it:
|
||||
* // use the same code to load STL as above
|
||||
* if (geometry.hasColors) {
|
||||
* material = new THREE.MeshPhongMaterial({ opacity: geometry.alpha, vertexColors: true });
|
||||
* } else { .... }
|
||||
* const mesh = new THREE.Mesh( geometry, material );
|
||||
*
|
||||
* For ASCII STLs containing multiple solids, each solid is assigned to a different group.
|
||||
* Groups can be used to assign a different color by defining an array of materials with the same length of
|
||||
* geometry.groups and passing it to the Mesh constructor:
|
||||
*
|
||||
* const mesh = new THREE.Mesh( geometry, material );
|
||||
*
|
||||
* For example:
|
||||
*
|
||||
* const materials = [];
|
||||
* const nGeometryGroups = geometry.groups.length;
|
||||
*
|
||||
* const colorMap = ...; // Some logic to index colors.
|
||||
*
|
||||
* for (let i = 0; i < nGeometryGroups; i++) {
|
||||
*
|
||||
* const material = new THREE.MeshPhongMaterial({
|
||||
* color: colorMap[i],
|
||||
* wireframe: false
|
||||
* });
|
||||
*
|
||||
* }
|
||||
*
|
||||
* materials.push(material);
|
||||
* const mesh = new THREE.Mesh(geometry, materials);
|
||||
*/
|
||||
|
||||
class STLLoader extends THREE.Loader {
|
||||
|
||||
constructor( manager ) {
|
||||
|
||||
super( manager );
|
||||
|
||||
}
|
||||
load( url, onLoad, onProgress, onError ) {
|
||||
|
||||
const scope = this;
|
||||
const loader = new THREE.FileLoader( this.manager );
|
||||
loader.setPath( this.path );
|
||||
loader.setResponseType( 'arraybuffer' );
|
||||
loader.setRequestHeader( this.requestHeader );
|
||||
loader.setWithCredentials( this.withCredentials );
|
||||
loader.load( url, function ( text ) {
|
||||
|
||||
try {
|
||||
|
||||
onLoad( scope.parse( text ) );
|
||||
|
||||
} catch ( e ) {
|
||||
|
||||
if ( onError ) {
|
||||
|
||||
onError( e );
|
||||
|
||||
} else {
|
||||
|
||||
console.error( e );
|
||||
|
||||
}
|
||||
|
||||
scope.manager.itemError( url );
|
||||
|
||||
}
|
||||
|
||||
}, onProgress, onError );
|
||||
|
||||
}
|
||||
parse( data ) {
|
||||
|
||||
function isBinary( data ) {
|
||||
|
||||
const reader = new DataView( data );
|
||||
const face_size = 32 / 8 * 3 + 32 / 8 * 3 * 3 + 16 / 8;
|
||||
const n_faces = reader.getUint32( 80, true );
|
||||
const expect = 80 + 32 / 8 + n_faces * face_size;
|
||||
if ( expect === reader.byteLength ) {
|
||||
|
||||
return true;
|
||||
|
||||
}
|
||||
|
||||
// An ASCII STL data must begin with 'solid ' as the first six bytes.
|
||||
// However, ASCII STLs lacking the SPACE after the 'd' are known to be
|
||||
// plentiful. So, check the first 5 bytes for 'solid'.
|
||||
|
||||
// Several encodings, such as UTF-8, precede the text with up to 5 bytes:
|
||||
// https://en.wikipedia.org/wiki/Byte_order_mark#Byte_order_marks_by_encoding
|
||||
// Search for "solid" to start anywhere after those prefixes.
|
||||
|
||||
// US-ASCII ordinal values for 's', 'o', 'l', 'i', 'd'
|
||||
|
||||
const solid = [ 115, 111, 108, 105, 100 ];
|
||||
for ( let off = 0; off < 5; off ++ ) {
|
||||
|
||||
// If "solid" text is matched to the current offset, declare it to be an ASCII STL.
|
||||
|
||||
if ( matchDataViewAt( solid, reader, off ) ) return false;
|
||||
|
||||
}
|
||||
|
||||
// Couldn't find "solid" text at the beginning; it is binary STL.
|
||||
|
||||
return true;
|
||||
|
||||
}
|
||||
|
||||
function matchDataViewAt( query, reader, offset ) {
|
||||
|
||||
// Check if each byte in query matches the corresponding byte from the current offset
|
||||
|
||||
for ( let i = 0, il = query.length; i < il; i ++ ) {
|
||||
|
||||
if ( query[ i ] !== reader.getUint8( offset + i ) ) return false;
|
||||
|
||||
}
|
||||
|
||||
return true;
|
||||
|
||||
}
|
||||
|
||||
function parseBinary( data ) {
|
||||
|
||||
const reader = new DataView( data );
|
||||
const faces = reader.getUint32( 80, true );
|
||||
let r,
|
||||
g,
|
||||
b,
|
||||
hasColors = false,
|
||||
colors;
|
||||
let defaultR, defaultG, defaultB, alpha;
|
||||
|
||||
// process STL header
|
||||
// check for default color in header ("COLOR=rgba" sequence).
|
||||
|
||||
for ( let index = 0; index < 80 - 10; index ++ ) {
|
||||
|
||||
if ( reader.getUint32( index, false ) == 0x434F4C4F /*COLO*/ && reader.getUint8( index + 4 ) == 0x52 /*'R'*/ && reader.getUint8( index + 5 ) == 0x3D /*'='*/ ) {
|
||||
|
||||
hasColors = true;
|
||||
colors = new Float32Array( faces * 3 * 3 );
|
||||
defaultR = reader.getUint8( index + 6 ) / 255;
|
||||
defaultG = reader.getUint8( index + 7 ) / 255;
|
||||
defaultB = reader.getUint8( index + 8 ) / 255;
|
||||
alpha = reader.getUint8( index + 9 ) / 255;
|
||||
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
const dataOffset = 84;
|
||||
const faceLength = 12 * 4 + 2;
|
||||
const geometry = new THREE.BufferGeometry();
|
||||
const vertices = new Float32Array( faces * 3 * 3 );
|
||||
const normals = new Float32Array( faces * 3 * 3 );
|
||||
for ( let face = 0; face < faces; face ++ ) {
|
||||
|
||||
const start = dataOffset + face * faceLength;
|
||||
const normalX = reader.getFloat32( start, true );
|
||||
const normalY = reader.getFloat32( start + 4, true );
|
||||
const normalZ = reader.getFloat32( start + 8, true );
|
||||
if ( hasColors ) {
|
||||
|
||||
const packedColor = reader.getUint16( start + 48, true );
|
||||
if ( ( packedColor & 0x8000 ) === 0 ) {
|
||||
|
||||
// facet has its own unique color
|
||||
|
||||
r = ( packedColor & 0x1F ) / 31;
|
||||
g = ( packedColor >> 5 & 0x1F ) / 31;
|
||||
b = ( packedColor >> 10 & 0x1F ) / 31;
|
||||
|
||||
} else {
|
||||
|
||||
r = defaultR;
|
||||
g = defaultG;
|
||||
b = defaultB;
|
||||
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
for ( let i = 1; i <= 3; i ++ ) {
|
||||
|
||||
const vertexstart = start + i * 12;
|
||||
const componentIdx = face * 3 * 3 + ( i - 1 ) * 3;
|
||||
vertices[ componentIdx ] = reader.getFloat32( vertexstart, true );
|
||||
vertices[ componentIdx + 1 ] = reader.getFloat32( vertexstart + 4, true );
|
||||
vertices[ componentIdx + 2 ] = reader.getFloat32( vertexstart + 8, true );
|
||||
normals[ componentIdx ] = normalX;
|
||||
normals[ componentIdx + 1 ] = normalY;
|
||||
normals[ componentIdx + 2 ] = normalZ;
|
||||
if ( hasColors ) {
|
||||
|
||||
colors[ componentIdx ] = r;
|
||||
colors[ componentIdx + 1 ] = g;
|
||||
colors[ componentIdx + 2 ] = b;
|
||||
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
geometry.setAttribute( 'position', new THREE.BufferAttribute( vertices, 3 ) );
|
||||
geometry.setAttribute( 'normal', new THREE.BufferAttribute( normals, 3 ) );
|
||||
if ( hasColors ) {
|
||||
|
||||
geometry.setAttribute( 'color', new THREE.BufferAttribute( colors, 3 ) );
|
||||
geometry.hasColors = true;
|
||||
geometry.alpha = alpha;
|
||||
|
||||
}
|
||||
|
||||
return geometry;
|
||||
|
||||
}
|
||||
|
||||
function parseASCII( data ) {
|
||||
|
||||
const geometry = new THREE.BufferGeometry();
|
||||
const patternSolid = /solid([\s\S]*?)endsolid/g;
|
||||
const patternFace = /facet([\s\S]*?)endfacet/g;
|
||||
let faceCounter = 0;
|
||||
const patternFloat = /[\s]+([+-]?(?:\d*)(?:\.\d*)?(?:[eE][+-]?\d+)?)/.source;
|
||||
const patternVertex = new RegExp( 'vertex' + patternFloat + patternFloat + patternFloat, 'g' );
|
||||
const patternNormal = new RegExp( 'normal' + patternFloat + patternFloat + patternFloat, 'g' );
|
||||
const vertices = [];
|
||||
const normals = [];
|
||||
const normal = new THREE.Vector3();
|
||||
let result;
|
||||
let groupCount = 0;
|
||||
let startVertex = 0;
|
||||
let endVertex = 0;
|
||||
while ( ( result = patternSolid.exec( data ) ) !== null ) {
|
||||
|
||||
startVertex = endVertex;
|
||||
const solid = result[ 0 ];
|
||||
while ( ( result = patternFace.exec( solid ) ) !== null ) {
|
||||
|
||||
let vertexCountPerFace = 0;
|
||||
let normalCountPerFace = 0;
|
||||
const text = result[ 0 ];
|
||||
while ( ( result = patternNormal.exec( text ) ) !== null ) {
|
||||
|
||||
normal.x = parseFloat( result[ 1 ] );
|
||||
normal.y = parseFloat( result[ 2 ] );
|
||||
normal.z = parseFloat( result[ 3 ] );
|
||||
normalCountPerFace ++;
|
||||
|
||||
}
|
||||
|
||||
while ( ( result = patternVertex.exec( text ) ) !== null ) {
|
||||
|
||||
vertices.push( parseFloat( result[ 1 ] ), parseFloat( result[ 2 ] ), parseFloat( result[ 3 ] ) );
|
||||
normals.push( normal.x, normal.y, normal.z );
|
||||
vertexCountPerFace ++;
|
||||
endVertex ++;
|
||||
|
||||
}
|
||||
|
||||
// every face have to own ONE valid normal
|
||||
|
||||
if ( normalCountPerFace !== 1 ) {
|
||||
|
||||
console.error( 'THREE.STLLoader: Something isn\'t right with the normal of face number ' + faceCounter );
|
||||
|
||||
}
|
||||
|
||||
// each face have to own THREE valid vertices
|
||||
|
||||
if ( vertexCountPerFace !== 3 ) {
|
||||
|
||||
console.error( 'THREE.STLLoader: Something isn\'t right with the vertices of face number ' + faceCounter );
|
||||
|
||||
}
|
||||
|
||||
faceCounter ++;
|
||||
|
||||
}
|
||||
|
||||
const start = startVertex;
|
||||
const count = endVertex - startVertex;
|
||||
geometry.addGroup( start, count, groupCount );
|
||||
groupCount ++;
|
||||
|
||||
}
|
||||
|
||||
geometry.setAttribute( 'position', new THREE.Float32BufferAttribute( vertices, 3 ) );
|
||||
geometry.setAttribute( 'normal', new THREE.Float32BufferAttribute( normals, 3 ) );
|
||||
return geometry;
|
||||
|
||||
}
|
||||
|
||||
function ensureString( buffer ) {
|
||||
|
||||
if ( typeof buffer !== 'string' ) {
|
||||
|
||||
return THREE.LoaderUtils.decodeText( new Uint8Array( buffer ) );
|
||||
|
||||
}
|
||||
|
||||
return buffer;
|
||||
|
||||
}
|
||||
|
||||
function ensureBinary( buffer ) {
|
||||
|
||||
if ( typeof buffer === 'string' ) {
|
||||
|
||||
const array_buffer = new Uint8Array( buffer.length );
|
||||
for ( let i = 0; i < buffer.length; i ++ ) {
|
||||
|
||||
array_buffer[ i ] = buffer.charCodeAt( i ) & 0xff; // implicitly assumes little-endian
|
||||
|
||||
}
|
||||
|
||||
return array_buffer.buffer || array_buffer;
|
||||
|
||||
} else {
|
||||
|
||||
return buffer;
|
||||
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
// start
|
||||
|
||||
const binData = ensureBinary( data );
|
||||
return isBinary( binData ) ? parseBinary( binData ) : parseASCII( ensureString( data ) );
|
||||
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
THREE.STLLoader = STLLoader;
|
||||
|
||||
} )();
|
||||
@@ -0,0 +1,164 @@
|
||||
# BUILD_PLAN: flange_plate
|
||||
|
||||
Datum(来自功能基准): 原点 = 法兰轴线 ∩ 盘底平面;+Z 向上(凸台方向)。
|
||||
受控基准面:盘底 z=0、盘顶 z=`flange_t`、凸台顶 z=`boss_top_z`;法兰轴线 = Z 轴。
|
||||
对称性:基体轴对称(Z),螺栓阵按 `bolt_count` 旋转对称,首孔相位 +X(0°)。
|
||||
|
||||
构造策略(block-and-feature / 几何体素): 用户指定体素路线——盘、凸台、孔刀全部是
|
||||
"完全含于圆柱基本体"的纯工具体(FTC geometry tier 第 3 类合法情形),无草图层。
|
||||
盘 = 圆柱基体(build);凸台 = 圆柱 union(add);中心孔 = 圆柱孔刀 cut(subtract);
|
||||
螺栓阵 = `radial_pattern` 孔刀 cut(subtract,工具体在块内构型);根部 R3 与外缘 R2×2
|
||||
= QL 选边 fillet(modify),选边卡在源码打印、`.exactly(n)` 承重。圆角最后(FTC 顺序)。
|
||||
|
||||
## 阶段划分
|
||||
|
||||
- **S1 盘 + 凸台 + 中心孔**
|
||||
- 输出边界: 轴对称阶梯回转体,含中心通孔(flange-disc ∪ center-boss − center-bore)。
|
||||
不含: 螺栓孔、任何圆角。
|
||||
- 验证目标: 单实体;bbox = ⌀100 × [0, 30] ±0.05;体积 = π/4·(100²·10 + 55²·20 − 30²·30) = 104850.65 mm³ ±0.5%;
|
||||
QL 卡片:凸台顶平面 z=30、孔壁圆柱面 ⌀30、盘底平面 z=0。
|
||||
- **S2 螺栓孔阵 + 两次圆角**
|
||||
- 输出边界: 最终形态(6 孔版):+ 6×⌀11 @PCD78 螺栓通孔 + 凸台根部 R3 + 外缘上下 R2。不含: 改参。
|
||||
- 验证目标: 单实体;`bolt_count` 个 ⌀11 孔壁圆柱面,圆心到轴距离 = PCD/2 = 39,首孔相位 0°;
|
||||
孔壁圆心 z ∈ (0, flange_t);torus 面:根部 R3 ×1(minor radius 3)、外缘 R2 ×2(minor radius 2);
|
||||
体积 < S1 体积且 > S1 − 孔体积 − 5%;选边卡在模型源码输出中可见(数量 + 边长)。
|
||||
- **S3 改参轮(USER 第 2 轮,2026-09-05)**
|
||||
- 输入: 螺栓孔 6 → 8 均布,PCD 拉大到 88(尽量)。
|
||||
- 输出边界: 守卫判定(88 拒绝 + 依据 + 最大可行 PCD 推导)→ 参数改为 bolt_count=8、bolt_pcd=可行值
|
||||
→ V1/V2 全量回归 + 守卫判定证据 + 4 张渲染图 + 隔离 reviewer 逐区域判定。
|
||||
- 验证目标: PCD 88 被轮辐宽守卫拒绝(web = 50−44−5.5 = 0.5 < 2);可行上限 = flange_od − bolt_d − 2·min_edge_web = 85;
|
||||
8 孔版 V1/V2 回归全 PASS(PCD/孔数/相位/torus 不变式);渲染 4 图存在;reviewer 全区域 match。
|
||||
|
||||
(导出与重开校验由 Role 5 执行:.scadpkg + STEP + STL + 渲染集 → out/flange_plate/。)
|
||||
|
||||
## Verifier contracts(Role 3 逐阶段补填)
|
||||
|
||||
### S1
|
||||
`Verifier contract: S1 轴对称阶梯回转体(盘+凸台+中心通孔)/ Criteria: C1 单Solid+体积=π/4·(od²·t+boss_od²·(top−t)−bore²·top)±0.5%;C2 bbox x/y∈[±od/2] z∈[0,top]±0.05;C3 凸台顶环面 z=top 面积 π((boss_od/2)²−(bore/2)²);C4 孔壁圆柱面面积 π·bore·top;C5 盘底环面 z=0 面积 π((od/2)²−(bore/2)²);C6 守卫=名义参数通过+4 组 known-bad(bore≥boss / web<min / 孔撞根部圆角 / 根部圆角>凸台高)各触发 AssertionError / Script: verify/s1_verify.py`
|
||||
|
||||
Hypothesis 结果(verify/s1_hypothesis.py,已运行 2 轮):
|
||||
- H1 采用: 体素复刻体体积 104850.655 = 解析值(rel 0.000000)
|
||||
- H2a-c 采用: QL 卡片——孔壁圆柱面/凸台顶环面/盘底环面各恰 1,面积逐项吻合
|
||||
- H2b 修正(发现+修复): 凸台顶面被中心孔穿透 → 环面 π(27.5²−15²)=1668.97,非整圆 π·27.5²;探针期望值修错后全过(修的是检查的算术,不是几何)
|
||||
- H3 采用: bbox 用 `BRepBndLib.AddOptimal_s(useTriangulation=False)+SetGap(0)`,x/y∈[±50,50] z∈[0,30] 精确
|
||||
- H4 known-bad: 去凸台复刻体体积 71471.233,偏离合格解析值 31.84% ≫ 0.5% → 体积门有区分度 ✓
|
||||
|
||||
S1 阶段证据(verify/s1_verify.py 全 PASS,2026-09-05):
|
||||
- C1 volume=104850.655 = analytic;C2 bbox [±50,50]×[0,30];C3 凸台顶环面 1668.97 n=1;
|
||||
C4 孔壁 2827.43 n=1;C5 盘底环面 7147.12 n=1;C6 名义通过 + 4 守卫各触发(G1 bore≥boss /
|
||||
G2 web=1.5<2 / G3 gap=0 / G4 短凸台 高 2<R3)
|
||||
- C6 探针迭代:G4 首版 bad-dict(加大 R)被 G1/G3 先拦(守卫顺序 G1→G2→G3→G4 且壁厚 12.5),
|
||||
改为 boss_top_z=t+2(短凸台)后 G4 恰好独占触发——4 守卫各自可达、各自承重。
|
||||
|
||||
### S2
|
||||
`Verifier contract: S2 最终形态(6 孔+两圆角)/ Criteria: D1 单Solid+体积∈Pappus 支架±1.5%;D2 孔壁圆柱面 n=bolt_count 面积 π·bolt_d·flange_t 圆心轴距=PCD/2;D3 首孔相位 0°+相邻角距 360/n(≥2 单元实测);D4 根部 TORUS n=1(面积=2π(Rmaj−2R/π)·πR/2, z>flange_t)+外缘 TORUS n=2(面积=2π(Rmaj'+2R/π)·πR/2, z≤flange_t);D5 S1 回归(bbox±0.05+凸台顶环卡 n=1);D6 pattern 工具数=bolt_count(源码 fact 卡证据)/ Script: verify/s2_verify.py`
|
||||
|
||||
Hypothesis 结果(verify/s2_hypothesis.py,已运行 2 轮):
|
||||
- P1 采用: radial_pattern(count=6, total_rotation_angle=360) 返回 6 工具**含原型**,相位 0..300°,首孔 0°(+X)
|
||||
- P2a-c 采用: 孔壁卡 n=6,轴距全 39.000,等角距 60.0×5(实测 ≥2 单元)
|
||||
- P3/P4 采用: 选边卡——根部 CIRCLE@z=10 len=172.788=π·55 n=1;外缘 2×CIRCLE len=314.159=π·100 @z=0/10
|
||||
- P5 修正(发现+修复): torus 面积初版用弧所在大半径(Pappus 误用)→ 实测 846.520/972.615 揭穿;
|
||||
正确为弧质心半径(偏移 2R/π:根部向内、外缘向外),修后 rel<0.0001
|
||||
- P6 采用: 孔后体积 99148.664=解析精确;终体积 98955.987∈Pappus 支架(rel 0.00000)
|
||||
- P7 known-bad: 无圆角体 TORUS n=0≠3 ✓ 门有区分度
|
||||
|
||||
S2 阶段证据(verify/s2_verify.py 全 PASS,2026-09-05):
|
||||
- 源码 fact 卡:bolt-holes 99148.664/12 面 → root-fillet 99490.521/13 面 → edge-fillets 98955.987/15 面;
|
||||
两张选边卡在圆角前打印(root n=1 len=172.788;edge n=2 len=314.159×2 @z=0/10),exactly(1)/exactly(2) 承重
|
||||
- D1 98955.987 ∈ 支架(rel 0.00021);D2 孔壁 n=6 轴距 [39.0];D3 相位 0° 等距 60×5;
|
||||
D4a 根 torus 846.520 n=1;D4b 外缘 tori 972.615×2;D5 bbox 不变 + 凸台顶环卡 n=1
|
||||
|
||||
### S2 建模假设(Role 4)
|
||||
`Hypothesis: 孔刀原型@(+X,PCD/2) → radial_pattern(count=n, 360°) 含原型 → cut 一次 6 刀;圆角走几何窗选边(CIRCLE+len 2πr+z 窗)+ 卡片先行 + exactly(n) / Result: fact 卡链体积 99148.664→98955.987 与解析/Pappus 吻合;faces 6→12→13→15 / Adopted: flange_plate.build_solid() S2 三块`
|
||||
|
||||
### S3
|
||||
`Verifier contract: S3 改参轮(8 孔 + PCD 尽量大)/ Criteria: E1 守卫 G2 拒绝 8/88(断言消息含算术 web=0.500<2);E2 由 G2 不等式推导最大可行 PCD = flange_od − bolt_d − 2·min_edge_web = 85;E3 (8,85) 通过全部 4 守卫(G3 gap=6.5、G1 wall=12.5、G4 boss_h=20);E4 源码参数落位 bolt_count=8/bolt_pcd=85;回归 = s1_verify + s2_verify 重跑(D2/D3 自动按新参数校 8 孔 @45° 距、PCD 42.5 轴距)/ Script: verify/s3_guard_evidence.py`
|
||||
|
||||
视觉契约(Role 3 预定,Role 4 产图,隔离 reviewer 判定——本上下文不得自证):
|
||||
- 渲染集(out/flange_plate/):render_iso.png(等轴测 (30°,45°))、render_front.png(正视 (0°,0°))、
|
||||
render_top.png(俯视 (90°,0°))、render_detail.png((25°,20°) 高倍 zoom=9,螺栓孔+凸台根部圆角特写)
|
||||
- reviewer 输入:4 图路径 + REQUIREMENTS.md 形状描述(分区 1-5)
|
||||
- 判定字段(逐区域):match / mismatch / unreviewable + 理由;mismatch → 修模型重渲再评审(换新 reviewer)
|
||||
|
||||
Hypothesis 结果(verify/s3_guard_evidence.py 改参前决策轮,已运行):
|
||||
- E1 ✓ G2 拒绝 8/88:web = 100/2 − 88/2 − 11/2 = 0.500 < min_edge_web = 2.0(断言消息原样入证据)
|
||||
- E2 ✓ pcd_max = 100 − 11 − 2×2 = **85.0**
|
||||
- E3 ✓ (8, 85) 过全部守卫:web=2.000(恰达下限,守卫为 ≥)、G3 gap=6.500、G1 wall=12.500>R3、G4 boss_h=20≥R3
|
||||
- E4(改参前 FAIL 属预期——决策轮在模型改参之前运行,E4 在改参后翻转)
|
||||
|
||||
S3 阶段证据(verify/s3_guard_evidence.py + s2_verify.py 全 PASS,2026-09-05):
|
||||
- 判定链:E1 8/88 → G2a 拒(web=0.500<2,断言消息原样);E2a 上确界 pcd_sup=85(web=2.0 恰达下限);
|
||||
E2b 85 → G2b 拒(**实证退化**:8×PCD85 实跑 faces=16≠17、孔壁 7/8、0° 孔被边圆角吞并、
|
||||
体积反常 +950、顶/底面中心偏移 +X —— web==R_edge 精确相切);E2c 交付 84.5(0.5mm 网格,
|
||||
web=2.25 裕度 0.25);E3 (8,84.5) 过 G1/G2a/G2b/G3/G4(附 chord 32.34>11);E4 源码落位
|
||||
- 几何回归(84.5 版):D1 97055.323(rel 0.00021)D2 n=8 r=42.25 D3 相位 0°@45°×7 D4 torus 846.520+972.615×2 D5 bbox/凸台顶环 —— 全 PASS
|
||||
- **修复循环记录**(repair: S3 PCD 相切):初版按上确界交付 85 → D2 n=7≠8 暴露 → 诊断(面孔卡:
|
||||
0° 孔壁缺失、顶/底面中心偏移)→ 定因 web==R_edge 布尔相切 → 修 owning artifact(守卫拆 G2a/G2b +
|
||||
参数 84.5 + 证据脚本 E2a/b/c)→ 重跑全过。检查未削弱(D2 仍要 exactly 8)
|
||||
- **s1_verify 阶段锁定说明**:S3 后在最终源码重跑 s1_verify,C1/C5 FAIL 属预期——其契约测 S1 输出边界
|
||||
(当时源码仅 3 特征块);S1 不变量在最终形态的存活由 s2_verify D5 承担(bbox±0.05、凸台顶环卡 n=1),
|
||||
孔壁卡 C4 亦过。非回归,不改 S1 契约
|
||||
- 视觉判定(4 视图隔离 reviewer,2026-09-05;机制说明:本 host 无 task/subagent 工具,
|
||||
隔离评审由独立视觉模型(analyze_image MCP,全新上下文,仅收渲染图 URL + REQUIREMENTS 形状描述)
|
||||
承担,每视图一次独立调用,符合"产图上下文不得自证"的门槛):
|
||||
- iso: "region 1: match - thin round disc ... region 2: match - coaxial cylindrical boss ... region 3: match -
|
||||
central through bore clearly visible on boss top face ... region 4: match - 8 evenly spaced round holes ...
|
||||
region 5: unreviewable - the boss-to-disc junction shows a smooth transition but fillet radii (R3 concave
|
||||
ring, R2 rim rounds) cannot be verified precisely at this resolution ... overall: PASS"
|
||||
- top: "region 4: match - exactly 8 bolt holes, evenly spaced 45° apart, one hole lies on the +X axis
|
||||
(right side), all holes clear of the outer rim ... region 5: unreviewable - edge rounding radii cannot be
|
||||
reliably confirmed from a top-down view alone ... overall: PASS"
|
||||
- front: "region 5: match - Left/right ends of the disc silhouette are visibly rounded (convex rim rounding),
|
||||
and the boss-to-disc transition shows a smooth concave curve rather than a sharp step ... overall: PASS"
|
||||
- detail: "region 2: match - boss root shows a smooth concave sweeping fillet into the disc top, no sharp
|
||||
corner. region 3: match - visible bolt holes are plain cylinders with sharp unchamfered edges, clearly
|
||||
separated from the rim fillet by flat web ... overall: PASS"
|
||||
- 结论:0 mismatch;unreviewable 均为视图原理性不可见项(俯视看不到圆角半径、正视看不到隐藏孔),
|
||||
对应不变量已由 D4 torus 卡/孔壁卡在几何层面证明。视觉门关闭,无需修模重渲
|
||||
|
||||
## Hypotheses(Role 4 逐阶段补填)
|
||||
|
||||
### S1
|
||||
`Hypothesis: 体素链 make_cylinder(盘) → union(make_cylinder 凸台) → cut(make_cylinder 孔刀, z∈[-5,35] 过切) / Result: 三步 fact 卡 volume 78539.816→126056.405→104850.655(末值=解析),faces 3→5→6;@scad.part 包装返回 PartBuildResult / Adopted: flange_plate.build_solid() + build_flange_plate()`
|
||||
|
||||
### S2
|
||||
(待补)
|
||||
|
||||
### S3
|
||||
(待补)
|
||||
|
||||
## TODO(Role 2 初始化)
|
||||
|
||||
- Requirements: completed(REQUIREMENTS.md + 批量预答台账)
|
||||
- Plan: completed(本文件)
|
||||
- Build & Verify: S1 plan verifier / S1 model / S1 run verifier / S2 plan verifier / S2 model /
|
||||
S2 run verifier(S3 三项在改参轮追加)
|
||||
- Export: .scadpkg + STEP + STL + 渲染集 + 重开校验 + 最终报告
|
||||
|
||||
## Role 5 导出证据(2026-09-05)
|
||||
|
||||
- capture: `scad.capture(build_flange_plate(), examples/out/flange_plate/flange_plate.scadpkg)`
|
||||
→ CaptureResult;STEP 从包导出(AP242DIS,definition ('flange-plate',));STL 直读 BREP
|
||||
(3617 vertices / 7266 triangles,linear_deflection 0.1,需 `--extra gmsh`)
|
||||
- 新进程重开门(export.py --validate):`read_product_package` + `validate_product_package` OK;
|
||||
`load_product_package` → definition_id='flange-plate',definition_kind='single_solid',
|
||||
revision='1.0.0',solid_cache(BREP blob sha256:2678736…)present —— 单实体零件确认
|
||||
- 产物清单(examples/out/flange_plate/):flange_plate.scadpkg 4,373,342 B / flange_plate.step 52,981 B /
|
||||
flange_plate.stl 363,384 B / render_iso.png 69,140 B / render_front.png 28,312 B /
|
||||
render_top.png 94,349 B / render_detail.png 165,441 B
|
||||
|
||||
## 未执行的检查(诚实清单)
|
||||
|
||||
- FEM/强度/疲劳:无工况声明,按 manufacturing-boundaries 不做几何外断言
|
||||
- `validate_step_roundtrip_rdescriptor`(STEP 重导入往返):需求未声明 roundtrip 敏感消费方,未跑
|
||||
- GraphSession model-JSON replay 门:本流程走 @scad.part(非显式 GraphSession),replay 未演练;
|
||||
耐久性由 capture/reopen 门承担
|
||||
- 孔-圆角干涉的参数敏感性扫描(web 裕度 0.25 之外的扫描):未跑(守卫+单点实证已足)
|
||||
- OBJ/MJCF/FCStd:未要求,未导出
|
||||
|
||||
## 承重假设(报告用)
|
||||
|
||||
- min_edge_web=2(=R_edge,ASSUMED)→ 引出 G2b 相切禁令(实证承重)
|
||||
- "可行最大 PCD" 的 0.5mm 网格量化 → 84.5(上确界 85 被相切排除)
|
||||
- ⌀11 ≈ M10+1mm 间隙(规格推断,不影响几何)
|
||||
- 隔离评审机制:host 无 task/subagent 工具 → 独立视觉模型 MCP(analyze_image)逐视图独立调用
|
||||
@@ -0,0 +1,62 @@
|
||||
# Requirements: flange_plate(参数化法兰盘)
|
||||
|
||||
- Inputs: 用户 prose(全部尺寸已给定;几何体素路线由用户指定)+ 一轮批量提问(2026-09-05,用户预先批准按上稿选定全部默认)
|
||||
- Functional goals:
|
||||
1. 参数化法兰盘:盘 + 中心凸台 + 中心通孔 + 均布螺栓通孔阵,所有控制尺寸走命名参数(`scad.var`,带单位注释)
|
||||
2. 两次圆角:凸台根部 R3、法兰外缘上下 R2;圆角前必须打印选边卡(QL resolve 数量 + 边长),选边失败显式失败
|
||||
3. 参数可行性守卫前置(不可行参数在建模前显式 assert 失败,不许静默产出坏几何)
|
||||
- Geometry targets(分区描述,已确认):
|
||||
1. **法兰盘**:⌀`flange_od`(100) × 厚 `flange_t`(10) 圆柱盘;盘底平面 z=0,+Z 向上。
|
||||
2. **中心凸台**:⌀`boss_od`(55) 圆柱,自盘顶面 z=`flange_t` 起,凸台顶面到盘底距离 `boss_top_z`(30)(凸台高出盘面 20)。
|
||||
3. **中心通孔**:⌀`bore_d`(30),轴线 = Z 轴,贯穿盘 + 凸台。
|
||||
4. **螺栓通孔阵**:`bolt_count`(6) × ⌀`bolt_d`(11),轴线平行 Z,均布于 PCD `bolt_pcd`(78),首孔位于 +X(0°),贯穿法兰盘厚度(不含凸台)。
|
||||
5. **圆角**:凸台根部(凸台柱面 ∩ 盘顶面交线圆)R`boss_fillet_r`(3);法兰外缘上、下两条交线圆各 R`edge_fillet_r`(2)。
|
||||
- Units / coordinate convention: mm;原点 = 法兰轴线 ∩ 盘底平面;+Z 向上(凸台方向);受控基准面:盘底 z=0、盘顶 z=`flange_t`、凸台顶 z=`boss_top_z`;轴对称(关于 Z 轴,孔阵除外按 `bolt_count` 旋转对称)。
|
||||
- Named parameters (Var):
|
||||
- `flange_od = 100`(法兰盘外径, mm)
|
||||
- `flange_t = 10`(法兰盘厚度, mm)
|
||||
- `boss_od = 55`(凸台外径, mm)
|
||||
- `boss_top_z = 30`(凸台顶面到盘底距离, mm)
|
||||
- `bore_d = 30`(中心通孔直径, mm)
|
||||
- `bolt_d = 11`(螺栓孔直径, mm)
|
||||
- `bolt_pcd = 78`(螺栓孔分布圆直径, mm)
|
||||
- `bolt_count = 6`(螺栓孔数)(USER 第 2 轮改参:6 → 8,PCD 78 → 守卫可行值)
|
||||
- `boss_fillet_r = 3`(凸台根部圆角, mm)
|
||||
- `edge_fillet_r = 2`(法兰外缘圆角, mm)
|
||||
- `min_edge_web = 2` ASSUMED default(轮辐宽下限:螺栓孔边到法兰外缘的最小筋宽;取 = `edge_fillet_r`,保证外缘圆角不吃穿孔边)
|
||||
- Fastening & mounting: 螺栓沿 −Z/+Z 双侧可装(通孔、平孔口、无沉头);中心孔为轴/管道过孔。
|
||||
Envelope math: `bolt_d`=11 → 轮辐宽 = `flange_od`/2 − `bolt_pcd`/2 − `bolt_d`/2 ≥ `min_edge_web` →
|
||||
**PCD 上限 = `flange_od` − `bolt_d` − 2·`min_edge_web` = 100 − 11 − 4 = 85**
|
||||
- Service conditions: 未声明(不做强度/FEM 断言)
|
||||
- Export targets: `examples/out/flange_plate/` 下 .scadpkg + STEP + STL + 4 张渲染图(iso/front/top/detail)
|
||||
- Verification intent(验收前已写定,全部走外置 verify 脚本):
|
||||
- V1 (S1): 单实体、正体积;bbox = ⌀100 × [0, 30]±0.05;体积 = π/4·(flange_od²·flange_t + boss_od²·(boss_top_z−flange_t) − bore_d²·boss_top_z) ±0.5%
|
||||
- V2 (S2): 螺栓孔 `bolt_count` 个 ⌀11 圆柱孔壁 @PCD(QL 卡片:半径、圆心到轴距离);根部 torus ×1(R3);外缘 torus ×2(R2,上下);仍单实体;体积 < S1 体积
|
||||
- V3 守卫: 源码 `assert_params()` 含 4 条守卫(中心孔<凸台、轮辐宽、孔与根部圆角不干涉、根部圆角≤凸台高);verify 脚本以 known-bad 参数探针证明守卫承重(拒绝时抛错)
|
||||
- V4 (改参轮): PCD 88 须被轮辐宽守卫拒绝并打印依据;推导最大可行 PCD(保轮辐宽);按可行值交付 8 孔版并重跑 V1/V2 回归 + 守卫判定证据
|
||||
- V5 (导出): .scadpkg 新进程重开校验;STEP/STL 非空;4 渲染图存在;隔离 reviewer 按形状描述逐区域 match/mismatch/unreviewable 判定
|
||||
- Ask-or-Record ledger(本轮为批量预答:已问(批量)→ 用户预答(按上稿),不再向真实用户重复提问):
|
||||
| item | asked/assumed | answer/value |
|
||||
| --- | --- | --- |
|
||||
| 螺栓孔轴线与头侧 | asked(批量预答) | 沿 Z 贯穿、平孔口无沉头/倒角,双侧可装(按上稿选定) |
|
||||
| 基准与坐标 | asked(批量预答) | 盘底 z=0、+Z 凸台方向、原点在法兰轴线(按上稿选定) |
|
||||
| 螺栓孔起始角 | asked(批量预答) | 首孔 +X(0°)均布(按上稿选定) |
|
||||
| 载荷/服务工况 | asked(批量预答) | 未声明,仅做几何验证,不做强度断言(按上稿选定) |
|
||||
| min_edge_web 数值 | assumed | 2 mm(= edge_fillet_r;轮辐须不小于外缘圆角半径,改参轮据此推导 PCD 上限) |
|
||||
| 螺栓规格推断 | assumed | ⌀11 ≈ M10 + 1mm 间隙(孔径用户给定,规格为推断,不影响几何) |
|
||||
|
||||
## USER 第 2 轮改参(2026-09-05):8 孔 + PCD 尽量大(88)
|
||||
|
||||
守卫判定链(verify/s3_guard_evidence.py,证据原样可复跑):
|
||||
1. **8 孔 @PCD 88 → G2a 拒绝**:web = 100/2 − 88/2 − 11/2 = 0.500 < min_edge_web = 2.0
|
||||
2. **上确界 85 → G2b 排除(实征退化)**:web(85) = 2.0 == edge_fillet_r,孔口圆与 R2 圆角切圆
|
||||
精确内切。实跑 8×PCD85:边圆角吞并相切 0° 孔壁(孔壁 7/8、faces 16≠17、体积反常 +950、
|
||||
顶/底面中心偏移 +X)——相切是真实失败模式,非理论洁癖。守卫据此拆分:
|
||||
G2a 轮辐宽 ≥ 下限;G2b web 严格 > edge_fillet_r(禁相切)
|
||||
3. **交付 8 孔 @PCD 84.5**(0.5mm 网格上严格可行最大值,web=2.25,裕度 0.25):
|
||||
G1 wall 12.5>R3 / G2a 2.25≥2 / G2b 2.25>2 / G3 gap 6.25>0 / G4 boss_h 20≥R3 全过
|
||||
|
||||
参数变化:`bolt_count` 6→8(间距 60°→45°);`bolt_pcd` 78→84.5;其余全部不变。
|
||||
(几何回归:s2_verify D1-D5 全 PASS @8 孔 84.5 版。)
|
||||
|
||||
(USER 第 2 轮改参需求原文见 session_transcript.md [2] USER;判定记录同步 BUILD_PLAN.md S3 节。)
|
||||
@@ -0,0 +1,17 @@
|
||||
# 会话回放 Demo(单文件离线)
|
||||
|
||||
**打开方式:直接双击 `index.html`**(离线可用、无需服务器;数据、three.js、STL、渲染图全部内联,约 1.7 MB)。
|
||||
|
||||
把 `../session_transcript.md`(参数化法兰盘:几何体素路线与守卫驱动的改参交付)
|
||||
**忠实回放**成可交互页面:2 轮用户输入、66 次工具调用、28 个补丁、10 次角色切换
|
||||
(需求确认 → 总体规划 → S1–S3 分阶段建模/验证 → 导出),右侧 three.js 实时渲染
|
||||
最终 8 孔法兰盘。看点是第 2 轮改参:PCD 88 被守卫当场拒绝,85 因圆角相切被排除,
|
||||
84.5 实证可行交付。
|
||||
|
||||
## 重新生成(仓库根目录)
|
||||
|
||||
```bash
|
||||
python3 examples/flange_plate/demo/build.py
|
||||
```
|
||||
|
||||
构建器与转录格式见 [`examples/demo_kit/`](../../demo_kit/)。
|
||||
@@ -0,0 +1,75 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Rebuild the flange_plate replay demo with demo_kit.
|
||||
|
||||
Run from the repository root:
|
||||
|
||||
python3 examples/flange_plate/demo/build.py
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
HERE = Path(__file__).resolve().parent # demo/
|
||||
ROOT = HERE.parent # flange_plate/
|
||||
KIT = ROOT.parent / "demo_kit"
|
||||
sys.path.insert(0, str(KIT))
|
||||
|
||||
from build_demo import build_case # noqa: E402
|
||||
|
||||
build_case({
|
||||
"root": ROOT,
|
||||
"stl": {
|
||||
"path": ROOT.parent / "out" / "flange_plate" / "flange_plate.stl",
|
||||
"name": "flange_plate.stl",
|
||||
"note": "7,266 三角面 · 最终 8 孔 @PCD 84.5",
|
||||
"gl_cap": "flange_plate · 六特征块 FTC 建模 · 会话自动导出(scadpkg / STEP AP242 / STL)",
|
||||
},
|
||||
"imgs": [
|
||||
{"key": "iso", "path": ROOT.parent / "out" / "flange_plate" / "render_iso.png", "cap": "等轴测视图 · 8 孔终态"},
|
||||
{"key": "front", "path": ROOT.parent / "out" / "flange_plate" / "render_front.png", "cap": "正视图"},
|
||||
{"key": "top", "path": ROOT.parent / "out" / "flange_plate" / "render_top.png", "cap": "俯视图 · 首孔 +X / 45° 均布"},
|
||||
{"key": "detail", "path": ROOT.parent / "out" / "flange_plate" / "render_detail.png", "cap": "螺栓孔 + 凸台根部圆角特写"},
|
||||
],
|
||||
"params": [
|
||||
["flange_od", "100 mm", "法兰盘外径"],
|
||||
["flange_t", "10 mm", "法兰盘厚度"],
|
||||
["boss_od / boss_top_z", "55 / 30 mm", "中心凸台外径 / 顶面高度"],
|
||||
["bore_d", "30 mm", "中心通孔直径"],
|
||||
["bolt_count", "8", "螺栓孔数(USER 第 2 轮 6 → 8)"],
|
||||
["bolt_pcd", "84.5 mm", "分布圆直径(78 → 88 被守卫拒 → 85 相切排除 → 84.5)"],
|
||||
["bolt_d", "11 mm", "螺栓通孔直径(≈M10+1 间隙)"],
|
||||
["boss_fillet_r", "3 mm", "凸台根部圆角"],
|
||||
["edge_fillet_r", "2 mm", "法兰外缘上下圆角"],
|
||||
["min_edge_web", "2 mm", "轮辐宽下限 + 禁与 edge_fillet_r 相切(实测发现的第三守卫条款)"],
|
||||
],
|
||||
"tags": [
|
||||
"fillet.boss_root",
|
||||
"fillet.flange_edge",
|
||||
],
|
||||
"tags_note": "圆角生成面携带确定性标签:改参(6→8 孔、PCD 78→84.5)后选择仍按标签命中,不依赖拓扑序号。",
|
||||
"artifacts": {
|
||||
"files": [
|
||||
["flange_plate.scadpkg", "4.37 MB", "SimpleCAD 原生产品包 · 新进程重开校验通过"],
|
||||
["flange_plate.step", "53 KB", "STEP AP242DIS"],
|
||||
["flange_plate.stl", "363 KB", "7,266 三角面 · 单实体"],
|
||||
["render_*.png", "×4", "等轴 / 正视 / 俯视 / 孔+圆角特写"],
|
||||
],
|
||||
"scripts": [
|
||||
"s1_hypothesis", "s1_verify", "s2_hypothesis", "s2_verify", "s3_guard_evidence",
|
||||
],
|
||||
"notes": [
|
||||
"改参守卫链:PCD 88 拒(轮辐 0.5<2)· 85 相切排除 · 84.5 交付",
|
||||
"体积/圆角环量按解析公式逐位对账(Pappus)",
|
||||
],
|
||||
},
|
||||
"about": [
|
||||
"<b>这是什么。</b>一个按 single-part-modeling 工作流完整走完的建模会话回放:Role 1 需求确认 → Role 2 总体规划 → Role 3/4 逐阶段「先验证契约、后建模」→ Role 5 导出。Agent 在 {tools} 次工具调用中交付一个几何体素路线的参数化法兰盘。",
|
||||
"<b>左侧对话</b>逐条回放全部 {N} 条消息(用户输入 / 思考 / 工具调用输入输出 / 补丁 / 角色切换),与 session_transcript.md 一一对应,未做删改。",
|
||||
"<b>看点在第 2 轮用户输入</b>:客户把 6 孔改成 8 孔并把 PCD 拉到 88 —— 参数守卫当场拒绝(轮辐宽不足),上确界 85 因圆角相切被排除,最终以 0.5 mm 网格取到严格可行最大值 84.5 交付。参数化不是口号,是被验证器守住的合同。",
|
||||
"<b>右侧 3D</b> 是会话最终导出的 {stlName}({stlTris} 三角面),three.js 实时渲染,可拖拽旋转 / 缩放 / 平移。",
|
||||
],
|
||||
"highlights": "① 每阶段先写验证契约再建模({allPass} 次 ALL PASS);② 圆角生成面带确定性标签,改参后仍可按标签选择;③ 守卫拒绝链 + 解析体积对账保证改参安全;④ 选边卡(QL resolve)在每次圆角前打印在案。",
|
||||
"subtitle": "· 参数化改参 + 守卫拒绝链演示",
|
||||
"extra_stat": ["8 孔", "终态螺栓孔(6→8 改参交付)"],
|
||||
})
|
||||
@@ -0,0 +1,60 @@
|
||||
"""Role 5 export: durable package + STEP + STL from the validated 8-hole model.
|
||||
|
||||
uv run python examples/flange_plate/export.py # capture + STEP
|
||||
uv run --extra gmsh python examples/flange_plate/export.py # same + STL (gmsh backend)
|
||||
uv run python examples/flange_plate/export.py --validate # fresh-process re-open gate
|
||||
"""
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
sys.path.insert(0, str(Path(__file__).resolve().parent))
|
||||
|
||||
import simplecadapi as scad # noqa: E402
|
||||
import flange_plate as fp # noqa: E402
|
||||
|
||||
OUT = Path(__file__).resolve().parents[1] / "out" / "flange_plate"
|
||||
PKG = OUT / "flange_plate.scadpkg"
|
||||
|
||||
|
||||
def capture_and_export() -> None:
|
||||
OUT.mkdir(parents=True, exist_ok=True)
|
||||
result = fp.build_flange_plate() # PartBuildResult (cached single-solid part)
|
||||
cap = scad.capture(result, PKG) # canonical durable export (positional contract)
|
||||
print(f"capture: {PKG.name} exists={PKG.exists()} "
|
||||
f"result_type={type(cap).__name__}")
|
||||
|
||||
step_report = scad.exporter.step.export_product_package_to_step(
|
||||
data=PKG, output_path=OUT / "flange_plate.step")
|
||||
print(f"step: output={getattr(step_report, 'output_path', OUT / 'flange_plate.step')} "
|
||||
f"schema={getattr(step_report, 'schema', '?')} "
|
||||
f"definitions={getattr(step_report, 'definition_ids', '?')} "
|
||||
f"occurrences={getattr(step_report, 'occurrence_count', '?')}")
|
||||
|
||||
try:
|
||||
stl_report = scad.exporter.stl.export_product_package_to_stl(
|
||||
data=PKG, output_path=OUT / "flange_plate.stl",
|
||||
linear_deflection=0.1, angular_deflection_degrees=20.0)
|
||||
print(f"stl: vertices={getattr(stl_report, 'vertex_count', '?')} "
|
||||
f"triangles={getattr(stl_report, 'triangle_count', '?')} "
|
||||
f"backend={getattr(stl_report, 'backend', '?')}")
|
||||
except Exception as exc: # gmsh extra missing -> report, never silent
|
||||
print(f"stl: SKIPPED ({type(exc).__name__}: {str(exc)[:100]}) "
|
||||
f"— rerun with: uv run --extra gmsh python {Path(__file__).name}")
|
||||
|
||||
|
||||
def validate_reopen() -> None:
|
||||
package = scad.read_product_package(PKG)
|
||||
scad.validate_product_package(package)
|
||||
definition = scad.load_product_package(PKG)
|
||||
print(f"reopen: validate OK, root_definition={package.root_definition} "
|
||||
f"root_kind={package.root_kind} definition_id={definition.definition_id} "
|
||||
f"definition_kind={definition.definition_kind} revision={definition.revision} "
|
||||
f"solid_cache={'present' if definition.solid_cache_ref else 'absent'} "
|
||||
f"(single-solid part product)")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
if "--validate" in sys.argv:
|
||||
validate_reopen()
|
||||
else:
|
||||
capture_and_export()
|
||||
@@ -0,0 +1,181 @@
|
||||
"""flange_plate: 参数化法兰盘(几何体素路线,无草图层)。
|
||||
|
||||
Coordinate convention (REQUIREMENTS.md):
|
||||
origin = 法兰轴线 ∩ 盘底平面; +Z 凸台方向.
|
||||
受控基准面: 盘底 z=0, 盘顶 z=flange_t, 凸台顶 z=boss_top_z; 回转轴 = Z 轴.
|
||||
|
||||
体素路线依据 (FTC geometry tier case 3): 盘/凸台/孔刀全部是完全含于圆柱基本体
|
||||
的纯工具体 —— 基元即完整设计形状, 无需 profile. 一个 feature 一个块, 圆角最后.
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
import math
|
||||
|
||||
import simplecadapi as scad
|
||||
from simplecadapi import ql
|
||||
|
||||
# ---- Var-exposed tunable parameters (mm) ----
|
||||
FLANGE_OD = scad.var("flange_od", 100.0, comment="法兰盘外径", unit="mm")
|
||||
FLANGE_T = scad.var("flange_t", 10.0, comment="法兰盘厚度", unit="mm")
|
||||
BOSS_OD = scad.var("boss_od", 55.0, comment="中心凸台外径", unit="mm")
|
||||
BOSS_TOP_Z = scad.var("boss_top_z", 30.0, comment="凸台顶面到盘底距离", unit="mm")
|
||||
BORE_D = scad.var("bore_d", 30.0, comment="中心通孔直径", unit="mm")
|
||||
BOLT_D = scad.var("bolt_d", 11.0, comment="螺栓通孔直径", unit="mm")
|
||||
BOLT_PCD = scad.var("bolt_pcd", 84.5,
|
||||
comment="螺栓孔分布圆直径 PCD;USER 第 2 轮 78→88 被 G2a 拒(web 0.5<2);"
|
||||
"85 时 web==R_edge 精确相切(G2b 禁止,实证孔壁被圆角吞并),"
|
||||
"按 0.5mm 网格取严格可行最大值 84.5", unit="mm")
|
||||
BOLT_COUNT = scad.var("bolt_count", 8, comment="螺栓孔数(均布,首孔 +X/0°);USER 第 2 轮 6→8")
|
||||
BOSS_FILLET_R = scad.var("boss_fillet_r", 3.0, comment="凸台根部圆角", unit="mm")
|
||||
EDGE_FILLET_R = scad.var("edge_fillet_r", 2.0, comment="法兰外缘上下圆角", unit="mm")
|
||||
MIN_EDGE_WEB = scad.var("min_edge_web", 2.0,
|
||||
comment="轮辐宽下限:孔边到外缘最小筋宽(ASSUMED=取 edge_fillet_r)", unit="mm")
|
||||
|
||||
# 刀具过切量(feature-ordering: 孔刀须越过进出面)
|
||||
OVERSHOOT = 5.0
|
||||
|
||||
|
||||
def _value(v: object) -> float:
|
||||
evaluate = getattr(v, "evaluate", None)
|
||||
return float(evaluate()) if callable(evaluate) else float(v)
|
||||
|
||||
|
||||
def params() -> dict:
|
||||
return {
|
||||
"flange_od": _value(FLANGE_OD), "flange_t": _value(FLANGE_T),
|
||||
"boss_od": _value(BOSS_OD), "boss_top_z": _value(BOSS_TOP_Z),
|
||||
"bore_d": _value(BORE_D), "bolt_d": _value(BOLT_D),
|
||||
"bolt_pcd": _value(BOLT_PCD), "bolt_count": int(_value(BOLT_COUNT)),
|
||||
"boss_fillet_r": _value(BOSS_FILLET_R), "edge_fillet_r": _value(EDGE_FILLET_R),
|
||||
"min_edge_web": _value(MIN_EDGE_WEB),
|
||||
}
|
||||
|
||||
|
||||
def assert_params(p: dict | None = None) -> None:
|
||||
"""参数可行性守卫(REQUIREMENTS.md V3;不可行参数显式失败,绝不静默)。"""
|
||||
p = p if p is not None else params()
|
||||
# G1 中心孔 < 凸台(壁厚须同时扛住根部圆角)
|
||||
wall = (p["boss_od"] - p["bore_d"]) / 2.0
|
||||
assert p["bore_d"] < p["boss_od"], \
|
||||
f"G1 中心孔 {p['bore_d']} 不小于凸台外径 {p['boss_od']}"
|
||||
assert wall > p["boss_fillet_r"], \
|
||||
f"G1 凸台环形壁厚 {wall:.3f} 必须大于根部圆角 {p['boss_fillet_r']}"
|
||||
# G2 螺栓孔到外缘轮辐宽(两句:宽度下限 + 拓扑非相切)
|
||||
web = p["flange_od"] / 2.0 - p["bolt_pcd"] / 2.0 - p["bolt_d"] / 2.0
|
||||
assert web >= p["min_edge_web"], \
|
||||
(f"G2a 轮辐宽不足: web = {p['flange_od']}/2 - {p['bolt_pcd']}/2 - {p['bolt_d']}/2 "
|
||||
f"= {web:.3f} < min_edge_web = {p['min_edge_web']}")
|
||||
assert web > p["edge_fillet_r"], \
|
||||
(f"G2b 孔缘与外缘圆角相切: web = {web:.3f} 不大于 edge_fillet_r = {p['edge_fillet_r']};"
|
||||
"web==R_edge 时孔口圆与圆角切圆内切,边圆角会吞并相切孔壁(2026-09-05 实证: "
|
||||
"8 孔 PCD 85 → 0° 孔壁消失、体积反常 +950),须严格大于")
|
||||
# G3 螺栓孔与凸台根部圆角不干涉
|
||||
gap = p["bolt_pcd"] / 2.0 - p["bolt_d"] / 2.0 - p["boss_od"] / 2.0 - p["boss_fillet_r"]
|
||||
assert gap > 0.0, \
|
||||
(f"G3 螺栓孔内缘侵入根部圆角区: PCD/2 - d/2 - boss_od/2 - R = {gap:.3f} <= 0")
|
||||
# G4 根部圆角不超凸台高出盘面的高度
|
||||
boss_h = p["boss_top_z"] - p["flange_t"]
|
||||
assert p["boss_fillet_r"] <= boss_h, \
|
||||
f"G4 根部圆角 {p['boss_fillet_r']} 超过凸台高出盘面高度 {boss_h:.3f}"
|
||||
|
||||
|
||||
def _fact_card(slug: str, body: scad.Solid) -> None:
|
||||
"""小事实卡(incremental grounding):体积 + 面数,不打印整个实体。"""
|
||||
faces = ql.faces().resolve(body)
|
||||
print(f"[{slug}] volume={body.get_volume():.3f} faces={len(faces)}")
|
||||
|
||||
|
||||
def _edge_card(slug: str, sel, body: scad.Solid) -> None:
|
||||
"""选边卡(geometric-validation 选边证据门):QL resolve 数量 + 逐边长度与中心。"""
|
||||
card = sel.resolve(body)
|
||||
print(f"[{slug}] selection card: n={len(card)}")
|
||||
for e in card:
|
||||
c = e.get_center()
|
||||
print(f" len={e.get_length():.3f} center=({c.x:.2f},{c.y:.2f},{c.z:.2f})")
|
||||
|
||||
|
||||
def _bolt_hole_tools(p: dict) -> list:
|
||||
"""bolt-holes 块局部工具体:原型孔刀 + radial_pattern(首孔 +X,均布 360°)。"""
|
||||
proto = scad.make_cylinder_rsolid(
|
||||
radius=p["bolt_d"] / 2.0, height=p["flange_t"] + 2.0 * OVERSHOOT,
|
||||
bottom_face_center=(p["bolt_pcd"] / 2.0, 0.0, -OVERSHOOT), axis=(0.0, 0.0, 1.0))
|
||||
return scad.radial_pattern_rsolidlist(
|
||||
shape=proto, center=(0.0, 0.0, 0.0), axis=(0.0, 0.0, 1.0),
|
||||
count=p["bolt_count"], total_rotation_angle=360.0)
|
||||
|
||||
|
||||
def build_solid() -> scad.Solid:
|
||||
"""特征链(FTC: 一个 feature 一个块,块头注释即特征树)。"""
|
||||
p = params()
|
||||
assert_params(p)
|
||||
|
||||
# ---- feature: flange-disc (build) ----
|
||||
body = scad.make_cylinder_rsolid(
|
||||
radius=p["flange_od"] / 2.0, height=p["flange_t"],
|
||||
bottom_face_center=(0.0, 0.0, 0.0), axis=(0.0, 0.0, 1.0))
|
||||
_fact_card("flange-disc", body)
|
||||
|
||||
# ---- feature: center-boss (add) ----
|
||||
boss = scad.make_cylinder_rsolid(
|
||||
radius=p["boss_od"] / 2.0, height=p["boss_top_z"] - p["flange_t"],
|
||||
bottom_face_center=(0.0, 0.0, p["flange_t"]), axis=(0.0, 0.0, 1.0))
|
||||
body = scad.union_rsolid(body, boss)
|
||||
_fact_card("center-boss", body)
|
||||
|
||||
# ---- feature: center-bore (subtract) ----
|
||||
bore_tool = scad.make_cylinder_rsolid(
|
||||
radius=p["bore_d"] / 2.0, height=p["boss_top_z"] + 2.0 * OVERSHOOT,
|
||||
bottom_face_center=(0.0, 0.0, -OVERSHOOT), axis=(0.0, 0.0, 1.0))
|
||||
body = scad.cut_rsolid(body, bore_tool)
|
||||
_fact_card("center-bore", body)
|
||||
|
||||
# ---- feature: bolt-holes (subtract) ----
|
||||
bolt_tools = _bolt_hole_tools(p)
|
||||
body = scad.cut_rsolid(body, bolt_tools)
|
||||
_fact_card("bolt-holes", body)
|
||||
|
||||
# ---- feature: boss-root-fillet (modify) ----
|
||||
# 选边卡先行(REQUIREMENTS 要求 2):数量 + 边长,exactly(1) 承重,选边失败显式抛错
|
||||
root_sel = ql.edges().where(ql.and_(
|
||||
ql.prop("geom.type", "==", "CIRCLE"),
|
||||
ql.prop("geom.center.z", ">=", p["flange_t"] - 0.1),
|
||||
ql.prop("geom.center.z", "<=", p["flange_t"] + 0.1),
|
||||
ql.prop("geom.length", ">=", math.pi * p["boss_od"] - 0.5),
|
||||
ql.prop("geom.length", "<=", math.pi * p["boss_od"] + 0.5),
|
||||
)).exactly(1)
|
||||
_edge_card("boss-root-fillet", root_sel, body)
|
||||
body = scad.fillet_rsolid(solid=body, edges=root_sel,
|
||||
radius=p["boss_fillet_r"],
|
||||
generated_faces_tag="fillet.boss_root")
|
||||
_fact_card("boss-root-fillet", body)
|
||||
|
||||
# ---- feature: flange-edge-fillets (modify) ----
|
||||
edge_sel = ql.edges().where(ql.and_(
|
||||
ql.prop("geom.type", "==", "CIRCLE"),
|
||||
ql.prop("geom.length", ">=", math.pi * p["flange_od"] - 0.5),
|
||||
ql.prop("geom.length", "<=", math.pi * p["flange_od"] + 0.5),
|
||||
ql.or_(
|
||||
ql.and_(ql.prop("geom.center.z", ">=", -0.1),
|
||||
ql.prop("geom.center.z", "<=", 0.1)),
|
||||
ql.and_(ql.prop("geom.center.z", ">=", p["flange_t"] - 0.1),
|
||||
ql.prop("geom.center.z", "<=", p["flange_t"] + 0.1)),
|
||||
),
|
||||
)).exactly(2)
|
||||
_edge_card("flange-edge-fillets", edge_sel, body)
|
||||
body = scad.fillet_rsolid(solid=body, edges=edge_sel,
|
||||
radius=p["edge_fillet_r"],
|
||||
generated_faces_tag="fillet.flange_edge")
|
||||
_fact_card("flange-edge-fillets", body)
|
||||
|
||||
return body
|
||||
|
||||
|
||||
@scad.part(id="flange-plate", revision="1.0.0")
|
||||
def build_flange_plate() -> scad.Solid:
|
||||
"""产品零件入口(durable 导出用;验证脚本直接用 build_solid)。"""
|
||||
return build_solid()
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
result = build_flange_plate()
|
||||
print(f"part built: {type(result).__name__}")
|
||||
@@ -0,0 +1,29 @@
|
||||
"""Render the 4-view demo set for flange_plate (8-hole, PCD 84.5).
|
||||
|
||||
Views (BUILD_PLAN S3 visual contract):
|
||||
render_iso.png (30, 45) isometric
|
||||
render_front.png (0, 0) front (+X toward viewer)
|
||||
render_top.png (90, 0) top down +Z
|
||||
render_detail.png (25, 20) zoom 9 — bolt hole + boss root fillet close-up
|
||||
"""
|
||||
from pathlib import Path
|
||||
|
||||
import flange_plate as fp
|
||||
import simplecadapi as scad
|
||||
|
||||
OUT = Path(__file__).resolve().parents[1] / "out" / "flange_plate"
|
||||
OUT.mkdir(parents=True, exist_ok=True)
|
||||
|
||||
body = fp.build_solid()
|
||||
|
||||
views = {
|
||||
"render_iso.png": dict(view=(30.0, 45.0), zoom=4.0),
|
||||
"render_front.png": dict(view=(0.0, 0.0), zoom=4.0),
|
||||
"render_top.png": dict(view=(90.0, 0.0), zoom=4.0),
|
||||
"render_detail.png": dict(view=(25.0, 20.0), zoom=9.0),
|
||||
}
|
||||
for name, kw in views.items():
|
||||
path = scad.render_screenshot_rpath(
|
||||
shapes=body, output_path=str(OUT / name),
|
||||
image_size=(1400, 900), show_legend=False, show_callouts=False, **kw)
|
||||
print(f"rendered {path}")
|
||||
@@ -0,0 +1,116 @@
|
||||
"""S1 hypothesis probe: prove the S1 measurement set discriminates pass/fail.
|
||||
|
||||
Runs BEFORE the model source exists (verifier-first). Builds a hand replica of
|
||||
the S1 substructure with nominal dims and exercises every planned check:
|
||||
H1 volume formula V = pi/4*(od^2*t + boss_od^2*(top-t) - bore^2*top)
|
||||
H2 QL face cards (boss top plane / bore wall cylinder / flange bottom annulus)
|
||||
H3 bbox via BRepBndLib.AddOptimal_s (u_link lesson: Add_s bloats)
|
||||
H4 known-bad replica WITHOUT boss must fail the volume gate (proof the
|
||||
gate discriminates, not just passes)
|
||||
"""
|
||||
import math
|
||||
import sys
|
||||
|
||||
import simplecadapi as scad
|
||||
from simplecadapi import ql
|
||||
from OCP.Bnd import Bnd_Box
|
||||
from OCP.BRepBndLib import BRepBndLib
|
||||
|
||||
OD, T, BOSS_OD, TOP, BORE = 100.0, 10.0, 55.0, 30.0, 30.0
|
||||
|
||||
|
||||
def bbox_of(solid):
|
||||
box = Bnd_Box()
|
||||
box.SetGap(0.0)
|
||||
BRepBndLib.AddOptimal_s(solid.wrapped, box, useTriangulation=False)
|
||||
return box.Get()
|
||||
|
||||
|
||||
def analytic_volume(with_boss=True, with_bore=True):
|
||||
v = math.pi / 4.0 * OD * OD * T
|
||||
if with_boss:
|
||||
v += math.pi / 4.0 * BOSS_OD * BOSS_OD * (TOP - T)
|
||||
if with_bore:
|
||||
v -= math.pi / 4.0 * BORE * BORE * TOP
|
||||
return v
|
||||
|
||||
|
||||
def build_replica(with_boss=True, with_bore=True):
|
||||
body = scad.make_cylinder_rsolid(radius=OD / 2.0, height=T,
|
||||
bottom_face_center=(0.0, 0.0, 0.0), axis=(0.0, 0.0, 1.0))
|
||||
if with_boss:
|
||||
boss = scad.make_cylinder_rsolid(radius=BOSS_OD / 2.0, height=TOP - T,
|
||||
bottom_face_center=(0.0, 0.0, T), axis=(0.0, 0.0, 1.0))
|
||||
body = scad.union_rsolid(body, boss)
|
||||
if with_bore:
|
||||
bore = scad.make_cylinder_rsolid(radius=BORE / 2.0, height=TOP + 10.0,
|
||||
bottom_face_center=(0.0, 0.0, -5.0), axis=(0.0, 0.0, 1.0))
|
||||
body = scad.cut_rsolid(body, bore)
|
||||
return body
|
||||
|
||||
|
||||
results = []
|
||||
|
||||
|
||||
def h(name, ok, detail):
|
||||
print(f"{'PASS' if ok else 'FAIL'} {name} {detail}")
|
||||
results.append((name, ok))
|
||||
|
||||
|
||||
# H1 + H2 + H3 on the good replica
|
||||
good = build_replica()
|
||||
v = good.get_volume()
|
||||
want_v = analytic_volume()
|
||||
h("H1 volume formula", abs(v - want_v) / want_v < 0.005,
|
||||
f"measured={v:.3f} analytic={want_v:.3f} rel={abs(v-want_v)/want_v:.6f}")
|
||||
|
||||
faces = ql.faces().resolve(good)
|
||||
print(f"face card: n={len(faces)}")
|
||||
for f in faces:
|
||||
c = f.get_center()
|
||||
print(f" type=? area={f.get_area():.3f} center=({c.x:.2f},{c.y:.2f},{c.z:.2f})")
|
||||
|
||||
# bore wall: the only CYLINDER face with area pi*30*30
|
||||
bore_wall = ql.faces().where(ql.and_(
|
||||
ql.prop("geom.type", "==", "CYLINDER"),
|
||||
ql.prop("geom.area", ">=", math.pi * BORE * TOP - 1.0),
|
||||
ql.prop("geom.area", "<=", math.pi * BORE * TOP + 1.0),
|
||||
)).resolve(good)
|
||||
h("H2a bore wall card", len(bore_wall) == 1, f"n={len(bore_wall)} want_area={math.pi*BORE*TOP:.3f}")
|
||||
|
||||
# boss top plane: PLANE, z=30, annulus area pi*(27.5^2 - 15^2) (bore pierces it)
|
||||
boss_top = ql.faces().where(ql.and_(
|
||||
ql.prop("geom.type", "==", "PLANE"),
|
||||
ql.prop("geom.center.z", ">=", TOP - 0.1), ql.prop("geom.center.z", "<=", TOP + 0.1),
|
||||
ql.prop("geom.area", ">=", math.pi * ((BOSS_OD / 2.0) ** 2 - (BORE / 2.0) ** 2) - 1.0),
|
||||
ql.prop("geom.area", "<=", math.pi * ((BOSS_OD / 2.0) ** 2 - (BORE / 2.0) ** 2) + 1.0),
|
||||
)).resolve(good)
|
||||
h("H2b boss top annulus card", len(boss_top) == 1,
|
||||
f"n={len(boss_top)} want_area={math.pi*((BOSS_OD/2.0)**2-(BORE/2.0)**2):.3f}")
|
||||
|
||||
# flange bottom annulus: PLANE z=0, area pi*(50^2-15^2)
|
||||
bottom = ql.faces().where(ql.and_(
|
||||
ql.prop("geom.type", "==", "PLANE"),
|
||||
ql.prop("geom.center.z", ">=", -0.1), ql.prop("geom.center.z", "<=", 0.1),
|
||||
ql.prop("geom.area", ">=", math.pi * ((OD / 2.0) ** 2 - (BORE / 2.0) ** 2) - 1.0),
|
||||
ql.prop("geom.area", "<=", math.pi * ((OD / 2.0) ** 2 - (BORE / 2.0) ** 2) + 1.0),
|
||||
)).resolve(good)
|
||||
h("H2c bottom annulus card", len(bottom) == 1,
|
||||
f"n={len(bottom)} want_area={math.pi*((OD/2.0)**2-(BORE/2.0)**2):.3f}")
|
||||
|
||||
xmin, ymin, zmin, xmax, ymax, zmax = bbox_of(good)
|
||||
h("H3 bbox", abs(xmin + 50) < 0.05 and abs(xmax - 50) < 0.05 and abs(ymin + 50) < 0.05
|
||||
and abs(ymax - 50) < 0.05 and abs(zmin) < 0.05 and abs(zmax - TOP) < 0.05,
|
||||
f"x[{xmin:.2f},{xmax:.2f}] y[{ymin:.2f},{ymax:.2f}] z[{zmin:.2f},{zmax:.2f}]")
|
||||
|
||||
# H4 known-bad: replica without boss must FAIL the volume gate
|
||||
bad = build_replica(with_boss=False)
|
||||
vb = bad.get_volume()
|
||||
want_bad = analytic_volume(with_boss=False)
|
||||
h("H4 known-bad (no boss) fails volume gate", abs(vb - want_v) / want_v >= 0.005,
|
||||
f"no-boss volume={vb:.3f} vs good analytic={want_v:.3f} "
|
||||
f"(deviation {abs(vb-want_v)/want_v:.4%} must exceed 0.5%)")
|
||||
|
||||
ok_all = all(r for _, r in results)
|
||||
print(f"S1 hypothesis: {'ALL PASS' if ok_all else 'FAILED'}")
|
||||
sys.exit(0 if ok_all else 1)
|
||||
@@ -0,0 +1,108 @@
|
||||
"""S1 verifier: axisymmetric stepped revolve (disc + boss - center bore).
|
||||
|
||||
Run AFTER flange_plate.py exists (fresh process, re-materializes from source):
|
||||
uv run python examples/flange_plate/verify/s1_verify.py
|
||||
|
||||
Criteria (BUILD_PLAN S1 contract, hypothesis-proven in s1_hypothesis.py):
|
||||
C1 single Solid, volume = pi/4*(od^2*t + boss_od^2*(top-t) - bore^2*top) +-0.5%
|
||||
C2 bbox x/y in [-od/2, od/2], z in [0, boss_top_z], tol 0.05
|
||||
C3 boss top annulus plane @ z=boss_top_z, area pi*((boss_od/2)^2-(bore/2)^2)
|
||||
C4 bore wall cylinder, area pi*bore_d*boss_top_z
|
||||
C5 flange bottom annulus plane @ z=0, area pi*((od/2)^2-(bore/2)^2)
|
||||
C6 parameter guards reject 4 known-bad dicts and accept nominal params
|
||||
"""
|
||||
import math
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
sys.path.insert(0, str(Path(__file__).resolve().parents[1]))
|
||||
|
||||
import flange_plate as fp # noqa: E402
|
||||
from simplecadapi import ql # noqa: E402
|
||||
from OCP.Bnd import Bnd_Box # noqa: E402
|
||||
from OCP.BRepBndLib import BRepBndLib # noqa: E402
|
||||
|
||||
failures = []
|
||||
|
||||
|
||||
def check(name, ok, detail=""):
|
||||
print(f"{'PASS' if ok else 'FAIL'} {name} {detail}")
|
||||
if not ok:
|
||||
failures.append(name)
|
||||
|
||||
|
||||
p = fp.params()
|
||||
od, t = p["flange_od"], p["flange_t"]
|
||||
boss_od, top, bore = p["boss_od"], p["boss_top_z"], p["bore_d"]
|
||||
|
||||
body = fp.build_solid()
|
||||
|
||||
# C1
|
||||
volume = body.get_volume()
|
||||
analytic = math.pi / 4.0 * (od * od * t + boss_od * boss_od * (top - t) - bore * bore * top)
|
||||
check("C1 solid+volume", type(body).__name__ == "Solid" and volume > 0
|
||||
and abs(volume - analytic) / analytic < 0.005,
|
||||
f"volume={volume:.3f} analytic={analytic:.3f}")
|
||||
|
||||
# C2
|
||||
box = Bnd_Box()
|
||||
box.SetGap(0.0)
|
||||
BRepBndLib.AddOptimal_s(body.wrapped, box, useTriangulation=False)
|
||||
xmin, ymin, zmin, xmax, ymax, zmax = box.Get()
|
||||
bbox_wants = ((xmin, -od / 2), (xmax, od / 2), (ymin, -od / 2),
|
||||
(ymax, od / 2), (zmin, 0.0), (zmax, top))
|
||||
check("C2 bbox", all(abs(g - w) < 0.05 for g, w in bbox_wants),
|
||||
f"x[{xmin:.2f},{xmax:.2f}] y[{ymin:.2f},{ymax:.2f}] z[{zmin:.2f},{zmax:.2f}]")
|
||||
|
||||
# C3 boss top annulus
|
||||
a_top = math.pi * ((boss_od / 2.0) ** 2 - (bore / 2.0) ** 2)
|
||||
boss_top = ql.faces().where(ql.and_(
|
||||
ql.prop("geom.type", "==", "PLANE"),
|
||||
ql.prop("geom.center.z", ">=", top - 0.1), ql.prop("geom.center.z", "<=", top + 0.1),
|
||||
ql.prop("geom.area", ">=", a_top - 1.0), ql.prop("geom.area", "<=", a_top + 1.0),
|
||||
)).resolve(body)
|
||||
check("C3 boss top annulus", len(boss_top) == 1,
|
||||
f"n={len(boss_top)} area={[f'{f.get_area():.2f}' for f in boss_top]} want={a_top:.2f}")
|
||||
|
||||
# C4 bore wall
|
||||
a_bore = math.pi * bore * top
|
||||
bore_wall = ql.faces().where(ql.and_(
|
||||
ql.prop("geom.type", "==", "CYLINDER"),
|
||||
ql.prop("geom.area", ">=", a_bore - 1.0), ql.prop("geom.area", "<=", a_bore + 1.0),
|
||||
)).resolve(body)
|
||||
check("C4 bore wall cylinder", len(bore_wall) == 1,
|
||||
f"n={len(bore_wall)} area={[f'{f.get_area():.2f}' for f in bore_wall]} want={a_bore:.2f}")
|
||||
|
||||
# C5 flange bottom annulus
|
||||
a_bot = math.pi * ((od / 2.0) ** 2 - (bore / 2.0) ** 2)
|
||||
bottom = ql.faces().where(ql.and_(
|
||||
ql.prop("geom.type", "==", "PLANE"),
|
||||
ql.prop("geom.center.z", ">=", -0.1), ql.prop("geom.center.z", "<=", 0.1),
|
||||
ql.prop("geom.area", ">=", a_bot - 1.0), ql.prop("geom.area", "<=", a_bot + 1.0),
|
||||
)).resolve(body)
|
||||
check("C5 bottom annulus", len(bottom) == 1,
|
||||
f"n={len(bottom)} area={[f'{f.get_area():.2f}' for f in bottom]} want={a_bot:.2f}")
|
||||
|
||||
# C6 guards: nominal accepted, 4 known-bad dicts rejected
|
||||
try:
|
||||
fp.assert_params(p)
|
||||
ok_nominal = True
|
||||
except AssertionError:
|
||||
ok_nominal = False
|
||||
check("C6a nominal params accepted", ok_nominal)
|
||||
|
||||
bad_cases = {
|
||||
"bore>=boss (G1)": dict(p, bore_d=boss_od),
|
||||
"web<min (G2)": dict(p, bolt_pcd=od - p["bolt_d"] - 2.0 * p["min_edge_web"] + 1.0),
|
||||
"bolt hits root fillet (G3)": dict(p, bolt_pcd=boss_od + p["bolt_d"] + 2.0 * p["boss_fillet_r"]),
|
||||
"root fillet>boss height (G4)": dict(p, boss_top_z=t + 2.0), # boss 高 2 < R3
|
||||
}
|
||||
for name, bad_p in bad_cases.items():
|
||||
try:
|
||||
fp.assert_params(bad_p)
|
||||
check(f"C6 guard rejects {name}", False, "NO raise — guard is silent")
|
||||
except AssertionError as exc:
|
||||
check(f"C6 guard rejects {name}", True, f"raised: {str(exc)[:60]}")
|
||||
|
||||
print(f"S1 verifier: {'ALL PASS' if not failures else 'FAILED ' + str(failures)}")
|
||||
sys.exit(1 if failures else 0)
|
||||
@@ -0,0 +1,153 @@
|
||||
"""S2 hypothesis probe: bolt pattern + double fillet measurement set.
|
||||
|
||||
Proves on a hand replica (model source not yet extended to S2):
|
||||
P1 radial_pattern semantics (count includes prototype? angle coverage?)
|
||||
P2 bolt hole wall card (n, radius-from-axis, phase, area)
|
||||
P3 boss-root edge selection card (CIRCLE @ z=t, len 2*pi*27.5) -> fillet R3
|
||||
P4 flange-edge selection card (2 CIRCLEs len 2*pi*50) -> fillet R2
|
||||
P5 torus cards after fillets (n=3, areas, center.z windows)
|
||||
P6 volume after bolts = exact analytic; after fillets within Pappus bracket
|
||||
P7 known-bad: no-fillet replica fails torus card (discrimination proof)
|
||||
"""
|
||||
import math
|
||||
import sys
|
||||
|
||||
import simplecadapi as scad
|
||||
from simplecadapi import ql
|
||||
|
||||
OD, T, BOSS_OD, TOP, BORE = 100.0, 10.0, 55.0, 30.0, 30.0
|
||||
BOLT_D, PCD, N, R_ROOT, R_EDGE = 11.0, 78.0, 6, 3.0, 2.0
|
||||
OV = 5.0
|
||||
|
||||
results = []
|
||||
|
||||
|
||||
def h(name, ok, detail=""):
|
||||
print(f"{'PASS' if ok else 'FAIL'} {name} {detail}")
|
||||
results.append(ok)
|
||||
|
||||
|
||||
def base_body():
|
||||
body = scad.make_cylinder_rsolid(radius=OD / 2, height=T, bottom_face_center=(0, 0, 0), axis=(0, 0, 1))
|
||||
boss = scad.make_cylinder_rsolid(radius=BOSS_OD / 2, height=TOP - T, bottom_face_center=(0, 0, T), axis=(0, 0, 1))
|
||||
body = scad.union_rsolid(body, boss)
|
||||
bore = scad.make_cylinder_rsolid(radius=BORE / 2, height=TOP + 2 * OV, bottom_face_center=(0, 0, -OV), axis=(0, 0, 1))
|
||||
return scad.cut_rsolid(body, bore)
|
||||
|
||||
|
||||
def edge_card(name, sel, body):
|
||||
card = sel.resolve(body)
|
||||
print(f"selection card [{name}]: n={len(card)}")
|
||||
for e in card:
|
||||
c = e.get_center()
|
||||
print(f" len={e.get_length():.3f} center=({c.x:.2f},{c.y:.2f},{c.z:.2f})")
|
||||
return card
|
||||
|
||||
|
||||
body = base_body()
|
||||
|
||||
# ---- bolt prototype + pattern (P1/P2) ----
|
||||
proto = scad.make_cylinder_rsolid(radius=BOLT_D / 2, height=T + 2 * OV,
|
||||
bottom_face_center=(PCD / 2, 0.0, -OV), axis=(0, 0, 1))
|
||||
tools = scad.radial_pattern_rsolidlist(shape=proto, center=(0.0, 0.0, 0.0), axis=(0.0, 0.0, 1.0),
|
||||
count=N, total_rotation_angle=360.0)
|
||||
print(f"P1 pattern returns {len(tools)} tools (count={N})")
|
||||
h("P1 pattern count", len(tools) == N, f"got {len(tools)}")
|
||||
|
||||
holed = scad.cut_rsolid(body, tools)
|
||||
v_bolts = holed.get_volume()
|
||||
v_expect = math.pi / 4 * (OD * OD * T + BOSS_OD * BOSS_OD * (TOP - T) - BORE * BORE * TOP) \
|
||||
- N * math.pi / 4 * BOLT_D * BOLT_D * T
|
||||
h("P6a volume after bolts", abs(v_bolts - v_expect) / v_expect < 0.005,
|
||||
f"measured={v_bolts:.3f} analytic={v_expect:.3f}")
|
||||
|
||||
a_hole = math.pi * BOLT_D * T
|
||||
hole_walls = ql.faces().where(ql.and_(
|
||||
ql.prop("geom.type", "==", "CYLINDER"),
|
||||
ql.prop("geom.area", ">=", a_hole - 1.0), ql.prop("geom.area", "<=", a_hole + 1.0),
|
||||
)).resolve(holed)
|
||||
print(f"P2 hole wall card: n={len(hole_walls)}")
|
||||
radii, angles = [], []
|
||||
for f in hole_walls:
|
||||
c = f.get_center()
|
||||
r = math.hypot(c.x, c.y)
|
||||
radii.append(r)
|
||||
angles.append(round(math.degrees(math.atan2(c.y, c.x)) % 360.0, 2))
|
||||
print(f" center=({c.x:.3f},{c.y:.3f},{c.z:.3f}) r={r:.3f} area={f.get_area():.3f}")
|
||||
h("P2 hole walls", len(hole_walls) == N
|
||||
and all(abs(r - PCD / 2) < 0.05 for r in radii), f"radii={sorted(set(round(r,3) for r in radii))}")
|
||||
angles_sorted = sorted(angles)
|
||||
print(f" phases={angles_sorted}")
|
||||
h("P2b phase + spacing", angles_sorted[0] < 1e-6 or abs(angles_sorted[0] - 360.0) < 1e-6,
|
||||
f"first hole at {angles_sorted[0]} deg (want 0)")
|
||||
gaps = [round(b - a, 2) for a, b in zip(angles_sorted, angles_sorted[1:])]
|
||||
h("P2c equal spacing (2+ units)", len(set(gaps)) <= 1 and abs(gaps[0] - 360.0 / N) < 0.01,
|
||||
f"gaps={gaps}")
|
||||
|
||||
# ---- root fillet selection + apply (P3) ----
|
||||
root_sel = ql.edges().where(ql.and_(
|
||||
ql.prop("geom.type", "==", "CIRCLE"),
|
||||
ql.prop("geom.center.z", ">=", T - 0.1), ql.prop("geom.center.z", "<=", T + 0.1),
|
||||
ql.prop("geom.length", ">=", 2 * math.pi * BOSS_OD / 2 - 0.5),
|
||||
ql.prop("geom.length", "<=", 2 * math.pi * BOSS_OD / 2 + 0.5),
|
||||
))
|
||||
root_card = edge_card("boss-root R3", root_sel, holed)
|
||||
h("P3 root selection card", len(root_card) == 1
|
||||
and abs(root_card[0].get_length() - math.pi * BOSS_OD) < 0.5,
|
||||
f"n={len(root_card)} len={[f'{e.get_length():.3f}' for e in root_card]} want={math.pi*BOSS_OD:.3f}")
|
||||
|
||||
rooted = scad.fillet_rsolid(solid=holed, edges=root_sel.exactly(1), radius=R_ROOT,
|
||||
generated_faces_tag="fillet.boss_root")
|
||||
|
||||
# ---- edge fillets selection + apply (P4) ----
|
||||
edge_sel = ql.edges().where(ql.and_(
|
||||
ql.prop("geom.type", "==", "CIRCLE"),
|
||||
ql.prop("geom.length", ">=", 2 * math.pi * OD / 2 - 0.5),
|
||||
ql.prop("geom.length", "<=", 2 * math.pi * OD / 2 + 0.5),
|
||||
ql.or_(ql.and_(ql.prop("geom.center.z", ">=", -0.1), ql.prop("geom.center.z", "<=", 0.1)),
|
||||
ql.and_(ql.prop("geom.center.z", ">=", T - 0.1), ql.prop("geom.center.z", "<=", T + 0.1))),
|
||||
))
|
||||
edge_card_out = edge_card("flange-edge R2 x2", edge_sel, rooted)
|
||||
h("P4 edge selection card", len(edge_card_out) == 2
|
||||
and all(abs(e.get_length() - math.pi * OD) < 0.5 for e in edge_card_out),
|
||||
f"n={len(edge_card_out)} lens={[f'{e.get_length():.3f}' for e in edge_card_out]} want={math.pi*OD:.3f}")
|
||||
|
||||
final = scad.fillet_rsolid(solid=rooted, edges=edge_sel.exactly(2), radius=R_EDGE,
|
||||
generated_faces_tag="fillet.flange_edge")
|
||||
|
||||
# ---- torus cards (P5) ----
|
||||
tori = ql.faces().where(ql.prop("geom.type", "==", "TORUS")).resolve(final)
|
||||
print(f"P5 torus card: n={len(tori)}")
|
||||
# Pappus surface: A = 2*pi*r_bar*arc_len; arc-centroid radial offset from arc
|
||||
# center is 2R/pi along the bisector (root concave: inboard; edge convex: outboard)
|
||||
a_root = 2 * math.pi * (BOSS_OD / 2 + R_ROOT - 2 * R_ROOT / math.pi) * (math.pi * R_ROOT / 2)
|
||||
a_edge = 2 * math.pi * (OD / 2 - R_EDGE + 2 * R_EDGE / math.pi) * (math.pi * R_EDGE / 2)
|
||||
for f in tori:
|
||||
c = f.get_center()
|
||||
print(f" area={f.get_area():.3f} center=({c.x:.2f},{c.y:.2f},{c.z:.2f})")
|
||||
root_tori = [f for f in tori if f.get_center().z > T]
|
||||
edge_tori = [f for f in tori if f.get_center().z <= T]
|
||||
h("P5a root torus", len(root_tori) == 1 and abs(root_tori[0].get_area() - a_root) / a_root < 0.02,
|
||||
f"n={len(root_tori)} area={root_tori[0].get_area():.3f} want={a_root:.3f}")
|
||||
h("P5b edge tori", len(edge_tori) == 2 and all(abs(f.get_area() - a_edge) / a_edge < 0.02 for f in edge_tori),
|
||||
f"n={len(edge_tori)} areas={[f'{f.get_area():.3f}' for f in edge_tori]} want={a_edge:.3f}")
|
||||
|
||||
# ---- final volume bracket (P6b) ----
|
||||
# Pappus: root fillet ADDS ring (corner square minus quarter disc) at r~28.15
|
||||
a_fill = R_ROOT * R_ROOT - math.pi * R_ROOT ** 2 / 4
|
||||
v_root_add = 2 * math.pi * 28.15 * a_fill
|
||||
# each edge fillet REMOVES corner (square minus quarter disc) at r~49.55
|
||||
a_cut = R_EDGE * R_EDGE - math.pi * R_EDGE ** 2 / 4
|
||||
v_edge_cut = 2 * 2 * math.pi * 49.55 * a_cut
|
||||
v_final = final.get_volume()
|
||||
v_bracket = v_expect + v_root_add - v_edge_cut
|
||||
h("P6b final volume in Pappus bracket", abs(v_final - v_bracket) / v_bracket < 0.015,
|
||||
f"measured={v_final:.3f} bracket={v_bracket:.3f} rel={abs(v_final-v_bracket)/v_bracket:.5f}")
|
||||
|
||||
# ---- known-bad: holed body without fillets must fail torus card (P7) ----
|
||||
tori_bad = ql.faces().where(ql.prop("geom.type", "==", "TORUS")).resolve(holed)
|
||||
h("P7 known-bad no-fillet torus=0", len(tori_bad) == 0, f"n={len(tori_bad)} != 3 -> gate discriminates")
|
||||
|
||||
ok = all(results)
|
||||
print(f"S2 hypothesis: {'ALL PASS' if ok else 'FAILED'} ({sum(results)}/{len(results)})")
|
||||
sys.exit(0 if ok else 1)
|
||||
@@ -0,0 +1,106 @@
|
||||
"""S2 verifier: bolt pattern + double fillet (final 6-hole form at this stage).
|
||||
|
||||
Run AFTER flange_plate.py contains the S2 features:
|
||||
uv run python examples/flange_plate/verify/s2_verify.py
|
||||
|
||||
Criteria (BUILD_PLAN S2 contract, hypothesis-proven in s2_hypothesis.py):
|
||||
D1 single Solid + final volume in Pappus bracket +-1.5%
|
||||
D2 bolt_count hole walls: CYLINDER area pi*bolt_d*flange_t, axis-distance = PCD/2
|
||||
D3 phase: first hole at 0 deg; adjacent spacing = 360/n (>=2 units measured)
|
||||
D4 tori: root TORUS n=1 (area Pappus arc-centroid formula, z > flange_t);
|
||||
edge TORUS n=2 (same-radius formula, z <= flange_t)
|
||||
D5 S1 regression: bbox unchanged (x/y in +-od/2, z in [0, top]); boss top
|
||||
annulus / bore wall cards still resolve exactly 1
|
||||
D6 pattern tool count == bolt_count and prototype validated before patterning
|
||||
(source evidence: fact cards in run log; re-check hole wall count here)
|
||||
"""
|
||||
import math
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
sys.path.insert(0, str(Path(__file__).resolve().parents[1]))
|
||||
|
||||
import flange_plate as fp # noqa: E402
|
||||
from simplecadapi import ql # noqa: E402
|
||||
from OCP.Bnd import Bnd_Box # noqa: E402
|
||||
from OCP.BRepBndLib import BRepBndLib # noqa: E402
|
||||
|
||||
failures = []
|
||||
|
||||
|
||||
def check(name, ok, detail=""):
|
||||
print(f"{'PASS' if ok else 'FAIL'} {name} {detail}")
|
||||
if not ok:
|
||||
failures.append(name)
|
||||
|
||||
|
||||
p = fp.params()
|
||||
od, t = p["flange_od"], p["flange_t"]
|
||||
boss_od, top, bore = p["boss_od"], p["boss_top_z"], p["bore_d"]
|
||||
bolt_d, pcd, n = p["bolt_d"], p["bolt_pcd"], p["bolt_count"]
|
||||
r_root, r_edge = p["boss_fillet_r"], p["edge_fillet_r"]
|
||||
|
||||
body = fp.build_solid()
|
||||
|
||||
# D1 volume bracket
|
||||
v_base = math.pi / 4 * (od * od * t + boss_od * boss_od * (top - t) - bore * bore * top)
|
||||
v_bolts = n * math.pi / 4 * bolt_d * bolt_d * t
|
||||
# root fillet adds corner-fill ring (Pappus, centroid r = Rmaj - 2R/pi - fill offset)
|
||||
a_fill = r_root * r_root - math.pi * r_root ** 2 / 4
|
||||
v_root_add = 2 * math.pi * (boss_od / 2 + r_root - 2 * r_root / math.pi - 2 * 0.06) * a_fill
|
||||
a_cut = r_edge * r_edge - math.pi * r_edge ** 2 / 4
|
||||
v_edge_cut = 2 * 2 * math.pi * (od / 2 - r_edge) * a_cut
|
||||
v_bracket = v_base - v_bolts + v_root_add - v_edge_cut
|
||||
v = body.get_volume()
|
||||
check("D1 volume in bracket", type(body).__name__ == "Solid" and v > 0
|
||||
and abs(v - v_bracket) / v_bracket < 0.015,
|
||||
f"volume={v:.3f} bracket={v_bracket:.3f} rel={abs(v - v_bracket) / v_bracket:.5f}")
|
||||
|
||||
# D2 bolt hole walls
|
||||
a_hole = math.pi * bolt_d * t
|
||||
walls = ql.faces().where(ql.and_(
|
||||
ql.prop("geom.type", "==", "CYLINDER"),
|
||||
ql.prop("geom.area", ">=", a_hole - 1.0), ql.prop("geom.area", "<=", a_hole + 1.0),
|
||||
)).resolve(body)
|
||||
radii = [math.hypot(f.get_center().x, f.get_center().y) for f in walls]
|
||||
check("D2 bolt hole walls", len(walls) == n and all(abs(r - pcd / 2) < 0.05 for r in radii),
|
||||
f"n={len(walls)} want={n} radii={sorted(set(round(r, 3) for r in radii))} want_r={pcd / 2:.3f}")
|
||||
|
||||
# D3 phase + spacing (measure at least two units)
|
||||
angles = sorted(round(math.degrees(math.atan2(f.get_center().y, f.get_center().x)) % 360.0, 2) for f in walls)
|
||||
gaps = [round(b - a, 2) for a, b in zip(angles, angles[1:])]
|
||||
check("D3 phase 0deg + equal spacing", angles and angles[0] < 0.01
|
||||
and len(set(gaps)) == 1 and abs(gaps[0] - 360.0 / n) < 0.01,
|
||||
f"phases={angles} gaps={gaps} want_gap={360.0 / n:.2f}")
|
||||
|
||||
# D4 torus cards
|
||||
tori = ql.faces().where(ql.prop("geom.type", "==", "TORUS")).resolve(body)
|
||||
a_root = 2 * math.pi * (boss_od / 2 + r_root - 2 * r_root / math.pi) * (math.pi * r_root / 2)
|
||||
a_edge = 2 * math.pi * (od / 2 - r_edge + 2 * r_edge / math.pi) * (math.pi * r_edge / 2)
|
||||
root_tori = [f for f in tori if f.get_center().z > t]
|
||||
edge_tori = [f for f in tori if f.get_center().z <= t]
|
||||
check("D4a root torus", len(root_tori) == 1 and abs(root_tori[0].get_area() - a_root) / a_root < 0.02,
|
||||
f"n={len(root_tori)} area={root_tori[0].get_area():.3f} want={a_root:.3f}")
|
||||
check("D4b edge tori", len(edge_tori) == 2
|
||||
and all(abs(f.get_area() - a_edge) / a_edge < 0.02 for f in edge_tori),
|
||||
f"n={len(edge_tori)} areas={[f'{f.get_area():.3f}' for f in edge_tori]} want={a_edge:.3f}")
|
||||
|
||||
# D5 S1 regression
|
||||
box = Bnd_Box()
|
||||
box.SetGap(0.0)
|
||||
BRepBndLib.AddOptimal_s(body.wrapped, box, useTriangulation=False)
|
||||
xmin, ymin, zmin, xmax, ymax, zmax = box.Get()
|
||||
a_top = math.pi * ((boss_od / 2) ** 2 - (bore / 2) ** 2)
|
||||
boss_top = ql.faces().where(ql.and_(
|
||||
ql.prop("geom.type", "==", "PLANE"),
|
||||
ql.prop("geom.center.z", ">=", top - 0.1), ql.prop("geom.center.z", "<=", top + 0.1),
|
||||
ql.prop("geom.area", ">=", a_top - 1.0), ql.prop("geom.area", "<=", a_top + 1.0),
|
||||
)).resolve(body)
|
||||
wants = ((xmin, -od / 2), (xmax, od / 2), (ymin, -od / 2), (ymax, od / 2), (zmin, 0.0), (zmax, top))
|
||||
check("D5 S1 regression (bbox+boss top card)",
|
||||
all(abs(g - w) < 0.05 for g, w in wants) and len(boss_top) == 1,
|
||||
f"bbox x[{xmin:.2f},{xmax:.2f}] y[{ymin:.2f},{ymax:.2f}] z[{zmin:.2f},{zmax:.2f}] "
|
||||
f"boss_top n={len(boss_top)}")
|
||||
|
||||
print(f"S2 verifier: {'ALL PASS' if not failures else 'FAILED ' + str(failures)}")
|
||||
sys.exit(1 if failures else 0)
|
||||
@@ -0,0 +1,104 @@
|
||||
"""S3 guard-decision evidence: 6-hole -> 8-hole re-parameterization (USER round 2).
|
||||
|
||||
Records, as verification evidence:
|
||||
E1 candidate (bolt_count=8, bolt_pcd=88) is REJECTED by the web guard G2a,
|
||||
with the exact arithmetic in the assertion message
|
||||
E2 PCD supremum from the web inequality is 85, but 85 is EXCLUDED by the
|
||||
tangency guard G2b (web == edge_fillet_r): proven degenerate on 2026-09-05
|
||||
(run log: 8x PCD85 -> 7 hole walls, faces 16!=17, edge fillet swallowed
|
||||
the tangent 0-degree hole, volume +950 anomaly). Max deliverable PCD on a
|
||||
0.5 mm grid with web strictly > R_edge: 84.5
|
||||
E3 the delivered pair (8, 84.5) passes ALL guards (G1..G4, G2a+G2b)
|
||||
E4 parameter-change table 6-hole -> 8-hole (what changed, what did not)
|
||||
Run BEFORE and AFTER the model param edit (guard math reads module params,
|
||||
candidates passed as overrides; module defaults only feed the change table).
|
||||
|
||||
uv run python examples/flange_plate/verify/s3_guard_evidence.py
|
||||
"""
|
||||
import math
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
sys.path.insert(0, str(Path(__file__).resolve().parents[1]))
|
||||
|
||||
import flange_plate as fp # noqa: E402
|
||||
|
||||
failures = []
|
||||
|
||||
|
||||
def check(name, ok, detail=""):
|
||||
print(f"{'PASS' if ok else 'FAIL'} {name} {detail}")
|
||||
if not ok:
|
||||
failures.append(name)
|
||||
|
||||
|
||||
p = fp.params() # current module defaults (pre-change: 6 holes; post-change: 8)
|
||||
REQ_COUNT, REQ_PCD = 8, 88.0
|
||||
DELIVERED_PCD = 84.5 # 0.5 mm grid; supremum 85 excluded by G2b tangency
|
||||
|
||||
print(f"module defaults: bolt_count={p['bolt_count']} bolt_pcd={p['bolt_pcd']}")
|
||||
print(f"user request : bolt_count={REQ_COUNT} bolt_pcd={REQ_PCD} (as large as possible)")
|
||||
|
||||
# E1: candidate 8/88 must be rejected by the web guard G2a
|
||||
web88 = p["flange_od"] / 2 - REQ_PCD / 2 - p["bolt_d"] / 2
|
||||
try:
|
||||
fp.assert_params(dict(p, bolt_count=REQ_COUNT, bolt_pcd=REQ_PCD))
|
||||
check("E1 guard rejects 8/88", False, "NO raise — guard silent, unacceptable")
|
||||
except AssertionError as exc:
|
||||
msg = str(exc)
|
||||
ok = msg.startswith("G2") and f"= {web88:.3f}" in msg
|
||||
check("E1 guard rejects 8/88", ok, f"web(88)={web88:.3f} min={p['min_edge_web']} raised: {msg[:90]}")
|
||||
|
||||
# E2: supremum 85 from G2a inequality, then excluded by G2b (tangency, proven)
|
||||
pcd_sup = p["flange_od"] - p["bolt_d"] - 2.0 * p["min_edge_web"]
|
||||
web_sup = p["flange_od"] / 2 - pcd_sup / 2 - p["bolt_d"] / 2
|
||||
check("E2a supremum from web floor", abs(pcd_sup - 85.0) < 1e-9 and abs(web_sup - p["min_edge_web"]) < 1e-9,
|
||||
f"pcd_sup = {p['flange_od']} - {p['bolt_d']} - 2*{p['min_edge_web']} = {pcd_sup:.1f}, "
|
||||
f"web({pcd_sup:.0f}) = {web_sup:.3f} == min_edge_web (boundary)")
|
||||
try:
|
||||
fp.assert_params(dict(p, bolt_count=REQ_COUNT, bolt_pcd=pcd_sup))
|
||||
check("E2b 85 excluded by tangency guard", False, "85 accepted — G2b missing")
|
||||
except AssertionError as exc:
|
||||
check("E2b 85 excluded by tangency guard", str(exc).startswith("G2b"),
|
||||
f"raised: {str(exc)[:80]}")
|
||||
print(" degeneracy proof on record (2026-09-05 run): 8x PCD85 built a solid but the "
|
||||
"edge fillet swallowed the tangent 0-deg hole wall (D2 found 7/8 walls, "
|
||||
"faces 16 != 17, volume +950 anomaly) — tangency is a real failure mode, "
|
||||
"not a theoretical one")
|
||||
check("E2c delivered PCD", abs(DELIVERED_PCD - 84.5) < 1e-9,
|
||||
f"max deliverable on 0.5mm grid with web > R_edge: {DELIVERED_PCD} "
|
||||
f"(web = {p['flange_od']/2 - DELIVERED_PCD/2 - p['bolt_d']/2:.3f} > {p['edge_fillet_r']})")
|
||||
|
||||
# E3: delivered pair (8, 84.5) passes all guards
|
||||
delivered = dict(p, bolt_count=REQ_COUNT, bolt_pcd=DELIVERED_PCD)
|
||||
try:
|
||||
fp.assert_params(delivered)
|
||||
check("E3 guards accept 8/84.5", True)
|
||||
except AssertionError as exc:
|
||||
check("E3 guards accept 8/84.5", False, f"raised: {exc}")
|
||||
web = p["flange_od"] / 2 - DELIVERED_PCD / 2 - p["bolt_d"] / 2
|
||||
gap = DELIVERED_PCD / 2 - p["bolt_d"] / 2 - p["boss_od"] / 2 - p["boss_fillet_r"]
|
||||
chord = 2 * (DELIVERED_PCD / 2) * math.sin(math.pi / REQ_COUNT)
|
||||
print(f" evidence: web={web:.3f} > R_edge={p['edge_fillet_r']} (margin {web - p['edge_fillet_r']:.3f}), "
|
||||
f"G3 gap={gap:.3f} > 0, G1 wall={(p['boss_od']-p['bore_d'])/2:.3f} > R{p['boss_fillet_r']}, "
|
||||
f"G4 boss_h={p['boss_top_z']-p['flange_t']:.1f} >= R{p['boss_fillet_r']}, "
|
||||
f"adjacent chord={chord:.2f} > bolt_d={p['bolt_d']}")
|
||||
|
||||
# E4: change table
|
||||
print("E4 change table:")
|
||||
print(f" bolt_count : {p['bolt_count']} -> {REQ_COUNT} (spacing 360/{REQ_COUNT} = {360.0/REQ_COUNT:.1f} deg)")
|
||||
print(f" bolt_pcd : {p['bolt_pcd']} -> {DELIVERED_PCD} "
|
||||
f"(88 rejected by G2a: web 0.5 < {p['min_edge_web']}; 85 excluded by G2b tangency; "
|
||||
f"84.5 = 0.5mm-grid max with web > R_edge)")
|
||||
print(f" unchanged : flange_od={p['flange_od']} flange_t={p['flange_t']} boss_od={p['boss_od']} "
|
||||
f"boss_top_z={p['boss_top_z']} bore_d={p['bore_d']} bolt_d={p['bolt_d']} "
|
||||
f"R_root={p['boss_fillet_r']} R_edge={p['edge_fillet_r']}")
|
||||
if p["bolt_count"] == REQ_COUNT and abs(p["bolt_pcd"] - DELIVERED_PCD) < 1e-9:
|
||||
print(f" post-change module defaults already delivered: 8 holes @ web={web:.3f}")
|
||||
check("E4 module params delivered", True, "bolt_count=8, bolt_pcd=84.5 in source")
|
||||
else:
|
||||
print(" pre-change module defaults: model edit still pending (this run = decision evidence)")
|
||||
check("E4 module params delivered", False, "not yet edited")
|
||||
|
||||
print(f"S3 guard evidence: {'ALL PASS' if not failures else 'FAILED ' + str(failures)}")
|
||||
sys.exit(1 if failures else 0)
|
||||
@@ -0,0 +1,33 @@
|
||||
# 会话回放 Demo(单文件离线)
|
||||
|
||||
**打开方式:直接双击 `index.html`**(单文件、离线可用、无需服务器;数据、three.js、STL、渲染图全部内联,约 6.3 MB)。
|
||||
|
||||
## 这是什么
|
||||
|
||||
把 `../session_transcript.md`(2 MB / 590 条消息的真实 OpenCode 会话)**忠实回放**成可交互的演示页面,展示"人如何用自然语言与 Agent 协作完成参数化 CAD 建模":
|
||||
|
||||
- 左侧:逐条回放全部消息——15 轮用户输入(打字机效果)、Agent 思考/回复、601 次工具调用的输入与输出、232 个补丁、22 次角色切换(需求确认 → 总体规划 → 分阶段建模/验证)
|
||||
- 右侧:three.js 实时渲染会话最终导出的 `out/u_link_assembly.stl`(可旋转/缩放/平移/线框),另有渲染图、终版参数表、导出产物三个面板
|
||||
|
||||
## 操作
|
||||
|
||||
| 操作 | 方式 |
|
||||
| --- | --- |
|
||||
| 播放 / 暂停 | `空格` 或 ▶ 按钮 |
|
||||
| 跳到下一轮用户输入 | `⇧→` 或 ⏭ 按钮 |
|
||||
| 直达某一轮 | 点击进度条上的橙色刻度 |
|
||||
| 全量阅读 | 顶栏「阅读模式」 |
|
||||
| 倍速 | ×0.5 – ∞ |
|
||||
|
||||
## 重新生成
|
||||
|
||||
transcript 或产物更新后(在仓库根目录执行):
|
||||
|
||||
```bash
|
||||
python3 examples/u_link_motor_mount/demo/build.py
|
||||
```
|
||||
|
||||
构建器与前端源码统一在 [`examples/demo_kit/`](../../demo_kit/)(`build_demo.py` +
|
||||
`template.html` + `app.js` + `app.css` + `vendor/three.js` r147 UMD);每个 case
|
||||
的 `demo/build.py` 提供该 case 的文案与素材路径配置,转录格式见
|
||||
[`examples/demo_kit/TRANSCRIPT_FORMAT.md`](../../demo_kit/TRANSCRIPT_FORMAT.md)。
|
||||
@@ -0,0 +1,81 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Rebuild the u_link_motor_mount replay demo with demo_kit.
|
||||
|
||||
Run from the repository root:
|
||||
|
||||
python3 examples/u_link_motor_mount/demo/build.py
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
HERE = Path(__file__).resolve().parent # demo/
|
||||
ROOT = HERE.parent # u_link_motor_mount/
|
||||
KIT = ROOT.parent / "demo_kit"
|
||||
sys.path.insert(0, str(KIT))
|
||||
|
||||
from build_demo import build_case # noqa: E402
|
||||
|
||||
build_case({
|
||||
"root": ROOT,
|
||||
"stl": {
|
||||
"path": ROOT / "out" / "u_link_assembly.stl",
|
||||
"name": "u_link_assembly.stl",
|
||||
"note": "44,976 三角面 · OCC BREP 曲面细分",
|
||||
"gl_cap": "u_link_assembly · body + shell · 会话自动导出(STEP AP242 / STL / FCStd)",
|
||||
},
|
||||
"imgs": [
|
||||
{"key": "assembly", "path": ROOT / "out" / "render_assembly.png", "cap": "最终装配 · body + shell"},
|
||||
{"key": "iso", "path": ROOT / "out" / "render_iso.png", "cap": "等轴测视图"},
|
||||
{"key": "front", "path": ROOT / "out" / "render_front.png", "cap": "正视图"},
|
||||
{"key": "shell", "path": ROOT / "out" / "render_shell.png", "cap": "外壳 shell(剖视)"},
|
||||
],
|
||||
"params": [
|
||||
["L", "80 mm", "臂轴跨距 / 底宽(两电机轴线间距)"],
|
||||
["D", "20 mm", "臂端面高度(用户定向 40 → 20 取半)"],
|
||||
["rod_d", "30 mm", "U 形圆杆直径"],
|
||||
["thickness", "6 mm", "电机槽壁余量(槽壁厚 = 3)"],
|
||||
["d_motor", "19 mm", "电机深度(S11 用户定向 30 → 19 加深槽)"],
|
||||
["r_corner", "17 mm", "拐角中心线圆弧半径,须 ∈ (rod_d/2, D)"],
|
||||
["fillet_r", "1.2 mm", "全局倒角半径(< thickness/4)"],
|
||||
["back_cut_frac", "0.75", "背切平面位置(0.5=中心线 → 0.75 用户定向上移)"],
|
||||
["wall_t", "2.0 mm", "shell 壁厚 = 腔内偏移量"],
|
||||
["boss_d / boss_h", "5 / 5 mm", "boss 柱外径 / 高度"],
|
||||
["boss_x", "12 mm", "boss 轴位置(剖分面中央区 ±)"],
|
||||
["boss_hole_d", "2.7 mm", "boss 自攻孔径 = shell 底孔内径(用户指定一致)"],
|
||||
["cable_w_off", "3 mm", "走线窗底边高于安装面(用户规定 ∈ [3,5])"],
|
||||
["cable_w_h × w", "5 × 10 mm", "走线窗尺寸(S14 周向 5 → 10 加宽 2 倍)"],
|
||||
["safe_fillet_r", "0.6 mm", "shell 平底外缘防割手圆角"],
|
||||
["notch_w × h", "9 × 5 mm", "两端走线方口(S11 加大)"],
|
||||
["csink", "Ø5.4 × 1.35", "shell 底板沉头孔(90° 锥口)"],
|
||||
],
|
||||
"tags": [
|
||||
"feature.motor_mount_floor_left",
|
||||
"feature.motor_mount_floor_right",
|
||||
"feature.back_face",
|
||||
],
|
||||
"tags_note": "命名面在倒角、剖分、重打标后仍可被查询语言索引 —— 这是本轮会话的核心能力演示之一。",
|
||||
"artifacts": {
|
||||
"files": [
|
||||
["u_link_assembly.step", "1.30 MB", "STEP AP242DIS · 3 定义 · 2 实例"],
|
||||
["u_link_assembly.stl", "2.14 MB", "44,976 三角面 · OCC BREP 曲面细分"],
|
||||
["u_link_assembly.FCStd", "1.91 MB", "FreeCAD 可编辑特征树 · 167 对象"],
|
||||
["u_link_assembly.scadpkg", "18.9 MB", "SimpleCAD 原生装配包"],
|
||||
["render_*.png", "×4", "装配 / 等轴 / 正视 / 外壳渲染"],
|
||||
],
|
||||
"scripts": [
|
||||
"s1–s5_verify", "s6_param_sweep", "s8_preprobe/diag×3", "s9_diag/verify",
|
||||
"s10_verify", "s11_probe", "s12_verify", "s13_probe", "s14 回归",
|
||||
],
|
||||
"notes": ["参数扫描 13 变体 + 17 边界 全过"],
|
||||
},
|
||||
"about": [
|
||||
"<b>这是什么。</b>一个真实工程会话的忠实回放:2026-08-26 15:56 → 00:17,人类工程师用自然语言描述需求、逐步定向修改,Agent(SimpleCAD SDK)在 <b>{tools}</b> 次工具调用中完成「需求确认 → 总体规划 → 分阶段建模 → 每阶段独立验证 → 导出装配」的完整闭环。",
|
||||
"<b>左侧对话</b>逐条回放全部 {N} 条消息(用户输入 / Agent 思考与回复 / 工具调用输入与输出 / 补丁 / 角色切换),内容与 session_transcript.md 一一对应,未做删改。",
|
||||
"<b>右侧 3D</b> 是会话最终导出的 {stlName}({stlTris} 三角面),由 three.js 实时渲染,可拖拽旋转 / 缩放 / 平移。",
|
||||
],
|
||||
"highlights": "① 每阶段先写验证契约再建模({allPass} 次 ALL PASS);② 安装面/背面具备确定性命名、可被查询语言索引;③ 用户 7 次「不对/改一下」的真实返工(S8 卡扣→S9 boss→S10 剖分→S11 两刀工艺);④ 参数守卫链与变体扫描保证参数化正确性。",
|
||||
"subtitle": "· 从一句话需求到可制造装配",
|
||||
"extra_stat": ["2", "交付零件 body+shell"],
|
||||
})
|
||||
|
After Width: | Height: | Size: 188 KiB |
|
After Width: | Height: | Size: 437 KiB |
|
After Width: | Height: | Size: 50 KiB |
|
After Width: | Height: | Size: 89 KiB |
|
After Width: | Height: | Size: 32 KiB |
|
After Width: | Height: | Size: 33 KiB |
|
After Width: | Height: | Size: 162 KiB |
|
After Width: | Height: | Size: 68 KiB |
|
After Width: | Height: | Size: 91 KiB |