AniList Import ZH

从 AniList 导入

通过公开用户名导入你的 AniList 动画和漫画列表，无需 API 密钥，也无需 OAuth。

导入的内容

AniList 字段	Tonkatsu Box
Media id	关联到 AniList 条目的外部 id
媒体类型（ANIME / MANGA）	动画 / 漫画 项目
status	项目状态（见状态映射）
score（1-100）	我的评分，归一化到 1-10（0 分变为"无评分"）
progress	当前集数（动画）或当前话数（漫画）
progressVolumes	当前卷数（漫画）
repeat	重玩 / 重读次数（加入用户备注）
notes	追加到用户备注中
startedAt / completedAt	开始 / 完成日期（支持只有年 / 月 / 日的模糊日期）
updatedAt	最近活动时间戳

每个导入项目的备注里都会加入一个指向 AniList 页面的链接（https://anilist.co/anime/<id> 或 /manga/<id>）。

isAdult 条目会被跳过。来自自定义列表的条目也会被跳过，因为 AniList 同时把它们放在标准列表中，会造成重复。

状态映射

AniList 状态	Tonkatsu Box 状态
CURRENT	进行中
REPEATING	进行中（重玩次数保存在备注中）
COMPLETED	已完成（集数 / 话数 / 卷数计数补足到 AniList 的总数）
PLANNING	计划中
DROPPED	已弃置
PAUSED	已弃置

使用要求

• 无需 API 密钥，无需 OAuth：导入器读取的是你的公开 AniList 个人资料。
• 网络连接：每种列表类型发送一次 GraphQL 请求（动画一次，漫画一次）。
• 个人资料必须是公开的；私密资料会失败并给出清晰的错误提示。

如何导入

1. 打开 设置 → 导入 → AniList
2. 输入你的 AniList 用户名（导入器会记住它，方便下次使用）
3. 选择要拉取的列表：
   • 动画列表 和 / 或 漫画列表（至少选择一个）
4. 选择模式：
   • 仅添加新条目：跳过目标收藏中已有的项目
   • 覆盖已有条目：根据 AniList 更新状态、进度、评分和日期
5. 选择目标收藏：
   • 新建收藏：默认将收藏命名为 AniList Import - <username>
   • 使用已有收藏：从下拉菜单中选择一个
6. 点击 开始导入

导入进度

导入过程中你会看到：

• 当前阶段：获取动画列表 → 获取漫画列表 → 导入条目
• 显示当前数 / 总数的进度条
• 正在处理的条目名称
• 实时计数：已导入、已更新

COMPLETED 补全是如何工作的

对于标记为 COMPLETED 的条目，导入器会补全计数和日期，以反映"已完成"状态：

• 动画：集数计数设为 max(progress, anime.episodes)
• 漫画：话数计数设为 max(progress, manga.chapters)，卷数计数设为 max(progressVolumes, manga.volumes)
• 日期：如果缺少 completedAt，则回退到 startedAt，再回退到 updatedAt；如果缺少 startedAt，则回退到 completedAt

对于其他状态，计数和日期按原样采用。

重复处理

在覆盖模式下重新导入到同一个收藏时，会更新已有项目，而不是产生重复：

• 状态：通过标准的外部状态规则合并（绝不会降级已完成或已弃置）
• 进度：集数 / 话数 / 卷数取 max(本地值, AniList 值)
• 评分：AniList 评分在有值时胜出
• 日期：最早的 开始、最晚的 完成
• 用户备注：根据最新的 AniList 数据重建（链接、重玩次数、备注）

在仅添加新条目模式下，已有项目会被跳过。

小提示

• 用户名保存在本地，下次访问时会预先填好。它只会发送到 AniList，不会发往其他任何地方。
• 看 / 读了更多内容后，用覆盖模式重新导入即可刷新进度和日期。
• 如果同一部作品出现在不同收藏中，每个收藏都各自记录自己的进度，只有你为本次导入选中的收藏会被更新。