安装与升级

macOS 与 Linux

在终端中运行：

curl -fsSL https://download.lumenlan.com/lumenlan-cli/install.sh | sh

安装器识别 macOS 或 Linux 以及 arm64 或 x64，下载当前正式版的对应二进制，并先用正式版 SHA256SUMS 校验内容，再替换本机文件。默认位置是 ~/.local/bin/lumenlan。如果该目录不在 PATH，安装器会给出需要添加的目录；修改后重新打开终端即可。

指定安装目录或精确版本时，先下载脚本再传参：

curl -fsSL https://download.lumenlan.com/lumenlan-cli/install.sh -o install-lumenlan.sh
sh install-lumenlan.sh --install-dir "$HOME/bin" --version v0.3.1

Windows

在 PowerShell 中运行：

irm https://download.lumenlan.com/lumenlan-cli/install.ps1 | iex

默认安装到当前用户的 %LOCALAPPDATA%\Programs\Lumenlan\bin\lumenlan.exe，并把目录加入用户 PATH。打开新的 PowerShell 后运行 lumenlan version。如需固定版本或自选目录，可以下载脚本后运行：

./install.ps1 -Version v0.3.1 -InstallDir "$HOME\bin"

手工下载

正式版同时提供 macOS、Linux、Windows 的 arm64 与 x64 六个文件。请从 https://download.lumenlan.com/lumenlan-cli/latest/ 选择对应文件，并使用同目录的 SHA256SUMS 核对 SHA-256；校验成功后再赋予执行权限和放入 PATH。

升级、回退与移除

再次运行自动安装命令即可升级到当前正式版。使用 --version vX.Y.Z 或 PowerShell -Version vX.Y.Z 可以安装已发布的精确版本，用于可复现环境或回退。安装器会在替换前完成 下载校验和版本探测，不会把不完整文件留作正式命令。

移除时删除 lumenlan 或 lumenlan.exe；如果你手工把安装目录加入了 PATH，再从终端配置中 移除该目录。CLI 本身不保存长期登录凭据，但工作区状态目录可能包含脱敏审计和隔离输出，是否 保留应按你的项目留证策略决定。