Files
vibemake/scripts/optimize-duck-numbered-body.mjs
Jerry 1c837766cd feat: integrate robot assembly and simulation with resilient loading
Add backend-driven assembly and simulation experiences, MAKE branding, mobile rendering budgets and desktop-only CAD/PCB routes. Improve logo loading progress, document image recovery and URDF request handling; include dev packaging and regression coverage.
2026-10-30 18:38:39 +08:00

121 lines
7.7 KiB
JavaScript

// Offline BVH review of the combined numbered sequence. No runtime collision cost.
import { readFileSync, writeFileSync } from 'node:fs';
import assert from 'node:assert/strict';
import { Vector3, Quaternion } from 'three';
import { validatePackage } from '../js/experience-packages.js';
import { assemblyColliders } from './lib/assembly-colliders.mjs';
import { checkFiniteAxis, VIEW_AXES } from './lib/assembly-axis-planner.mjs';
const folder = new URL('../deliverables/experience-packages/microduck-numbered-body/', import.meta.url);
const raw = JSON.parse(readFileSync(new URL('input.json', folder)));
const result = structuredClone(raw), notes = JSON.parse(readFileSync(new URL('input.notes.json', folder)));
const config = validatePackage(raw, 'assembly', 'http://localhost:8090/manifest.json');
const get = assemblyColliders(config, '/Users/jerry/Downloads/小鸭子-扳手装配/零件模型');
const byId = new Map(result.parts.map(p => [p.id,p]));
const normalized = new Map(config.parts.map(p => [p.id,p]));
const display = new Quaternion(...config.displayQuaternion), inverse = display.clone().invert();
const installed = [], records = [], started = Date.now();
const vec = a => new Vector3(...a);
const clean = a => a.map(v => Math.abs(v) < 1e-12 ? 0 : v);
function checkFiniteApproach(moving, obstacles, vector, travel, maxMilliseconds=4000) {
return checkFiniteAxis(moving,obstacles,vector,travel,{maxMilliseconds});
}
function candidates(step, parts) {
const out = [];
const add = (name, vector) => {
const v = vector.clone().normalize();
if (!out.some(a => vec(a.vector).distanceTo(v) < 1e-5)) out.push({ name, vector: clean(v.toArray()) });
};
const preferred = vec(parts[0].installOffset).applyQuaternion(display).normalize();
const localQ = display.clone().multiply(new Quaternion(...parts[0].quaternion));
const local = axis => vec(axis).applyQuaternion(localQ);
const right = /^right-2-/.test(step.id), n = Number(step.id.split('-').at(-1));
add('preferred', preferred);
// Explicit fit constraints: do not install bearings sideways or screws across their holes.
if (right && [1,2].includes(n)) return out;
if (right && [5,6,17,34,35,42].includes(n)) {
// Align to the latest right assembly rather than inheriting an old tilted bearing axis.
out.length = 0;
const axis = local([1,0,0]); if (axis.dot(preferred) < 0) axis.negate();
add('local-fit-normal', axis); add('opposite-fit-normal', axis.clone().negate());
return out;
}
if (right && [3,18,31,43].includes(n)) {
out.length = 0;
const axis = local([0,0,1]); if (axis.dot(preferred) < 0) axis.negate();
add('local-fit-normal', axis); add('opposite-fit-normal', axis.clone().negate());
return out;
}
if (!right && [8,9,10,22,43,44].includes(n)) {
add('opposite-fit-normal', preferred.clone().negate()); return out;
}
if (right && n === 7) {
// Above the foot, with a small outward lean; never enter through the sole.
for (const z of [0,.08,.15,.25,.4]) add(`above-outward-${z}`,vec([0,1,z]));
return out;
}
for (const axis of VIEW_AXES) {
add(`display-${axis.name}`,vec(axis.vector)); add(`local-${axis.name}`,local(axis.vector));
}
return out;
}
for (const [i,step] of result.steps.entries()) {
const parts = step.parts.map(id => byId.get(id));
const moving = await Promise.all(step.parts.map(id => get(normalized.get(id))));
const fastener = parts.every(p => /螺钉/.test(p.file));
const record = { index:i+1, id:step.id, label:step.label, files:parts.map(p=>p.file) };
if (i < 52) {
record.status = 'preserved-reviewed-left';
} else if (fastener) {
const axis = vec(parts[0].installOffset).applyQuaternion(display).normalize().toArray();
record.selected = { name:'fixed-screw-axis', vector:axis,
...checkFiniteApproach(moving,installed,axis,.020,2500) };
record.status = 'fixed-fastener-axis';
record.note = 'Approach checked only; screw rotation, tool sweep and final seating are not certified.';
} else {
record.candidates = candidates(step,parts).map(c => ({ ...c,
...checkFiniteApproach(moving,installed,c.vector,Math.hypot(...parts[0].installOffset)) }));
for(const c of record.candidates) if(c.status==='needs-review')
Object.assign(c,checkFiniteApproach(moving,installed,c.vector,c.travel,15000));
const isClear=c=>['clear-to-seating','foundation'].includes(c.status);
const clear = record.candidates.filter(isClear);
const measurable = record.candidates.filter(c => Number.isFinite(c.remaining));
// If no certified approach exists, select a mechanically allowed direction that
// reaches closest to seating before first contact. Explicitly retain the warning.
const best = clear[0] ?? measurable.sort((a,b) => a.remaining-b.remaining)[0] ?? record.candidates[0];
const first = record.candidates[0];
const selected = !clear.length && first.status==='blocked-or-touching'
&& first.remaining <= (best.remaining ?? Infinity)+.00025 ? first : best;
record.selected = selected;
record.status = isClear(selected) ? 'clear-approach' : 'closest-approach-contact-remains';
// Preserve a practical finite entry distance; distant parts outside this swept
// range were excluded, so never use the longer internal check starting range.
const offset = vec(selected.vector).multiplyScalar(selected.travel).applyQuaternion(inverse);
parts.forEach(p => { p.installOffset=clean(offset.toArray()); });
record.changed = parts.some(p => Math.hypot(...p.installOffset.map((v,k)=>v-raw.parts.find(q=>q.id===p.id).installOffset[k]))>1e-8);
notes.steps[i].reason = `${notes.steps[i].reason}。${record.status==='clear-approach'
? 'BVH 检查:到最终落位前 0.15 mm 的直线进入路径未发现接触'
: '已比较允许的进入轴向;末段仍有接触/交叠,未认证全程无碰撞'}。`;
}
record.offsets=parts.map(p=>p.installOffset); records.push(record); installed.push(...moving);
console.log(`${i+1}/${result.steps.length} ${step.label}: ${record.status}${record.selected?.remaining!==undefined ? ` firstContact=${(record.selected.remaining*1000).toFixed(2)}mm` : ''}`);
writeFileSync(new URL('axis-review.progress.json',folder),JSON.stringify({completed:i+1,total:result.steps.length,records},null,2));
}
assert.deepEqual(result.steps,raw.steps); assert.deepEqual(result.files,raw.files); assert.deepEqual(result.tools,raw.tools);
for (let i=0;i<result.parts.length;i++) {
const {installOffset:a,...p}=result.parts[i], {installOffset:b,...q}=raw.parts[i]; assert.deepEqual(p,q);
}
validatePackage(result,'assembly','http://localhost:8090/manifest.json');
const summary = records.reduce((o,r)=>(o[r.status]=(o[r.status]??0)+1,o),{});
writeFileSync(new URL('manifest.json',folder),JSON.stringify(result,null,2)+'\n');
writeFileSync(new URL('manifest.notes.json',folder),JSON.stringify(notes,null,2)+'\n');
writeFileSync(new URL('axis-review.json',folder),JSON.stringify({
library:'three-mesh-bvh@0.9.17', seconds:(Date.now()-started)/1000,summary,
method:'Conservative advancement of full GLB triangle surfaces; mechanically constrained candidate axes; all earlier steps are obstacles.',
seatingToleranceMeters:.00015,collisionCertified:false, skipped:['3-36','3-37'],
limitations:['Left 52 offsets preserved from previous review.','Contact remains in multiple source mating geometries; closest-approach selection is a visual optimization, not a proof of collision freedom.',
'No rotation path planning or flexible/contact assembly; screw/tool swept volumes not certified.','Trunk same-type screw numbering has no occurrence pose; original component hole groups reused.'],steps:records,
},null,2)+'\n');
console.log(JSON.stringify({summary,seconds:(Date.now()-started)/1000}));