7f45abe93c
结论：未扩展 smoke 功能行为，仅收紧 OPFS workspace、directory、policy 浏览器烟测和 source-map 守卫。 LinuxCNC 来源依据：src/emc/rs274ngc/rs274ngc_pre.cc 的 restore_parameters/save_parameters/read_text 参数文件与文件读取语义，以及 interp_internal.hh 的 rs274ngc.var/.bak 常量边界。 检查通过：./check-linuxcnc-opfs-source-map.sh；./check-linuxcnc-wasm-smoke-source-map.sh；./check-linuxcnc-workstreams-source-map.sh；./test-native.sh；./test-linuxcnc-source-link.sh。
3.2 KiB
3.2 KiB
LinuxCNC OPFS source map
This map records the source basis for browser-side LinuxCNC parameter-file persistence. It is a policy and bridge map only; it must not add independent filesystem behavior or expand the temporary smoke parser.
LinuxCNC Source Basis
src/emc/rs274ngc/interp_internal.hhdefinesRS274NGC_PARAMETER_FILE_NAME_DEFAULTasrs274ngc.var.src/emc/rs274ngc/interp_internal.hhdefinesRS274NGC_PARAMETER_FILE_BACKUP_SUFFIXas.bak.src/emc/rs274ngc/rs274ngc_pre.ccimplementsInterp::restore_parameters()for parameter-file reads.src/emc/rs274ngc/rs274ngc_pre.ccimplementsInterp::save_parameters()forfilename + ".new", backup, and replacement writes.src/emc/rs274ngc/rs274ngc_pre.ccunlinksfilename + ".bak", links the previous parameter file to that backup path, then renamesfilename + ".new"over the configured parameter file.
OPFS Coverage
| Entry | Boundary |
|---|---|
web/src/wasm-core.js |
Keeps LinuxCNC parameter restore/save bridge files under the OPFS workspace and cleans WASM scratch files. |
web/src/app.js |
Persists browser programs at programs/current.ngc and LinuxCNC parameters at parameters/rs274ngc.var. |
web/test-browser-wasm-smoke-opfs-basic-sections.js |
Verifies OPFS program file reads through LinuxCNC read_text() and rejects unsafe paths. |
web/test-browser-wasm-smoke-opfs-parameter-sections.js |
Verifies OPFS parameter restore, save, .new, .bak, failure, and stale-state semantics. |
web/test-browser-wasm-smoke-opfs-workspace-sections.js |
Aggregates OPFS basic, parameter, mirror, and directory checks under browser OPFS availability. |
web/test-browser-wasm-smoke-opfs-mirror-sections.js |
Verifies OPFS/WASM mirror persistence used by source-backed file parsing and parameter movement. |
web/test-browser-wasm-smoke-opfs-directory-sections.js |
Verifies OPFS directory persistence and WASM mirror refresh without polluting mirrors during metadata queries. |
web/test-browser-wasm-smoke-opfs-policy-sections.js |
Verifies OPFS workspace and mount policy, including the browser rule that OPFS cannot be disabled. |
web/test-browser-wasm-smoke-app-sections.js |
Verifies app-level OPFS program, parameter, backup, and reload behavior. |
Browser Bridge Boundary
web/src/wasm-core.jsmust keep LinuxCNC parameter persistence routed through an OPFS workspace.- Browser contexts with OPFS support must not disable OPFS.
- OPFS workspace paths must remain relative paths inside the CNC workspace, and OPFS mount points must remain absolute paths inside the Emscripten filesystem.
- Browser app and wasm bridge code must not use Local Storage, IndexedDB, File Picker, Directory Picker, WebKit filesystem, or FileReader persistence paths for CNC programs, LinuxCNC parameter files, or mirrored workspace files.
web/src/app.jsmust parse browser programs throughparseFileWithParameterFile()so the program file and LinuxCNC parameter state both live under OPFS.
Checks
Run:
./check-linuxcnc-opfs-source-map.sh
./test-native.sh
./test-linuxcnc-source-link.sh
check-linuxcnc-opfs-source-map.sh keeps this document, the LinuxCNC source
anchors, and the browser bridge guardrails synchronized.