故障排查

客户端无法启动#

栞无法启动时，会弹出提示，写明错误、日志目录（%LOCALAPPDATA%\GalShelf\logs），并提醒需要 Microsoft Edge WebView2 运行时。请从微软官网安装或修复 WebView2 运行时，然后重新启动栞。同时确认已完整解压发布包，并且 components 目录与 GalShelf.exe 位于同一目录。

提示“此端口有客户端或其他服务”#

桌面客户端在端口 18765 上运行本地服务。如果另一个栞窗口、另一份栞或其他程序占用了这个端口，会提示你先退出它。关闭另一份程序（注意检查系统托盘）后再启动栞。“本地服务启动失败”或“本地服务启动超时”通常也是同样的原因，日志中有更多信息。

提示“本地服务已停止”#

窗口打开期间本地服务意外停止时，栞会提示并退出。重新启动即可；如果反复出现，请查看日志目录中的 desktop.log。

日志#

• %LOCALAPPDATA%\GalShelf\logs\desktop.log
• %LOCALAPPDATA%\GalShelf\logs\desktop-output.log

日志中可能包含文件路径和电脑上的其他信息，分享前请先检查。

galbd 未连接#

见 galbd / AstrBot 故障排查。最常见的原因是安装配套接口后没有重载插件，或插件更新覆盖了挂钩。

Steam 已关联但看不到游戏#

登录和读取数据是两个步骤。请把 Steam 个人资料和游戏详情设为公开，等几分钟（结果会缓存 10 分钟）后再试。详见 Steam。

同步问题#

• 在网站上看到冲突对话框，说明同一字段在别处也被修改了，请选择要保留的值。浏览器中排队的修改会在恢复连接后发送。
• 与 galbd 同步时，有冲突的字段会列出来由你选择，不要反复提交来强行覆盖。
• 网站上的修改没有出现在桌面客户端：请在新界面中开启书架同步（经典界面的上传按钮只会发送），并确认登录的是这个书架所属的账号。详见同步。
• 游戏存档不属于书架同步，详见云存档。

NextMoe 登录#

桌面客户端提供 NextMoe 连接检查，可以在账号设置中运行。如果在浏览器中登录后没有回到客户端，请确认防火墙没有阻止本机连接，然后重试。

Magpie 无法缩放#

请从托盘退出另外安装的 Magpie，栞使用的是自带的那一份。详见本机工具。

网站语言不对#

使用页头的 中 / EN 切换，或在地址后加上 ?lang=zh-CN 或 ?lang=en。选择保存在 galshelf_lang Cookie 中；清除 Cookie 后会回到浏览器的语言。

网站无法访问#

网站暂时不可用时，桌面客户端仍可以使用本地书架；网站恢复后，登录和同步会继续。

反馈问题#

目前没有公开的问题追踪页面。请通过你获取栞的渠道反馈，并附上程序目录中的 package-manifest.json 和标题栏显示的版本号。说明你做了什么、期望看到什么；日志请检查后再附上。