安装

选择你喜欢的安装方法。

从源码安装(推荐)

从源码构建以获取最新功能:

git clone https://github.com/savfox-ai/savfox.git
cd savfox
cargo install --path crates/savfox-cli

前提条件:

  • Rust 1.94 或更新版本
  • Git

Docker

在容器中运行 Savfox:

docker pull ghcr.io/savfox-ai/savfox:latest
docker run -it ghcr.io/savfox-ai/savfox:latest

使用卷挂载进行持久化配置:

docker run -it \
  -v ~/.savfox:/root/.savfox \
  -v $(pwd):/workspace \
  ghcr.io/savfox-ai/savfox:latest

Docker Compose

创建 compose.yml

services:
  savfox:
    image: ghcr.io/savfox-ai/savfox:latest
    volumes:
      - ./config:/root/.savfox
      - ./workspace:/workspace
    ports:
      - '18881:18881'
    command: savfox gateway

运行:

docker compose up -d

预编译二进制文件

从 GitHub Releases 下载预编译的二进制文件:

# Linux/macOS
curl -sSL https://github.com/savfox-ai/savfox/releases/latest/download/savfox-$(uname -s)-$(uname -m) -o savfox
chmod +x savfox
sudo mv savfox /usr/local/bin/

# Windows (PowerShell)
Invoke-WebRequest -Uri "https://github.com/savfox-ai/savfox/releases/latest/download/savfox-windows-x86_64.exe" -OutFile "savfox.exe"

验证安装

savfox --version
savfox --help

开发设置

为 Savfox 做贡献:

git clone https://github.com/savfox-ai/savfox.git
cd savfox

# 安装 just(命令运行器)
cargo install just

# 检查代码库
just check

# 运行测试
just test

# 构建
cargo build --release

下一步

配置认证并运行你的第一个会话。 设置网关以进行远程访问。