跳到主要内容

安装

最新安装包见 Serpent Releases。

系统要求​

  • macOS:Apple Silicon(arm64)或 Intel(x64),macOS 11 或更高版本
  • Windows:64 位 Windows 10 或 Windows 11
  • Linux:64 位 x86_64 或 aarch64(发布资产为 AppImage;建议较新的发行版,两条架构都用 Ubuntu 22.04 / glibc ≥ 2.35 基线)
  • 应用本身约需 500 MB;资源库数据另占空间

安装包与版本说明以 Serpent Releases 为准。

macOS​

  1. 下载对应架构的 Serpent-darwin-arm64-<版本>-package.dmg(或 Intel 架构对应安装包)。
  2. 打开 DMG,将 Serpent 拖到「应用程序」。

当前开发版若未签名公证,首次打开时右键应用选择「打开」并确认。若系统仍阻止,可以在终端清除隔离属性:

xattr -cr /Applications/Serpent.app

卸载只需将应用移入废纸篓;资源库位于创建时选择的位置,不会因删除应用而删除。

Windows​

  1. 从发布页下载 Windows 安装包 Serpent-win-x86-64-<版本>-setup.zip(解压运行内含的安装向导进行安装),或下载便携版 Serpent-win-x86-64-<版本>-portable.zip(解压到任意本地目录即可直接运行)。
  2. 运行安装程序并按向导选择安装路径、语言等偏好完成安装。

未签名开发包可能触发 SmartScreen,请核对来源后选择「更多信息 → 仍要运行」。通过系统「设置 → 应用」卸载,卸载程序会干净移除安装文件。

Linux​

  1. 从发布页下载与本机架构对应的 AppImage:x86_64 为 Serpent-linux-x86-64-<版本>.AppImage,aarch64 为 Serpent-linux-arm64-<版本>.AppImage。
  2. 赋予执行权限并运行:
chmod +x Serpent-linux-x86-64-<版本>.AppImage
./Serpent-linux-x86-64-<版本>.AppImage
# aarch64 把文件名换成 Serpent-linux-arm64-<版本>.AppImage

运行依赖:

  • FUSE(libfuse2)。没有 FUSE 时加 --appimage-extract-and-run。x86_64 与 aarch64 相同。
  • 发布用 AppImage 内置与 macOS、Windows 相同的 ffmpeg、ffprobe 和 oiiotool(oiiotool 含 LibRaw / OCIO)。视频预览和专业图像格式一般不需要再安装系统里的这些程序。SERPENT_FFMPEG_PATH 和 SERPENT_OIIO_PATH 仍可改用其他路径。aarch64 安装包要等对应媒体包晋升后才会出现在 Releases。
  • Debian/Ubuntu 示例:sudo apt install libfuse2。从源码运行且还没有媒体包时,才需要系统 ffmpeg。

当前 Linux 行为与限制:

  • 界面沿用 Windows 风格:无边框窗口、应用内主菜单(≡)、有合成器时圆角。
  • 没有系统托盘:关闭窗口会退出应用(不会像 Windows 那样隐藏到通知区域)。
  • 登录时启动暂不提供。详见基本使用。
  • 已在 Debian 13(X11)和嵌套 Wayland 合成器下测试;原生 Wayland 会话仍待专项验收。x86_64 与 aarch64 使用同一套限制。
  • 无可用 GPU / GL 时可设置 SERPENT_SOFTWARE_GL=1 启用软件 WebGL。圆角可用 SERPENT_LINUX_ROUNDED_CORNERS=0 / 1 强制关闭或开启。

卸载:删除 AppImage 文件即可。资源库目录独立于应用文件,不会随之删除。

浏览器扩展​

从扩展发布页下载浏览器扩展(Chrome / Edge / Firefox),安装与使用见浏览器扩展。

升级​

macOS 用新 DMG 替换应用,Windows 运行新版安装程序覆盖安装,Linux 用新版 AppImage 替换旧文件(可先保留旧文件以便回退)。资源库目录和用户配置独立于应用安装目录,通常会保留;升级前建议备份资源库。跨版本迁移和平台差异请以发布说明为准。

应用内「帮助 → 关于 → 检查更新」在 Linux 上会按本机架构识别 Serpent-linux-x86-64-<版本>.AppImage 或 Serpent-linux-arm64-<版本>.AppImage 便携资产;下载校验后需自行 chmod +x 再运行。