栞Your first bookmark
从第一部作品开始。
不用一次完成所有设置，先整理书架，随后再启用需要的关联。
01. 获取 GalShelf
在下载页获取 Windows 版，完整解压后启动 GalShelf.exe，并保留配套的 components 目录。只想在浏览器里整理书架，也可以直接登录网页版，不需要安装客户端。
02. 把作品加入书架
选择本地游戏目录，或扫描本机 Steam 安装清单。先预览作品匹配，再确认导入；无法可靠识别的项目不会自动当作 Galgame 加入书架。
03. 留下评分和进度
打开作品详情，记录状态、评分、短评和剧情进度。剧情进度是你填写的完成比例；Steam 累计游玩时长是另一个字段，不会自动变成剧情进度或逐次日志。
04. 登录与同步
在网站首页注册或登录 GalShelf 账号，也可以选择「使用 Google 登录」或「使用 NextMoe 登录」。任何一种方式都能直接进入你的书架，不需要安装或打开客户端，也不需要 QQ。第一次用 Google 或 NextMoe 登录时，你可以明确选择创建新账号或绑定到已有账号，不会按邮箱自动合并。
在客户端的「登录 GalShelf」中使用同一个账号，需要时可把本机书架上传到账号。同步前可以预览差异；遇到两端都有修改的冲突，请先查看差异并选择保留内容，不要反复提交覆盖。
05. 保护游戏存档
在客户端开启云存档后，已关联 VNDB 作品的游戏会自动安全地备份存档，云端位置是你选择的同步文件夹。作品的云存档卡片有三个操作：「立即同步」按安全方向对比并同步；「上传备份」只保存这台电脑的进度；「下载 / 恢复」只恢复明确的云端版本，替换本地有改动的存档前会先确认并保留本地快照。网站只显示设备上报的状态摘要，不能恢复或删除存档。
06. 连接 Steam
在网页书架的 Steam 页或客户端设置中使用 Steam 登录，按浏览器提示确认，不需要 QQ。服务地址为 https://galshelf.com。读取结果受 Steam 隐私设置影响，公开资料不等于游戏详情也已公开。
07. 可选：通过 QQ 连接 galbd 群功能
在客户端完成群内本人确认与客户端确认。随后由客户端发起网页授权，在网页填写客户端显示的连接码。QQ 验证保留一份原始配对；创建账号后，可用密码在其他客户端或浏览器登录。退出单个账号会话不会解除原配对。
数据与隐私
客户端保留本地记录。网页书架保存在你的 GalShelf 账号中；通过 QQ 群入口进入时，网页保存会更新 galbd 中的本人记录，未验证游客不能查看个人游戏库。网页记录访问 IP、浏览器设备标识与授权客户端信息，访问安全记录保留 90 天；账号密码使用随机盐和不可逆校验值保存。Steam 开发者密钥只保存在服务器。请妥善保管导出的个人记录。
常见问题
网页版需要客户端一直开着吗？
不需要。网页书架保存在你的 GalShelf 账号中，电脑关机时也能在浏览器里查看和修改。本机目录扫描、启动与计时、存档备份等功能只在 Windows 客户端中提供。
为什么 Steam 能登录，却读不到游戏库？
登录确认和数据读取是不同步骤。请检查游戏详情及游玩时间公开设置，也可能是 Steam 暂时不可用。
服务无法连接时，本地记录还能用吗？
可以。服务器离线期间远程登录和同步不可用，本地整理与记录仍可使用。恢复连接后再同步。
Galdrive 是什么？现在能下载吗？
Galdrive 是计划中的独立小程序，只负责游戏存档。它目前暂未开放，下载页只列出它的状态，不提供下载。GalShelf 自带的云存档照常可用，不需要它。
Galguard 和 GalShelf 是什么关系？
Galguard 就是 GalShelf Guard，一个可选的独立完整性与恢复伴侣程序，目前提供预览版。不安装它，GalShelf 也能正常使用；需要时可以在下载页查看它的发布页，或在 GalShelf 的设置中下载并校验后安装。
为什么 QQ 收不到验证码？
确认群号、QQ 号、本人群成员身份及机器人在线状态；该群必须已被管理员开放。频繁请求会触发限流，请稍后重试。