Repository navigation
Collections ZH
收藏是 Tonkatsu Box 的核心，也就是你用来整理、评分和追踪的项目列表（游戏、电影、电视剧等等）。
「收藏」标签页会把你所有的收藏以视觉卡片的形式展示出来。
网格卡片会把最多八张封面随意堆成一摞 - 每个收藏都有自己固定的排布，卡片看上去始终如一 - 鼠标悬停或手柄聚焦时，这摞封面会收拢成整齐的层叠牌堆。最上面那张封面带有 +N 徽标，表示未显示的其余项目。
名称下方是项目数量，以及两个说明内容构成的标记：
- 彩色圆点 - 收藏中每种媒体类型一个，占比最大的排在最前，像头像堆一样相互叠压。超过五种时其余会收成一个「+N」圆点。富样式卡片和列表视图使用同样的圆点。
- 光谱条 - 统计下方的一条细带，每种媒体类型按其占比分得一段，类似代码仓库的语言条。
- 打开 收藏 标签页
- 点击 + 新建收藏
- 输入名称（例如「SNES RPG」「2025 观看清单」「吉卜力工作室」）
- 可选：勾选 隐藏收藏 - 见下文
- 完成，收藏已就绪，开始添加项目吧
当你既不想删除某个收藏、又不想看到它时，可以把它标记为隐藏：礼物清单、私藏书架，任何不希望别人越过肩膀看到的内容。
有三个地方可以标记：
- 新建收藏对话框中的 隐藏收藏 复选框，
- 编辑对话框中的同一个复选框，
- 右键（或长按）卡片 → 隐藏开关。
会发生的变化：
- 卡片显示占位图而非封面拼贴 - 隐藏的收藏始终使用经典卡片，不使用大图。
- 其中的条目不再出现在 全部条目 页面和偏好词云中。
不会变化的部分：收藏在列表中保留名称和计数，可正常打开，在任何收藏选择器中仍是可选目标，仍计入 统计，导出时不带该标记。切换即时生效，双向皆然。完整备份会记住哪些收藏是隐藏的，并在恢复时重新隐藏它们。
- 打开 搜索 标签页
- 找到一款游戏、一部电影或一部电视剧
- 点击结果，再点击 添加到收藏
- 选择要加入哪个收藏（或者新建一个）
你可以用不同的平台把同一款游戏多次加入一个收藏。例如把 Final Fantasy VI 同时加为 SNES 和 GBA 两个版本。
选择平台时，已经添加过的平台会标上 ✓ 对勾。在同一平台上重复添加同一款游戏会被拦截（重复项），但不同平台是允许的。
在看板上，每个平台版本都会显示为一张单独的卡片。
- 从 tonkatsu-collections 下载一个
.xcollx文件 - 在应用中：收藏 → 导入 → 选择该文件
- 整个库会连同封面和元数据一并导入
默认视图。项目以带封面图的视觉网格展示。点击任意项目即可打开它的详情。
标题现在位于封面下方，占据固定高度的区块，并与其元信息行（评分、平台、年份、类型、分类）在一起。海报本身保持干净，同一行的卡片无论标题多长都保持对齐。过长的名称以省略号截断，完整名称可通过悬停提示查看。
元信息行以该条目来源的徽标开头 - AniList、MangaDex、IGDB、TMDB、TheTVDB 等 - 一眼就能看出作品在哪里被追踪。点击徽标会在浏览器中打开该作品在来源上的页面；本地条目和自定义卡片的徽标只作标记。
留在海报上的只有底部一条半透明细带：左侧是状态圆点和标签，右侧是进度及其进度条。若某条目三者皆无，细带会整条消失，海报保持干净。
凡是出现卡片的地方用的都是这同一张卡片：收藏网格、「全部条目」、搜索和 Browse。
一个纵向列表，采用更大的图块，显示封面、标题、副标题、评分、描述和评论。适合在浏览时查看每个项目的更多细节。
一个类似电子表格的视图，行列紧凑：名称、媒体类型、平台、状态、评分、发行年份、标签和收藏。非常适合大型收藏，让你一眼就能排序和对比大量项目。
你可以拖动列来重新排序，拖动列的边缘来调整宽度，也可以隐藏用不到的列。列的顺序、宽度以及哪些列被隐藏，都会为每个收藏分别记住。
表格上方有两个按钮：
- 筛选 会打开一个规则编辑器。每条规则由一列加一个条件加一个值组成，规则之间以「与」的方式组合。状态从你实际用到的状态下拉列表中选取；其他列则接受「包含」这类文本条件。在窄屏上，每条规则会纵向堆叠，让控件保持清晰易读。
- 列 用来切换显示哪些列。
点击列标题即可按该列排序。编辑就在行内进行，评分星级、状态、收藏和标签都可以直接改，还有一个复选框列用于选中行（见下方「批量操作」）。要打开某个项目，单击它的名称，或者在它的行上任意位置双击。把收藏切换为手动排序后，左侧会出现一个拖动手柄列，你就可以通过拖动来重新排序行，触摸操作也支持。
使用收藏工具栏中的视图切换按钮，在各视图间循环：网格视图 → 列表视图 → 表格视图 → 网格视图。图标会变化，提示接下来会切换到哪个视图。
一块自由画布，你可以在上面拖动海报、添加文字备注和图片，并在项目之间连线。非常适合制作系列脉络图、「喜欢 X 就试试 Y」的推荐板，或是可视化的待玩清单。
收藏中的每个项目都有一个状态：
| 状态 | 含义 |
|---|---|
| 未开始 | 还没接触过 |
| 进行中 | 正在游玩 / 观看 / 阅读 |
| 已完成 | 已经完成 |
| 重玩中 | 再次体验一个已完成的作品（电影 / 电视剧 / 动画为重看中，漫画和书籍为重读中） |
| 已弃置 | 放弃了 |
| 计划中 | 想以后玩 / 看 |
| 已忽略 | 留在库里，但有意搁置 |
要更改状态，点击某个项目，然后在详情界面顶部的状态选择器中选择。重玩中不会改动开始和完成日期，所以项目仍保持已完成的状态。与之搭配的重玩次数计数器请见 项目详情。
已忽略与其他状态用法相同：可以在卡片上、表格单元格里或批量菜单中选择，可以按它筛选，也会出现在收藏统计里。它不改动日期，排序时排在最后，导入或与外部追踪器同步都不会把项目从这个状态里拉出来。
给任意项目评 1 到 10 分。你的个人评分和 API 评分（IGDB、TMDB）是分开存储的。你可以按任意一种来排序。
点击收藏工具栏中的排序 / 筛选图标：
排序方式：
- 手动（拖放顺序）
- 名称（A-Z / Z-A）
- 我的评分（从高到低 / 从低到高），只按你自己的评分排名；未评分的项目排在最后
- API 评分（IGDB 或 TMDB 分数）
- 添加日期
- 开始日期（你开始某个项目的时间）
- 完成日期（你完成它的时间）
- 状态
- 收藏（收藏的排在前面）
- 活跃度（最近有动作的排在前面；从未动过的项目按添加日期排名）
方向标签会明确说明你会得到什么结果（「最新在前」「A-Z」），而不是笼统的升序 / 降序。直接在卡片上编辑评分或状态，列表会立即重新排序。
筛选方式：
- 媒体类型（游戏、电影、电视剧、动画、视觉小说、漫画、书籍、音频）
- 状态，网格上方的下拉菜单可以一次选中多个状态。勾选时菜单保持打开，项目只要命中其中任意一个就通过筛选，选中超过一个时分段显示「状态：3」。全部 会清空选择。
- 子分类，选中「游戏」标签会在下方展开平台标签；漫画和动画则展开形式标签（Manhwa、OVA、轻小说……）。这些标签是根据收藏中实际存在的内容构建的。
- 收藏（星标），同一条筛选栏里的一个分段，把列表缩小到你加过星的项目。它可以与类型、子分类、标签、状态和搜索筛选叠加使用。
每个媒体类型箭头上的数量会跟随当前的子筛选：选择一个平台或形式，数字就会随之收窄。至于显示哪些箭头，依据的仍是未筛选的总数，因此某个类型不会在筛选过程中从栏里消失。
想在不先选择媒体类型的情况下就看到平台和形式标签？打开 设置 → 始终显示子分类。
收藏内部以及「全部项目」界面的搜索框（顶栏）前面多了一个模式菜单：按标题 或 按详情。两种模式都不区分大小写。
按标题 会匹配：
- 标题名称
- 标签名称
- 个人备注和作者评论，你可以通过自己写下的内容来找到作品
- 专辑的艺人和书籍的作者
按详情 匹配的是作品的构成信息：流派、标签、制作公司、作者、出版社、主题、开发商、艺人、厂牌、平台、形式、季度和发行年份，适用于所有媒体类型。
- 逗号把多个条件按「与」串联，一个条件内部的斜杠（或
|）表示「或」：horror / thriller, 2019会找出 2019 年的恐怖或惊悚作品。 - 一个短语算作一个值，所以
kyoto animation找的是这家公司，而不是拆开的两个词。
在项目卡片上，流派、动画和漫画标签、漫画作者、专辑厂牌以及自定义项目的平台都是可点的标签。点一下，卡片关闭，这个值会在下层界面上作为详情搜索执行。如果界面上已经有一条详情查询，点中的值会作为又一个「与」条件加进去。从搜索或发行界面点标签，会带着同样的查询回到主页。
在桌面端，右键点击项目和收藏会显示一个上下文菜单，无需去找 ⋮ 按钮：
- 在收藏卡片上（主页界面）：打开、重命名、删除
- 在收藏项目上（网格、列表、表格视图）：移动到收藏、复制到收藏、移除、标签，以及底部一条列有所有状态的横条。点击某一段即可更改状态而无需离开菜单（标签会随媒体类型调整：游戏显示 游玩中，电影和电视剧显示 观看中）。
- 在收藏界面的空白区域：新建收藏、导入收藏、切换视图
- 在「全部项目」中的卡片上：移动 / 复制 / 移除，加上同样的内联状态切换器
在移动端，用长按来执行相同的操作。
术语说明： 在统计、提示和对话框中，俄语措辞「элемент」已替换为「тайтл」（英文仍为 "item"）。在看板上保留「элемент」，因为那里指的是看板基本元素（文字 / 贴纸 / 图片），而非收藏项目。
选中多个项目并一次性对它们操作，在收藏内的每个视图（网格、列表、表格、手动排序）以及主页的「全部项目」界面都可用。
进入选择模式：
- 桌面端，把鼠标悬停在任意卡片上，左上角会淡入一个勾选圆圈；点击它即可选中。一旦选中至少一个项目，所有卡片上的圆圈就会持续显示，此时普通的左键点击会切换选中状态，而不是打开详情界面。
- 移动端，长按任意卡片进入选择模式并选中它；继续点击可切换其他项目。
- 表格视图 还有一个复选框列。表头的复选框会对当前可见的行切换全选（会遵循表格列的筛选）；每一行都有自己的复选框。
只要选择不为空，批量操作栏 就会出现在列表上方。你可以从中：
- 移动 选中的项目到另一个收藏
- 复制 选中的项目到另一个收藏
- 更改状态，对整批选择生效（未开始 / 游玩中 / 已完成 / 重玩中 / 已弃置 / 计划中，标签会随媒体类型调整）
- 导出为 PNG，把选中的封面渲染成一张海报图片，方便保存或分享
- 从收藏中移除 选中的项目（会有确认框显示数量）
- 添加标签 / 移除标签，两者都会打开与单个项目相同的标签选择器，且不预先勾选任何项：勾选表示「应用到所有选中项」，而不是「这个项目已有它」。添加只做添加，移除只去掉你勾选的标签，因此你未勾选的标签及其手动顺序都会保留
- 移到顶部 / 移到底部，仅在收藏设为手动（自定义）排序时可见；选中的这组会在新位置保持相对顺序
窗口较窄时，操作栏会分成两行：计数占一行，操作占另一行。
当可见的项目多于你已选中的数量时，计数旁边会出现一个 选择所有可见项 链接，选中当前筛选下显示的每一个项目。
按操作栏左侧的 × 按钮即可清除选择。
在主页的「全部项目」界面上，操作栏可跨收藏工作，每个项目所属的源收藏会被独立地刷新，因此各处的统计和计数都保持一致。
移动端长按提示： 长按现在会进入选择模式，而不是打开单项目的上下文菜单。移动 / 复制 / 移除 / 更改状态仍然可用，用长按选中项目，然后使用批量操作栏。
当收藏设为手动（自定义）排序时，单行的右键（或长按）菜单现在还会有 移到顶部 和 移到底部。一次点击就能让项目跳到列表的开头或末尾，无需拖着它穿过整个收藏。在其他排序模式下这两项会被隐藏，因为它们在那里没有可见效果。
把你的收藏作为文本列表复制到剪贴板，方便在论坛、Reddit 或社交媒体上分享。
快速复制：菜单（⋮）→ 复制为列表，使用默认模板 {name} ({year}) 复制所有项目。
自定义模板：菜单（⋮）→ 复制为文本…，会打开一个对话框，你可以在其中：
- 使用这些占位符编辑模板：
{name}、{year}、{rating}、{myRating}、{platform}、{status}、{genres}、{notes}、{type}、{#} - 点击文本框下方的标签来插入占位符
- 选择排序顺序（当前、名称、评分、年份、添加日期）
- 查看前 5 个项目的实时预览
- 你的模板会被保存，下次继续使用
示例模板：{#}. {name} ({year}) - ★{rating} - {platform}
生成结果：1. Elden Ring (2022) - ★9.5 - PS5
空占位符会连同它周围的分隔符一起被自动清理。
- 重命名 / 编辑（该对话框也处理描述、封面图片和隐藏标记）：长按（或右键）收藏 → 重命名，会打开一个对话框，你可以在其中更改名称、添加描述、标记为隐藏并挑选封面图片（见下方 个性化视图）
- 隐藏 / 取消隐藏：长按（或右键）→ 隐藏开关，即时生效
- 删除：长按 → 删除（项目不会被删除，它们会变为未分类）
给每个收藏配上自己的封面图片和一行描述。打开 设置 → 外观 → 丰富收藏视图 即可启用。
启用后：
- 主页界面上的收藏卡片 会从 3+3 封面拼图切换为满幅主视觉图，名称、描述和统计信息叠加在左下角。没有自定义封面的收藏会使用几张内置默认横幅之一（自动分配）。
- 收藏界面 顶部会出现一条大幅主视觉横幅（图片在右，标题和描述在左），它会随网格一起滚动。横幅上带着收藏名称和返回控件，作品还在加载时它也留在界面上。
设置 → 外观 → 收藏横幅样式 决定横幅怎么画：经典、漫画、贴纸相册、粗野主义 或 条带。除经典外，每种样式都会画出该收藏的状态概览，按样式不同表现为带圆点和数字图例的等比色条、圆形状态徽章或方正计数器。「条带」把照片切成一整幅满幅画面，中间隔着两道斜切。「漫画」和「贴纸相册」使用固定的纸墨配色，其余样式跟随应用主题。
通过长按 / 右键点击收藏 → 重命名（该对话框也处理描述和封面）→ 选择图片 来挑选封面。推荐尺寸：2560×1080（21:9）。把主体放在右侧，左侧会被标题遮挡，底部会淡入背景。使用 移除图片 可回退到内置默认封面。
封面存储在本地，并包含在完整的 .xcollx 导出中，因此它们会随收藏一起迁移。
主页标签页的「全部项目」界面有一个状态筛选下拉标签。你可以按以下状态筛选项目：
- 进行中（默认），你当前正在玩 / 看的内容
- 计划中，你的待办清单
- 未开始，还没有任何动作的项目
- 已完成，已完成的项目
- 已弃置，你放弃了的项目
- 已忽略，你搁置的作品
可以同时勾选任意多个状态：项目命中其中任意一个就通过筛选。全部 会清空选择。整组选择会在多次会话之间保留，并为每个配置分别记忆。
紧挨着状态筛选的是一个 收藏 切换按钮，打开它就只看你用心形标记的项目。它也会记住自己的状态，并为每个配置分别记忆。
在「全部项目」网格上，每个收藏分组以收藏名称打头，下面配一条粗重的强调下划线、总数、按媒体类型的小计数（类型图标加上它的数字）以及一个收藏计数。点击名称即可打开那个收藏；多选进行中时名称不响应点击。不属于任何收藏的项目会归入一个灰暗的「未分类」标题下。
从搜索或项目详情把项目添加到收藏时，收藏选择器对话框的标题栏中有一个排序切换。可循环切换：A-Z、Z-A、日期升序、日期降序。初始排序会跟随你的主页排序设置。
标签是你为分组项目自定义的标记，「RPG」「最爱」「待办」，需要什么都行。它们在整个应用中共享：一套标签，每个收藏都从中取用。「RPG」创建一次，处处可用。一个项目可以同时携带任意数量的标签。
- 从海报卡片，点击任意卡片右下角的标签徽章
- 从详情界面，点击描述下方的标签行
- 从右键 / 长按菜单，选择 标签
以上任意一种都会打开选择器。想勾选多少标签都行，或者输入一个名称当场创建。在卡片上，徽章会显示第一个标签，当有更多标签时再加上一个「+N」计数。
管理标签 和 选择标签 选择器共用同一套界面，所以无论从哪里打开标签，可用的编辑操作都一样：
- 随输入过滤列表的搜索框，以及给尚不存在的名称准备的 创建「…」 行
- 重命名、背景色，以及一个可选的文字颜色，用于当自动的白色文字难以辨认时
- 每个标签被多少个作品使用
- 删除
- 手动模式下拖动排序
选择器行里的编辑会立刻作用于标签本身，与复选框无关：复选框决定给这个项目挂哪些标签，颜色和重命名则作用于所有带该标签的作品。
排序菜单提供 手动（你拖出来的顺序）、A–Z 和 Z–A。这个选择按配置记忆，同时决定收藏上方标签栏和窄屏筛选面板里的顺序。
两个标签不能同名：输入的名称与已有标签重合（不区分大小写）时，创建行会立刻隐藏。
在宽屏上，当前收藏的标签排成一行标签块，位于作品上方，每块显示标签名和本收藏中带它的作品数。行首是 分组 切换按钮，接着是显示当前激活标签数的重置块。标签块的组合方式与筛选面板一致。
标签块放不下时，这一行可以横向滚动：桌面端用两侧的渐隐箭头、鼠标滚轮，或用手指、鼠标拖动。窄屏仍把标签和排序放在筛选栏按钮后面的面板里。
在收藏内部，项目会按其第一个标签分组成各个区块，每个区块的标题显示标签名称和数量。没有标签的项目会归入自己的区块。
标签筛选是「仅包含」式的：选一个或多个标签，你就会看到携带其中任意一个标签的每一个项目。某个收藏的筛选列表只显示该收藏中项目实际用到的标签。
把项目移动到另一个收藏会保留它的标签。复制会把标签关联复制到新副本上。导出会为每个项目写入标签名称，完整备份则包含整套标签，因此你的标签会随数据一起迁移。较旧的应用版本从较新的文件中仍能为每个项目恢复一个标签。
你可以手动创建不在任何数据库中的项目。打开一个收藏 → 菜单（⋮）→ 添加自定义项目。
填写详情：
- 标题 和可选的别名标题
- 封面图片，来自文件或 URL（推荐 2:3 宽高比）
- 年份、题材（可搜索的多选）
- 描述 和 评分
- 显示类型，把项目样式设为游戏、电影、电视剧等（影响颜色和图标）
- 平台（自定义游戏）或 形式（自定义漫画 / 动画），从真实项目所用的相同列表中挑选
- 进度总量，项目共有多少集、章、页或部，方便你之后追踪它的进度（见 项目详情）
自定义项目和其他项目一样工作，它们会出现在看板、等级列表和导出中。在筛选栏中，一个自定义项目会同时计入 自定义 以及它所显示的类型之下，它的平台或形式也会出现在子分类标签中。
不属于任何收藏的项目会出现在主页标签页的「全部项目」界面中。你可以随时从项目详情界面把它们移动到某个收藏。
未分类这个容器正在被逐步淘汰。它现在是只读的：在移动或添加项目时它不能被选作目标，它的卡片带有一条红色的「即将移除」警告，它内部的添加按钮也被隐藏了。把还留在里面的东西都移到一个正常收藏中吧，「全部项目」上会有一条横幅提醒你，直到它清空为止。