安装与启动
| 依赖 | 要求 |
|---|---|
| 操作系统 | Linux / macOS / Windows / WSL |
| Node.js | >= 24.0.0（源码安装需要） |
| Git | 推荐 |
方式一：便携包（推荐）
Section titled “方式一：便携包（推荐）”从 GitHub Releases 下载对应平台的便携包，解压即可使用。
| 平台 | 文件 |
|---|---|
| Linux x64 | lingxiao-vLINGXIAO_VERSION-linux-x64.tar.gz |
| Linux arm64 | lingxiao-vLINGXIAO_VERSION-linux-arm64.tar.gz |
| macOS arm64 | lingxiao-vLINGXIAO_VERSION-darwin-arm64.tar.gz |
| Windows x64 | lingxiao-vLINGXIAO_VERSION-win-x64.zip |
Linux / macOS：
tar xzf lingxiao-vLINGXIAO_VERSION-linux-x64.tar.gzcd lingxiao./lingxiaoWindows：
解压 zip 文件后，双击 lingxiao.exe 或在 PowerShell 中运行：
.\lingxiao.exe方式二：Windows 桌面版
Section titled “方式二：Windows 桌面版”从 Releases 下载 Windows 安装包：
- NSIS 安装包（
LingXiao-Setup-LINGXIAO_VERSION.exe）：推荐，支持自动更新 - MSI 安装包（
LingXiao.LINGXIAO_VERSION.msi）：适合企业部署
安装后从开始菜单启动「凌霄」，后续版本更新会自动检测并增量下载。
方式三：源码安装
Section titled “方式三：源码安装”Linux / macOS
Section titled “Linux / macOS”git clone https://github.com/hexian2001/lingxiao-coding.gitcd lingxiao-codingnpm installnpm run buildnpm linkWindows (PowerShell)
Section titled “Windows (PowerShell)”git clone https://github.com/hexian2001/lingxiao-coding.gitcd lingxiao-codingnpm installnpm run buildnpm linkWindows (WSL)
Section titled “Windows (WSL)”git clone https://github.com/hexian2001/lingxiao-coding.gitcd lingxiao-codingnpm installnpm run buildnpm link安装完成后直接运行：
lingxiao首次运行会引导配置模型和 API 密钥。配置文件位于 ~/.lingxiao/settings.json。
npm link会将lingxiao命令注册到全局 PATH，之后可在任意目录使用。
lingxiao --version便携包 / 源码安装
Section titled “便携包 / 源码安装”lingxiao upgradelingxiao upgrade 会自动检测安装类型（源码或便携包），定位安装路径，下载最新版本并完成更新。
Windows 桌面版
Section titled “Windows 桌面版”桌面版启动后自动检测更新，增量下载并提示安装。也可手动检查更新。
手动升级（源码 — 三平台通用）
Section titled “手动升级（源码 — 三平台通用）”Linux / macOS
Section titled “Linux / macOS”cd lingxiao-codinggit pullnpm installnpm run buildWindows (PowerShell)
Section titled “Windows (PowerShell)”cd lingxiao-codinggit pullnpm installnpm run buildWindows (WSL)
Section titled “Windows (WSL)”cd lingxiao-codinggit pullnpm installnpm run buildgit clone https://github.com/hexian2001/lingxiao-coding.gitcd lingxiao-codingnpm installnpm run buildnpm run cliWeb 前端开发：
cd webnpm installnpm run devnpm run buildVite 开发代理示例：
LINGXIAO_WEB_PORT=8787 npm run clicd webLINGXIAO_WEB_PROXY_TARGET=http://127.0.0.1:8787 npm run devnpx tsc -p tsconfig.cli.json --noEmitnpx tsc -p web/tsconfig.json --noEmitnpm run test:architecturenpm run buildnpm test本项目采用 AGPL v3 + 商业双授权 模式。详见 LICENSE。