Tonkatsu Box 是免费开源的收藏管理器，支持游戏、电影、剧集、动漫和视觉小说整理。集成 IGDB、TMDB、VNDB 数据库，自定义收藏集，追踪进度，评分评级，创建视觉看板，导入 Trakt 数据，与好友分享收藏。
🎤 引言
作为一名资深玩家和影迷，你是否遇到过这样的困扰：Steam 库里的游戏越积越多，却记不清哪些已经通关；追过的剧集分散在 Netflix、B 站、爱奇艺，找不到统一的追踪工具；想整理自己的"想玩清单"和"已通关"列表，却只能用 Excel 手动记录？
今天给大家推荐的 Tonkatsu Box 就是一款专为收藏爱好者打造的开源管理神器。它支持游戏、电影、剧集、动漫和视觉小说五大类别，一站式解决你的收藏整理需求。
⭐ 核心亮点
- 全平台支持：Windows、Linux、Android 三端通用
- 开源免费：代码完全开源，无订阅无广告
- 多数据源：IGDB（游戏）、TMDB（影视）、VNDB（视觉小说）
- 视觉化管理：拖拽式看板，海报墙视图
- 进度追踪：支持剧集级进度管理
- 数据导入：一键导入 Trakt.tv 历史记录
🏛️ 收藏集管理
创建无限数量的收藏集，按你的喜好自由分类：
- 按平台：SNES、PlayStation、PC、Switch
- 按类型：RPG、科幻、恐怖、喜剧
- 按状态：待玩清单、已通关、最爱收藏、本地合作游戏
- 混合收藏：一个收藏集里可以同时包含游戏、电影、动漫
支持列表视图和海报网格视图切换，浏览体验更加直观。
🔍 智能搜索系统
Tonkatsu Box 内置三个独立搜索标签页，每个都有专属过滤器：
🎮 游戏搜索（IGDB 驱动）
- 多平台筛选：从数百个平台中选择（NES、SNES、PS、PC 等）
- 排序方式：相关性、发行日期、IGDB 评分
- 添加时可精确选择平台版本
🎬 影视搜索（TMDB 驱动）
- 类型过滤：全部、电影、剧集、动画
- 排序方式：相关性、发行日期、评分
- 动漫自动识别：根据类型自动归类为动漫
📖 视觉小说搜索（VNDB 驱动）
- 按题材/标签浏览或标题搜索
- 排序：评分、发行日期、投票数
- 无需 API 密钥：VNDB 完全免费开放
搜索结果采用无限滚动加载，每张卡片显示海报、标题、年份、评分和主要类型。
📝 待办清单
没有网络时也能快速记录想玩的游戏或想看的电影：
- 记下名称，标记媒体类型
- 添加备注说明
- 需要时一键跳转到搜索（名称已预填充）
- 找到后标记为"已解决"
📊 进度追踪
精细化的进度管理系统：
- 状态标记：未开始、进行中、已完成、暂停、弃坑
- 剧集追踪：电视剧和动漫支持按季勾选单集进度
- 评分系统：1-10 分星级评分
- 时间记录：自动记录开始和完成时间
🎨 视觉看板
自由形式的视觉化看板功能：
- 拖拽海报自由排列布局
- 添加文本备注、图片、链接
- 绘制项目之间的关联线
- 浏览 SteamGridDB 高质量游戏 artwork 并添加到看板
- 每个项目都可以拥有个人专属看板
🌍 多语言支持
完整的国际化支持：
- 支持语言：英语、俄语
- 运行时切换：设置 → 语言，无需重启应用
- 全面本地化：菜单、状态、标签、消息全部翻译
📤 分享与导出
与好友分享你的收藏：
- 轻量导出（.xcoll）：仅包含项目列表，文件小巧，接收方需要网络加载详情
- 完整导出（.xcollx）：包含所有图片、看板布局、媒体数据，完全离线可用
- 导入收藏：接收后可浏览或"派生"创建自己的可编辑版本
🔄 Trakt 数据导入
已在 Trakt.tv 追踪影视记录？一键迁移：
- 从 trakt.tv/users/YOU/data 导出数据（ZIP 文件）
- 设置 → Trakt 导入 → 选择 ZIP 文件
- 预览数据（已观看、评分、想看清单）
- 选择导入选项，开始导入
导入内容自动匹配 TMDB 元数据，动画内容自动识别为动漫。
🛠️ API 密钥配置
应用使用免费 API 搜索游戏、影视、视觉小说和 artwork，需要自行注册 API 密钥（免费，几分钟完成）：
🎮 IGDB（游戏搜索，必需）
- 访问 dev.twitch.tv/console 登录/注册 Twitch 账号
- 点击"Register Your Application"
- 填写应用名称（任意）、OAuth 重定向 URL（http://localhost）
- 创建后复制 Client ID 和 Client Secret
- 在应用设置 → 凭据中填入
🎬 TMDB（影视搜索，推荐）
- 访问 themoviedb.org 注册免费账号
- 个人资料 → 设置 → API → 申请 API 密钥
- 选择 Developer，填写申请表（个人/非商业用途）
- 复制 API Key（v3 auth）
- 在应用设置 → 凭据中填入
💡 提示：没有 TMDB 密钥仍可搜索游戏，只是无法搜索影视和动漫。
🖼️ SteamGridDB（游戏 artwork，可选）
- 访问 steamgriddb.com 注册免费账号
- Preferences → API 复制 API Key
- 在应用设置 → 凭据中填入
💡 提示：此密钥仅用于在看板中添加高质量游戏 artwork。
📥 安装与编译
源码编译（需要 Flutter SDK）
git clone https://github.com/hacan359/tonkatsu_box.git
cd tonkatsu_box
flutter pub get
flutter run -d windows # 或：-d linux / -d android环境要求：
- Windows 编译：需要 Windows 桌面开发工具
- Android 编译：需要 Android SDK
- Android 发布版本：需要签名密钥（详见贡献指南）
首次启动时，应用会引导你完成欢迎向导，讲解 API 密钥配置等步骤。
🎯 适用场景
- 游戏收藏家：整理实体/数字游戏库，追踪通关进度
- 影视爱好者：统一管理多平台追剧记录
- 视觉小说玩家：记录 VNDB 海量作品
- 多栖玩家：同时涉足游戏、影视、动漫的多媒体收藏者
- 数据迁移者：从 Trakt.tv 迁移历史记录
- 隐私倡导者：偏好本地存储、开源软件的用户
💡 使用技巧
- 首次配置：按欢迎向导顺序配置 IGDB 和 TMDB 密钥
- 批量导入：使用 Trakt 导入快速填充已观看记录
- 看板创作：为不同主题创建专属看板（如"2024 年度最佳"）
- 分享收藏：导出完整包（.xcollx）分享给好友
- 待办清单：看到推荐但无法立即搜索时，先添加到待办
📊 同类对比
| 功能 | Tonkatsu Box | Steam | Trakt.tv | Playnite |
|---|---|---|---|---|
| 游戏管理 | ✅ | ✅ | ❌ | ✅ |
| 影视追踪 | ✅ | ❌ | ✅ | ❌ |
| 动漫支持 | ✅ | ❌ | ✅ | ❌ |
| 视觉小说 | ✅ | ❌ | ❌ | ❌ |
| 开源免费 | ✅ | ❌ | ❌ | ✅ |
| 跨平台 | ✅ | ❌ | ✅ | ✅ |
| 视觉看板 | ✅ | ❌ | ❌ | ❌ |
| 本地存储 | ✅ | ❌ | ❌ | ✅ |
🔗 下载链接
- GitHub 仓库：github.com/hacan359/tonkatsu_box
- 官方文档：github.com/hacan359/tonkatsu_box/blob/main/README.md
- 贡献指南：github.com/hacan359/tonkatsu_box/blob/main/docs/CONTRIBUTING.md
✅ 总结
Tonkatsu Box 是一款真正为收藏爱好者打造的开源神器。它不仅仅是一个简单的"已读/已玩"清单，而是提供了丰富的可视化、社交和自动化功能。无论你是想整理自己的游戏库，还是追踪追剧进度，或是与好友分享收藏，它都能胜任。
最重要的是，它完全开源免费，数据本地存储，没有订阅制，没有广告，真正做到了"用户至上"。强烈推荐给每一位有收藏爱好的朋友！