Skip to content

gegd19/AnimeMan

BranchesTags

Repository files navigation

🎌 AnimeMan · 番剧智能管家

AnimeMan Banner

🤖 AI 驱动的动漫媒体库全自动整理神器 · 专为 NAS 用户与二次元收藏家设计

Python Flask License Docker

✨ 为什么选择 AnimeMan • 🆚 对比同类项目 • 🔧 失败处理对比 • 📦 实战案例 • 🚀 快速开始 • 📸 界面预览

🤔 你是否也经历过这些崩溃瞬间？

  • 辛辛苦苦从网上拖了 178 集《网球王子》BDRip，文件名全是 [压制组] Prince of Tennis [01][Ma10p_1080p].mkv，手动改名改到怀疑人生？
  • Emby / Jellyfin 刮削总是识别成奇怪的罗马音，海报牛头不对马嘴，媒体库乱七八糟？
  • 特典、OVA、SP、NCED 散落各处，被 Emby 统统塞进 S00E00，找都找不到？
  • 想保种又想让媒体库整洁美观，复制一份浪费空间，不复制 Emby 又扫不到？

别慌，AnimeMan 就是来终结这一切的。

🆚 与同类项目的区别

功能/特性 AnimeMan Sonarr/Radarr FileBot tinyMediaManager
动漫文件名解析 ⭐⭐⭐⭐⭐
内置 anitopy + 罗马数字转换 + 总集数换算		 ⭐⭐
对压制组命名支持较弱		 ⭐⭐⭐
需手动编写规则		 ⭐⭐⭐
AI 智能辅助 ⭐⭐⭐⭐⭐
DeepSeek/OpenAI 驱动，自动修正解析失败的文件名		 ❌ ❌ ❌
硬链接保种 ⭐⭐⭐⭐⭐
默认硬链接，跨盘自动降级符号链接		 ⭐⭐⭐⭐
支持硬链接但配置复杂		 ⭐⭐⭐⭐ ⭐⭐⭐
特典/OVA 处理 ⭐⭐⭐⭐⭐
可视化管理映射规则，一键归类 S00		 ⭐⭐⭐
需手动调整		 ⭐⭐⭐ ⭐⭐⭐
移动端 Web 界面 ⭐⭐⭐⭐⭐
专为手机优化，卡片化设计，躺沙发也能管理		 ⭐⭐⭐⭐
有移动端界面但体验一般		 ❌
无 Web 界面		 ⭐⭐⭐
字幕智能匹配 ⭐⭐⭐⭐⭐
AI 分组匹配 + 自动调轴		 ⭐⭐⭐
需搭配 Bazarr		 ❌ ⭐⭐⭐
上手难度 ⭐⭐⭐⭐⭐
Docker 一键部署，Web 界面配置，无需学习规则语法		 ⭐⭐⭐
配置项较多		 ⭐⭐⭐ ⭐⭐⭐⭐

🎯 AnimeMan 更擅长的场景

  • ✅ 你是 PT 玩家：下载的动漫需要保种，又想让 Emby 完美刮削 → 硬链接模式两全其美
  • ✅ 你收藏了大量动漫 BDRip：文件名千奇百怪（[VCB-Studio]、III、1072）→ anitopy + AI 自动搞定
  • ✅ 你经常在手机/平板上管理媒体库：AnimeMan 的移动端界面专门优化，按钮大、卡片清晰
  • ✅ 你不想学复杂的规则语法：Web 界面点点按钮就能完成所有配置和修正
  • ✅ 你有大量特典/OVA/SP 需要整理：可视化映射规则，一键归类到 S00

🤝 更人性化的设计细节

  • 失败缓存可视化：处理失败的文件会集中展示，支持批量手动修正，而不是默默跳过
  • 实时处理日志：Web 界面实时滚动日志，出问题一目了然
  • 引导式配置：首次使用有教程横幅，一步步带你填写 TMDB Key、路径等必要信息
  • 暂停日志功能：日志滚动太快看不清？点击「暂停日志」慢慢查
  • 双击停止任务：Web 界面停止按钮支持双击强制重置，卡死也不怕

✨ 为什么选择 AnimeMan？

🧠 AI 大脑，看懂一切奇葩命名

  • 纯数字 1072.mkv？方括号 [11]？罗马数字季号 III、IV？
  • AnimeMan 调用 DeepSeek / OpenAI 大模型，像人类一样理解文件夹结构，自动换算总集数、识别正确的季和集。
  • 动漫特化：内置 anitopy 引擎，专为动漫文件名优化，压制组标签自动清洗。

🔗 NAS 党最爱的「硬链接」模式

  • 不复制、不移动、不损坏做种。通过硬链接在 Emby/Jellyfin 媒体库中生成文件入口，源文件继续保种上传。
  • 跨盘自动降级为符号链接，并给出友好提示。Windows 开发者模式？没在怕，一键提示开启。

📺 Emby / Jellyfin / Plex 完美伴侣

  • 自动生成 movie.nfo、tvshow.nfo、episode.nfo，刮削器直接读取，100% 精准匹配。
  • 自动下载 TMDB 官方海报、背景图，你的媒体库从此颜值在线。

📝 字幕智能中心

  • 自动扫描同目录及 Subs/ 文件夹下的 .ass、.srt 字幕。
  • AI 分组匹配：同一番剧的字幕文件，一次性批量关联到正确剧集，告别手动拖放。
  • 支持 ffsubsync 自动调轴，日语字幕也能对得上嘴型。

📱 移动端友好，躺沙发上也能管理

  • 响应式 Web 面板，手机、平板、电脑无缝切换。
  • 失败缓存一键批量修正，再也不用手动翻目录改文件名。

🐳 为 NAS 量身打造的部署方式

  • 提供 Docker Compose 一键部署，群晖、威联通、Unraid 通用。
  • 源码运行支持 Python 虚拟环境，干净隔离不污染系统。

🔧 失败处理：传统方法 vs AnimeMan

即使是最智能的工具，也难免遇到无法自动处理的文件（例如 TMDB 无记录、文件名极度混乱）。这时候，如何处理失败项就成了区分工具好坏的关键。

😫 传统方法的痛苦

使用其他工具或手动整理时，你可能会经历以下流程：

  1. 打开下载文件夹，找到那个处理失败的文件。
  2. 手动分析文件名，猜测它应该是哪一季哪一集。
  3. 打开 TMDB 网站，搜索剧集，找到正确的 TMDB ID。
  4. 手动创建目标文件夹（如 Season 03）。
  5. 手动复制/硬链接文件到正确位置，并重命名为 Emby 可识别的格式。
  6. 如果有多个文件失败，重复以上步骤 N 次，每次都要切换窗口、复制粘贴。

结果：整理 10 个失败文件可能要花半小时，而且极易出错。

🚀 AnimeMan 的批量修正

AnimeMan 将这个过程简化为 「所见即所得」的批量操作：

  1. 失败自动归类：所有处理失败的文件会按文件夹聚合显示，一眼就知道哪些剧集出了问题。
  2. 一键查看文件夹内全部文件：点击「查看所有文件」，可以看到该文件夹下的所有视频文件（包括已成功和失败的），方便统一判断。
  3. 智能排序与预览：系统自动按文件名中的集号排序，并实时预览每个文件将被分配的集号（如 1, 2, 3...）。支持手动调整顺序（↑↓按钮）。
  4. 内置 TMDB 搜索：直接在弹窗内搜索 TMDB，选择正确条目后，系统自动获取该剧集的季集结构。
  5. 绝对集数自动换算：如果文件是总集数命名（如 1072.mkv），勾选「自动跨季换算」后，系统会自动计算正确的季号和季内集号。
  6. 一键执行：确认无误后，点击「开始批量修正」，系统会自动清理旧缓存、重新匹配、创建链接、生成 NFO，所有文件一次搞定。

📊 效率对比

场景 传统方法 AnimeMan
处理 10 个失败文件 约 30 分钟，需反复切换窗口 2 分钟，在一个弹窗内完成
总集数换算（1072 → S21E08） 手动计算或查表，易出错 一键自动换算
特典/OVA 归类 手动创建 S00 文件夹，逐个移动 映射规则自动归类
修改集数顺序 手动重命名文件 拖拽排序或点击上下移动

这就是 AnimeMan 的核心理念：自动化能解决的问题绝不让你动手，实在需要你介入的，也尽量压缩到最少的点击次数。

📦 实战案例：整理《某科学的超电磁炮》合集

假设你从 BT 站下载了《某科学的超电磁炮》全系列，目录结构如下：

/downloads/anime/[VCB-Studio] Toaru Kagaku no Railgun [Ma10p_1080p]/
├── [VCB-Studio] Toaru Kagaku no Railgun [01][Ma10p_1080p][x265_flac].mkv
├── [VCB-Studio] Toaru Kagaku no Railgun [02][Ma10p_1080p][x265_flac].mkv
├── ...
├── [VCB-Studio] Toaru Kagaku no Railgun S [01][Ma10p_1080p][x265_flac].mkv
├── [VCB-Studio] Toaru Kagaku no Railgun S [02][Ma10p_1080p][x265_flac].mkv
├── ...
├── [VCB-Studio] Toaru Kagaku no Railgun T [01][Ma10p_1080p][x265_flac].mkv
├── ...
├── [VCB-Studio] Toaru Kagaku no Railgun [OVA][Ma10p_1080p][x265_flac].mkv
└── [VCB-Studio] Toaru Kagaku no Railgun [NCED][Ma10p_1080p][x265_flac].mkv

1️⃣ 配置 AnimeMan

在 auto_config.json 中设置：

{
  "source_folders": ["/downloads/anime"],
  "tv_target_folder": "/media/TV Shows",
  "movie_target_folder": "/media/Movies",
  "link_type": "hard",
  "tmdb_api": { "api_key": "你的TMDB密钥" },
  "ai_parser": { "enabled": true, "api_key": "你的AI密钥" },
  "ignore_patterns": ["NCED", "NCOP", "CM", "SPs"]
}

2️⃣ 添加特辑映射规则（可选）

为了正确处理 OVA 文件，在 Web 面板的「特辑/OVA 手动映射规则」中添加：

关键词 TMDB ID 类型 季号 集号
[OVA] 某科学的超电磁炮 4604 tv 0 1

3️⃣ 运行处理

点击「开始处理」，AnimeMan 将自动：

  • 识别出《某科学的超电磁炮》第一季、第二季（S）、第三季（T）
  • 将 OVA 归类到 S00E01
  • 跳过 NCED 等特典文件
  • 在 /media/TV Shows/某科学的超电磁炮 (2009)/ 下创建标准目录结构

4️⃣ 最终输出

/media/TV Shows/
└── 某科学的超电磁炮 (2009)/
    ├── tvshow.nfo
    ├── poster.jpg
    ├── fanart.jpg
    ├── Season 01/
    │   ├── 某科学的超电磁炮 (2009) - S01E01 - 电击使.mkv
    │   ├── 某科学的超电磁炮 (2009) - S01E02 - 炎天下の撮影.mkv
    │   └── ...
    ├── Season 02/
    │   ├── 某科学的超电磁炮 (2009) - S02E01 - 超电磁炮.mkv
    │   └── ...
    ├── Season 03/
    │   └── ...
    └── Season 00/
        └── 某科学的超电磁炮 (2009) - S00E01 - OVA.mkv

此时刷新 Emby 媒体库，所有剧集已完美刮削，海报、简介、演员信息一应俱全。

🚀 快速开始（NAS 用户看这里）

方式一：Docker Compose（推荐）

# 下载项目
git clone https://github.com/gegd19/AnimeMan.git
cd AnimeMan

# 修改 docker-compose.yml 中的挂载路径（将 /path/to/... 替换为你 NAS 上的实际路径）
vim docker-compose.yml

# 准备配置文件
#### 通过 Web 界面填写（推荐，最简单）
1. 启动容器后，浏览器访问 `http://你的NAS_IP:8000`。
2. 在「配置面板」→「API 密钥」中粘贴你的 TMDB API Key，点击「保存配置」即可生效。
> **无需手动编辑任何文件**，所有路径也可在 Web 界面中通过「浏览」按钮选择。


# 启动！
docker compose up -d

浏览器访问 http://你的NAS_IP:8000，开始配置。

方式二：源码运行（含虚拟环境教程）

1. 克隆项目并创建虚拟环境

git clone https://github.com/gegd19/AnimeMan.git
cd AnimeMan

# 创建虚拟环境
python3 -m venv venv

# 激活虚拟环境 (Linux/macOS)
source venv/bin/activate

# 激活虚拟环境 (Windows PowerShell)
cmd
.\venv\Scripts\Activate.ps1

# 激活虚拟环境 (Windows CMD)
venv\Scripts\activate.bat

2. 安装依赖

pip install -r requirements.txt

3. 配置文件

cp auto_config.json.example auto_config.json
vim auto_config.json  # 填写 TMDB API Key 和路径

4. 启动！

python web_app.py

访问 http://127.0.0.1:8000。

⚙️ 配置核心项速览

配置项 必填 说明
tmdb_api.api_key ✅ 去 TMDB 免费申请
source_folders ✅ 你的下载目录，例如 /downloads/anime
tv_target_folder ✅ Emby 剧集库路径，例如 /media/TV Shows
movie_target_folder ✅ Emby 电影库路径，例如 /media/Movies
ai_parser.enabled ❌ 开启 AI 解析，强烈推荐！
ai_parser.api_key ❌ DeepSeek 等 API Key（新用户有免费额度）
link_type ❌ 默认 hard，同盘保种最优解
ignore_patterns ❌ 跳过包含这些关键词的文件/目录

📸 界面预览

桌面端

主控制面板

桌面控制面板

失败缓存管理

失败缓存管理

批量手动修正

批量手动修正

媒体库管理界面

桌面媒体库管理界面

移动端

手机控制面板

手机控制面板

手机媒体库管理界面

手机媒体库管理界面

🧩 技术栈

层级 技术
后端 Python 3, Flask, requests, anitopy
前端 原生 JavaScript (模块化), CSS3 Grid/Flex
AI DeepSeek / OpenAI / 智谱 / 通义千问
元数据 TMDB API v3
字幕同步 ffsubsync, pysubs2
部署 Docker, Docker Compose

🙋 常见问题

Q：我下载的文件在多个硬盘上，能用硬链接吗？ A：硬链接仅限同一分区。跨盘会自动尝试符号链接，并在 Web 界面提示。建议将下载盘与媒体库盘设置在同一分区。

Q：AI 解析会花很多钱吗？ A：DeepSeek 等大模型新用户通常有免费额度，文件夹批量解析模式能大幅节省 Token。单文件解析成本极低。

Q：为什么有些特典还是被识别为 S01E01？ A：你可以在「特辑/OVA 手动映射规则」中添加关键词规则，强制指定 TMDB ID 和季/集号。OVA、SP 等将自动归类到 S00 季。

Q：支持 Windows NAS 吗？ A：完全支持。源码运行或 Docker Desktop 均可。注意 Windows 下符号链接可能需要开启「开发者模式」。

🤝 贡献

欢迎提交 Issue 与 PR！如果你有更好的动漫文件名样本，也欢迎提交供 AI 训练参考。

📄 许可证

本项目基于 MIT License 开源。

🎌 AnimeMan · 让每一部番，终归此匣
Made with ❤️ for NAS & Anime Lovers

About

🎌 AI 驱动的动漫媒体库全自动整理工具 · 专为 NAS 与二次元收藏家设计

Topics

python flask ai anime docker-compose emby nas

Resources

Readme
Activity

Stars

7 stars

Watchers

1 watching

Forks

1 fork
Report repository

Releases

No releases published

Packages

 
 
 

Contributors 1

Languages