📖 本文由 Batocera 官方 Wiki 翻译整理，内容可能随版本更新而变化。

---

游戏收藏夹设置指南

想要在大堆游戏中快速找到心头好？你可以通过“游戏收藏夹”功能来打理你的私人游戏库。

自定义收藏夹（Custom collections）

在进入正题前，有一个小小的版本说明：
【注意】自定义收藏夹目前已经处于“过时（Deprecated）”状态，官方更推荐使用下文提到的功能更强大的动态收藏夹（Dynamic collections）。虽然 Batocera 36 依然支持已有的静态自定义收藏夹，但专门的辅助创建工具 Batocera-create-collection 已经从新版本中移除了。

---

收藏夹的“秘密基地”

你的私人收藏夹文件都统一存放在 /userdata/system/configs/EmulationStation/collections/ 这个目录下。

生活化类比：收藏夹文件就像一张“点歌单”。它本身不包含歌曲（游戏文件），只是记录了歌曲在点歌机（硬盘）里的具体位置。

这些文件其实就是简单的纯文本文件，你可以通过系统界面进行编辑，也可以像打开记事本一样手动修改它们。例如，一个名为 custom-mario.cfg 的马里奥主题收藏夹，其内部结构看起来是这样的：


/userdata/roms/gameandwatch/Mario Bros. (Nintendo, Multi Screen).mgw
/userdata/roms/NES/Mario Bros (NES).zip
/userdata/roms/gb/Super Mario Land (World) (Rev A).zip


---

快捷创建小技巧（仅限旧版本）

如果你使用的是 Batocera 5.26 及以上、但低于 36 的版本，可以使用内置的命令工具来快速搞定：

• 第一步：确定关键词
  想好你想整理的游戏主题，比如“马里奥”。
• 第二步：运行命令
  在终端输入 Batocera-create-collection mario。
• 第三步：自动生成
  系统会自动搜寻所有名字或描述中带有“Mario”字样的游戏，并为你生成一个名为 custom-mario.cfg 的文件。

---

玩转高级自定义收藏：精准筛选你的游戏

如果你觉得自动搜索范围太广，还可以通过命令行参数对收藏夹进行“精细化修剪”。你可以指定只在某个特定机种里搜索，或者只筛选特定的游戏类型。

生活化类比：这就像是在图书馆找书。普通的搜索是在全馆范围内找“球类”，而高级搜索可以让你指定“只在二楼的体育类书架（特定系统）上找带‘球’字（关键字）的书”。

---

进阶操作：分步骤构建主题收藏

假设你想创建一个名为 “ballers” 的收藏夹，专门收集红白机（NES）和 Gameboy（GB）上的所有“球类”游戏：

• 第一步：建立基础收藏（以 NES 为例）
  输入以下命令，系统会筛选出 NES 系统中所有含 “ball” 关键字的游戏并保存到 “ballers” 收藏夹中：
  batocera-create-collection -c ballers -s NES ball

• 第二步：追加其他系统游戏（以 GB 为例）
  再次运行命令，这次指定 GB 系统，游戏会自动追加到同一个收藏夹文件中：
  batocera-create-collection -c ballers -s gb ball

【注意】为了让搜索生效，你的游戏必须已经完成了刮削（Scraped）。只有这样，系统才能读取到游戏库中的名称和类型信息，特别是对于那些文件名晦涩难懂的街机游戏（如 MAME 或 Final Burn Neo）。

---

命令行工具参数手册

如果你想深入研究，这里是该工具的参数说明：

参数	说明	示例
-c [收藏夹名]	指定生成的配置文件名称。系统会自动保存为 custom-[名称].cfg。	-c foobar 会生成 custom-foobar.cfg
-g [类型]	只添加符合特定游戏类型（Genre）的游戏。	-g Shooter 只添加射击类游戏
-s [系统]	指定只搜索某个特定机种目录下的游戏。	-s SNES 只搜索超级任天堂的游戏
search_terms	你要搜索的关键字（通常放在命令最后）。	ball 或 mario

---

【提示】脚本功能详解

根据官方脚本库的信息，batocera-create-collection 是一个强大的自动化助手，它通过读取你每个机种目录下的 gamelist.xml 文件来提取信息。只要你的游戏元数据足够准确，它就能帮你快速搭建起井井有条的游戏仓库。

• -h：显示此帮助信息。

【提示】如果你创建的收藏夹名称与现有的重复，系统不会覆盖旧文件，而是会将新找到的游戏追加（Append）到列表中。

---

实战演练：这些例子能帮你快速上手

为了让你更直观地理解，我们来看几个具体的应用场景：

• 全平台搜寻：
  输入 Batocera-create-collection zelda，系统会把所有名字里带“Zelda”的游戏塞进一个收藏夹。
• 处理空格：
  如果你搜“最终幻想”，输入 Batocera-create-collection "final fantasy"，系统会生成一个名为 custom-final.fantasy.cfg 的文件。
• 精准排他：
  如果你只想看 NBA 篮球，不想看到弹珠台（Pinball），可以加上空格限制。
  输入 Batocera-create-collection -c basketball 'nba '。
  > 生活化类比：这就像是在找“周杰”的歌，如果不加限定，系统可能会把“周杰伦”的歌也推给你。加个空格就像是告诉系统：“我就要这两个字，后面别跟着乱七八糟的。”
• 按类型一键归类：
  想玩平台跳跃游戏？输入 Batocera-create-collection -c plateformers -g Plateform，所有该类型的游戏都会集合到 custom-plateformers.cfg。
• 全家桶备份：
  输入 batocera-create-collection -c all 可以在一个文件里列出你系统中的所有游戏。
  【注意】如果你的游戏存量惊人，这个过程会比较耗时，请耐心等待。
• 跨平台组合：
  想把红白机（NES）和 Gameboy（GB）上的塞尔达合在一起？
  第一步：执行 Batocera-create-collection -s NES zelda。
  第二步：接着执行 Batocera-create-collection -s gb zelda。

---

你需要避开的“小坑”（Gotchas）

在输入命令时，请留意以下细节：

• 大小写敏感度：
  • 游戏搜索词和系统名称：是不区分大小写的（写大写小都行）。
  • 游戏类型（Genres）：是严格区分大小写的！
    【注意】这是由于不同刮削器（Scrapers）抓取的数据标准不一，所以搜类型时请务必确保拼写和大小写与系统显示一致。

---

动态收藏夹（Dynamic collections）

动态收藏夹（Dynamic collections）

从 Batocera 5.26 版本开始，你可以在 EmulationStation 游戏前端中直接创建更加智能的“动态收藏夹”。

生活化类比：动态收藏夹就像是电子邮箱里的“自动分类规则”或“智能文件夹”。你只需要设定好过滤条件（比如：发件人是谁、标题包含什么关键词），此后每当你收到符合条件的新邮件，它们就会自动出现在那个文件夹里。

Batocera 的动态收藏夹也是同理：你先设定好规则（比如：匹配游戏名中的某个词、指定某个机种或特定游戏类型），以后每当你添加新的 游戏镜像（ROMs），只要它们符合规则，就会自动出现在收藏夹中。

这种方式最酷的地方在于：你可以把自己的动态收藏夹规则分享给朋友，即便你们的游戏文件列表不完全一样，或者文件名有些许差别，这套规则依然能在他的系统上精准生效。

---

实战演习：创建一个“Capcom 游戏合集”

让我们以创建一个收集所有 Capcom 公司游戏的动态收藏夹为例，按照以下步骤操作：

• 第一步：进入设置菜单
  在系统主界面打开游戏收藏设置（GAME COLLECTION SETTINGS）。
• 第二步：新建动态收藏
  选择创建新的动态收藏（CREATE NEW DYNAMIC COLLECTION）。
• 第三步：为它命名
  在弹出的输入框中填入“Capcom”，然后确认。

【提示】这只是建立了一个“空的筛选规则”，接下来你还需要根据系统提示设定具体的过滤条件（如：开发商包含 Capcom），这样你的新收藏夹才能把分散在各个机种里的 Capcom 游戏一网打尽。

在接下来的菜单里，你可以为这个动态收藏夹设置各种“过滤器”，让它变得非常聪明。

开启强大的过滤功能

你可以根据多种维度来筛选游戏，系统提供的选项非常丰富：
* 机种（Systems）
* 类型（Genre）
* 发行商/开发商（Publisher/Developer）
* 玩家人数（Number of players）
* 评分、语言、地区，甚至连“是否玩过”或“是否适合儿童”都能作为筛选条件。

---

操作指南：定制你的 Capcom 合集

• 第一步：耐心等待加载
  为了列出所有可用的选项，系统会扫描（Parse）你所有的 gamelist.xml 元数据文件。
  【注意】如果你的游戏非常多，加载可能会比较慢。例如，在拥有 12,000 个游戏镜像的情况下，加载“发行商”列表可能需要一分钟以上的时间。
• 第二步：勾选相关选项
  在发行商列表里，勾选所有和 Capcom 相关的条目。
  【提示】具体的条目名称取决于你的刮削元数据（Scraping metadata），你可能会看到诸如 “CAPCOM”、”CAPCOM CO., LTD.” 或 “CAPCOM U.S.A., INC.” 等不同的写法，把它们都选上即可。
• 第三步：确认完成
  选好后，你的新动态收藏夹就大功告成了！所有 Capcom 游戏现在都会整整齐齐地躺在这里。

---

如何微调或修改收藏夹

如果你以后想修改过滤规则，操作也非常简单：

• 第一步：在 EmulationStation 中进入你刚创建的这个收藏夹。
• 第二步：按下手柄上的 SELECT 键。
• 第三步：选择编辑动态收藏过滤器（EDIT DYNAMIC COLLECTION FILTERS）即可重新调整。

生活化类比：这就像是为一个自动扫地机器人重新划定“清扫禁区”或者“重点清扫区”，你不需要重新买一台机器，只需要在设置里微调一下规则，它就会按照新的指令去工作了。

进阶管理：动态收藏夹的“幕后”文件

动态收藏夹在系统中是以 XML 格式（eXtensible Markup Language） 文件存储的。它们统一存放在 /userdata/system/configs/EmulationStation/collections/ 目录下（例如我们刚才创建的 Capcom.xcc）。

如果你更喜欢敲代码，也可以通过 SSH 远程连接（Secure Shell） 登录系统，手动修改这些文件。

生活化类比：如果把图形化菜单比作快餐店的自助点餐机，那么手动编辑文件就像是直接把需求写给后厨的厨师。虽然看起来有点复杂，但对于“老饕”来说，这往往更直接、更精准。

文件的内容结构如下：

<?xml version="1.0"?>
<filter name="Capcom">
<pubDev>CAPCOM CO., LTD.</pubDev>
<pubDev>CAPCOM</pubDev>
<pubDev>CAPCOM U.S.A., INC.</pubDev>
</filter>

---

文件夹的高级权限设置（Setup folders at Gamelist）

在 Batocera 中，不仅单个游戏文件可以被设置为“收藏”或“隐藏”，整个文件夹也可以。你可以批量决定某个文件夹是否对儿童开放，或者是否在列表中消失。

【注意】文件夹的这类高级设置目前无法在系统界面直接操作，你需要通过编辑 gamelist.xml 文件来手动完成。

• 第一步：定位文件
  找到你想要修改的游戏目录下的 gamelist.xml。
• 第二步：插入文件夹控制标签
  在文件中加入 <folder> 相关的控制代码。

操作示例：
如果你想隐藏名为 _HACKS 的文件夹，配置代码如下：

<folder>
<path>./_HACKS</path>
<favorite>false</favorite>
<kidgame>false</kidgame>
<hidden>true</hidden>
</folder>

---

标签含义速查表

标签 (Tags)	说明
path	文件夹的路径
favorite	是否设为“我的最爱” (true/false)
kidgame	是否设为“儿童模式游戏” (true/false)
hidden	是否彻底隐藏该文件夹 (true/false)

---

原文: 游戏收藏界面设置 • 翻译: DIY8 Bot