书架与导入

书架上的每部作品都是本地书架里的一条记录。导入不会移动、重命名或删除任何游戏文件：栞只记住游戏在哪里，以及它对应哪个目录条目。

导入文件夹#

• 桌面版0.2.8 已提供
• 网页版不适用

打开导入并选择文件夹，有三种扫描方式：

单次扫描上限为 4,000 个文件夹、60,000 个条目、120 秒或 300 部游戏，很大的硬盘建议分文件夹导入。

栞会为每个游戏文件夹选择启动程序，并跳过安装、卸载、补丁、配置工具和运行库程序。如果文件夹里同时有原版和汉化版程序（文件名带 CHS、_CN、汉化 等），会建议把汉化版作为启动程序，另一个记为原版。这只依据文件名判断，请检查并按需修改。程序内的版本信息也会用来区分游戏本体和启动器。

在你确认检查列表之前，不会写入任何内容。

作品如何匹配#

每个候选项都会与你启用的目录来源比对，并给出可信度：

• 高：路径已经关联过、标题唯一且完全一致，或匹配度很高且与第二名差距明显。默认勾选，但可以取消或更改。
• 中：看起来合理，需要你手动勾选。
• 低：手动搜索，或只作为本地记录导入、不关联目录条目。

新作品的状态默认为想玩。如果候选项对应的作品已在书架上，只会补全空着的路径字段，其他内容不会被覆盖。

目录来源：鲲 Galgame（默认优先）、VNDB、Shionlib 和 Bangumi。TouchGal 只有在配置了 API 密钥后才会出现，而且只填写空着且未锁定的字段。NextMoe 可以在搜索设置中启用。

手动修改作品的标题、原名、封面、简介、开发商或发售日后，该字段会被锁定，之后的自动刷新不会改动它。

游戏指纹#

• 桌面版0.2.8 已提供
• 网页版不适用

游戏指纹还能根据文件本身协助识别发行版本与版次；任何联网查询都需要你同意。详见游戏指纹。

Steam 游戏#

• 桌面版0.2.8 已提供
• 网页版不适用

• 本机已安装的游戏：栞读取 Steam 的库文件夹与应用清单，以及 Steam 为你的账号记录的本地游玩时间。
• 完整的 Steam 游戏库：通过网站关联 Steam（见 Steam），或使用你自己的 Steam Web API 密钥。密钥只在这次导入中使用，不会保存。

只有 VNDB 中有精确的 Steam 与发行版本对应关系的游戏才会导入，其他游戏会列为“已排除”或“未确定”，交给你自行处理。“仅日文作品”筛选默认开启。Steam 没有提供的游玩时间保持为空，不会记成 0。

手动添加#

• 桌面版0.2.8 已提供
• 网页版已可用

使用手动添加新建记录，或在目录中搜索作品直接加入书架，无需磁盘上有文件。在网站上，请使用书架的添加作品（见网页版书架）。

拖放#

• 桌面版0.2.8 已提供
• 网页版不适用

把文件夹或游戏程序拖到栞的窗口上，会打开同样的导入检查。拖到某部作品的卡片上时，会询问是更新该作品的路径，还是作为新作品导入。

资源管理器右键菜单#

• 桌面版0.2.8 已提供
• 网页版不适用

在“设置 → 书架与导入 → 资源管理器右键菜单”中，可以为 Windows 资源管理器添加两个菜单项：.exe 文件上的添加到 GalShelf，以及文件夹上的用 GalShelf 扫描游戏。它们只对当前用户生效；在 Windows 11 中位于“显示更多选项”里。删除栞之前，请先在同一位置关闭它们。

监控文件夹#

• 桌面版0.2.8 已提供
• 网页版不适用

在“设置 → 书架与导入 → 文件夹监控”中最多可以监控 8 个文件夹，可以直接输入路径或点浏览选择。每 60 秒以及列表变化时，栞会在两层以内查找新的游戏文件夹。

如果被监控游戏的文件被删除，记录和游玩历史会保留，只清除已经不存在的启动路径。被移除的作品在 30 天内重新导入即可恢复。

导出、备份与导入文件#

• 桌面版0.2.8 已提供
• 网页版不适用

这些操作在“设置 → 高级与诊断 → 数据与备份”中。

• 导出完整记录会先让你选择一个文件夹，再在其中保存 galshelf-library-日期-时间.json（不会覆盖以前的导出），包含作品、游玩记录和大部分设置。
• 创建本地备份会在 %LOCALAPPDATA%\GalShelf\backups 中生成书架数据库的快照，自动备份保留最近 20 份。
• 可以导入 GalShelf 或 galbd v1 格式的 JSON 文件：选择文件后会先列出其中的作品，只导入你勾选的那些。预览会把每部作品标为新作品、已有作品（书架中已有相同 VNDB 编号）或需要确认（同名但没有相同的 VNDB 编号，或文件中重复出现）；需要确认的作品要先选择合并或分开保存才会导入。已有作品始终保留你自己的状态、评分（包括 0 分）、短评、标签、完成标记、进度、笔记、路线和备注名；没有设置状态的作品导入后仍是“未设置状态”。预览读不了的记录会列出原因并跳过。

导出内容从不包含配对密钥或 Steam 密钥。

恢复本地备份#

栞不会自动恢复备份。创建备份后，“数据与备份”会显示备份文件、正在使用的数据库和下面的步骤：

1. 完全退出栞，包括托盘图标。
2. 保留当前数据：把正在使用的数据库以及旁边同名、以 -wal 或 -shm 结尾的文件移到一个安全的文件夹，不要删除它们。
3. 用创建备份时的同一版本栞，把备份复制到原数据库的位置并改成原来的文件名。
4. 重新启动栞，检查作品、游玩记录和时长；如果不对，退出后把保留的文件放回原处。
5. 如果移动或复制过数据文件夹，再检查截图、分享卡模板和背景。

备份包含当前账号的作品记录、游玩记录与时长、本机的路径设置和截图记录；不包含截图图片和其他媒体文件、分享卡模板和导出的卡片、背景和下载的素材、游戏存档（请在作品页的游戏工具或云存档中单独备份），也不包含游戏本身。导入 JSON 记录文件只会添加或更新作品记录，不是恢复。