Sage 桌面客户端安装指南

March 24, 2026 · View on GitHub

本文档说明如何在 macOS 和 Windows 上构建和安装 Sage 桌面应用程序。

1. 前置依赖安装

在开始之前，请确保已安装以下工具。

Tauri 依赖 Rust 语言环境。

macOS / Linux:

打开终端运行：

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

或者brew安装：

brew install rustup-init

安装完成后，重启终端或运行 source $HOME/.cargo/env 以生效。验证安装：

cargo --version
# 输出示例: cargo 1.70.0 (ec8a8a0ca 2023-04-25)

安装 Tauri CLI:

为了更方便地使用 Tauri，请安装 Tauri CLI 工具 (需要 v2 版本)：

cargo install tauri-cli --version "^2"

Windows:

请访问 Rust 官网下载并运行 rustup-init.exe。

或者使用 winget 安装：

winget install Rustlang.Rust.MSVC

验证安装：

cargo --version

前端构建依赖 Node.js。推荐使用 LTS 版本 (v18+)。

macOS (使用 Homebrew):

brew install node

Windows:

请访问 Node.js 官网下载安装包。

或者使用 winget 安装：

winget install OpenJS.NodeJS.LTS

验证安装：

node -v
npm -v

后端服务依赖 Python 环境。

macOS:

推荐使用 Homebrew 或 Pyenv 安装。

brew install python@3.11

Windows:

请访问 Python 官网下载安装包。

或者使用 winget 安装（推荐）：

winget install Python.Python.3.11

验证安装：

python --version
pip --version

为了更好地管理 Python 环境，推荐使用 Miniconda 或 Anaconda。

我们提供了一个脚本 dev_windows.ps1 来简化开发模式的启动。

在 PowerShell 中运行：

 powershell -ExecutionPolicy Bypass -File ".\app\desktop\scripts\dev_windows.ps1"

注意：首次运行时会自动安装 Python 依赖和前端依赖，可能需要较长时间。

我们提供了一键编译脚本，自动处理 Python 环境打包、前端构建和 Tauri 打包。

在项目根目录下运行：

chmod +x app/desktop/scripts/build.sh
./app/desktop/scripts/build.sh

 powershell -ExecutionPolicy Bypass -File ".\app\desktop\scripts\build_windows.ps1"

构建产物位置：