Guard visual assets from physics acceptance
This commit is contained in:
parent
0df3f8497a
commit
73f6dc2ccf
11
README.md
11
README.md
@ -143,9 +143,10 @@ npm run verify:real-backend -- \
|
||||
This probe calls the live MotrixSim bridge, not a mock. It checks editable
|
||||
entity groups in `/manifest`, calls real backend `/compose` for the
|
||||
G1/store/built-in primitive scene, verifies the composed object bodies in `/state`,
|
||||
writes a no-op pose for one composed body, writes a no-op pose for one product
|
||||
member, resumes the simulator, confirms fixed shelf anchors do not drift, and
|
||||
measures compact pause/resume control latency.
|
||||
writes a pose for one composed dynamic body, verifies fixed pre-stocked product
|
||||
bodies reject `set_body_pose`, resumes the simulator, confirms fixed shelf
|
||||
anchors do not drift, checks a lifted dynamic prop drops under backend physics,
|
||||
and measures compact pause/resume control latency.
|
||||
|
||||
For handoff or acceptance, prefer the single product gate:
|
||||
|
||||
@ -177,6 +178,10 @@ restored.
|
||||
The gate also validates the object physics-tier evidence. The product physical
|
||||
scene must include backend dynamic bodies and backend fixed environment bodies;
|
||||
visual-only objects are allowed only as explicit, counted preview artifacts.
|
||||
The product gate also validates builder physics coverage: default user-added
|
||||
props must be backend dynamic bodies. A separate negative browser path uploads a
|
||||
local OBJ asset and confirms the in-page acceptance fails instead of treating the
|
||||
visual asset as real collision physics.
|
||||
|
||||
For release handoff, `npm run product:release-check` first builds `dist/`,
|
||||
checks the JavaScript gzip bundle budget, then forces the browser gate through
|
||||
|
||||
@ -126,6 +126,11 @@ The product acceptance gate must pass with zero failures. It checks:
|
||||
- Object physics-tier diagnostics, proving the product scene has real backend
|
||||
dynamic bodies and fixed environment bodies, and explicitly counting any
|
||||
visual-only objects.
|
||||
- Builder physics coverage, proving every user-added default prop in the
|
||||
product physical scene is a backend dynamic body.
|
||||
- Visual-only upload boundary, proving a locally uploaded OBJ asset is rendered
|
||||
as a visual object and makes product acceptance fail instead of silently
|
||||
passing as real collision physics.
|
||||
- Runtime diagnostics panel with manifest, state, control, latency, binding, and
|
||||
asset health evidence.
|
||||
- Nonblank WebGL rendering.
|
||||
@ -169,6 +174,9 @@ Release checks write these artifacts:
|
||||
- `product-readiness-config-import-restore.jpg`: screenshot captured after
|
||||
importing the downloaded builder config in a clean browser context and
|
||||
restoring the backend physical scene.
|
||||
- `product-readiness-visual-only-boundary.jpg`: screenshot captured after adding
|
||||
a local uploaded OBJ asset to the physical preset. This negative-path evidence
|
||||
must show visual-only builder props and a failed in-page acceptance verdict.
|
||||
- `product-readiness-evidence.json`: compact handoff manifest with the report
|
||||
hash, git branch/commit/dirty state/remotes, screenshot/export paths, byte
|
||||
sizes, capture strategy, builder/share/config-import status, canvas metadata,
|
||||
@ -185,7 +193,7 @@ evidence to a code state:
|
||||
|
||||
Representative product gate baseline for the current thresholds:
|
||||
|
||||
- Result: `38 passed / 0 warned / 0 failed`
|
||||
- Result: `41 passed / 0 warned / 0 failed`
|
||||
- Frontend mode: `preview` for release handoff through
|
||||
`npm run product:release-check`.
|
||||
- Fail on warning: `true` for release handoff.
|
||||
@ -202,7 +210,7 @@ Representative product gate baseline for the current thresholds:
|
||||
- Fixed inventory protection: a pre-stocked product body returned HTTP `400`
|
||||
for `set_body_pose`, proving fixed stock is not accidentally treated as a
|
||||
movable free body.
|
||||
- Dynamic object drop: a lifted user-added cube dropped `0.48012m` after resume,
|
||||
- Dynamic object drop: a lifted user-added cube dropped `0.47701m` after resume,
|
||||
proving dynamic props still use backend physics.
|
||||
- Object physics tiers: the diagnostics panel and exported acceptance artifacts
|
||||
count backend dynamic, backend fixed, backend state-only, and visual-only
|
||||
@ -211,6 +219,12 @@ Representative product gate baseline for the current thresholds:
|
||||
- Product UI compose: the Scene Builder `Physical Scene` workflow reaches
|
||||
`后端物理组合场景`, keeps `4` builder props, exposes `/control`, and shows
|
||||
`外部仿真 / 后端物理` diagnostics.
|
||||
- Builder physics coverage: the product UI and exported acceptance package show
|
||||
`builderDynamic=4`, `builderVisual=0`, `total=4`, `ready=true`.
|
||||
- Visual-only upload boundary: the gate uploads a local OBJ asset and adds it to
|
||||
the physical preset in a separate clean browser context. The resulting preview
|
||||
has `641` objects, `builderDynamic=0`, `builderVisual=5`, and the in-page
|
||||
acceptance verdict correctly fails with `10 通过 / 0 警告 / 1 失败,共 11 项`.
|
||||
- Product share link: the gate clicks `复制分享链接`, confirms the copied URL has
|
||||
a `builder` payload and no `manifest` override, then opens it in a clean
|
||||
browser context. The restored page keeps the same `4` props, reaches
|
||||
@ -265,13 +279,14 @@ Scene evidence:
|
||||
- Meshes: `627`
|
||||
- Editable groups: `4 / 568`
|
||||
- Fallback meshes: `0`
|
||||
- Desktop acceptance: `10 通过 / 0 警告 / 0 失败,共 10 项`
|
||||
- Desktop acceptance telemetry: `0 ms / 10-0-0`
|
||||
- Desktop acceptance: `11 通过 / 0 警告 / 0 失败,共 11 项`
|
||||
- Desktop acceptance telemetry: `0 ms / 11-0-0`
|
||||
- Mobile preview: `636 objects / 635 bindings / 30 pixels`
|
||||
- Mobile acceptance: `10 通过 / 0 警告 / 0 失败,共 10 项`
|
||||
- Mobile acceptance telemetry: `0 ms / 10-0-0`
|
||||
- Mobile acceptance: `11 通过 / 0 警告 / 0 失败,共 11 项`
|
||||
- Mobile acceptance telemetry: `0 ms / 11-0-0`
|
||||
- UI acceptance package export: `schema=motrixsim-web.acceptance-package.v1`,
|
||||
`state=pass`, `objects=636`, `control=http://127.0.0.1:18090/control`
|
||||
`state=pass`, `objects=636`, `builderDynamic=4`, `builderVisual=0`,
|
||||
`control=http://127.0.0.1:18090/control`
|
||||
- UI HTML report export: title includes `MotrixSim Web 预览验收报告`, backend
|
||||
physics evidence is present, and `/control` is present.
|
||||
- UI HTML report render: the downloaded report opens in Chromium with a visible
|
||||
@ -300,25 +315,26 @@ Control evidence:
|
||||
backend diagnostics.
|
||||
- Composed object body edit: `133ms`.
|
||||
- Fixed inventory edit rejection: `86ms`.
|
||||
- Dynamic composed object drop: `0.48012m`.
|
||||
- Dynamic composed object drop: `0.47701m`.
|
||||
- Static shelf anchor stability: `max drift 0.00000m` after a 2500 ms resume
|
||||
window.
|
||||
- Resume backend state: `56ms paused=false`
|
||||
- Resume visible UI state: `62ms`
|
||||
- Pause backend state: `288ms paused=true`
|
||||
- Pause visible UI state: `292ms`
|
||||
- Desktop acceptance wait: `6115ms` total, product telemetry `0ms`
|
||||
- Mobile acceptance wait: `11062ms` total, product telemetry `0ms`
|
||||
- Resume backend state: `229ms paused=false`
|
||||
- Resume visible UI state: `182ms`
|
||||
- Pause backend state: `84ms paused=true`
|
||||
- Pause visible UI state: `66ms`
|
||||
- Desktop acceptance wait: `6535ms` total, product telemetry `0ms`
|
||||
- Mobile acceptance wait: `3993ms` total, product telemetry `0ms`
|
||||
- Runtime diagnostics panel:
|
||||
`state=http://127.0.0.1:18090/state`,
|
||||
`control=http://127.0.0.1:18090/control`,
|
||||
`latency=响应 291 ms / 确认 291 ms / 可见 292 ms`,
|
||||
`acceptanceLatency=0 ms / 10-0-0`,
|
||||
`binding=635/636; 4/568`.
|
||||
`latency=响应 65 ms / 确认 65 ms / 可见 66 ms`,
|
||||
`acceptanceLatency=0 ms / 11-0-0`,
|
||||
`binding=635/636; 4/568`,
|
||||
`builderPhysics=已添加物体 4: 后端动态 4 / 仅视觉 0`.
|
||||
- Evidence screenshot artifacts:
|
||||
`builder page; share page; import page; desktop canvas; mobile canvas`
|
||||
`builder page; share page; import page; visual-only boundary canvas; desktop canvas; mobile canvas`
|
||||
- Evidence export artifacts:
|
||||
`config 1 KiB v1; package 7 KiB motrixsim-web.acceptance-package.v1; report 8 KiB; rendered screenshot recorded`
|
||||
`config 1 KiB v1; package 9 KiB motrixsim-web.acceptance-package.v1; report 9 KiB; rendered screenshot recorded`
|
||||
|
||||
Visible UI control sync is the product interaction SLA and must stay under the
|
||||
current `3000ms` target. Backend state polling can take longer when the remote
|
||||
|
||||
@ -372,6 +372,7 @@ async function collectEvidenceArtifacts(browserEvidence) {
|
||||
const builderCapture = browserEvidence?.screenshots?.builderCompose;
|
||||
const shareRestoreCapture = browserEvidence?.screenshots?.shareRestore;
|
||||
const configImportCapture = browserEvidence?.screenshots?.configImportRestore;
|
||||
const visualOnlyBoundaryCapture = browserEvidence?.screenshots?.visualOnlyBoundary;
|
||||
const desktopCapture = browserEvidence?.screenshots?.desktop;
|
||||
const mobileCapture = browserEvidence?.screenshots?.mobile;
|
||||
const builderConfigExport = browserEvidence?.exports?.builderConfig;
|
||||
@ -403,6 +404,15 @@ async function collectEvidenceArtifacts(browserEvidence) {
|
||||
summaryProps: browserEvidence?.configImportRestore?.stats?.summaryProps,
|
||||
}
|
||||
: undefined;
|
||||
const visualOnlyBoundary = visualOnlyBoundaryCapture
|
||||
? {
|
||||
...(await describeArtifact(visualOnlyBoundaryCapture.path)),
|
||||
strategy: captureStrategy(visualOnlyBoundaryCapture),
|
||||
acceptanceState: browserEvidence?.visualOnlyBoundary?.stats?.acceptanceTelemetry?.state,
|
||||
acceptanceScore: browserEvidence?.visualOnlyBoundary?.stats?.acceptanceScore,
|
||||
builderPhysics: browserEvidence?.visualOnlyBoundary?.stats?.builderPhysics,
|
||||
}
|
||||
: undefined;
|
||||
const desktop = {
|
||||
...(await describeArtifact(desktopCapture?.path ?? "")),
|
||||
strategy: captureStrategy(desktopCapture),
|
||||
@ -431,6 +441,12 @@ async function collectEvidenceArtifacts(browserEvidence) {
|
||||
&& configImportRestore.bytes >= thresholds.minEvidenceImageBytes
|
||||
&& configImportRestore.sha256.length === 64
|
||||
&& ["page", "preview", "canvas"].includes(configImportRestore.strategy);
|
||||
const validVisualOnlyBoundary = Boolean(visualOnlyBoundary)
|
||||
&& visualOnlyBoundary.bytes >= thresholds.minEvidenceImageBytes
|
||||
&& visualOnlyBoundary.sha256.length === 64
|
||||
&& ["page", "preview", "canvas"].includes(visualOnlyBoundary.strategy)
|
||||
&& visualOnlyBoundary.acceptanceState === "fail"
|
||||
&& Number(visualOnlyBoundary.builderPhysics?.visualOnly ?? 0) > 0;
|
||||
const builderConfig = builderConfigExport
|
||||
? {
|
||||
...(await describeArtifact(builderConfigExport.path)),
|
||||
@ -439,6 +455,7 @@ async function collectEvidenceArtifacts(browserEvidence) {
|
||||
sceneId: builderConfigExport.sceneId,
|
||||
robotId: builderConfigExport.robotId,
|
||||
propCount: builderConfigExport.propCount,
|
||||
physics: builderConfigExport.physics,
|
||||
workspaceStatus: builderConfigExport.workspaceStatus,
|
||||
}
|
||||
: undefined;
|
||||
@ -453,6 +470,7 @@ async function collectEvidenceArtifacts(browserEvidence) {
|
||||
objectCount: packageExport.objectCount,
|
||||
controlUrl: packageExport.controlUrl,
|
||||
objectPhysics: packageExport.objectPhysics,
|
||||
builderPhysics: packageExport.builderPhysics,
|
||||
}
|
||||
: undefined;
|
||||
const acceptanceReport = reportExport
|
||||
@ -487,13 +505,19 @@ async function collectEvidenceArtifacts(browserEvidence) {
|
||||
&& acceptancePackage.objectCount >= thresholds.minObjects
|
||||
&& Number(acceptancePackage.objectPhysics?.backendDynamic ?? 0) >= 4
|
||||
&& Number(acceptancePackage.objectPhysics?.backendFixed ?? 0) >= 1
|
||||
&& Number(acceptancePackage.builderPhysics?.backendDynamic ?? 0) >= 4
|
||||
&& Number(acceptancePackage.builderPhysics?.visualOnly ?? Number.POSITIVE_INFINITY) === 0
|
||||
&& acceptancePackage.builderPhysics?.ready === true
|
||||
&& String(acceptancePackage.controlUrl ?? "").includes("/control");
|
||||
const validBuilderConfig = Boolean(builderConfig)
|
||||
&& builderConfig.bytes >= 256
|
||||
&& builderConfig.sha256.length === 64
|
||||
&& builderConfig.version === 1
|
||||
&& builderConfig.sceneId === "g1-store-blocks-physics"
|
||||
&& builderConfig.propCount >= 4;
|
||||
&& builderConfig.propCount >= 4
|
||||
&& builderConfig.physics?.ready === true
|
||||
&& Number(builderConfig.physics?.backendDynamic ?? 0) >= 4
|
||||
&& Number(builderConfig.physics?.visualOnly ?? Number.POSITIVE_INFINITY) === 0;
|
||||
const validReport = Boolean(acceptanceReport)
|
||||
&& acceptanceReport.bytes >= thresholds.minEvidenceExportBytes
|
||||
&& acceptanceReport.sha256.length === 64
|
||||
@ -509,8 +533,8 @@ async function collectEvidenceArtifacts(browserEvidence) {
|
||||
&& acceptanceReport.render?.containsPhysicsTiers === true;
|
||||
check(
|
||||
"evidence-screenshot-artifacts",
|
||||
validDesktop && validMobile && validBuilderCompose && validShareRestore && validConfigImportRestore,
|
||||
`builder ${Math.round((builderCompose?.bytes ?? 0) / 1024)} KiB ${builderCompose?.strategy ?? "-"}; share ${Math.round((shareRestore?.bytes ?? 0) / 1024)} KiB ${shareRestore?.strategy ?? "-"}; import ${Math.round((configImportRestore?.bytes ?? 0) / 1024)} KiB ${configImportRestore?.strategy ?? "-"}; desktop ${Math.round(desktop.bytes / 1024)} KiB ${desktop.strategy}; mobile ${Math.round(mobile.bytes / 1024)} KiB ${mobile.strategy}`,
|
||||
validDesktop && validMobile && validBuilderCompose && validShareRestore && validConfigImportRestore && validVisualOnlyBoundary,
|
||||
`builder ${Math.round((builderCompose?.bytes ?? 0) / 1024)} KiB ${builderCompose?.strategy ?? "-"}; share ${Math.round((shareRestore?.bytes ?? 0) / 1024)} KiB ${shareRestore?.strategy ?? "-"}; import ${Math.round((configImportRestore?.bytes ?? 0) / 1024)} KiB ${configImportRestore?.strategy ?? "-"}; boundary ${Math.round((visualOnlyBoundary?.bytes ?? 0) / 1024)} KiB ${visualOnlyBoundary?.strategy ?? "-"}; desktop ${Math.round(desktop.bytes / 1024)} KiB ${desktop.strategy}; mobile ${Math.round(mobile.bytes / 1024)} KiB ${mobile.strategy}`,
|
||||
);
|
||||
check(
|
||||
"evidence-export-artifacts",
|
||||
@ -522,6 +546,7 @@ async function collectEvidenceArtifacts(browserEvidence) {
|
||||
builderCompose,
|
||||
shareRestore,
|
||||
configImportRestore,
|
||||
visualOnlyBoundary,
|
||||
desktop,
|
||||
mobile,
|
||||
},
|
||||
@ -587,6 +612,12 @@ async function readBrowserStats(page) {
|
||||
visualOnly: numberData("physicsVisualOnly"),
|
||||
total: numberData("physicsTotalObjects"),
|
||||
},
|
||||
builderPhysics: {
|
||||
backendDynamic: numberData("builderBackendDynamic"),
|
||||
visualOnly: numberData("builderVisualOnly"),
|
||||
total: numberData("builderTotalObjects"),
|
||||
ready: data.builderPhysicsReady === "true",
|
||||
},
|
||||
diagnostics: {
|
||||
manifestUrl: text("#diag-manifest-url"),
|
||||
stateUrl: text("#diag-state-url"),
|
||||
@ -597,6 +628,7 @@ async function readBrowserStats(page) {
|
||||
acceptanceLatency: text("#diag-acceptance-latency"),
|
||||
binding: text("#diag-binding"),
|
||||
physicsTiers: text("#diag-physics-tiers"),
|
||||
builderPhysics: text("#diag-builder-physics"),
|
||||
assets: text("#diag-assets"),
|
||||
status: text("#diagnostics-status"),
|
||||
},
|
||||
@ -850,17 +882,21 @@ async function exportAcceptanceArtifacts(page) {
|
||||
const packageObjectCount = Number(packageJson?.stats?.objectCount ?? 0);
|
||||
const packageControlUrl = packageJson?.diagnostics?.controlUrl;
|
||||
const packagePhysics = packageJson?.diagnostics?.stats?.objectPhysics ?? {};
|
||||
const packageBuilderPhysics = packageJson?.diagnostics?.stats?.builderPhysics ?? {};
|
||||
const packageOk = packageJson?.schema === "motrixsim-web.acceptance-package.v1"
|
||||
&& packageJson?.acceptance?.state === "pass"
|
||||
&& packageJson?.acceptance?.failCount === 0
|
||||
&& packageObjectCount >= thresholds.minObjects
|
||||
&& Number(packagePhysics.backendDynamic ?? 0) >= 4
|
||||
&& Number(packagePhysics.backendFixed ?? 0) >= 1
|
||||
&& Number(packageBuilderPhysics.backendDynamic ?? 0) >= 4
|
||||
&& Number(packageBuilderPhysics.visualOnly ?? Number.POSITIVE_INFINITY) === 0
|
||||
&& packageBuilderPhysics.ready === true
|
||||
&& String(packageControlUrl ?? "").includes("/control");
|
||||
check(
|
||||
"browser-acceptance-package-export",
|
||||
packageOk,
|
||||
`${packageDownload.suggestedFilename}; state=${packageJson?.acceptance?.state}; objects=${packageObjectCount}; dynamic=${packagePhysics.backendDynamic ?? "-"}; fixed=${packagePhysics.backendFixed ?? "-"}; control=${packageControlUrl ?? "-"}`,
|
||||
`${packageDownload.suggestedFilename}; state=${packageJson?.acceptance?.state}; objects=${packageObjectCount}; dynamic=${packagePhysics.backendDynamic ?? "-"}; fixed=${packagePhysics.backendFixed ?? "-"}; builderDynamic=${packageBuilderPhysics.backendDynamic ?? "-"}; builderVisual=${packageBuilderPhysics.visualOnly ?? "-"}; control=${packageControlUrl ?? "-"}`,
|
||||
);
|
||||
|
||||
const reportDownload = await clickAndSaveDownload(
|
||||
@ -896,6 +932,7 @@ async function exportAcceptanceArtifacts(page) {
|
||||
objectCount: packageObjectCount,
|
||||
controlUrl: packageControlUrl,
|
||||
objectPhysics: packagePhysics,
|
||||
builderPhysics: packageBuilderPhysics,
|
||||
},
|
||||
report: {
|
||||
...reportDownload,
|
||||
@ -1046,12 +1083,15 @@ async function exportBuilderConfigArtifact(page) {
|
||||
&& config?.sceneId === "g1-store-blocks-physics"
|
||||
&& Array.isArray(config?.props)
|
||||
&& config.props.length >= 4
|
||||
&& config?.physics?.ready === true
|
||||
&& Number(config?.physics?.backendDynamic ?? 0) >= 4
|
||||
&& Number(config?.physics?.visualOnly ?? Number.POSITIVE_INFINITY) === 0
|
||||
&& /motrixsim-scene-.*\.json$/i.test(download.suggestedFilename)
|
||||
&& /配置已导出|config exported/i.test(workspaceStatus);
|
||||
check(
|
||||
"browser-builder-config-export",
|
||||
exportOk,
|
||||
`${download.suggestedFilename}; props=${config?.props?.length ?? "-"}; scene=${config?.sceneId ?? "-"}; status=${workspaceStatus}`,
|
||||
`${download.suggestedFilename}; props=${config?.props?.length ?? "-"}; scene=${config?.sceneId ?? "-"}; builderDynamic=${config?.physics?.backendDynamic ?? "-"}; builderVisual=${config?.physics?.visualOnly ?? "-"}; status=${workspaceStatus}`,
|
||||
);
|
||||
return {
|
||||
...download,
|
||||
@ -1060,6 +1100,7 @@ async function exportBuilderConfigArtifact(page) {
|
||||
sceneId: config?.sceneId,
|
||||
robotId: config?.robotId,
|
||||
propCount: config?.props?.length,
|
||||
physics: config?.physics,
|
||||
workspaceStatus,
|
||||
};
|
||||
}
|
||||
@ -1281,6 +1322,52 @@ async function controlThroughUi(page, selector, expectedPaused) {
|
||||
return { clickMs, backend, dom: { ...dom, clickMs }, expectedPaused };
|
||||
}
|
||||
|
||||
async function verifyVisualOnlyBoundary(browser) {
|
||||
const context = await browser.newContext({ viewport: { width: 1440, height: 820 }, deviceScaleFactor: 1 });
|
||||
await context.addInitScript(() => {
|
||||
window.localStorage.removeItem("motrixsim-web-locale");
|
||||
window.localStorage.removeItem("motrixsim-web-builder-draft");
|
||||
});
|
||||
const page = await context.newPage();
|
||||
try {
|
||||
await page.goto(frontendUrl.href, { waitUntil: "domcontentloaded" });
|
||||
await waitForProductScene(page);
|
||||
await page.setInputFiles(
|
||||
"#asset-upload-file",
|
||||
[path.join(rootDir, "research-tests/product-acceptance/local-upload-fixture/meshes/tri.obj")],
|
||||
);
|
||||
await page.waitForFunction(() => (
|
||||
Array.from(document.querySelectorAll("[data-add-preset]"))
|
||||
.some((element) => element.dataset.addPreset?.startsWith("prop-uploaded-"))
|
||||
), undefined, { timeout: thresholds.browserReadyMs });
|
||||
await page.locator('[data-add-preset^="prop-uploaded-"]').first().click();
|
||||
await page.waitForFunction(() => {
|
||||
const data = document.documentElement.dataset;
|
||||
const visualOnly = Number(data.builderVisualOnly ?? 0);
|
||||
const status = document.querySelector("#builder-status")?.textContent ?? "";
|
||||
return visualOnly > 0 && !/组合中|composing/i.test(status);
|
||||
}, undefined, { polling: 100, timeout: thresholds.browserReadyMs });
|
||||
const acceptance = await runAcceptanceReview(page);
|
||||
const stats = await readBrowserStats(page);
|
||||
const screenshot = await safeScreenshot(
|
||||
"browser-visual-only-boundary-screenshot",
|
||||
page,
|
||||
path.join(outDir, "product-readiness-visual-only-boundary.jpg"),
|
||||
{ preferPreview: true },
|
||||
);
|
||||
const visualOnly = stats.builderPhysics?.visualOnly ?? 0;
|
||||
const failCount = stats.acceptanceTelemetry.failCount ?? 0;
|
||||
check(
|
||||
"browser-visual-only-boundary",
|
||||
visualOnly > 0 && stats.acceptanceTelemetry.state === "fail" && failCount > 0,
|
||||
`builderVisual=${visualOnly}; builderDynamic=${stats.builderPhysics?.backendDynamic ?? "-"}; acceptance=${stats.acceptanceScore}; ${stats.diagnostics.builderPhysics}`,
|
||||
);
|
||||
return { acceptance, stats, screenshot };
|
||||
} finally {
|
||||
await closeContext(context, "visual-only-boundary-context");
|
||||
}
|
||||
}
|
||||
|
||||
async function verifyBrowser() {
|
||||
await postControl("pause");
|
||||
const browser = await chromium.launch({ headless: true });
|
||||
@ -1314,6 +1401,11 @@ async function verifyBrowser() {
|
||||
logProgress("config import restore done");
|
||||
await postControl("pause");
|
||||
|
||||
logProgress("visual-only boundary start");
|
||||
const visualOnlyBoundary = await verifyVisualOnlyBoundary(browser);
|
||||
logProgress("visual-only boundary done");
|
||||
await postControl("pause");
|
||||
|
||||
logProgress("desktop acceptance start");
|
||||
const desktopContext = await browser.newContext({ viewport: { width: 1440, height: 820 }, deviceScaleFactor: 1, acceptDownloads: true });
|
||||
await desktopContext.addInitScript(() => {
|
||||
@ -1356,11 +1448,15 @@ async function verifyBrowser() {
|
||||
const fallbackCount = numericText(desktopStats.fallbacks);
|
||||
const pixelCount = numericText(desktopStats.pixels);
|
||||
const physicsTiers = desktopStats.physicsTiers ?? {};
|
||||
const builderPhysics = desktopStats.builderPhysics ?? {};
|
||||
const physicsTierVisualBudget = Math.max(1, objectCount - bindingCount);
|
||||
const physicsTierOk = (physicsTiers.backendDynamic ?? 0) >= 4
|
||||
&& (physicsTiers.backendFixed ?? 0) >= 1
|
||||
&& (physicsTiers.total ?? 0) === objectCount
|
||||
&& (physicsTiers.visualOnly ?? Number.POSITIVE_INFINITY) <= physicsTierVisualBudget;
|
||||
const builderPhysicsOk = (builderPhysics.backendDynamic ?? 0) >= 4
|
||||
&& (builderPhysics.visualOnly ?? Number.POSITIVE_INFINITY) === 0
|
||||
&& builderPhysics.ready === true;
|
||||
const sourceLabel = `${desktopStats.sourceLabel} ${desktopStats.projectSource}`;
|
||||
const acceptancePassed = acceptanceScoreHasNoFailures(desktopStats.acceptanceScore);
|
||||
const mobileAcceptancePassed = acceptanceScoreHasNoFailures(mobileStats.acceptanceScore);
|
||||
@ -1389,6 +1485,11 @@ async function verifyBrowser() {
|
||||
physicsTierOk,
|
||||
`dynamic=${physicsTiers.backendDynamic ?? "-"} fixed=${physicsTiers.backendFixed ?? "-"} state=${physicsTiers.backendStateOnly ?? "-"} visual=${physicsTiers.visualOnly ?? "-"} total=${physicsTiers.total ?? "-"} budget=${physicsTierVisualBudget}; ${desktopStats.diagnostics.physicsTiers}`,
|
||||
);
|
||||
check(
|
||||
"browser-builder-physics-coverage",
|
||||
builderPhysicsOk,
|
||||
`builderDynamic=${builderPhysics.backendDynamic ?? "-"} builderVisual=${builderPhysics.visualOnly ?? "-"} total=${builderPhysics.total ?? "-"} ready=${builderPhysics.ready}; ${desktopStats.diagnostics.builderPhysics}`,
|
||||
);
|
||||
check(
|
||||
"browser-builder-compose-ui",
|
||||
/后端物理组合|physical backend composed/i.test(builderCompose.builderStatus)
|
||||
@ -1410,6 +1511,7 @@ async function verifyBrowser() {
|
||||
&& desktopStats.diagnostics.source.includes("外部仿真")
|
||||
&& desktopStats.diagnostics.binding.includes(String(bindingCount))
|
||||
&& desktopStats.diagnostics.physicsTiers.includes(String(physicsTiers.backendDynamic ?? ""))
|
||||
&& desktopStats.diagnostics.builderPhysics.includes(String(builderPhysics.backendDynamic ?? ""))
|
||||
&& desktopStats.diagnostics.assets.includes(String(meshCount)),
|
||||
JSON.stringify(desktopStats.diagnostics),
|
||||
);
|
||||
@ -1433,6 +1535,7 @@ async function verifyBrowser() {
|
||||
shareLink,
|
||||
shareRestore,
|
||||
configImportRestore,
|
||||
visualOnlyBoundary,
|
||||
controlTimings: { resume: resumeControl, pause: pauseControl },
|
||||
acceptanceTimings: { desktop: desktopAcceptance, mobile: mobileAcceptance },
|
||||
paused,
|
||||
@ -1445,6 +1548,7 @@ async function verifyBrowser() {
|
||||
builderCompose: builderComposeScreenshot,
|
||||
shareRestore: shareRestore.screenshot,
|
||||
configImportRestore: configImportRestore.screenshot,
|
||||
visualOnlyBoundary: visualOnlyBoundary.screenshot,
|
||||
desktop: desktopScreenshot,
|
||||
mobile: mobileScreenshot,
|
||||
},
|
||||
|
||||
@ -43,6 +43,7 @@ export type MessageKey =
|
||||
| "label.physicsMode"
|
||||
| "label.physicalObjects"
|
||||
| "label.physicsTiers"
|
||||
| "label.builderPhysics"
|
||||
| "label.position"
|
||||
| "label.selectedObject"
|
||||
| "label.backend"
|
||||
@ -267,6 +268,7 @@ export type MessageKey =
|
||||
| "acceptance.check.pixels"
|
||||
| "acceptance.check.physics"
|
||||
| "acceptance.check.physicsTiers"
|
||||
| "acceptance.check.builderPhysics"
|
||||
| "acceptance.check.report"
|
||||
| "acceptance.detail.manifestOk"
|
||||
| "acceptance.detail.manifestPending"
|
||||
@ -430,6 +432,7 @@ const messages: Record<Locale, Messages> = {
|
||||
"label.physicsMode": "运行模式",
|
||||
"label.physicalObjects": "真实物理对象",
|
||||
"label.physicsTiers": "对象物理分层",
|
||||
"label.builderPhysics": "添加物体物理",
|
||||
"label.position": "位置",
|
||||
"label.selectedObject": "选中对象",
|
||||
"label.backend": "后端",
|
||||
@ -654,6 +657,7 @@ const messages: Record<Locale, Messages> = {
|
||||
"acceptance.check.pixels": "画面可见",
|
||||
"acceptance.check.physics": "物理链路",
|
||||
"acceptance.check.physicsTiers": "对象物理分层",
|
||||
"acceptance.check.builderPhysics": "添加物体真实绑定",
|
||||
"acceptance.check.report": "验收摘要",
|
||||
"acceptance.detail.manifestOk": "已加载 {name}",
|
||||
"acceptance.detail.manifestPending": "尚未完成 manifest 加载",
|
||||
@ -810,6 +814,7 @@ const messages: Record<Locale, Messages> = {
|
||||
"label.physicsMode": "Mode",
|
||||
"label.physicalObjects": "Real physics objects",
|
||||
"label.physicsTiers": "Object physics tiers",
|
||||
"label.builderPhysics": "Added object physics",
|
||||
"label.position": "Position",
|
||||
"placeholder.noScene": "No scene uploaded",
|
||||
"label.selectedObject": "Selected object",
|
||||
@ -1034,6 +1039,7 @@ const messages: Record<Locale, Messages> = {
|
||||
"acceptance.check.pixels": "Visible render",
|
||||
"acceptance.check.physics": "Physics path",
|
||||
"acceptance.check.physicsTiers": "Object physics tiers",
|
||||
"acceptance.check.builderPhysics": "Added object real bindings",
|
||||
"acceptance.check.report": "Acceptance summary",
|
||||
"acceptance.detail.manifestOk": "loaded {name}",
|
||||
"acceptance.detail.manifestPending": "manifest has not finished loading",
|
||||
|
||||
64
src/main.ts
64
src/main.ts
@ -72,6 +72,13 @@ interface BuilderConfig {
|
||||
sceneId: string;
|
||||
robotId: string;
|
||||
robotPose: Vec3;
|
||||
physics?: {
|
||||
objectPolicy: "backend-dynamic-only";
|
||||
backendDynamic: number;
|
||||
visualOnly: number;
|
||||
total: number;
|
||||
ready: boolean;
|
||||
};
|
||||
props: Array<{
|
||||
presetId: string;
|
||||
position: Vec3;
|
||||
@ -151,6 +158,7 @@ interface RuntimeDiagnostics {
|
||||
objects: number;
|
||||
bodyBindings: number;
|
||||
objectPhysics: ObjectPhysicsProfile;
|
||||
builderPhysics: BuilderPhysicsProfile;
|
||||
editableGroups: number;
|
||||
groupedObjects: number;
|
||||
meshes: number;
|
||||
@ -194,6 +202,13 @@ interface ObjectPhysicsProfile {
|
||||
total: number;
|
||||
}
|
||||
|
||||
interface BuilderPhysicsProfile {
|
||||
backendDynamic: number;
|
||||
visualOnly: number;
|
||||
total: number;
|
||||
ready: boolean;
|
||||
}
|
||||
|
||||
function manifestPhysicsRole(object: PreviewObject): NonNullable<PreviewObject["physics"]> | undefined {
|
||||
return object.physics;
|
||||
}
|
||||
@ -604,6 +619,7 @@ document.querySelector<HTMLDivElement>("#app")!.innerHTML = `
|
||||
<dt data-i18n="label.acceptanceLatency">${t("label.acceptanceLatency")}</dt><dd id="diag-acceptance-latency">-</dd>
|
||||
<dt data-i18n="label.realBinding">${t("label.realBinding")}</dt><dd id="diag-binding">-</dd>
|
||||
<dt data-i18n="label.physicsTiers">${t("label.physicsTiers")}</dt><dd id="diag-physics-tiers">-</dd>
|
||||
<dt data-i18n="label.builderPhysics">${t("label.builderPhysics")}</dt><dd id="diag-builder-physics">-</dd>
|
||||
<dt data-i18n="label.assetHealth">${t("label.assetHealth")}</dt><dd id="diag-assets">-</dd>
|
||||
</dl>
|
||||
<div class="button-row single">
|
||||
@ -1807,6 +1823,22 @@ function builderPropPhysicsLabel(item: BuilderProp): string {
|
||||
return builderPropPhysicsClass(item) === "dynamic" ? t("physicsTier.backendDynamic") : t("physicsTier.visualOnly");
|
||||
}
|
||||
|
||||
function builderPhysicsProfile(): BuilderPhysicsProfile {
|
||||
const backendDynamic = builderProps.filter((item) => builderPropPhysicsClass(item) === "dynamic").length;
|
||||
const total = builderProps.length;
|
||||
const visualOnly = total - backendDynamic;
|
||||
return {
|
||||
backendDynamic,
|
||||
visualOnly,
|
||||
total,
|
||||
ready: visualOnly === 0,
|
||||
};
|
||||
}
|
||||
|
||||
function builderPhysicsProfileLabel(profile = builderPhysicsProfile()): string {
|
||||
return `${t("label.addedObjects")} ${profile.total}: ${t("physicsTier.backendDynamic")} ${profile.backendDynamic} / ${t("physicsTier.visualOnly")} ${profile.visualOnly}`;
|
||||
}
|
||||
|
||||
function renderBuilderSummary(): void {
|
||||
const scenePreset = selectedScenePreset();
|
||||
const robotPreset = selectedRobotPreset();
|
||||
@ -2042,6 +2074,7 @@ function currentAcceptanceChecks(): AcceptanceCheck[] {
|
||||
const stats = previewer.getStats();
|
||||
const health = healthSummary();
|
||||
const physicsProfile = objectPhysicsProfile();
|
||||
const builderPhysics = builderPhysicsProfile();
|
||||
const manifestAvailable = stats.manifestName !== "none" && stats.objectCount > 0 && manifestInput.value.trim().length > 0;
|
||||
const hasUsefulMeshes = stats.loadedMeshCount > 0 || stats.objectCount > 0;
|
||||
const reportText = document.querySelector<HTMLTextAreaElement>("#workflow-report-text")?.value.trim() ?? "";
|
||||
@ -2106,6 +2139,18 @@ function currentAcceptanceChecks(): AcceptanceCheck[] {
|
||||
: "warn"
|
||||
: "warn",
|
||||
},
|
||||
{
|
||||
id: "builder-physics",
|
||||
label: t("acceptance.check.builderPhysics"),
|
||||
detail: builderPhysicsProfileLabel(builderPhysics),
|
||||
state: health.hasBackendPhysics
|
||||
? builderPhysics.ready
|
||||
? "pass"
|
||||
: "fail"
|
||||
: builderPhysics.total === 0
|
||||
? "warn"
|
||||
: "fail",
|
||||
},
|
||||
{
|
||||
id: "report",
|
||||
label: t("acceptance.check.report"),
|
||||
@ -2170,7 +2215,7 @@ function currentAcceptanceCases(checks = currentAcceptanceChecks()): AcceptanceC
|
||||
id: "backend",
|
||||
titleKey: "acceptance.case.backend.title",
|
||||
goalKey: "acceptance.case.backend.goal",
|
||||
checks: pick("backend", "physics", "physics-tiers"),
|
||||
checks: pick("backend", "physics", "physics-tiers", "builder-physics"),
|
||||
},
|
||||
{
|
||||
id: "control",
|
||||
@ -2329,6 +2374,7 @@ function currentRuntimeDiagnostics(): RuntimeDiagnostics {
|
||||
const stats = previewer.getStats();
|
||||
const entry = latestControlTelemetry();
|
||||
const physicsProfile = objectPhysicsProfile();
|
||||
const builderPhysics = builderPhysicsProfile();
|
||||
return {
|
||||
schema: "motrixsim-web.runtime-diagnostics.v1",
|
||||
capturedAt: new Date().toISOString(),
|
||||
@ -2344,6 +2390,7 @@ function currentRuntimeDiagnostics(): RuntimeDiagnostics {
|
||||
objects: stats.objectCount,
|
||||
bodyBindings: stats.bodyBoundObjectCount,
|
||||
objectPhysics: physicsProfile,
|
||||
builderPhysics,
|
||||
editableGroups: stats.editableGroupCount,
|
||||
groupedObjects: stats.groupedObjectCount,
|
||||
meshes: stats.loadedMeshCount,
|
||||
@ -2393,6 +2440,7 @@ function currentDiagnosticsReport(): string {
|
||||
`${t("label.acceptanceLatency")}: ${acceptanceLatencySummary()}`,
|
||||
`${t("label.realBinding")}: ${diagnostics.stats.bodyBindings}/${diagnostics.stats.objects}; groups ${diagnostics.stats.editableGroups}/${diagnostics.stats.groupedObjects}`,
|
||||
`${t("label.physicsTiers")}: ${objectPhysicsProfileLabel(diagnostics.stats.objectPhysics)}`,
|
||||
`${t("label.builderPhysics")}: ${builderPhysicsProfileLabel(diagnostics.stats.builderPhysics)}`,
|
||||
`${t("label.assetHealth")}: meshes ${diagnostics.stats.meshes}; fallbacks ${diagnostics.stats.fallbacks}; pixels ${diagnostics.stats.nonBackgroundPixelSamples}`,
|
||||
].join("\n");
|
||||
}
|
||||
@ -2405,6 +2453,10 @@ function renderDiagnosticsPanel(): void {
|
||||
data.physicsBackendStateOnly = String(diagnostics.stats.objectPhysics.backendStateOnly);
|
||||
data.physicsVisualOnly = String(diagnostics.stats.objectPhysics.visualOnly);
|
||||
data.physicsTotalObjects = String(diagnostics.stats.objectPhysics.total);
|
||||
data.builderBackendDynamic = String(diagnostics.stats.builderPhysics.backendDynamic);
|
||||
data.builderVisualOnly = String(diagnostics.stats.builderPhysics.visualOnly);
|
||||
data.builderTotalObjects = String(diagnostics.stats.builderPhysics.total);
|
||||
data.builderPhysicsReady = String(diagnostics.stats.builderPhysics.ready);
|
||||
setText("#diag-manifest-url", diagnostics.manifestUrl);
|
||||
setText("#diag-state-url", endpointLabel(diagnostics.stateUrl));
|
||||
setText("#diag-control-url", endpointLabel(diagnostics.controlUrl));
|
||||
@ -2417,6 +2469,7 @@ function renderDiagnosticsPanel(): void {
|
||||
`${diagnostics.stats.bodyBindings}/${diagnostics.stats.objects}; ${diagnostics.stats.editableGroups}/${diagnostics.stats.groupedObjects}`,
|
||||
);
|
||||
setText("#diag-physics-tiers", objectPhysicsProfileLabel(diagnostics.stats.objectPhysics));
|
||||
setText("#diag-builder-physics", builderPhysicsProfileLabel(diagnostics.stats.builderPhysics));
|
||||
setText(
|
||||
"#diag-assets",
|
||||
`mesh ${diagnostics.stats.meshes}; fallback ${diagnostics.stats.fallbacks}; pixels ${diagnostics.stats.nonBackgroundPixelSamples}`,
|
||||
@ -2458,6 +2511,7 @@ function currentWorkflowReport(): string {
|
||||
`${t("label.objects")}: ${stats.objectCount}`,
|
||||
`${t("label.editableGroups")}: ${stats.editableGroupCount} / ${stats.groupedObjectCount}`,
|
||||
`${t("label.physicsTiers")}: ${objectPhysicsProfileLabel(physicsProfile)}`,
|
||||
`${t("label.builderPhysics")}: ${builderPhysicsProfileLabel()}`,
|
||||
`${t("label.meshes")}: ${stats.loadedMeshCount}`,
|
||||
`${t("label.pixelCheck")}: ${stats.nonBackgroundPixelSamples ?? 0}`,
|
||||
`${t("label.runState")}: ${runStateLabel()}`,
|
||||
@ -2887,11 +2941,19 @@ function renderBuilderPhysicsGuard(): void {
|
||||
}
|
||||
|
||||
function builderConfig(): BuilderConfig {
|
||||
const physics = builderPhysicsProfile();
|
||||
return {
|
||||
version: 1,
|
||||
sceneId: selectedScenePreset().id,
|
||||
robotId: selectedRobotPreset().id,
|
||||
robotPose: [...builderRobotPose] as Vec3,
|
||||
physics: {
|
||||
objectPolicy: "backend-dynamic-only",
|
||||
backendDynamic: physics.backendDynamic,
|
||||
visualOnly: physics.visualOnly,
|
||||
total: physics.total,
|
||||
ready: physics.ready,
|
||||
},
|
||||
props: builderProps.map((item) => ({
|
||||
presetId: item.presetId,
|
||||
position: [...item.position] as Vec3,
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user