中文 | English | 日本語

AnimeMachine

AnimeMachine 是一款支持中、英、日三语界面的动画库管理工具。它整合作品资料、媒体文件与订阅进度，提供作品检索、新番追更、收藏整理、系列关系查询和播放功能，可在 Windows、Linux、macOS 或 Docker 中运行。

用户手册 · 快速部署 · 常见问题。启动后点击页面顶部的 手册，可离线查阅图文步骤。

新作雷达与一键继续观看	作品关系图（关联的新老作品）

主要功能

• 新番追更：通过新作雷达查看开播日期和最新集数，检索季度资源，选择字幕组并添加 Ani-RSS 订阅。
• 收藏管理：识别已有媒体，比较 Torrent 资源与本地文件，生成补齐计划；按作品和系列组织目录。
• 作品检索：按年代、类型、制作公司、主题和收藏状态筛选，支持中文、英文和日文名称搜索。
• 系列关系：通过作品关系图查看前作、续作、剧场版和番外。
• 播放与字幕：选择起始集，向 VLC、PotPlayer 等播放器提供播放列表；按账号记录观看集数，一键继续观看当季 TV；PotPlayer 可记录播放位置并自动续播。支持外置字幕。
• 服务接入：连接已有的 qBittorrent、Ani-RSS 或 NAS 媒体目录。界面支持中文、英文、日文及明暗主题。

连续播放本周新集

在新作雷达点击 一键继续观看，勾选已订阅且有新集待看的 TV 动画，自行修改各作品的播放集数范围并排序。默认从上次未看完的一集播到最新可用集数；PotPlayer 安装扩展后，还可从上次停止的位置续播。

播放记录在作品详情和雷达之间共用，也可以手动修改。操作步骤见一键继续观看与播放。

查看系列作品关系

点击作品卡片上的 作品关系图，查看前作、续作、剧场版和番外之间的联系。打开后会定位到当前作品，点击图中标题可查看详情。

关系类型可点击切换显示，也可以全屏查看或导出 PNG、SVG。具体操作见作品关系图。

快速开始

根据设备选择启动方式，具体步骤见部署与使用指南。

视频教程： 使用教程 · 部署教程

使用场景	启动方式
Windows 10 / 11	从 Releases 下载 Windows ZIP，解压后双击 AnimeMachine.cmd。发布包包含 Python 运行环境。
Linux	安装 Python 3.11 或更新版本，下载对应的 Linux 发布包，解压后运行 ./AnimeMachine-Linux.sh。
macOS	安装 Python 3.11 或更新版本，下载对应的 macOS 发布包，解压后打开 AnimeMachine-macOS.command。
NAS / Docker	下载完整组合的 compose.yaml，在文件所在目录执行 docker compose up -d。部署方案与步骤见Docker Compose 指南。

默认 compose.yaml 同时附在 Releases 和发布包根目录。下载这一个文件即可开始部署，无需下载源码或从多个模板中选择。

启动后打开 http://localhost:8787。从其他设备访问时，将 localhost 替换为运行 AnimeMachine 的电脑或 NAS 地址。初始账户和随机密码显示在启动窗口或容器日志中。

首次启动优先准备当季作品，资料就绪后直接显示发行包预置的当季封面，其余资料和图片在后台补全。升级沿用已有作品库和图片缓存。

flowchart TB
    A[启动并登录] --> B[设置媒体目录]
    B --> C[找到一部作品]
    C --> D[播放收藏 / 添加订阅]

Loading

使用文档

内容	文档
安装、登录与首次设置	部署与使用指南
追新番、补收藏、看关系图和播放	日常使用
接入下载器、Ani-RSS 或已有媒体库	连接与目录
更新、备份或处理使用中的问题	更新与备份 · 常见问题
了解组件和目录如何配合	架构说明
查环境变量、网络参数和开发入口	配置与技术参考

更新日志 · 参与开发

AnimeMachine 使用 AGPL-3.0-only 许可证。作品资料来自 Bangumi Archive，追番连接使用 Ani-RSS。组件和资料来源见 THIRD-PARTY.md。