← 返回文档

Linux 安装指南

本指南将指导您在 Linux 系统上安装 Sokuji。Sokuji 提供 .deb 包用于 Debian/Ubuntu 发行版，以及 AppImage 用于通用兼容性。

下载 Linux 版本

系统要求

  • Ubuntu 20.04 或更高版本，Debian 10 或更高版本，或同等发行版
  • 64 位处理器
  • 最少 4GB RAM（推荐 8GB）
  • 100MB 可用磁盘空间
  • 用于音频支持的 PulseAudio 或 PipeWire
  • 用于 AI 服务的互联网连接

安装步骤

步骤 1：下载 Sokuji

访问 官方 GitHub 发布页面 下载最新版本的 Linux 版 Sokuji。

可用的安装包

  • .deb 包 - 用于基于 Debian/Ubuntu 的发行版
  • .AppImage - 适用于所有 Linux 发行版的通用包
  • .rpm 包 - 用于基于 Fedora/RHEL 的发行版（如果可用）

步骤 2：安装 .deb 包（Ubuntu/Debian）

如果您使用 Ubuntu、Debian 或其衍生版，推荐使用 .deb 包。

方法 1：使用 GUI

  1. 打开文件管理器并导航到下载文件夹
  2. 双击 sokuji_*.deb 文件
  3. 在打开的软件中心中点击"安装"
  4. 在提示时输入您的密码

方法 2：使用终端

打开终端并运行以下命令： 
cd ~/Downloads
sudo dpkg -i sokuji_*.deb
如果遇到依赖问题，使用以下命令修复： 
sudo apt-get install -f

步骤 3：安装 AppImage（通用）

AppImage 适用于所有 Linux 发行版，无需安装。

设置 AppImage

  1. 从发布页面下载 AppImage 文件
  2. 使其可执行： 
    chmod +x sokuji-*.AppImage
  3. 运行应用程序： 
    ./sokuji-*.AppImage

可选：系统集成

要将 AppImage 与系统集成： 
mkdir -p ~/.local/bin
cp sokuji-*.AppImage ~/.local/bin/sokuji
chmod +x ~/.local/bin/sokuji
现在您可以在终端的任何位置输入 sokuji 来运行 Sokuji。

步骤 4：首次运行配置

首次启动 Sokuji 时，您需要进行配置：

初始设置

  1. 从应用程序菜单或终端启动 Sokuji
  2. 选择您喜欢的界面语言
  3. 配置您的 AI 提供商（OpenAI、Google Gemini 等）
  4. 输入所选提供商的 API 密钥
  5. 选择您的麦克风和扬声器设备
  6. 测试音频以确保一切正常
Sokuji 现在已准备就绪！您可以通过点击开始会话按钮开始实时翻译。

故障排除

音频问题

如果遇到音频问题：
  • 确保 PulseAudio 或 PipeWire 正在运行：systemctl --user status pipewire
  • 检查音频权限：groups $USER 应包含 'audio'
  • 重启音频服务：systemctl --user restart pipewire

权限拒绝

如果收到"Permission denied"错误： 
sudo usermod -a -G audio $USER
然后注销并重新登录以使更改生效。

缺少依赖项

安装所需的库： 
sudo apt-get update
sudo apt-get install libgtk-3-0 libnotify4 libnss3 libxss1 \
    libxtst6 xdg-utils libatspi2.0-0 libdrm2 libgbm1

AppImage 无法运行

如果 AppImage 无法运行，请安装 FUSE： 
sudo apt-get install fuse libfuse2
对于较新的系统（Ubuntu 22.04+），您可能需要： 
sudo apt-get install libfuse2t64