Repository navigation
Import Export ZH
Tonkatsu Box 使用 .xcollx 文件来分享收藏。单个文件包含全部项目、元数据、封面、看板布局和设置。
- 打开一个收藏
- 点击菜单（⋮）→ 导出
- 选择
.xcollx文件的保存位置 - 完成，文件里包含所有内容：项目、封面、评分、状态、看板
- 所有收藏项目及其元数据
- 封面图片（嵌入文件中）
- 你的评分和状态
- 作者评论
- 看板布局：项目、文字备注、连线、位置
- 看板图片
- 你的标签，以及哪些项目带有这些标签
导出时会提供一个可选的**「包含个人数据」**复选框。启用后，导出内容还会包括：
- 用户状态和日期（开始、完成、最近活动）
- 个人备注（用户评论）
- 分集进度（当前季、当前集）
- 已看分集标记，即你具体勾选了哪些分集；导入时会重新应用到目标收藏
- 分集、季、章节及其他单位上的喜欢与备注
- 排序顺序和添加日期
带有个人数据的文件会在文件头里带有 user_data: true 标记。导入时，如果存在个人数据会自动还原。没有该标记的文件按以前的方式导入（向后兼容）。
- 愿望单项目
- API 密钥或应用设置
- 进入收藏标签页
- 点击导入（或菜单 → 导入）
- 选择一个
.xcollx文件 - 选择：新建收藏，或添加到现有收藏
- 开始导入，项目会与数据库进行匹配并加入
完整导出（.xcollx）：包含所有项目、封面、元数据、看板布局和等级列表。导入时可离线使用。
轻量导出（.xcoll）：仅包含项目和元数据，文件更小。导入时需要 API 密钥来获取封面和详情。每个项目都会从它原本的提供方重新获取，因此 TVmaze 剧集、Kitsu 与 MangaDex 作品以及书籍都会带着自己的来源回来，而不只是 TMDB 和 AniList 的项目。
0.40 之前的版本导出的轻量文件不带书籍和 MangaDex 漫画的提供方标识：它们会以未解析的状态到达，在该项目上执行 从来源刷新 即可修好。
导入到现有收藏时，重复项目会被更新（作者评论、评分），而不是跳过。文件中的等级列表和标签会正常导入。看板布局会被跳过，以避免重复（看板项目没有唯一性约束）。
- 创建收藏（或选定收藏）
- 项目连同其状态和评分一起加入
- 提取封面图片并保存到本地
- 还原看板布局（如果存在）
- 如果媒体数据没有嵌入，则从 API 获取
如果导入失败，应用现在会显示完整的错误文本，并带有一个复制按钮，而不是截断的消息。你可以看清到底出了什么问题，并把它复制下来，在求助时一并附上。
直接在应用内下载现成的收藏：设置 > 导入 > 浏览在线收藏。目录中收录了覆盖 32 个平台的 45 多个收藏，另有电影和动画。
如果你在别处保存了一份列表，或者自己写脚本生成，可以直接从 JSON 或 CSV 文件加载卡片：设置 → 导入 → 自定义卡片。只需要标题和类型；其余内容全部可选，包括年份、题材、封面、平台、你的状态、评分、备注、日期和标签。
除了文件导出，你还可以把收藏以格式化文本复制到剪贴板：
-
复制为列表：使用默认模板
{name} ({year})快速复制，一键完成，无需对话框 - 复制为文本…：打开一个对话框，可自定义模板、使用标记芯片、选择排序方式，并提供实时预览
可用标记：{name}、{year}、{rating}、{myRating}、{platform}、{status}、{genres}、{notes}、{type}、{link}、{#}
{link} 会输出项目在其来源上的页面：游戏用 IGDB，电影和剧集用 TMDB，动画和漫画用 AniList，自定义项目用你自己填的链接。{type} 打印自定义项目所显示的类型（游戏、动画……），而不是一律写「Custom」。为空的标记会连同它的分隔符一起被去掉。
你的自定义模板会在会话之间保存。
.xcollx 是一个 ZIP 压缩包，内含 JSON 数据和嵌入的图片。这是一种开放格式，你可以解压并查看其内容。完整规范见 RCOLL_FORMAT.md。
一键备份所有内容：设置 → 备份 → 备份全部数据。备份的 .zip 包含：
- 所有收藏，连同你的评分、状态、备注、看板和已保存的封面
- 你的标签
- 等级列表和心情格
- 愿望单项目
- 电视剧和动画的分集观看进度
- 你的发行关注列表和日历条目
- RetroAchievements 和 Steam 的追踪进度
- 应用设置
在这些内容加入之前制作的旧备份仍可正常恢复，只是不会带入它们当时还没有的部分。
恢复会保留原始日期：每个收藏的创建时间和每个项目的添加时间，因此统计里的「按月添加」历史能完整地走完一轮。心情格的说明文字模板和格子标签模板也会一并恢复。
恢复方法：设置 → 备份 → 从备份恢复 → 选择 .zip 文件。确认对话框会显示清单预览（收藏数量、项目数量、愿望单数量），并附有用于恢复愿望单和设置的复选框。收藏总是作为新的创建（不合并）。愿望单条目按文本去重。
开始恢复时，应用会在其余界面之上打开一个窗口：「正在从备份恢复，请勿关闭应用。较大的副本可能需要几分钟。」 界面会显示已恢复收藏的计数。
恢复进行期间：
- 返回按钮不起作用。
- 在桌面端，通过任务栏或 Alt+F4 关闭窗口会被取消。
- 只有在一个收藏被完整保存后，计数才会增加。
在最后阶段，界面会显示正在收尾…。只有在数据真正写入完成后，窗口才会关闭。在应用仍在保存时，你不会看到「完成」。
- 使用完整备份做一次完整快照，它比逐个导出收藏更快
- 把
.xcollx文件分享给朋友，他们可以直接导入 - 现成的收藏无需任何 API 密钥即可使用
- 浏览在线收藏，从目录下载现成的收藏
- 从 Trakt 导入，从 Trakt.tv 导入电影和电视剧
- 从 Steam 导入，导入你的 Steam 游戏库
- 从 RetroAchievements 导入，导入带成就进度的复古游戏
- 从 MyAnimeList 导入，从 MAL 导入动画和漫画列表
- 从 AniList 导入，从 AniList 导入动画和漫画列表
- 导入 IGDB 列表，导入从 IGDB.com 导出的游戏列表
- 从 Kinorium 导入，从 Kinorium 导入电影和电视剧列表
- 导入自定义卡片，从 JSON 或 CSV 文件加载你自己的卡片