FXG Desk Windows - complete offline runtime

Install using the matching FXGDesk-Windows-*-Setup.exe, or extract the entire portable folder.
Run FXGDesk.exe. Do NOT copy only the executable to another PC.
The package includes Node, host-agent, native WebRTC module and the required VC runtime.
No npm install, system-wide Node installation or source checkout is needed.
Windows 10/11 x64 desktop; remote viewing uses the browser. HEVC hardware availability varies.

Online updating: the app checks its own release channel on launch and every 6 hours.
Open Settings > Online updates to download the complete package. Installation briefly ends remote access.
The app verifies HTTPS, exact byte size and SHA256 before closing, then installs into the same directory and restarts.
Settings/passwords/device identity remain outside the application directory.
For manual installation, fully exit the old GUI first. This installer never force-stops sharing.
First launch does not start sharing automatically; later launches restore your last sharing preference.
New devices receive a 6-digit code; existing 8-digit codes are preserved.
Wait for the server-confirmed code before connecting.
Access passwords require at least 6 characters (at most 256 UTF-8 bytes).
Device identity is created for the current Windows user, not bundled or shared between machines.
If registration fails, check the UI error, network connectivity and system date/time.
Offline runtime check: runtime\node.exe host-agent\launch.js --check

Playback: v6 encoder backpressure retained; v7 FPS/status switch included.
v8 holds the last displayed frame during temporary underruns and learns a bounded jitter cushion.
This is not a guarantee of no network stalls; frozen frames never renew control readiness.

Touch control (v9): tap once for left click; tap with two fingers for right click.
The right click is placed at the midpoint of the two initial contacts.
One-finger movement or holding starts a left-button drag.
Two-finger swipes, pinches, long holds and three-finger gestures do not click.
Touch gestures are cancelled on lost control, page hiding and stream replacement.

Settings/passwords/identity are not removed by uninstall. Existing server downloads remain available for rollback.
Build identity is displayed in Settings > About and exported diagnostic logs.
This preview installer is unsigned; verify its SHA256 against the release SHA256SUMS.txt.

Unified Windows release (0.1.7+):
- Source-linked, in-process FRP is compiled into FXGDesk.exe. No frpc.exe or FRP DLL is required.
- The Windows GUI is FRP Internet-only. Port, LAN/VPN and DataChannel selectors are not shown.
- FRP mode uses an authenticated memory Desk; it does not listen on local TCP 8787.
- The bundled Node/WebRTC runtime is retained for standalone CLI/legacy compatibility, not the FRP-only GUI.
- Clipboard: explicit text send/read and remote PNG read/download. Not background monitoring.
- Clipboard HTTP access requires the authenticated session that currently owns control.
- Desktop audio: default playback-device loopback, AAC/fMP4. Disabled until explicitly enabled.
- Multi-viewer: at most 16 authenticated viewers and one input owner; spectators never auto-take control.
Use release.json or FXGDesk.exe --version-json to verify all compiled feature flags before distributing.

Installation/update behavior (0.1.8+ NSIS installer):
- Clicking Install requests the FXGDesk.exe in the selected installation folder to exit.
- The welcome/directory pages alone do not interrupt sharing.
- Current releases use local IPC; verified official 0.1.6/0.1.7 binaries use tray Quit.
- Sharing/input/FRP cleanup completes before executable files are replaced.
- There is a 30-second bounded wait. Hung apps, unknown legacy binaries, or locked
  runtimes stop installation without replacing the payload. No force-kill is used.
- Only the selected installation is targeted, not other portable copies by name.
- User settings, protected password, device identity and saved sharing intent are retained.
- Interactive installs leave Launch unchecked; silent updates restart via the update helper.
- Exit codes: 10 timeout, 11 unsupported legacy quit interface, 12 locked/inaccessible
  files or helper failure, 20 another installer/installation-guard failure.
- Shutdown log: %LOCALAPPDATA%\FXGDesk\updates\installer-shutdown.log

Video compatibility (0.1.11 test release):
- Auto prefers HEVC hardware, then H.264. H.264 tries hardware then the Windows
  Media Foundation software encoder; it does not require HEVC in a virtual machine.
- Settings > Advanced video settings: "H.264" + "CPU software encoding" forces the VM-compatible path. Stop sharing
  before changing host settings, then start sharing and reconnect the viewer.
- Browser selectors: Auto / HEVC / H.264 / manual JPEG. Automatic JPEG fallback
  remains disabled. Explicit HEVC/H.264 failure stops video safely instead of
  pretending another codec is in use. VP8/VP9 encoders are NOT included yet.
- Status/diagnostics show the actual codec and hardware/software encoder. Software
  decoding is allowed for H.264. Actual profile/resolution support is checked.
- Start VM testing at 1280px / 30fps; try 20fps if the VM's CPU is saturated.
  30fps is a target, NOT a performance guarantee. WGC capture must work too.
- The package is Windows x64. VMware Fusion Windows ARM guests and macOS guests
  have NOT been validated by this Windows release.
- Concurrent viewers share one compressed video codec. A second viewer cannot
  switch an existing viewer from HEVC to H.264 (or the reverse).
- Includes the missing-input-helper fast path, detailed pipeline/control timings,
  and a fix for future scheduling debt when returning from control-first single
  polling to three-frame prefetch. Normal playback does not seek to drop frames.
- Local diagnostic CLI: smalldesk-windows.exe --codec h264 --encoder software
  --port 8052 --fps 30 --jpeg-width 1280 (choose an unused port >=8050).
- Synthetic encoder probe: FXGDesk.exe --probe-encoder software --probe-codec h264.
  This tests synthetic pixels only; it does not enable sharing or inject input.
- This build is a local test deliverable; production downloads/DC/TURN settings
  are unchanged until a separate deployment is approved.

Compact Windows GUI (0.1.13 test release):
- Home shows only device ID, access password, show/copy actions, connection status and start/stop sharing.
- The top-right Settings button contains password preferences, video/audio, updates, administrator control,
  connection diagnostics and About. Back and the Chinese/English toggle stay visible while scrolling.
- Opening Settings or switching language does not interrupt sharing. Access/video options are locked while sharing.
- Home copies an access link only after the Internet entry is ready and no sharing error is present.
- The tray copy action also copies the verified Internet entry, never a local-loopback address.
- GUI --port / --lan / --transport and their environment overrides no longer enable legacy modes.
- Default window: 480 x 560; minimum: 440 x 520. Chinese/English choice is remembered for the current user.

Control/video decoupling (0.1.14 test release):
- Starting/stopping/taking over control does not change video prefetch or the
  configured encoder FPS. All viewers keep independent bounded media consumption.
- The default video window stays at up to three in-flight requests with or
  without control. The manual single-frame comparison and old-host fallback remain.
- Video/audio settings, including desktop sound, keep the same widgets and current
  values visible while sharing. They are disabled until sharing is stopped.
- This change does not implement Windows PIN/password sign-in desktop capture or input.
锁屏访问（v0.2 测试功能）
实际 SYSTEM/Winlogon 锁屏解锁尚待测试机验收，安装成功和源码测试不代表已经解锁通过。
更新主程序后，运行 Enable-Lock-Screen-Access.cmd，按 Windows 提示完成一次管理员授权。
它为当前 Windows 用户安装独立锁屏访问服务；普通“管理员窗口控制”助手不能代替此组件。
重新开始共享后，锁屏壁纸显示时可在查看端点“显示登录界面”，等待新画面后再开启控制并正常输入凭据。
Windows 密码/PIN 不保存；控制台登录后的锁屏场景是当前测试范围，开机未登录、UAC 与切用户尚未验收。
需要移除时运行 Remove-Lock-Screen-Access.cmd，确认管理员授权。
