开始使用

安装 Windows 桌面客户端，找到数据目录，导入第一批作品，并保持栞为最新版本。

本页内容

栞 GalShelf 是一款 Windows 上的 Galgame 书架，另有配套网站。桌面客户端负责整理电脑上的游戏、记录游玩时长并提供各种本机工具；网站把书架保存在你的 GalShelf 账号里，任何浏览器都能打开。两者都可以作为起点。

运行条件#

Windows 10 或 11，64 位。
Microsoft Edge WebView2 运行时。栞不附带它，Windows 11 通常已经预装。如果栞提示无法启动并提到 WebView2，请从微软官网安装后再试。
不需要 Python、Node.js，也不需要管理员权限。
部分工具有各自的限制（例如 Magpie 缩放、以管理员身份运行的游戏的手柄映射），详见本机工具。

在下载页获取 Windows 版压缩包。正式发布位于 https://github.com/Harihi-Works/GalShelf-Dev/releases (外部链接)，客户端也从这里检查更新。
选择安装包：GalShelf Full（-Full.zip）是开箱即用的完整版，已预装 Locale Emulator、Magpie 和分享卡素材库；GalShelf Lite（-Lite.zip）体积更小，功能相同，可选工具可以关联你已有的安装或之后在 GalShelf 中安装。把压缩包完整解压到一个新文件夹，保留与 GalShelf.exe 同级的 components 目录（aria2 与 Real-ESRGAN），Full 还要保留 modules 目录。
运行 GalShelf.exe。

栞没有安装程序，可执行文件也没有代码签名，因此 Windows SmartScreen 可能会要求确认。每个发布包都带有 SHA256SUMS 和 package-manifest.json；如果是从镜像下载的，解压后可以核对哈希值。

桌面客户端的所有数据都在 %LOCALAPPDATA%\GalShelf：书架数据库、设置、日志、截图、存档备份和本地备份。删除程序目录不会删除这些数据。

使用桌面客户端不需要账号。第一次运行时：

账号、Steam、QQ 和云端功能都是可选的，随时可以再连接。

新界面第一次启动时，会打开带动画的新手引导 欢迎来到栞。八个场景都使用虚构作品名的演示数据，不会改动你的书架、账号和游戏：

使用下一步、上一步或方向键切换，用跳过引导或 Esc 离开，开始使用完成引导。引导中也可以切换语言。中途被打断时，下次会从停下的地方继续。开启减少动态效果时，场景以静态画面显示。随时可以在“设置 → 帮助 → 重新播放新手引导”中再看一遍。

从 0.2.4 起，桌面客户端可以自动更新：

启动约 90 秒后检查公开发布页，之后每 8 小时检查一次。
更新清单带有签名，每个下载文件使用前都会核对 SHA-256；下载中断后可以续传。
在设置中选择方式：仅提醒（默认）、自动下载或自动安装。安装会等到没有正在计时的游戏、下载或同步时才进行，先备份程序文件，失败时自动回退。
更新程序不会改动你的数据目录。

如果程序放在 Program Files 这类受保护的目录，它只会检查并提醒；请自行解压新版本来完成更新。

如果开启过资源管理器右键菜单，请先在设置里关闭（或运行 GalShelf.exe --shell-integration remove）。这只会移除栞为当前用户创建的两个菜单项。
如果在机器人上安装过 galbd 配套接口，请先用它的安装器移除（见 galbd / AstrBot）。
删除程序目录。
只有在也想删除个人数据时，才删除 %LOCALAPPDATA%\GalShelf。

网站 galshelf.com 无需安装。用 GalShelf 账号或 NextMoe 登录后，书架就保存在你的账号里。详见网页版书架和账号。