From 3d40cf08e7db722cadfb0737c10209fedbbb7091 Mon Sep 17 00:00:00 2001 From: Jeremy Date: Tue, 27 Oct 2026 12:09:03 +0000 Subject: [PATCH] docs(installer): describe the per-user default install location and scope --- README.md | 5 +++-- README.zh-hans.md | 5 +++-- README.zh-hant.md | 5 +++-- docs/mcp.md | 6 +++--- docs/user/getting-started/install.md | 4 ++-- 5 files changed, 14 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 71f30d4c2..c438a91b1 100644 --- a/README.md +++ b/README.md @@ -563,8 +563,9 @@ Questions, ideas or a bug you'd like to talk through first? Bring them to [Disco | arm64 (Snapdragon and other ARM PCs) | `lightcraft--windows-arm64.msi` | `lightcraft--windows-arm64-portable.zip` | | x86 (32-bit) | `lightcraft--windows-x86.msi` | `lightcraft--windows-x86-portable.zip` | -Installers and executables are code-signed. The installer asks where to install (`C:\Program Files\LightCraft` by -default; upgrades stay in the folder you chose) and ends on a page confirming LightCraft was installed, with an +Installers and executables are code-signed. The installer asks who to install for and where (for your account only, in +`%LOCALAPPDATA%\Programs\ArtCraft\LightCraft`, by default; "Everyone on this computer" uses +`C:\Program Files\ArtCraft\LightCraft`; upgrades stay in the folder you chose) and ends on a page confirming LightCraft was installed, with an option to start it. For unattended installs: `msiexec /i lightcraft--windows-x64.msi /qn INSTALLFOLDER="D:\Apps\LightCraft\"`. ### macOS diff --git a/README.zh-hans.md b/README.zh-hans.md index 2c6ca8191..f7c0808cf 100644 --- a/README.zh-hans.md +++ b/README.zh-hans.md @@ -484,8 +484,9 @@ egui 前端是一个可替换的 crate；它下面没有任何东西知道 UI | arm64（骁龙及其他 ARM PC） | `lightcraft--windows-arm64.msi` | `lightcraft--windows-arm64-portable.zip` | | x86（32 位） | `lightcraft--windows-x86.msi` | `lightcraft--windows-x86-portable.zip` | -安装程序和可执行文件都有代码签名。安装程序会询问安装位置（默认 -`C:\Program Files\LightCraft`；升级会留在你选择的文件夹），结束时有一页确认 LightCraft 已安装， +安装程序和可执行文件都有代码签名。安装程序会询问为谁安装以及安装位置（默认仅为当前账户，安装到 +`%LOCALAPPDATA%\Programs\ArtCraft\LightCraft`；选择“这台计算机上的所有人”则安装到 +`C:\Program Files\ArtCraft\LightCraft`；升级会留在你选择的文件夹），结束时有一页确认 LightCraft 已安装， 并可选择启动它。无人值守安装：`msiexec /i lightcraft--windows-x64.msi /qn INSTALLFOLDER="D:\Apps\LightCraft\"`。 ### macOS diff --git a/README.zh-hant.md b/README.zh-hant.md index ca624ce68..0b52419a8 100644 --- a/README.zh-hant.md +++ b/README.zh-hant.md @@ -514,8 +514,9 @@ egui 前端是一個可替換的 crate；它之下沒有任何東西知道 UI | arm64（Snapdragon 及其他 ARM PC） | `lightcraft--windows-arm64.msi` | `lightcraft--windows-arm64-portable.zip` | | x86（32 位元） | `lightcraft--windows-x86.msi` | `lightcraft--windows-x86-portable.zip` | -安裝程式與執行檔都有程式碼簽章。安裝程式會詢問安裝位置（預設為 -`C:\Program Files\LightCraft`；升級時會留在你選擇的資料夾），結束時會有一頁確認 LightCraft 已安裝， +安裝程式與執行檔都有程式碼簽章。安裝程式會詢問為誰安裝以及安裝位置（預設僅為目前帳戶，安裝到 +`%LOCALAPPDATA%\Programs\ArtCraft\LightCraft`；選擇「這台電腦上的所有人」則安裝到 +`C:\Program Files\ArtCraft\LightCraft`；升級時會留在你選擇的資料夾），結束時會有一頁確認 LightCraft 已安裝， 並可選擇立即啟動。無訊息安裝：`msiexec /i lightcraft--windows-x64.msi /qn INSTALLFOLDER="D:\Apps\LightCraft\"`。 ### macOS diff --git a/docs/mcp.md b/docs/mcp.md index 4800c37d8..7be25f7f0 100644 --- a/docs/mcp.md +++ b/docs/mcp.md @@ -96,13 +96,13 @@ The release packages ship `lightcraft-cli` alongside the desktop app, so no buil | Install | CLI | |---|---| -| Windows (MSI) | `C:\Program Files\LightCraft\lightcraft-cli.exe` by default (wherever you installed it otherwise), not on `PATH` | +| Windows (MSI) | `%LOCALAPPDATA%\Programs\ArtCraft\LightCraft\lightcraft-cli.exe` by default (`C:\Program Files\ArtCraft\LightCraft\lightcraft-cli.exe` for an all-users install, or wherever you installed it otherwise), not on `PATH` | | Linux (deb, rpm) | `/usr/bin/lightcraft-cli` | | macOS | the separate `lightcraft-cli--macos-.zip` release asset (the `.app` holds only the desktop app) | ```sh -# Windows, default install folder -claude mcp add lightcraft -- "C:\Program Files\LightCraft\lightcraft-cli.exe" mcp +# Windows (PowerShell), default install folder +claude mcp add lightcraft -- "$env:LOCALAPPDATA\Programs\ArtCraft\LightCraft\lightcraft-cli.exe" mcp # Linux, or macOS with the CLI unzipped onto PATH claude mcp add lightcraft -- lightcraft-cli mcp ``` diff --git a/docs/user/getting-started/install.md b/docs/user/getting-started/install.md index 8327222cb..a63157d98 100644 --- a/docs/user/getting-started/install.md +++ b/docs/user/getting-started/install.md @@ -11,12 +11,12 @@ Download the file for your system from the [latest release](https://github.com/s 1. Open the [latest release](https://github.com/storytold/lightcraft/releases/latest). 2. Download `lightcraft--windows-x64.msi`. It fits most PCs (Intel and AMD, 64-bit). -3. Run the file. The installer asks where to install. The default is `C:\Program Files\LightCraft`, and upgrades stay in the folder you chose. +3. Run the file. The first page asks who to install LightCraft for. "Only for me" is the default: it needs no administrator permission and installs to `%LOCALAPPDATA%\Programs\ArtCraft\LightCraft`. "Everyone on this computer" asks for an administrator and installs to `C:\Program Files\ArtCraft\LightCraft`. Upgrades stay in the folder you chose. 4. At the end, choose the option to start LightCraft. For a Snapdragon or other Arm PC, download `lightcraft--windows-arm64.msi` instead. For a 32-bit Windows, download `lightcraft--windows-x86.msi`. -Upgrading from an installer older than 0.6.0 also keeps LightCraft in the folder it was installed in. If that folder was deleted, the upgrade installs to `C:\Program Files\LightCraft`. +Upgrading from an installer older than 0.6.0 also keeps LightCraft in the folder it was installed in. If that folder was deleted, the upgrade installs to the default folder for the scope you choose. To run it without installing, download `lightcraft--windows-x64-portable.zip`. Portable builds for `arm64` and `x86` are on the release page too.