[opoeta]

What

A desktop/ folder with an Electron shell around the local build — Windows x64 for now, self-contained (own package.json; nothing in src/ changes):

• Graphics backend — Help → Hardware picks what ANGLE translates WebGL to: DirectX 11 (default), DirectX 12, Vulkan or OpenGL, and shows GPU, WebGPU, thread count, cross-origin isolation and WebNN. Applies on restart.
• Translation at run time — the page's English text is swapped from desktop/i18n/<lang>.json, node by node, and kept translated as React redraws (MutationObserver), so the app source needs no i18n plumbing. pt-BR today; the first language follows the OS, the Language menu switches. Canvas text and run-time numbers are not covered.
• Creality Scan projects — project.obp opens from menu, command line, drag & drop and the file picker, resolving to the project's result/Mesh.ply (or the newest session's Fused.ply); File → Watch Creality Scan folder… offers each new mesh the scanner writes.
• Agents on the open window — the app starts the relay itself and writes agent.json (port, token) in its user-data folder; scanruler-mcp.cmd next to the exe joins that app, so claude mcp add …scanruler-mcp.cmd drives the window the user is looking at instead of a background copy.
• File associations: .scanruler .stl .ply .obj .3mf .step .obp.

Dependencies

electron (MIT), electron-builder (MIT), puppeteer-core (Apache-2.0), dev-only. New files carry the SPDX header. Everything written from scratch.

Checks (Windows 11, Node 24)

• npm test in desktop/: smoke (isolated, 24 threads, WebGL2, WebGPU) and Creality watcher — ok
• node test/i18n.mjs — ok; node test/e2e-agent.mjs — relay connected, page reached
• Not run: CI (the root workflow does not touch desktop/), macOS/Linux packaging.

Happy to split this into smaller PRs (shell alone, then translation, Creality, agent pairing) if that is easier to review.

🤖 Generated with Claude Code

[opoeta]

Pushed a second commit: dictionaries for de, es, fr, it, ja, pt-BR and zh-CN (each file also carries the shell's menu and Hardware-panel strings; test/dicts.mjs checks them against the English keys), the graphics API shown in the window title, and the relay entry exiting when the app quits so it never takes the app's port over.

[opoeta]

Relation to #66 (Mearman's per-platform builds, tray app and installers): the two overlap only in "an Electron window on the local build, paired with the agent relay". #66 is the distribution side — detached background server, tray, installers, CI matrix across six platforms; this one is the feature side — graphics backend choice (DirectX 11/12, Vulkan, OpenGL, shown in the title and in Help → Hardware), run-time translation in seven languages, Creality Scan project.obp, and the agent attached to the open window.

To make them easier to take together I switched this PR to @electron/packager as well (electron-builder's bundled 7-Zip is LGPL — same reasoning as in #66). The features here live in their own modules (settings.js for the GPU switches, i18n.js for the page translation, creality.js for .obp, hardware.html + preload.cjs for the panel), so they can sit on top of #66's electron/main.ts shell with little change. If #66 is the shell you want, I am happy to rebase these onto it as a follow-up rather than keep a second shell.

One behavioural difference worth deciding: #66's background server outlives the window and even the tray's Quit; here the relay ends with the app (the agent entry exits once agent.json is gone), so a closed app never keeps port 7317.