Getting Started ZH

快速开始

安装

1. 从 Releases 获取适合你平台的最新版本
   • Windows：便携版 .zip。解压到任意位置并运行 .exe，无需安装程序
   • Linux：.tar.gz（实验性）。解压后运行可执行文件
   • macOS：.dmg（实验性）。该版本未签名，因此首次启动时会出现 Gatekeeper 警告，右键点击应用并选择打开即可绕过。这里没有 VGMaps 浏览器或截图捕获功能，和 Linux 一样
   • Android：.apk
2. 安装并启动应用

Android：三种安装方式

Windows 和 Linux 版本只需简单下载即可。在 Android 上，你有多种选择：

• 直接 APK：从 Releases 下载 .apk 并打开。第一次时，Android 会要求你允许从浏览器或文件管理器安装。允许一次即可。
• RuStore：从 RuStore 安装。更新会像其他应用一样通过商店送达。
• Obtainium：如果你想不经商店、直接从 GitHub 获取更新，可使用 Obtainium。点击 Add App，把 https://github.com/hacan359/tonkatsu_box 粘贴到来源字段，再点击 Add。Obtainium 会监视 Releases，并为你安装每个新版本。Android 仍会弹出安装提示以确认，所以没有 root 权限就无法做到完全静默更新。

欢迎向导

第一次打开应用时，一个 6 步向导会带你完成初始设置。

第 1 步，欢迎：概览应用及其功能。阅读后点击下一步即可。

第 2 步，你的名字：输入你的名字，它会作为作者显示在你创建和分享的收藏上。

第 3 步，语言：选择应用界面语言（English、Русский、中文、Español、Português (Brasil) 或 Français）。向导会立即切换语言。

第 4 步，API 密钥：输入你的 IGDB 凭据以搜索游戏。你可以跳过此步，稍后在设置中完成。详细的 API 密钥指南

第 5 步，工作原理：快速了解收藏、搜索和看板。

第 6 步，准备就绪！：选择前往设置，或立即开始探索。

💡 你可以随时从设置 → 欢迎指南重看欢迎向导。

设置完成后的第一步

1. 搜索点什么

进入搜索标签页。在筛选栏的第一段选择你要找什么（电影、剧集、游戏、动漫、漫画、视觉小说、书籍），然后输入标题。该类型下的所有来源会同时作答；下方的来源行可以逐个关闭不需要的来源。

2. 添加到收藏

点击任意搜索结果 → 点击添加到收藏 → 选择一个现有收藏或新建一个。

3. 浏览你的收藏

切换到收藏标签页。打开你的收藏。你会看到带封面图的项目网格。

4. 评分与追踪

点击任意项目打开其详情。设置一个状态（游玩中、已完成、已弃置……），给它打 1 到 10 分，并添加个人备注。

没有 API 密钥能用什么？

不设置任何 API 密钥，你也能使用应用的大部分功能：

• ✅ 创建收藏并整理项目
• ✅ 导入现成的收藏（.xcollx 文件）
• ✅ 为项目评分、追踪和加注
• ✅ 看板
• ✅ 愿望单
• ✅ 导出和分享收藏
• ✅ 搜索视觉小说、动画、漫画、书籍和音乐（VNDB、AniList、Kitsu、MangaDex、MangaBaka、OpenLibrary、Fantlab、MusicBrainz，均无需密钥）
• ✅ 搜索播客并标记剧集（Podcast Index 内置了一对密钥）
• ✅ 在 设置 → 外观 → 主题 中选择主题（深色或樱花）

搜索游戏（IGDB）以及电影或剧集（TMDB、TheTVDB，两者都自带内置密钥）时需要 API 密钥。设置 API 密钥

用现成收藏快速上手

不想设置 API 密钥？下载包含数千款游戏的现成收藏：

1. 前往 tonkatsu-collections
2. 下载任意 .xcollx 文件（例如 snes-full-library.xcollx）
3. 在应用中：收藏 → 导入 → 选择该文件
4. 完成，浏览带封面的完整库

现有资源：23 个复古平台，25,000 多款游戏。另有电影和动画收藏。

键盘快捷键（桌面端）

在桌面端（Windows、Linux、macOS）你可以完全用键盘操作应用：

全局快捷键（随处可用）：

快捷键	操作
Ctrl+1..6	切换到第 1 至 6 个标签页
Ctrl+Tab / Ctrl+Shift+Tab	下一个 / 上一个标签页
Escape / Alt+Left	返回
Ctrl+F	聚焦搜索
F5	刷新当前界面
F1	显示当前界面的键盘快捷键

界面专属快捷键：

• 主页：Ctrl+N（新建收藏）、Ctrl+I（导入）、Ctrl+Shift+V（切换视图）、Delete/F2（对焦点卡片）
• 收藏：Ctrl+N/E/I、Ctrl+B（切换看板）、Ctrl+Shift+V（切换视图）、Delete/Ctrl+M/F2（对焦点项目）
• 项目详情：Alt+0..5（设置评分）、Ctrl+B（切换看板）、Ctrl+L（锁定）、Ctrl+M（移动）
• 等级列表：Ctrl+N（创建）、Delete/F2（对焦点卡片）
• 愿望单：Ctrl+N（添加）、Ctrl+H（切换已完成）、Ctrl+Shift+D（清除已完成）

💡 在任意界面按 F1，即可查看所有可用快捷键的速查表。

手柄支持

Tonkatsu Box 在 Windows、Linux、macOS 和 Android 上支持手柄导航（非常适合 Odin 2 或 Steam Deck 这类掌机）。

按键映射：

按键	操作
LB / RB	切换主标签页
LT / RT	切换筛选 / 子标签页
方向键	浏览内容
A	确认 / 打开
B	返回（同 Escape）
Y	上下文菜单（同右键）

切换标签页时，焦点会自动移到第一个内容项目。可聚焦的项目在手柄模式下会显示可见边框。

接下来做什么？

• 设置 API 密钥，以获得完整的搜索权限
• 了解收藏，创建、整理、排序
• 从 Trakt.tv 导入，如果你有观看记录
• 探索看板，用于可视化整理