Files
vibemake/scripts/package-experiences.mjs
T
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

65 lines
6.3 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import { cpSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from 'node:fs';
import { resolve, join, relative } from 'node:path';
import { fileURLToPath } from 'node:url';
import { createHash } from 'node:crypto';
import { execFileSync } from 'node:child_process';
import { expectedController } from '../sandbox/src/game/package-config.js';
import { validatePackage, validateEmbeddedGlb } from '../js/experience-packages.js';
const ROOT = fileURLToPath(new URL('..', import.meta.url));
const OUT = join(ROOT, 'deliverables/experience-packages');
mkdirSync(OUT, { recursive: true });
const json = (file, data) => writeFileSync(file, JSON.stringify(data, null, 2) + '\n');
const hash = (bytes) => createHash('sha256').update(bytes).digest('hex');
const walk = (dir) => readdirSync(dir, { withFileTypes: true }).flatMap((e) => e.isDirectory() ? walk(join(dir, e.name)) : [join(dir, e.name)]);
const filesFor = (dir) => walk(dir).filter((p) => !p.endsWith('.DS_Store')).sort().map((p) => {
const bytes = readFileSync(p);
return { path: relative(dir, p), bytes: bytes.length, sha256: hash(bytes) };
});
function prepare(name) {
const dir = join(OUT, name);
rmSync(dir, { recursive: true, force: true });
mkdirSync(dir, { recursive: true });
return dir;
}
function finish(name, dir, manifest, readme) {
validatePackage(manifest, manifest.kind, `https://assets.example.com/${name}/manifest.json`);
json(join(dir, 'manifest.json'), manifest);
writeFileSync(join(dir, 'README.txt'), readme);
const zip = join(OUT, `${name}.zip`);
rmSync(zip, { force: true });
execFileSync('zip', ['-q', '-r', zip, '.'], { cwd: dir });
execFileSync('unzip', ['-tq', zip]);
console.log(`${name}.zip ${(readFileSync(zip).length / 1048576).toFixed(2)} MB SHA256 ${hash(readFileSync(zip))}`);
}
const assembly = prepare('microban-assembly');
mkdirSync(join(assembly, 'models'));
cpSync(join(ROOT, 'assets/models/microban-assembly.glb'), join(assembly, 'models/robot.glb'));
const glb = readFileSync(join(assembly, 'models/robot.glb'));
validateEmbeddedGlb(glb.buffer.slice(glb.byteOffset, glb.byteOffset + glb.byteLength));
finish('microban-assembly', assembly, {
schemaVersion: 1, kind: 'assembly', title: 'Microban', unit: 'meter',
displayQuaternion: [-Math.SQRT1_2, 0, 0, Math.SQRT1_2],
files: filesFor(assembly),
parts: [{ id: 'robot', file: 'models/robot.glb', position: [0, 0, 0], quaternion: [0, 0, 0, 1], scale: [1, 1, 1] }],
steps: [],
}, `Microban 装配展示包\n\n上传整个 ZIP,由后端解压并保持目录结构。\n将解压后的 manifest.json HTTP(S) 地址写入项目 assemblyManifestUrl。不要返回 ZIP 下载地址。\nmodels/robot.glb 与用户提供的原始文件完全一致,保留原材质。\n当前包是完整模型预览,没有真实装配工序;不会凭空生成安装步骤。\n\n未来多零件:每个 GLB 列在 files 中;parts 中每个实例拥有唯一 id、file、parentId、position、quaternion、scale。\n位置是相对父节点的米制坐标;四元数顺序 x,y,z,w;默认父节点为总装根节点。\n同一 file 可被多个实例复用,例如螺丝;不要对每个 GLB 单独居中或归一化。\nsteps 依次给出 id、label、parts(本步新增零件 id)。必须覆盖全部零件,各安装一次,父零件先安装或同一步安装。\ninstallOffset 是每个零件开始安装时相对最终位置的偏移;前端平移到准确安装位置。\n这是预先编排的装配展示,不是 CAD 约束求解或自动识别装配关系。\n\n每个 GLB 必须自包含贴图和缓冲区;目前支持静态、未压缩 GLB 2.0。\n单个 GLB 最大 50 MB,全部资源总计最大 200 MB,零件实例最多 1000 个。此上限不是手机性能保证。\n包内附带的 SHA256/大小需要后端核验;上传资源目录保持不可变,每次更新使用新目录。\n`);
const walking = prepare('microduck-walking');
for (const name of ['robot', 'policies', 'assets']) cpSync(join(ROOT, 'sandbox/public', name), join(walking, name), { recursive: true });
for (const name of ['LICENSE', 'NOTICE', 'UPSTREAM.md']) cpSync(join(ROOT, 'sandbox', name), join(walking, name));
json(join(walking, 'controller.json'), expectedController());
finish('microduck-walking', walking, {
schemaVersion: 1, kind: 'walking', title: 'Microduck', robotId: 'microduck-alpha',
runtimeProfile: 'microduck-alpha-v1', controller: 'controller.json', autoWalk: false,
files: filesFor(walking),
}, `Microduck 行走演示资源包\n\n上传整个 ZIP,由后端解压并保持目录结构。\n将解压后的 manifest.json HTTP(S) 地址写入项目 walkingManifestUrl。不要返回 ZIP 下载地址。\n\n本包属于 Microduck,不能当作 Microban 的策略。仅用于验证现有 Microduck 运行器的动态资源加载。\n可临时挂到测试项目联调;正式发布时请绑定实际对应的机器人项目。\n包含原机器人网格、物理 XML、运动学 JSON、ONNX 策略、音效和原许可证。原资产未修改。\n不含 Python 训练环境、node_modules、页面脚本或 WASM。\n平台前端必须部署 npm run build:walking 生成的 /play/microduck/ 运行器;运行器是网站的一部分,不从 ZIP 执行代码。\n\n运行约定:microduck-alpha-v1,14 个动作、61 维观测、13 维指令、0.005 秒物理步长,每 4 步推理一次(50 Hz)。\ncontroller.json 固化了关节顺序、默认姿态和控制语义,前端会检查,不匹配会拒绝启动。\n替换 ONNX 需要相同机器人、动力学、关节顺序、观测和动作语义,并在算法端重新验证。\n不是任意机器人/任意 ONNX 的通用播放器;其他机器人要新增运行器适配。\n打开默认不自动行走,保留球、方向控制、暂停、重置及移动端性能策略。\n\n后端校验路径、资源完整性、大小、SHA256,并在隔离环境验证物理模型和策略。\n提供 JSON/XML/GLB/ONNX/音效的正确 Content-Type 和跨域读取配置;使用 HTTPS 与不可变版本路径。\n`);
json(join(OUT, 'backend-fields.example.json'), {
assemblyManifestUrl: '/deliverables/experience-packages/microban-assembly/manifest.json',
walkingManifestUrl: '/deliverables/experience-packages/microduck-walking/manifest.json',
});
console.log(`输出目录:${resolve(OUT)}`);
cpSync(join(ROOT, 'docs/experience-packages.txt'), join(OUT, '后端接入说明.txt'));