★ FEATURED ARTICLE 桌面应用游戏开发CLI【免费下载链接】RimSortRimSort is an open source mod manager for the video game RimWorld. There is support for Linux, Mac, and Windows, built from the ground up to be a reliable, community-managed alternative to RimPy Mod Manager.项目地址https://gitcode.com/gh_mirrors/ri/RimSort点击查看免费下载RimSort 是一款面向《环世界》(RimWorld) 的开源跨平台 Mod 管理器官方为 Windows、macOS、Linux 提供预编译的二进制发行版。本文以官方安装文档 docs/user-guide/downloading-and-installing.md 为主体结合仓库源码如 app/utils/app_info.py、app/main.py、app/utils/update_utils.py深入讲解发行版类型的选择、三大平台的安装启动步骤、Linux 下 RimWorld 与 RimSort 的路径布局、Qt 依赖补齐以及常见故障排查读完即可独立完成任一平台的安装与验证。发行版类型Stable 与 EdgeRimSort 官方发布两种类型的发行版Release类型更新频率稳定性适用场景Stable稳定版较低定期发布高经过充分测试绝大多数用户日常使用Edge边缘版较高频繁发布较低更可能存在 Bug想第一时间体验新功能、并愿意反馈问题的用户选择发行版时需要同时考虑三个因素操作系统Windows / macOS / Linux、CPU 架构x86_64 / ARM64以及自身需求是否需要 Steamworks 深度集成、纹理压缩等附加能力。各平台的启动方式有所差异详见下文。⚠️重要提醒绝大多数用户应当使用预编译发行版而不是从仓库页面通过Code Download ZIP下载源码。ZIP 下载的是未编译的源代码无法直接运行只有在计划参与贡献、自行构建 RimSort 或通过 Python 解释器运行源码时才需要获取源码源码运行方式见 docs/development-guide/development-setup.md。Windows 安装Windows 平台提供Windows x86-64发行版安装步骤非常简洁下载并解压Windows x86-64发行版压缩包进入解压目录运行可执行文件RimSort.exe。关于杀毒软件误报的说明Windows 上运行RimSort.exe时有可能被 Windows Defender 等杀毒软件误报并直接删除。这是使用 Nuitka 将 Python 程序编译为可分发的可执行文件、且未进行代码签名所产生的副作用——代码签名证书价格昂贵且需要持续续费项目无力承担。RimSort 本身是安全的用户可以放心地在杀毒软件中为该程序添加白名单。如果不放心也可以将可执行文件提交到 VirusTotal 等在线多引擎扫描服务综合多家杀毒引擎的意见后再自行判断。从源码结构看该可执行文件由distribute.py驱动 Nuitka 编译app/包生成见 docs/development-guide/development-setup.md 的 Packaging RimSort 一节因此单文件可执行、体积大、启动稍慢都属于 Nuitka 冻结freeze后的正常特征并不代表程序有问题。macOS 安装macOS 用户需要根据 CPU 架构选择对应发行版ARM64Apple SiliconM1/M2 及更新机型x86_64Intel 芯片的 Mac。安装步骤下载并解压与 CPU 架构匹配的 Darwin/macOS 发行版使用xattr命令规避 Gatekeeper 并放行RimSort.app与libsteam_api.dylib打开应用包RimSort.app。Gatekeeper 放行xattrApple 的系统运行时保护机制 Gatekeeper 可能会阻止 RimSort 启动甚至提示应用已损坏。可以通过xattr命令手动移除隔离属性来放行xattr -d com.apple.quarantine /path/to/RimSort.app xattr -d com.apple.quarantine /path/to/libsteam_api.dylib把/path/to/替换为文件/文件夹的实际路径例如xattr -d com.apple.quarantine /Users/John/Downloads/RimSort.app在 docs/development-guide/development-setup.md 的 Manually building 一节中同样的xattr操作被推荐给源码运行/自建版本的用户说明这是 macOS 上无论发行版还是源码方式都通用的必经步骤。Apple Silicon 上的额外注意如果出于某种原因在 Apple Silicon 上运行x86_64构建即通过 Rosetta 2 转译不要启用 watchdog 功能todds 纹理压缩工具目前截至 2023 年 5 月不支持 Apple SiliconM1/M2 ARM64 CPU。watchdog 是 RimSort 内置的文件监视功能源码位于 app/utils/watchdog.py默认开启app/models/settings.py 中watchdog_toggle默认为True用于监听appworkshop_294100.acf等 Steam 文件变化以自动刷新 Mod 状态。在 Rosetta 转译环境下它可能引发异常故官方建议关闭。Linux 安装Linux 平台提供多种安装形态按推荐程度依次为AppImage推荐、Ubuntu Tarball、源码运行最后手段。AppImage推荐AppImage 是最简单的运行方式它打包了全部依赖无需安装任何东西即可在绝大多数发行版上运行。从发布页面下载.AppImage文件赋予可执行权限并运行chmod x RimSort-*.AppImage ./RimSort-*.AppImageFUSE 依赖AppImage 运行依赖 FUSE2。大多数发行版自带但如果遇到 FUSE 相关报错可以通过包管理器安装fuse2/libfuse2或改用--appimage-extract-and-run参数绕过 FUSE 直接解压运行./RimSort-*.AppImage --appimage-extract-and-run桌面集成如需自动加入桌面应用菜单并方便更新可以考虑 AppImageLauncher 这类工具它会将 AppImage 注册进桌面环境使其像普通已安装应用一样出现在应用菜单中。自更新机制以 AppImage 方式运行时RimSort 内置的更新器会原地替换AppImage 文件旧版本先备份为.bak下次启动时自动清理。这一行为在源码中有明确实现app/utils/update_utils.py 的_prepare_appimage_update()会将新版本写入运行中 AppImage 同目录下的.new文件随后在更新流程中通过.bak重命名作为备份跳过 ZIP 备份逻辑app/utils/app_info.py 的_cleanup_appimage_backup()在应用初始化时自动清理上次更新遗留的.bak文件由于 AppImage 的application_folder是只读的 FUSE 挂载点更新器会改为在.AppImage文件自身所在的目录进行替换对应is_appimage判断见 app/utils/app_info.py 中基于$APPIMAGE环境变量的检测逻辑。由此可以推断AppImage 必须放在用户可写的目录中否则自更新会失败详见下文故障排查。Ubuntu Tarball预编译的 Tarball 发行版基于 Ubuntu 22.04 与 24.04 构建也可能在其他基于 Debian 的发行版或 glibc 版本兼容的发行版上运行但不保证兼容性。下载并解压与你 Ubuntu 版本匹配的.tar.gz或.zip发行版运行可执行文件./RimSort⚠️ 如果所有预编译发行版在你的发行版上都无法运行可以自行从源码构建或通过 Python 解释器运行具体步骤见 docs/development-guide/development-setup.md。Qt 依赖RimSort 使用 QtPySide6构建 GUI。使用 Tarball 发行版而非 AppImage时系统可能缺少 Qt 共享库最常见的缺失库是libxcb-cursor。Debian / Ubuntusudo apt install libxcb-cursor0如果还有其他缺失库可用apt-file定位所属软件包sudo apt install apt-file apt-file update apt-file search libxcb-whatever.soFedora / RHELsudo dnf install xcb-util-cursor使用dnf provides查找其他缺失库对应的软件包dnf provides */libxcb-whatever.so*Arch / Manjarosudo pacman -S xcb-util-cursor使用pkgfile搜索缺失库pkgfile libxcb-whatever.so提示文档中以libxcb-whatever.so作为占位符实际排查时应替换为报错信息中出现的真实库名。Linux 上的 RimWorld 路径RimSort 需要知道 RimWorld 的安装位置以及配置存放位置这两类路径会因 Steam 与 RimWorld 的安装方式不同而变化。⚠️官方强烈推荐使用发行版软件源安装的原生 SteamNative Steam RimWorld 原生 Linux 版本这是兼容性最好的组合方式。Native Steam推荐路径类型位置游戏安装目录~/.local/share/Steam/steamapps/common/RimWorld/配置文件夹~/.config/unity3d/Ludeon Studios/RimWorld by Ludeon Studios/Config/Workshop Mod~/.local/share/Steam/steamapps/workshop/content/294100/存档~/.config/unity3d/Ludeon Studios/RimWorld by Ludeon Studios/Saves/如果 Steam 库安装在其他磁盘/分区上游戏安装目录与 Workshop 路径应改为该库对应的steamapps/目录。294100是 RimWorld 的 Steam App ID在 app/utils/constants.py 中以常量RIMWORLD_STEAM_APP_ID 294100定义RimSort 依据它定位 Workshop 内容目录。Flatpak Steam通过 Flatpak 安装的 Steam 会把所有路径沙箱化到~/.var/app/com.valvesoftware.Steam/下路径类型位置游戏安装目录~/.var/app/com.valvesoftware.Steam/.local/share/Steam/steamapps/common/RimWorld/配置文件夹~/.config/unity3d/Ludeon Studios/RimWorld by Ludeon Studios/Config/Workshop Mod~/.var/app/com.valvesoftware.Steam/.local/share/Steam/steamapps/workshop/content/294100/⚠️Snap 版 Steam 不受支持且不推荐Snap 包存在已知的游戏兼容性问题且未获得 Valve 官方支持请改用原生.deb包或 Flatpak 版本。Proton通过 Steam Play 运行 Windows 版 RimWorld如果通过 Proton 运行 Windows 版 RimWorld 而非原生 Linux 版配置文件夹位于 Proton 的虚拟 Windows 文件系统中路径类型位置配置文件夹~/.local/share/Steam/steamapps/compatdata/294100/pfx/drive_c/users/steamuser/AppData/LocalLow/Ludeon Studios/RimWorld by Ludeon Studios/Config/存档~/.local/share/Steam/steamapps/compatdata/294100/pfx/drive_c/users/steamuser/AppData/LocalLow/Ludeon Studios/RimWorld by Ludeon Studios/Saves/游戏安装目录与 Workshop Mod 路径与 Native Steam 相同。若使用 Flatpak Steam Proton需要在 compatdata 路径前加上~/.var/app/com.valvesoftware.Steam/前缀。通过 Proton 运行时RimWorld 可执行文件是RimWorldWin64.exe或RimWorldWin.exe而不是RimWorldLinux。RimSort 会自动检测两者但手动设置路径时需要留意。原生 Linux 版 RimWorld 优于 Proton路径更简单与 RimSort 各功能的兼容性更好。RimSort 自身的数据位置RimSort 使用platformdirs库按照各平台惯例存放自身数据。在 Linux 上数据类型位置应用数据 / 设置~/.local/share/RimSort/日志~/.local/state/RimSort/log/RimSort.log源码层面这些路径由 app/utils/app_info.py 的AppInfo单例类解析非开发模式下通过PlatformDirs(appnameRimSort, appauthorFalse)的user_data_dir与user_log_dir得到上述目录并派生dbs数据库、modlistsMod 列表、themes主题、backups备份等子目录。若以--dev参数运行源码开发模式则所有数据会重定向到仓库根目录下的dev/子目录避免污染生产数据。开启调试日志在应用数据目录中创建一个名为DEBUG的空文件即可启用调试级日志touch ~/.local/share/RimSort/DEBUG这个机制在源码中有直接对应见 app/main.py —— 非开发模式下程序检查AppInfo().app_storage_folder / DEBUG是否存在且为文件若存在则将日志级别设为 DEBUGsetup_logging中file_level DEBUG if debug else INFO见 app/utils/log_setup.py。Wayland 与 X11RimSort 基于 PySide6Qt6原生支持 Wayland大多数情况下无需额外配置即可正常运行。如果在 Wayland 下遇到渲染异常或崩溃可以通过 XWayland 强制使用 X11 模式QT_QPA_PLATFORMxcb ./RimSortAppImage 版本同理QT_QPA_PLATFORMxcb ./RimSort-*.AppImage故障排查glibc 版本不匹配Tarball 预编译发行版链接的是 Ubuntu 的 glibc如果你的发行版 glibc 版本较旧会报出类似GLIBC_2.xx not found的错误。此时请改用 AppImage或从源码构建。AppImage 无法启动FUSE 错误从包管理器安装fuse2或libfuse2或者使用--appimage-extract-and-run参数绕过 FUSE 要求。AppImage 自更新失败AppImage 必须位于用户可写目录。如果放在需要 root 权限的位置如/opt/请将其移动到主目录或手动更新。Steam 集成不工作启动 RimSort 前请确保 Steam 已在运行——Steamworks API 需要活跃的 Steam 客户端连接源码中通过SteamworksPy模块与本地 Steam 客户端交互对应 libs/ 目录下的SteamworksPy*.so/.dylib/.dll预编译库。若使用 Flatpak Steam在沙箱外运行的 RimSort 可能无法与之通信官方推荐使用原生 Steam。Mod 路径未检测到如果 RimSort 找不到 Mod 或配置请确认你使用的 Steam 安装方式原生、Flatpak 或 Snap并在 RimSort 设置中手动指定路径路径表参见上文 RimWorld 路径章节。最后的办法——从源码运行如果所有预编译发行版在你的环境都无法运行可以直接通过 Python 解释器运行源码完整步骤参见 docs/development-guide/development-setup.md概览克隆仓库含子模块→uv sync安装依赖 →uv run python -m app启动。小结安装 RimSort 的核心要点可以归纳为四条一是优先选择与平台、CPU 架构匹配的Stable预编译发行版二是按平台处理系统级障碍Windows 杀毒误报、macOS Gatekeeper 放行、Linux Qt 依赖与 FUSE三是在 Linux 上根据 Steam 安装方式原生 / Flatpak / Proton正确理解 RimWorld 与 RimSort 的路径布局四是遇到问题时善用DEBUG文件启用调试日志、查看~/.local/state/RimSort/log/RimSort.log定位原因。对希望深度定制或排查疑难问题的用户docs/development-guide/development-setup.md 提供了从源码构建与运行的完整指引。赞分享桌面应用游戏开发CLI【免费下载链接】RimSortRimSort is an open source mod manager for the video game RimWorld. There is support for Linux, Mac, and Windows, built from the ground up to be a reliable, community-managed alternative to RimPy Mod Manager.项目地址https://gitcode.com/gh_mirrors/ri/RimSort点击查看免费下载相关推荐RimSort 下载与安装完整指南Stable/Edge 发行渠道、Windows/macOS/Linux 部署与 RimWorld 路径排障RimSort 下载与安装完整指南Stable/Edge 发行渠道、Windows/macOS/Linux 部署与 RimWorld 路径排障 本文以 Rim桌面应用游戏开发CLIPaper 服务器插件实测指南10 个插件按服务器生长阶段装完Paper 服务器插件实测指南10 个插件按服务器生长阶段装完 本文是 Paper 服务器的插件选型与安装指南Paper 是目前使用最广泛的高性能 Mine后端游戏开发OpenDiablo2 运行配置指南config.json 详解与跨平台 MPQ 路径调整OpenDiablo2 运行配置指南config.json 详解与跨平台 MPQ 路径调整 OpenDiablo2 是一款使用 Go 语言编写的开源暗黑破坏神游戏开发图形学上一篇WB Python SDK 变更日志深度解读从 0.6 到 0.30 的版本演进、破坏性变更与升级指南下一篇测量并守护 Node.js 内存使用nodebestpractices 生产环境实战指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
