第 6 组：源码链接、构建和文档约束闭环完成

2026-06-01 06:11:08 +08:00
parent 1498d9830d
commit 4c55ab3435
43 changed files with 8414 additions and 636 deletions
--- a/web/test-browser-wasm-smoke-opfs-mirror-sections.js
+++ b/web/test-browser-wasm-smoke-opfs-mirror-sections.js
@@ -0,0 +1,76 @@
+export async function runBrowserOpfsMirrorSections(context, simulator) {
+  const {
+    expectMissingWasmPath,
+    expectText,
+    runSection,
+  } = context;
+
+  await runSection("opfs wasm mirror persist file", async () => {
+    const wasmPath = simulator.fs.opfs.resolvePath("programs/browser-smoke.ngc");
+    const wasmDecoded = new TextDecoder().decode(simulator.fs.module.FS.readFile(wasmPath));
+    expectText(wasmDecoded, "G21 G90\nG0 X1\n", "OPFS file was not mirrored into the WASM filesystem");
+    const persistedPath = simulator.fs.opfs.resolvePath("programs/browser-persisted.ngc");
+    simulator.fs.module.FS.writeFile(persistedPath, new TextEncoder().encode("G21 G90\nG0 X2\n"));
+    const persisted = new TextDecoder().decode(await simulator.fs.opfs.persistFile("programs/browser-persisted.ngc"));
+    expectText(persisted, "G21 G90\nG0 X2\n", "WASM filesystem file was not persisted into OPFS");
+    const persistedDecoded = new TextDecoder().decode(
+      await simulator.fs.opfs.readFile("programs/browser-persisted.ngc"),
+    );
+    expectText(persistedDecoded, "G21 G90\nG0 X2\n",
+      "persisted WASM filesystem file was not readable from OPFS");
+  });
+
+  await runSection("opfs copy and move mirror files", async () => {
+    // LinuxCNC source basis: rs274ngc_pre.cc save_parameters()
+    // links the current parameter file to filename + ".bak", then
+    // writes filename + ".new" and renames it over the parameter file.
+    await simulator.fs.opfs.writeFile("parameters/move-main.var", "5161\t1.000000\n");
+    const copiedParameterBackup = new TextDecoder().decode(
+      await simulator.fs.opfs.copyFile("parameters/move-main.var", "parameters/move-main.var.bak"),
+    );
+    expectText(copiedParameterBackup, "5161\t1.000000\n",
+      "OPFS copyFile did not return the copied file contents");
+    const copiedParameterBackupFile = new TextDecoder().decode(
+      await simulator.fs.opfs.readFile("parameters/move-main.var.bak"),
+    );
+    expectText(copiedParameterBackupFile, "5161\t1.000000\n",
+      "OPFS copyFile did not create the backup file");
+    const copiedParameterBackupWasmPath = simulator.fs.opfs.resolvePath("parameters/move-main.var.bak");
+    const copiedParameterBackupWasm = new TextDecoder().decode(
+      simulator.fs.module.FS.readFile(copiedParameterBackupWasmPath),
+    );
+    expectText(copiedParameterBackupWasm, "5161\t1.000000\n",
+      "OPFS copyFile did not update the WASM mirror destination");
+    await simulator.fs.opfs.writeFile("parameters/move-main.var.new", "5161\t2.000000\n");
+    await simulator.fs.opfs.moveFile("parameters/move-main.var.new", "parameters/move-main.var");
+    const movedParameterFile = new TextDecoder().decode(
+      await simulator.fs.opfs.readFile("parameters/move-main.var"),
+    );
+    expectText(movedParameterFile, "5161\t2.000000\n",
+      "OPFS moveFile did not replace the destination file");
+    if (await simulator.fs.opfs.exists("parameters/move-main.var.new")) {
+      throw new Error("OPFS moveFile left the source file behind");
+    }
+    const movedParameterWasmPath = simulator.fs.opfs.resolvePath("parameters/move-main.var");
+    const movedParameterWasm = new TextDecoder().decode(
+      simulator.fs.module.FS.readFile(movedParameterWasmPath),
+    );
+    expectText(movedParameterWasm, "5161\t2.000000\n",
+      "OPFS moveFile did not update the WASM mirror destination");
+    const movedTemporaryWasmPath = simulator.fs.opfs.resolvePath("parameters/move-main.var.new");
+    expectMissingWasmPath(
+      () => simulator.fs.module.FS.stat(movedTemporaryWasmPath),
+      "OPFS moveFile left the WASM mirror source behind",
+    );
+  });
+
+  await runSection("opfs write truncates wasm mirror", async () => {
+    await simulator.fs.opfs.writeFile("programs/truncate.ngc", "G21 G90\nG0 X12345\nM30\n");
+    await simulator.fs.opfs.writeFile("programs/truncate.ngc", "G21\n");
+    const truncatedProgram = new TextDecoder().decode(await simulator.fs.opfs.readFile("programs/truncate.ngc"));
+    expectText(truncatedProgram, "G21\n", "OPFS writeFile did not truncate stale program bytes");
+    const truncatedWasmPath = simulator.fs.opfs.resolvePath("programs/truncate.ngc");
+    const truncatedWasmProgram = new TextDecoder().decode(simulator.fs.module.FS.readFile(truncatedWasmPath));
+    expectText(truncatedWasmProgram, "G21\n", "OPFS writeFile did not truncate the WASM mirror");
+  });
+}