跳转到内容
AnySoul 文档

安装桌面客户端

桌面客户端提供网页版无法实现的原生功能 —— GPU 加速 TTS、系统通知、全局快捷键，以及专属的 Soul 窗口。

Windows

Section titled “Windows”

免安装版（推荐）

Section titled “免安装版（推荐）”
  1. 从 anysoul.ai 下载 Portable .exe 文件
  2. 双击即可运行，无需安装
  3. 数据存储在 %APPDATA%/AnySoul

安装版（NSIS）

Section titled “安装版（NSIS）”
  1. 从 anysoul.ai 下载 Setup .exe 文件
  2. 运行安装程序，按向导操作
  3. AnySoul 将安装到 Program Files，并创建开始菜单快捷方式

Windows SmartScreen 警告

Section titled “Windows SmartScreen 警告”

由于 AnySoul 尚未使用 EV 证书进行代码签名，Windows 可能会弹出 SmartScreen 警告：

  1. 点击 更多信息
  2. 点击 仍要运行

这是未签名应用的正常现象，不代表存在恶意软件。

macOS

Section titled “macOS”

重要：绕过 Gatekeeper

Section titled “重要：绕过 Gatekeeper”

Apple 要求所有应用必须经过代码签名和公证。我们正在积极注册 Apple Developer Program 以实现正式签名。

在此之前，macOS 会阻止打开应用并显示：

无法打开”AnySoul.app”，因为无法验证开发者。

解决方法 —— 安装后在终端中运行：

Terminal window
sudo xattr -cr '/Applications/AnySoul.app'

或者：右键点击应用 → 打开 → 在弹出的对话框中点击打开。

安装步骤

Section titled “安装步骤”
  1. 从 anysoul.ai 下载 .dmg 文件
  2. 打开 .dmg，将 AnySoul 拖入 Applications（应用程序）文件夹
  3. 打开终端，运行上述 xattr 命令
  4. 从启动台或应用程序文件夹打开 AnySoul

”应用已损坏”错误

Section titled “”应用已损坏”错误”

如果看到”AnySoul.app 已损坏，无法打开”提示，这是同样的 Gatekeeper 问题。运行上述 xattr 命令即可修复：

Terminal window
sudo xattr -cr '/Applications/AnySoul.app'

Linux

Section titled “Linux”

AppImage

Section titled “AppImage”
  1. 从 anysoul.ai 下载 .AppImage 文件
  2. 添加执行权限：
Terminal window
chmod +x AnySoul-*.AppImage
  1. 运行：
Terminal window
./AnySoul-*.AppImage

桌面集成

Section titled “桌面集成”

如需自动桌面集成（菜单入口、文件关联），可安装 AppImageLauncher：

Terminal window
# Ubuntu/Debian
sudo apt install appimagelauncher

然后双击 .AppImage 文件，AppImageLauncher 会自动提示集成。

缺少 libfuse2

Section titled “缺少 libfuse2”

如果遇到 FUSE 相关错误，请安装 libfuse2：

Terminal window
# Ubuntu 22.04+
sudo apt install libfuse2

常见问题

Section titled “常见问题”
现象平台解决方案
SmartScreen 提示”未知发布者”Windows点击”更多信息” → “仍要运行"
"无法验证开发者”macOSsudo xattr -cr '/Applications/AnySoul.app'
”应用已损坏”macOS同上 xattr 命令
AppImage 无法启动Linuxchmod +x 文件，安装 libfuse2
应用打开后显示空白所有平台检查网络连接 —— 应用需要访问 api.anysoul.ai

下一步

Section titled “下一步”

安装完成后，桌面客户端与网页版使用同一个账户：