1c837766cd
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.
65 lines
6.3 KiB
JavaScript
65 lines
6.3 KiB
JavaScript
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'));
|