桌面应用CLI【免费下载链接】ludusaviBackup tool for PC game saves项目地址https://gitcode.com/GitHub_Trending/lu/ludusavi点击查看免费下载LudusaviPC 游戏存档备份工具将配置、日志与数据清单统一存放在一个应用文件夹中本文基于官方帮助文档 application-folder.md结合仓库源码系统讲解该目录在 Windows / Linux / macOS 各平台的确切位置、便携模式portable mode的判定机制与适用场景、目录内关键文件config.yaml、manifest.yaml等的职责并给出通过命令行定位与导出配置的实操方法。读完本文你将能精准找到 Ludusavi 的配置文件、理解ludusavi.portable标志文件的工作原理并在多机迁移、U 盘随身携带等场景下正确规划数据存放。一、Ludusavi 应用文件夹是什么Ludusavi 是一个绿色的 PC 游戏存档备份工具它的程序本体可以放在任意位置直接运行安装指南 明确说明下载的可执行文件是便携的放哪里都行但它的配置、日志、数据清单并不会跟随可执行文件而是集中写入一个统一的应用文件夹application folder。官方文档给出各平台默认位置如下平台默认应用文件夹路径Windows%APPDATA%\ludusaviLinux$XDG_CONFIG_HOME/ludusavi或~/.config/ludusaviLinuxFlatpak 安装~/.var/app/com.github.mtkennerly.ludusavi/config/ludusavimacOS~/Library/Application Support/ludusaviWindows的%APPDATA%通常展开为C:\Users\用户名\AppData\Roaming因此实际路径一般为C:\Users\用户名\AppData\Roaming\ludusavi。Linux下若已设置XDG_CONFIG_HOME环境变量则优先使用该变量的值否则回落到~/.config。Flatpak沙箱会把配置文件重定向到~/.var/app/com.github.mtkennerly.ludusavi/config/ludusavi其对应的桌面与元数据文件见仓库 assets/flatpak/ 目录com.github.mtkennerly.ludusavi.desktop与com.github.mtkennerly.ludusavi.metainfo.xml。这些默认位置均由操作系统层面的配置目录约定推导而来。在源码中目录定位统一收敛到 src/prelude.rs 的常量APP_DIR_NAME ludusavi即应用文件夹名 配置目录 ludusavi子目录。二、便携模式把配置放到可执行文件旁边默认情况下配置写入系统标准配置目录但在某些场景下你可能希望Ludusavi 把配置存放在与可执行文件相同的目录——官方文档给出的典型场景是从 U 盘在多台电脑上运行 Ludusavi这样配置可以随 U 盘随身携带换电脑即插即用。启用方式非常简单在包含 Ludusavi 可执行文件的目录中创建一个名为ludusavi.portable的文件内容可以为空仅作为标志存在。之后 Ludusavi 就会把应用文件夹解析为可执行文件所在目录本身config.yaml、manifest.yaml、日志等都会写入该目录。底层判定逻辑源码级这一逻辑实现在 src/prelude.rs 的app_dir()函数中优先级如下如果命令行指定了--config目录见下文直接使用该目录否则获取当前可执行文件路径std::env::current_exe()取其所在目录拼接标志文件名ludusavi.portable常量定义于 src/prelude.rs若该标志文件存在则返回可执行文件所在目录作为应用文件夹若不存在回落到系统配置目录 /ludusavi的默认路径。由此可以总结两个要点标志文件只需存在不要求内容非空甚至可以在运行过程中临时创建/删除因为每次启动都会重新判定优先级高于便携模式的是命令行--config参数src/main.rs在main()入口处解析参数后会将指定的配置目录写入全局CONFIG_DIR见 src/main.rs而app_dir()第一步就检查CONFIG_DIR是否已设置。因此--config是比便携标志更硬的覆盖手段。三、应用文件夹里都有什么应用文件夹并不仅仅是存放一处配置它承载了 Ludusavi 运行所需的全部本地状态。核心文件如下1.config.yaml—— 用户配置Ludusavi 的全部设置备份目录、备份格式、游戏过滤、云同步、语言等都保存在名为config.yaml的文件中对应源码 src/resource/config.rs 中Config的FILE_NAME常量。文件结构定义在仓库的 JSON Schema 文档 docs/schema/config.yaml 中每个字段的完整说明可参考 配置文件指南。配置文件不存在时Ludusavi 会以默认配置初始化src/resource.rs 的load_from逻辑若配置文件解析失败Ludusavi 不会直接丢弃它而是把原文件移动到config.invalid.yaml后重新开始见 src/resource/config.rs 的archive_invalid()避免用户手工编辑出错时丢失全部配置。2.manifest.yaml—— 备份数据清单请勿手动修改manifest.yaml是 Ludusavi 的备份数据清单记录了每个游戏需要备份哪些文件/注册表项等元信息。它同样存放在应用文件夹下src/resource/manifest.rs 定义FILE_NAME manifest.yaml路径由app_dir().joined(...)生成。官方文档特别强调不要修改这个文件因为每当 Ludusavi 下载到新版本清单时都会整体覆盖你做的改动。清单支持多数据源主清单名为manifest.yaml备用源则以manifest-名称.yaml命名src/resource/manifest.rs。3. 日志文件与其余状态程序日志也写入应用文件夹src/main.rs在初始化日志器flexi_logger时将日志目录指向app_dir()见 src/main.rs 与 src/main.rs。此外云端备份缓存Cache等资源文件同样通过 src/resource.rs 的ResourceFile::path()统一落在app_dir()下。小结凡是 Ludusavi 需要记住的东西几乎都以app_dir()为根目录。理解了第一节与第二节的路径解析规则就等于掌握了整个程序的状态存储布局。四、命令行实战定位与导出配置Ludusavi 的 CLI 提供了两个与配置目录直接相关的子命令方便脚本化运维# 打印 config.yaml 的完整路径 ludusavi config path # 以 YAML 格式打印当前生效的配置内容 ludusavi config show # 以 JSON 格式打印配置内容 ludusavi config show --api # 打印配置文件的默认值而非当前生效值 ludusavi config show --default这些子命令在 src/cli.rs 中实现config path直接调用Config::path().render()输出绝对路径config show则把当前配置序列化为 YAML 或 JSON--api走 JSON--default先重置为默认配置再输出。在多台机器间同步配置时可以先config show导出再放到另一台机器的应用文件夹中作为config.yaml使用。启动时还可以用--config 目录参数显式指定应用文件夹此参数在main()入口处生效并覆盖便携模式判定见 src/main.rs适合在 CI 或脚本中隔离不同任务的配置。五、典型使用场景与注意事项U 盘 / 便携介质在可执行文件所在目录创建ludusavi.portable空文件即可之后配置与清单都会保存在该目录换电脑无需重新配置注意Windows 下%APPDATA%默认路径与便携目录中的配置是互斥的——便携标志存在时默认目录中的配置不会被读取反之亦然。迁移时只需保证标志文件与期望的配置文件在同一个目录即可。Flatpak 沙箱限制Flatpak 版本的应用文件夹位于~/.var/app/com.github.mtkennerly.ludusavi/config/ludusavi且默认仅有受限的文件系统访问权限~与/run/media见 安装指南。如果备份目标超出这些范围需要自行调整 Flatpak 权限。manifest.yaml 的只读纪律清单文件是 Ludusavi 判定备份什么的依据任何手工修改都会在下次清单更新时被覆盖官方文档明示。若确实需要自定义备份规则应通过自定义游戏功能实现相关说明见 自定义游戏而不是直接改清单。配置损坏的兜底手工编辑config.yaml语法出错时Ludusavi 会自动把损坏文件改名为config.invalid.yaml并用默认配置继续运行src/resource/config.rs。恢复时把config.invalid.yaml修复后改回config.yaml即可无需担心旧配置被立即抹除。六、相关文档配置文件指南config.yaml各字段说明配置 SchemaJSON Schema 定义安装指南各平台安装方式与便携性说明命令行参考config子命令及完整 CLI 用法备份结构备份文件在目标目录中的组织方式赞分享桌面应用CLI【免费下载链接】ludusaviBackup tool for PC game saves项目地址https://gitcode.com/GitHub_Trending/lu/ludusavi点击查看免费下载相关推荐Cemu便携模式配置文件与数据目录管理Cemu便携模式配置文件与数据目录管理 引言为什么需要便携模式 还在为Cemu模拟器的配置文件散落各处而烦恼吗每次重装系统或更换电脑时都要重新配置所有虚拟化MarkText 应用数据目录完全指南跨平台位置、便携模式与数据备份MarkText 应用数据目录完全指南跨平台位置、便携模式与数据备份 MarkText 的每用户应用数据目录Application Data Directo桌面应用富文本UniGetUI 便携模式Portable Mode完整指南数据目录重定向、标记文件与安装器配置UniGetUI 便携模式Portable Mode完整指南数据目录重定向、标记文件与安装器配置 本指南基于仓库官方文档 docs/PORTABLE.md桌面应用开发工具跨平台上一篇acpx提示技巧清单exec、stdin、--file、--no-wait队列的6种正确姿势下一篇快速上手二进制挑战ctf-pwn堆栈溢出/ROP/Heap技巧与ctf-reverse抗分析/VM逆向实战清单创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考