在 Linux 上安装书笙乐谱（AppImage）

适用于 0.10 及以后版本。Linux 版是一个单文件 .AppImage，不需要安装包管理器，也不需要 root；下载、给执行权限、运行，三步就能打开。

一、在官网下载 Linux 版

打开 ssscore.qzss.top，拉到「下载」区，点 Linux 那张卡（会写着「已开放下载」），点「下载」拿到的文件名形如 SSScore-0.10-…-linux-x86_64.AppImage，约 120MB。

官网「下载」区：按设备选卡，Linux 已开放下载

二、给执行权限并运行

在文件所在目录打开终端：

chmod +x SSScore-0.10-…-linux-x86_64.AppImage
./SSScore-0.10-…-linux-x86_64.AppImage

第一次启动会弹出主界面；之后每次双击这个文件就能打开。

三、没有 FUSE 的机器（容器、精简发行版）

AppImage 默认要挂载自身，缺 FUSE 时会提示 dlopen(): error loading libfuse.so.2 或直接没反应。两种办法：

• 装 FUSE 库：Debian/Ubuntu 上 sudo apt install libfuse2；
• 或者不挂载，直接解包运行：

./SSScore-0.10-…-linux-x86_64.AppImage --appimage-extract
./squashfs-root/usr/bin/sss

解包后的 squashfs-root 可以留在任意目录，以后直接跑里面的 usr/bin/sss。

四、第一次启动：听得见声音前要等音色库

安装包不含播放音色库（约 49MB）。第一次启动后它会在后台安静下载，不挡着打开谱面；写着写着就好了，关掉软件也会继续下完。只有你在音色没好时点了播放，才会显示进度，下完自动接着播。

音色库没就绪时点播放，会显示下载进度并自动续播

下载失败时可以重试，也可以手动放置：把 MS Basic.sf3 放到 ~/文档/SSScore/SoundFonts（中文系统）或 ~/Documents/SSScore/SoundFonts（英文系统）。完整步骤见 播放没有声音：补上播放音色库。

五、放到「应用程序」里（可选）

想在应用菜单里看到图标，把自己那份的路径写进一个 .desktop 文件：

mkdir -p ~/.local/share/applications
cat > ~/.local/share/applications/SSScore.desktop <<'EOF'
[Desktop Entry]
Type=Application
Name=书笙乐谱
Exec=/home/你的用户名/应用/SSScore-0.10-…-linux-x86_64.AppImage
Icon=audio-x-generic
Terminal=false
Categories=AudioVideo;Audio;Music;
EOF

把 Exec= 换成你自己的实际路径即可；有些桌面环境需要再执行 update-desktop-database ~/.local/share/applications。

六、常见问题

• 双击没反应：多半是没有执行权限，先 chmod +x；仍不行看下一条。
• 提示缺 libfuse：按第三节装 libfuse2，或改用 --appimage-extract 解包运行。
• Wayland 桌面下显示异常：可以临时用 QT_QPA_PLATFORM=xcb 启动，或确认系统装了 xcb 相关库。
• 怎么升级：Linux 版暂未接入自动更新，下载新的 .AppImage 替换旧文件即可；音色库会复用本机已有的那份，不会重新下载。

七、已知限制

• 安装包未做签名：不影响使用，但更新器只负责下载，升级要你自己换文件。
• 自动更新与增量更新尚未接入，暂不提供回滚。
• macOS 版与移动端随后续版本开放。