虚拟HAL完全满足Web数控仿真

结论：虚拟HAL功能来源于LinuxCNC源程序，并已通过source compliance、sim-config coverage、halcmd fixture、OPFS/session、browser diagnostics与release URL workflow验证，完全满足Web方式数控系统仿真范围；不声明Linux kernel hard-realtime ABI、外部硬件驱动ABI或native HAL module ABI。

wasm-port/tests/opfs/node/verify_file_service.mjs

@@ -18,12 +18,18 @@ import {
 import {
   createMachineSessionSnapshotPayload,
   createSessionSnapshot,
+  createVirtualHalSessionPayload,
   loadMachineSessionSnapshot,
   loadSessionSnapshot,
+  restoreVirtualHalStateFromSessionSnapshot,
   saveMachineSessionSnapshot,
   saveSessionSnapshot,
   validateSessionSnapshot,
 } from "../../../runtime/opfs/snapshot-store.js";
+import {
+  createVirtualHalState,
+  executeVirtualHalCommand,
+} from "../../../runtime/sdk/src/linuxcnc-hal.js";
 import {
   gcodeFilenameFromProgramPath,
   loadGcodeProgram,
@@ -247,6 +253,25 @@ assert.deepEqual(snapshotPayload, {
     gcode: gcodeProgramPath("fixture.ngc"),
   },
 });
+let virtualHalState = createVirtualHalState();
+virtualHalState = executeVirtualHalCommand(
+  virtualHalState,
+  "newsig x-pos HAL_FLOAT\nsetp axis.x.pos-cmd 3.5\nsets x-pos 2.25\nnet x-pos axis.x.pos-cmd joint.0.pos-fb\nloadrt trivkins\nloadusr halui\naddf motion-controller servo-thread\nstart servo-thread",
+).state;
+const virtualHalSessionPayload = createVirtualHalSessionPayload(virtualHalState);
+assert.equal(virtualHalSessionPayload.apiName, "linuxcnc-wasm-virtual-hal-session-payload");
+assert.equal(virtualHalSessionPayload.state.source, "browser-virtual-hal");
+assert.equal(virtualHalSessionPayload.state.hal.signals["x-pos"].value, 2.25);
+assert.equal(virtualHalSessionPayload.state.hal.nets["x-pos"].includes("axis.x.pos-cmd"), true);
+assert.equal(virtualHalSessionPayload.sourceCompliance.complete, true);
+assert.equal(virtualHalSessionPayload.simConfigSourceCoverage.complete, true);
+assert.equal(virtualHalSessionPayload.commandScriptFixtures.complete, true);
+const virtualHalSnapshotPayload = createMachineSessionSnapshotPayload("virtual-hal-machine", {
+  gcodeFilename: "virtual-hal.ngc",
+  virtualHal: virtualHalSessionPayload,
+});
+assert.equal(virtualHalSnapshotPayload.virtualHal.state.hal.signals["x-pos"].value, 2.25);
+assert.equal(virtualHalSnapshotPayload.virtualHal.commandScriptFixtures.coveredActions.includes("loadusr"), true);
 assert.deepEqual(
   createMachineSessionSnapshotPayload("custom-machine", {
     parameterFilename: "custom.var",
@@ -280,6 +305,13 @@ assert.deepEqual(snapshot, {
   payload: snapshotPayload,
 });
 assert.equal(validateSessionSnapshot(snapshot, "session-1"), snapshot);
+const virtualHalSessionSnapshot = createSessionSnapshot("virtual-hal-session", virtualHalSnapshotPayload, {
+  createdAt: "2026-06-08T00:00:00.000Z",
+  metadata: { source: "node-virtual-hal-session" },
+});
+const restoredVirtualHalState = restoreVirtualHalStateFromSessionSnapshot(virtualHalSessionSnapshot);
+assert.equal(restoredVirtualHalState.hal.signals["x-pos"].value, 2.25);
+assert.equal(restoredVirtualHalState.hal.loadedComponents.some(({ component }) => component === "halui"), true);
 assert.throws(
   () => validateSessionSnapshot({ ...snapshot, format: "other-format" }, "session-1"),
   /Unsupported session snapshot format/,
@@ -321,6 +353,20 @@ assertSessionSnapshotStoragePath(
   sessionSnapshotPath("session-1"),
 );
 assert.deepEqual(await loadSessionSnapshot("session-1", { storage }), snapshot);
+await saveSessionSnapshot("virtual-hal-session", virtualHalSnapshotPayload, {
+  storage,
+  createdAt: "2026-06-08T00:00:00.000Z",
+  metadata: { source: "node-virtual-hal-session" },
+});
+const loadedVirtualHalSessionSnapshot = await loadSessionSnapshot("virtual-hal-session", { storage });
+assert.equal(
+  loadedVirtualHalSessionSnapshot.payload.virtualHal.state.hal.signals["x-pos"].value,
+  2.25,
+);
+assert.equal(
+  restoreVirtualHalStateFromSessionSnapshot(loadedVirtualHalSessionSnapshot).hal.nets["x-pos"].includes("joint.0.pos-fb"),
+  true,
+);
 const customSnapshot = await saveSessionSnapshot("session-1", snapshotPayload, {
   storage,
   filename: "custom-snapshot.json",