nex_shift/docs
mula.liu 0ab3768c5a fix(update): make the Windows handoff actually run
Reported: the 0.1.13 Windows build fails after download and restart. Two
independent defects sat on that path:

- The helper was launched as `cmd.exe /D /C "<path with spaces>" ...`.
  cmd strips the first and last quote when the command has more than one
  quoted token, so the script under `%TEMP%\Shift Updates` was never
  recognized. Shift quit and nothing installed. The script path now arrives
  in an environment variable, with the extra outer quote layer cmd needs.
- A silent install could still open the WebView2 warning. Nobody is present
  to dismiss it during an in-app update, so the installer waited forever.
  The manual warning stays; silent installs skip it.

The installer also waits briefly after taskkill before overwriting the EXE,
and the handoff logs its start and a missing target so a future failure is
visible in `%TEMP%\Shift Updates\handoff.log`.

Verified with Wine: the old command reproduces the quote-stripping failure,
the new one runs; the rebuilt installer completes silently without WebView2
and the full wait-install-relaunch handoff replaces the executable.
2026-11-20 18:29:16 +08:00
..
ARCHITECTURE.md docs: 收录 2026-11 全面评审的修复与约束 2026-11-07 12:42:35 +08:00
BUILD_WINDOWS.md release: prepare Shift 0.1.8 2026-10-27 18:45:32 +08:00
ENGINEERING-NOTES.md fix(update): make the Windows handoff actually run 2026-11-20 18:29:16 +08:00
MOBILE.md docs: 收录 2026-11 全面评审的修复与约束 2026-11-07 12:42:35 +08:00
README.md docs: 收录 2026-11 全面评审的修复与约束 2026-11-07 12:42:35 +08:00
RELEASE.md fix(update): make the Windows handoff actually run 2026-11-20 18:29:16 +08:00
ROADMAP.md docs: 收录 2026-11 全面评审的修复与约束 2026-11-07 12:42:35 +08:00
SECURITY.md fix(update): make the Windows handoff actually run 2026-11-20 18:29:16 +08:00
SPECIFICATION.md docs: 收录 2026-11 全面评审的修复与约束 2026-11-07 12:42:35 +08:00

README.md

Shift documentation

Start with the user guide, then choose the engineering document that matches the work.

Document Audience Contents
../README.md / ../README.zh-CN.md Users Features, formats, shortcuts, privacy, known limitations
ARCHITECTURE.md Contributors Process/window model, module ownership, events, data flows
SPECIFICATION.md Product and QA Observable behaviour, naming, limits, acceptance criteria
SECURITY.md Security reviewers and maintainers Trust boundaries, update and LAN risk, residual gaps
ENGINEERING-NOTES.md Contributors Regression ledger and non-negotiable implementation constraints
RELEASE.md Release maintainers Channel layout, signing, update handoff and verification
BUILD_WINDOWS.md Builders Windows prerequisites, cross-build and installer notes
ROADMAP.md Contributors Completed milestones and next desktop work
MOBILE.md Product planning Mobile feasibility and architecture plan
../CONTRIBUTING.md Contributors Setup, checks, change rules and manual matrix

Source of truth

  • Current code and tests define implemented behavior.
  • The conversion/tool tables in README describe the user-visible catalogue; the runtime catalogue lives in src/lib/conversionFormats.ts and src/lib/radialOrder.ts.
  • Platform/runtime limitations must be stated as unverified when no real hardware run exists.
  • Do not claim a CI run without linking its log.