AniShelf
下载

使用指南

完成 AniShelf 的初始设置，添加第一部动画，用好追踪、提醒与同步功能。

本页内容

开始使用

AniShelf 支持 iOS 或 iPadOS 26 及以上版本的 iPhone 与 iPad，并提供适用于 macOS 26 及以上版本的原生 Mac App。在 Mac 上，侧边栏列出资料库和分类，选中条目后，详情会显示在旁边的检查器中。在 文件 菜单中选择 新建窗口，可以打开新窗口。在 iPad 和 Mac 上，每个窗口会独立保留各自的分类、筛选、排序和视图模式。

首次打开 AniShelf 时，需要填入一个 TMDb API 密钥。App 中的标题、简介、海报和每集信息都来自 The Movie Database（TMDb），个人使用可以免费申请密钥。AniShelf 是免费 App，不提供公用的密钥，需要你自己申请一个。

申请 TMDb API 密钥

  1. 在 The Movie Database 注册一个免费账户。
  2. 登录后，打开 API 申请页面。也可以在账户设置的 API 部分找到它。
  3. 选择 Personal Use（个人使用），然后填写表单：
    • Application Name（应用名称）：AniShelf
    • Application URL（应用网址）：https://anishelf.konakona.dev
    • Type of Use（使用类型）：Mobile Application
    • Application Summary（应用概述）：例如 “An anime library app for tracking the series and films I watch.”
    • 填写联系信息，同意条款后点击 Subscribe。
  4. 回到 API 设置页面，复制页面下方的 API Key。请复制 API Key，不要复制 API Read Access Token（读取访问令牌）。
  5. 按提示把密钥粘贴到 AniShelf 中。验证通过后，AniShelf 会请你选择动画信息语言和默认海报，点击 开始使用 AniShelf 即可进入资料库。之后如需更换密钥，请打开设置 › 元数据与图片，点击 更改 API 密钥。

添加动画

点击右下角的搜索按钮，输入番剧或动画电影的名称进行搜索。

  • 番剧：通过结果下方的滑块，选择添加整部系列还是单独某一季。用结果右上角的按钮选中系列，或者一季、多季，然后点击 加入资料库。
  • 动画电影：选中后点击 加入资料库。
  • 一次添加多部：点击搜索页面右上角的 批量添加，输入多个标题或 TMDb ID。

有些番剧虽然分几段播出，官方却没有分季，集数是连续的。典型的例子是《葬送的芙莉莲》，它的“第一季”包含了全部 38 集。遇到这种情况，请添加整部系列。

浏览资料库

  • 点击左下角的图标，可以在网格、列表和图库视图之间切换。
  • 用下方正中央的状态栏筛选条目，例如只显示“在看”。
  • 长按条目可以进行更多操作。在列表视图中，左滑或右滑条目可以快速更新观看状态或删除条目。左滑后点击 打开，或直接左滑到底，可以在其他 App 中打开条目。如果不想每次选择，可以在设置 › 外观与交互的 滑动操作打开 中选一个 App。
  • 如需同时修改多个条目，在列表或网格视图中点击右上角的 选择，即可批量修改观看状态、评分、收藏和日期，或批量删除。

用分类整理

分类可以让你按自己的方式整理动画，例如正在追的一季新番，或者和朋友一起看的番。分类功能默认关闭，如需开启，请打开设置 › 资料库与追踪，开启 资料库分类。

  • 把动画加入分类：在列表或网格视图中点击 选择，选中动画后点击 分类。选择一个分类即可加入或移出选中的动画；也可以点击 新建分类…，用它们新建一个分类。菜单会保持打开，方便一次选择多个分类。
  • 切换分类：点击资料库顶部的标题，或者在下方正中央状态栏的菜单中选择 分类。全部 会显示整个资料库。在分类中，状态筛选和排序依然有效。
  • 管理分类：在标题菜单中选择 编辑分类…，或在设置中点击 管理分类，可以重命名、删除分类或调整顺序。删除分类不会把其中的动画移出资料库。
  • 分类标签：开启 固定分类栏 后，列表和网格视图会在导航栏下方固定显示分类标签，点击标签即可切换。长按标签可以重命名或删除分类，也可以选择 调整标签顺序，把标签拖到合适的位置后点击 完成。

分类会通过 iCloud 同步，也会包含在备份中。

记录观看

双击条目即可打开详情页，在那里可以记录：

  • 观看状态：想看、在看、已看完或中断
  • 开始和完成日期
  • 观看进度
  • 评分和笔记

分集进度默认关闭。如需开启，请打开设置，在“资料库与追踪”中开启 记录分集进度。之后，条目处于“在看”状态时，详情页会显示分集进度。关闭该设置只会隐藏进度，不会删除已记录的进度。

点击星星即可评分。再点一次同一颗星可以加半星，例如 4.5 星；也可以在星星上拖动来调整分数。

点击 打开方式，可以在 Infuse、Kazumi 或哔哩哔哩中打开条目，或打开条目主页。未安装的 App 会显示为 未安装。

向下滑动可以查看简介、声优阵容和每集摘要。点击心形按钮可以收藏条目；点击分享按钮可以生成一张海报，推荐给朋友。··· 菜单里还有更多选项，例如在系列和单季之间转换，或者将条目标记为中断。

重看

想再看一遍时，打开条目的详情页，把观看状态从“已看完”改为“在看”。AniShelf 会询问 是在重看吗？

  • 开始重看：将条目标记为“重看中”，并清除分集进度，从第 1 集开始记录这次重看。
  • 不是重看：只修改观看状态。

把重看中的条目标为“已看完”时，重看次数会加 1。如果改为其他状态，这次重看会结束，但不计入次数。

观看状态旁的标记会显示当前是第几遍（例如 第 2 遍），或者已经重看了几次。点击它可以开启或关闭 重看中，或者修改 重看次数。在资料库中，重看次数会显示在观看状态旁，例如“已看完 ×2”。

播出提醒

符合条件的番剧会在详情页显示播出时间。对于正在连载的番剧，打开 ··· 菜单，选择 通知 > 开启。之后 AniShelf 会为每一集新番安排通知。请在 AniShelf 询问时允许通知。

  • 默认提醒时间：在设置的“播出与提醒”中，选择 默认提醒时间，范围从播出前 1 小时到播出后 1 小时。初始设置为提前 15 分钟。
  • 为某部动画单独设置：在同一个 通知 菜单中选择 提醒时间，关闭 使用默认设置，选择 播出前 或 播出后，然后设置小时和分钟。
  • 管理提醒：在设置 › 播出与提醒中点击 提醒，可以查看所有提醒、修改提醒时间或移除提醒。刷新 会按最新的播出时间重新安排提醒，全部移除 会移除此设备上的所有提醒。

播出时间来自 TVmaze，部分番剧没有相关数据。提醒需要在每台设备上分别设置。

同步、备份与导出

点击右上角的设置图标即可打开设置，这里还能看到资料库统计。以下操作均位于“同步与数据”中。

  • iCloud 同步：在每台设备上开启，并确保各设备登录同一个 Apple 账户。资料库、观看进度和设置会保持同步。首次开启时，AniShelf 可能会询问要保留哪份数据，请参阅解决 iCloud 同步冲突。
  • 备份与恢复：备份 会将整个资料库和设置保存为 .mallib 文件，其中不包含 TMDb API 密钥。恢复 会用备份内容覆盖当前资料库，如需保留现有数据，请先重新备份一次。
  • 导出为：将资料库导出为 TXT、CSV、TSV、JSON 或 XLSX 文件，方便查看或在其他 App 中使用。

只有 .mallib 备份可以恢复，AniShelf 无法导入导出的文件。恢复备份前，请先关闭 iCloud 同步，恢复完成后再重新开启。

更改动画信息语言

AniShelf 可以用英文、中文或日文显示标题、简介等动画信息，默认跟随设备语言。如需指定语言，请打开设置 › 语言，关闭 跟随系统，然后选择一种语言。

海报默认优先使用动画的原语言。如果希望 TMDb 有对应语言的海报时优先显示，可以在同一页面的“默认海报”中选择 跟随动画信息语言。

新的语言只对之后获取的信息生效。AniShelf 会询问是否刷新现有条目，点击 刷新 即可立即更新。资料库较大时，刷新可能需要一些时间。如需稍后刷新，可以在设置 › 元数据与图片中点击 刷新信息。

开启 iCloud 同步后，还可以用 anishelf-cli 在命令行中查看资料库。

疑难解答

API 密钥验证不通过，或者搜索不到结果

在部分网络环境下，访问 TMDb 可能不稳定。请依次尝试：

  1. 确认复制的是 API Key，而不是 API Read Access Token。
  2. 关闭或开启 VPN（梯子）等网络代理。不同代理的规则可能影响对 TMDb 的访问。
  3. 在设置 › 元数据与图片中开启 使用 TMDb 代理。开启后，AniShelf 会通过开发者自建的中转服务器请求 TMDb API，而不是直连 TMDb。

如果你已经在使用 VPN 或其他网络代理，建议保持 使用 TMDb 代理 关闭，直连 TMDb 通常更快、更稳定。海报等图片不会经过中转服务器，因此在部分网络环境下仍可能加载失败。中转服务器会收到哪些信息，请参阅隐私政策。

解决 iCloud 同步冲突

开启或重建 iCloud 同步时，AniShelf 会比较这台设备和 iCloud 中的资料库。如果同一部动画在两边的数据不同，AniShelf 会显示 解决 iCloud 同步冲突，并列出受影响的条目数量。

  • 使用 iCloud：保留这些条目在 iCloud 中的版本，这台设备上对它们的修改会被替换。
  • 使用这台设备：保留这台设备上的版本并上传到 iCloud，其他设备会在下次同步时获取。
  • 取消：关闭 iCloud 同步，资料库保持不变。

无论选择哪一项，只存在于一边的动画都会保留。如果不确定哪份数据是对的，可以先取消，备份资料库，再重新开启 iCloud 同步。

iCloud 同步出错或显示同步问题

打开设置 › 同步与数据，查看“iCloud 同步”下方的状态。

  1. 如果上次同步失败，点击 重试。如果 iCloud 储存空间已满，请先释放空间或升级储存空间方案。
  2. 如果状态下方出现橙色提示（例如“3 个同步问题”），点击它可以打开 同步问题，查看每个问题的说明：
    • 条目未加载：AniShelf 会自动重试。如果 TMDb 上已不存在某个条目，可以点击 从 iCloud 删除… 删除它，删除操作会同步到其他设备。
    • 更改未上传：iCloud 未接受这些更改。它们仍保存在这台设备上，AniShelf 会在之后的同步中再次尝试上传。
    • 记录无法读取：这些记录可能由更新版本的 AniShelf 保存。请更新这台设备上的 AniShelf。
  3. 如果问题仍然存在，在设置 › 同步与数据中点击 重建 iCloud 同步。AniShelf 会重新获取 iCloud 资料库，并与这台设备重新同步，期间可能需要解决同步冲突。

iCloud 同步显示“iCloud 数据已删除”

如果在设备的 iCloud 设置中删除了 AniShelf 的 iCloud 数据，就会显示此状态。这台设备上的资料库不受影响。请在设置 › 同步与数据中选择下一步：

  • 上传此资料库：用这台设备上的资料库重新创建 AniShelf 的 iCloud 数据，其他设备会重新与它同步。
  • 关闭 iCloud 同步：只在这台设备上继续使用这个资料库。

打开资料库前提示更新 AniShelf

你的资料库已由更新版本的 AniShelf 保存过，例如在其他设备上，或者你换回了旧版本。资料库安全无损：AniShelf 没有修改或移动它，iCloud 同步也会暂停。点击 打开 App Store，更新 AniShelf 后即可打开资料库。

遇到其他问题

请前往支持与反馈报告问题或寻求帮助。

常见问题

可以用 AniShelf 看番或下载吗？

不可以。AniShelf 只负责记录你看过的番，不管你在哪里看。它不提供在线播放、下载或剧集链接，也不是漫画或小说阅读器。

AniShelf 能和 Bangumi、AniList 或 TMDb 同步吗？

暂时不能。与其他平台同步观看数据已在计划中，但工作量较大，目前还没有确定的时间。

支持 iOS 26 以下的系统吗？

不支持。App 的设计大量使用了液态玻璃（Liquid Glass），需要 iOS、iPadOS 和 macOS 26 及以上版本。

有安卓或鸿蒙版吗？

暂时没有这方面的计划。