FAQ ZH

需要联网吗？

只有搜索和添加新项目时才需要联网。项目一旦加入收藏，一切都能离线使用：封面、元数据、评分、看板全都可用。

需要注册账号吗？

不需要。应用把所有内容都保存在你自己的设备上。没有注册，没有云同步，也不收集任何数据。

API 密钥是免费的吗？

是的。IGDB（通过 Twitch）、TMDB、TheTVDB 和 SteamGridDB 都提供免费的 API 密钥。VNDB、Kitsu、AniList、MangaDex、MangaBaka、TVmaze、OpenLibrary 和 Fantlab 则完全不需要密钥。详见 API 密钥设置。

有哪些界面语言？

English、Русский、中文（简体）、Español、Português (Brasil) 和 Français。在 设置 → 应用语言 中切换，整个界面会立即改变。电影和剧集描述的语言是另一项设置（内容语言，约 45 个选项）。

没有任何 API 密钥能用这个应用吗？

可以！你可以导入现成的收藏（.xcollx 文件）、整理项目、给项目评分、使用看板，还能导出收藏，这些都不需要 API 密钥。密钥只在搜索新项目时才用得上。

下载现成的收藏：tonkatsu-collections

能在一个收藏里混放不同的媒体类型吗？

可以。同一个收藏里可以同时放游戏、电影、电视剧、动画、视觉小说、漫画、书籍、专辑和播客。

怎么把数据转移到另一台设备？

把你的收藏导出为 .xcollx 文件（收藏 → 导出），然后在新设备上导入。至于应用设置，可以用 设置 → 数据库 → 导出 / 导入配置。

我的数据安全吗？

所有数据都保存在你自己的设备上。应用不会把你的数据发送到任何地方。请定期导出作为备份。

怎么备份我的数据？

应用的全部数据都保存在 Application Support 目录里：

平台	路径
Windows	%APPDATA%\tonkatsu_box\
Linux	~/.local/share/tonkatsu_box/
Android	/data/data/com.hacan359.tonkatsu_box/files/tonkatsu_box/

完整复制： 复制整个 tonkatsu_box 文件夹。其中包含数据文件（tonkatsu_box.db）和已保存的图片。

仅数据： 只复制 tonkatsu_box.db。它保存了你所有的收藏、项目、评分、看板布局和设置。

要恢复时，替换文件夹或数据文件，然后重启应用。

注意： API 密钥单独保存在系统设置里，不在这个文件夹中。全新安装后，你需要重新输入它们。

支持哪些平台？

Windows、Linux、Android 和 macOS（实验性：该版本未签名，维护者也尚未测试）。不支持 iOS。

能和朋友分享收藏吗？

可以。把一个收藏导出为 .xcollx 文件发送出去。对方把它导入自己的 Tonkatsu Box，所有项目、封面和看板布局都会一并转移。

应用崩溃了 / 有功能不正常

请在 GitHub 上提交 issue，并附上：

• 发生问题时你正在做什么
• 你的平台（Windows/Linux/Android）和应用版本
• 如果可以，附上截图

去哪里寻求帮助

欢迎加入我们的 Discord 服务器，一起提问和讨论。

游戏详情页上的 ScreenScraper 画廊是什么？

ScreenScraper 是一个社区数据库，收录了 IGDB 没有的额外游戏美术素材：原版包装盒图（正面 / 背面、3D）、wheel/marquee 图、标题画面、游戏内截图、同人图、mix 渲染图。它覆盖了 52 个复古及现代平台。

要启用它，请在 screenscraper.fr 上免费注册一个账号，然后在 设置 → API 密钥 → ScreenScraper 中填入你的 ssid 和 sspassword。开发者凭据已经内置在应用中。免费会员每天可发起 20000 次请求；结果会缓存 30 天。详见 API 密钥设置。

如果没有出现画廊，可能是该游戏的平台不受支持，或者标题没有匹配到任何 ScreenScraper 条目。

可以在浏览器里运行 Tonkatsu Box 吗？

可以 - 自托管即可。在自己的机器或家庭服务器上执行 docker compose up -d --build，然后从任意设备打开 http://<服务器IP>:8080。数据库、封面缓存和 API 密钥都在服务器上，因此所有设备共用同一个库。桌面端专属功能（VGMaps、Discord Rich Presence、Kodi、手柄、局域网同步、用户配置）在浏览器中会被隐藏。参见 自托管（Web）。

Web 版没有账号和密码 - 请只在局域网内使用。

应用只有深色主题吗？

不是。设置 → 外观 → 主题 提供 深色 和 樱花 两种：后者是柔和的浅色主题，有自己的配色、壁纸和强调色。切换即时生效。

为什么同一部电影出现了两次？

从 0.42 起电影是多来源的：同一部作品可以分别来自 TMDB 和 TheTVDB，两者作为各自独立的条目被追踪，拥有各自的 id 和封面。在搜索页的「来源」行里关掉你不需要的那个来源即可。

为什么升级到 0.42 后电影封面重新下载了？

封面缓存现在按来源分了命名空间，这样 TheTVDB 的海报就不会覆盖编号相同的 TMDB 影片的海报。已有封面会再抓取一次，之后照常缓存。