# 安装 — Liu Terminal

> 在 macOS 上安装 Liu Terminal。下载适用于 Apple Silicon 或 Intel 的 DMG，或通过 Homebrew 安装。

URL: https://liu.software/zh/docs/install/  
Language: zh  
Updated: 2026-10-17

在 macOS 或 Linux 上安装 Liu — 从下载菜单获取打包版本，或在一分钟内从源代码编译。

## 安装

从下载菜单获取打包版本（Apple Silicon / Intel 的 macOS .dmg、Linux .tar.gz），或使用包管理器：

```
# macOS (Homebrew)
brew install --cask calculusteam/liu/liu

# Arch (AUR)
paru -S liu-bin

# Debian/Ubuntu (PPA)
sudo add-apt-repository ppa:calculusteam/liu && sudo apt update && sudo apt install liu

# Fedora (COPR)
sudo dnf copr enable calculusteam/liu && sudo dnf install liu
```

这些包管理器命令对应的仓库可能并非每个版本都已发布。下面的可复现源码构建路径不依赖这些仓库。

macOS 版本已使用 Developer ID 签名并经 Apple 公证 — 打开 Liu.app 时不会出现 Gatekeeper 提示。

或通过脚本安装最新的签名版本（备用）：

```
curl -fsSL https://raw.githubusercontent.com/calculusteam/liu/main/scripts/install.sh | bash
```

## 从源代码构建

在仓库根目录中，构建辅助脚本会检测平台并默认选择 Release 基线：

```
./scripts/build.sh --yes      # recommended non-interactive build
./scripts/build.sh --debug    # Debug build
./scripts/build.sh --native   # host CPU tuning
./scripts/build.sh --package  # Release build + macOS DMG/Linux tarball
```

直接使用 CMake 的路径是：

```
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j$(sysctl -n hw.ncpu 2>/dev/null || nproc)
./build/Liu
```

## 先决条件

- CMake 3.20+
- C11 编译器 — Apple clang、主线 clang 或 gcc 10+
- `libssh2` （由 CMake 选择系统库或内置构建）
- Linux 还需要 OpenSSL/libcrypto、X11 和 OpenGL 开发包。Debian/Ubuntu 示例：libssh2-1-dev libssl-dev libx11-dev libxcursor-dev libxrandr-dev libgl-dev pkg-config。

SQLite3、stb\_truetype、stb\_image 和 cJSON 已内置于 third\_party/ 中 — 您无需单独安装它们。

## macOS — 主要目标

```
brew install libssh2
git clone https://github.com/calculusteam/liu.git && cd liu

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j$(sysctl -n hw.ncpu)

./build/Liu
```

Release 构建添加 LTO 和 -O3。默认为可移植基线；若要在 x86\_64 上使用 -march=native，向 cmake 传入 -DLIU\_NATIVE\_ARCH=ON（Apple arm64 使用 -mcpu=apple-m1）。调试构建请将 Release 换为 Debug。

## Linux

```
sudo apt install cmake build-essential libssh2-1-dev
git clone https://github.com/calculusteam/liu.git && cd liu

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j$(nproc)

./build/Liu
```

Metal 后端在非 macOS 系统上会被跳过，您将获得 OpenGL 3.3 核心渲染器。如果要在 macOS 上强制使用 OpenGL，也可传递 -DUSE\_METAL=OFF。

## 有用的标志

```
cmake -B build -DUSE_ASM=OFF        # 跳过 SIMD 汇编
cmake -B build -DUSE_METAL=OFF      # 在 macOS 上强制使用 OpenGL
cmake -B build -DUSE_LIBFUZZER=ON   # 启用 libFuzzer 测试框架
```

```
cmake -B build -DLIU_NATIVE_ARCH=ON       # tune Release for this CPU
cmake -B build -DLIU_BROWSER=OFF             # disable the macOS WebKit browser
cmake -B build -DUSE_VENDORED_SSH_DEPS=OFF  # use system SSH/crypto deps
cmake -B build -DAUTO_DOWNLOAD_SSH_DEPS=OFF # do not bootstrap missing macOS deps
```

## 配套二进制文件

单次顶层构建会在主应用旁边生成两个同级二进制文件：

```
cmake --build build --target liu-notify   # 通知守护进程 + CLI
cmake --build build --target liu-history  # 独立的代理历史 CLI
```

## 打包 (macOS)

```
./scripts/build_macos_compat_deps.sh    # 内置 libssh2 + OpenSSL
./scripts/package_macos_dmg.sh          # 签名的 .app + DMG
```

## 自定义 Terminfo

Liu 自带终端条目，以便远程 Shell 能声明正确的功能 —— 真彩色、鼠标模式、括号粘贴、Mode 2026 同步输出、OSC 7/8/133。

```
tic -x liu.terminfo
```

[下一步 快速入门 →](https://liu.software/zh/docs/quickstart.md)