feat(app): the Windows installer

- app/shell/installer.nsi with installer.sh: package.sh's folder into Jarvis-Setup-<version>.exe
  (NSIS, about 10 MB) and its .sha256; models and runtimes still come with the first-run wizard
- Program Files with one administrator prompt, Korean pages, components (start menu and desktop
  shortcuts, the virtual monitor's driver off by default, installed through the app's elevated
  half), the WebView2 runtime only when missing, a wait for a running Jarvis, /S and /S /RUN for
  updates, the app started through Explorer so it never runs as administrator
- uninstall removes this app's driver, only the files it installed, the shortcuts and its
  registry keys; the data folder stays
- checked on the win-ci VM: silent install, start, update while running and start again,
  uninstall; and an install with the driver from the pages, whose uninstall leaves no device,
  driver package or registry key

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
javis-bot
2026-11-14 11:13:33 +09:00
parent ebf264d54b
commit 5ce832f51a
4 changed files with 256 additions and 2 deletions

View File

@@ -559,7 +559,31 @@ URL), so other local programs cannot drive it.
out `Jarvis/`: `jarvis.exe`, `WebView2Loader.dll`, `python-src/` (the `voice_worker` and
`jarvis` packages, no caches or specs) and `display-driver/` (the virtual monitor's driver). The worker's default sources are `python-src` next to the
executable when it is there, else the repository's `src/`; the install reads its requirement
files from the same place. The installer (NSIS) comes later; the folder runs as it is.
files from the same place. The folder also runs as it is.
## Installer (`app/shell/installer.nsi`, `app/shell/installer.sh`)
`docs/v2/architecture.md` ("설치 파일: NSIS"). `installer.sh <folder>` runs `package.sh` and makensis
3 (on Linux; `NSISDIR` when it is not installed system-wide) and writes
`Jarvis-Setup-<version>.exe` with its `.sha256`. The installer is about 10 MB; models and runtimes
come with the first-run wizard into the data folder, which the installer never touches.
- Program Files (`Jarvis`), one administrator prompt, 64-bit Windows 10/11 only; Korean pages:
folder, components, progress, finish ("Jarvis 실행", started through Explorer so the app runs as
the signed-in user, not as administrator).
- Components: Jarvis (always), start menu shortcut (on), desktop shortcut (off), the virtual
monitor's driver (off; the app's elevated half, `jarvis.exe --display-driver install`, so Windows
asks the SignPath question once; a failure says it can be installed later from the features
screen). Shortcuts are for every user of the PC.
- The WebView2 runtime is installed with Microsoft's bootstrapper (inside the installer) only when
the PC has none.
- Before installing or removing, the installer waits for `jarvis.exe` to close: it asks with a
retry, or silently waits up to 60 s (an update closes the app itself), then gives up.
- `/S` installs silently with the default components; `/S /RUN` starts the app again afterwards
(the app's updates). The uninstall entry has the version, size and a quiet uninstall string.
- Uninstall: the driver goes too when this app installed it (the elevated half refuses another
program's copy), then only what the installer put there (a folder the person chose may hold
other things), the shortcuts and the registry keys. The data folder stays.
## Tests