HAMA.bundle：让你的Plex动漫库从此告别混乱时代

"为什么我的《进击的巨人》被识别成了《Attack on Titan》？""为什么OVA特典总是混在正片里找不到？""为什么海报总是显示错误？"

如果你也曾经被这些问题困扰过，那么恭喜你找到了解决方案——HAMA.bundle，这款专为动漫爱好者打造的Plex元数据插件，将彻底终结你的动漫库管理噩梦！

🎯 新手必读：HAMA.bundle是什么？

简单来说，HAMA.bundle就是Plex的"动漫专属翻译官"。它通过深度整合AniDB数据库，让Plex能够真正理解动漫的命名规则和分类逻辑。

核心工作原理揭秘

HAMA.bundle的工作流程可以概括为三个关键步骤：

1. 精准识别：通过AniDB ID系统，准确匹配每一部番剧
2. 智能映射：利用ScudLee映射文件，正确区分正片、OVA、SP等内容
3. 数据聚合：从多个平台获取最完整的元数据信息

🚀 四步搞定安装配置

第一步：下载插件文件

git clone https://gitcode.com/gh_mirrors/ha/Hama.bundle

第二步：安装扫描器

为了让HAMA.bundle发挥最佳效果，你需要配合Absolute Series Scanner使用：

# 创建扫描器目录
mkdir -p "Plex Media Server/Scanners/Series"

# 下载最新版扫描器
wget -O "Plex Media Server/Scanners/Series/Absolute Series Scanner.py" https://raw.githubusercontent.com/ZeroQI/Absolute-Series-Scanner/master/Scanners/Series/Absolute%20Series%20Scanner.py

第三步：放置插件文件

将Hama.bundle文件夹复制到你的Plex插件目录中：

• Windows用户：%LOCALAPPDATA%\Plex Media Server\Plug-ins
• macOS用户：~/Library/Application Support/Plex Media Server/Plug-ins
• Linux用户：$PLEX_HOME/Library/Application Support/Plex Media Server/Plug-ins

第四步：启用插件

1. 进入Plex Web界面 → 设置 → 代理
2. 在"电影"和"电视节目"中勾选"HamaTV"
3. 重启Plex媒体服务器

📁 文件命名的最佳实践

正确的文件命名是HAMA.bundle成功运行的关键。下面是最推荐的命名格式：

你的动漫库/
├── 进击的巨人 [anidb-10218]/
│   ├── Season 01/
│   │   ├── 进击的巨人 - S01E01.mkv
│   │   └── 进击的巨人 - S01E02.mkv
│   ├── Specials/
│   │   └── 进击的巨人 - S00E01.mkv
│   ├── poster.jpg    # 自定义海报
│   └── theme.mp3     # 主题曲文件

关键技巧：在文件夹名称中加入[anidb-xxxxx]标记，这是确保准确识别的秘诀！

⚙️ 个性化设置指南

语言优先级配置

在HAMA插件设置中，你可以自定义标题和简介的语言显示顺序。例如：

• 日语优先：ja,en,zh-Hans
• 中文优先：zh-Hans,ja,en
• 英文优先：en,ja,zh-Hans

元数据来源定制

HAMA.bundle支持为不同元数据字段指定不同的来源优先级：

元数据类型	推荐配置	效果说明
标题	AniDB|ja,MyAnimeList|ja	优先显示日语原名
简介	TheTVDB|en,AniDB|en	获取英文剧情简介
海报	FanartTV,AniDB	获取高质量海报资源

🛠️ 常见问题快速解决

问题1：番剧无法正确识别

解决方案：

• 确认文件夹名称包含正确的AniDB ID
• 在番剧文件夹内创建.plexmatch文件手动指定ID

问题2：海报和背景图不显示

解决方案：

• 检查插件数据目录权限
• 手动清除缓存文件
• 确保网络连接正常

问题3：中文字体显示异常

解决方案：

• 在Plex服务器设置中更换支持中文的字体
• 调整HAMA语言优先级设置

📊 使用前后的惊人对比

使用前 vs 使用后

方面	传统插件	HAMA.bundle
识别准确率	50-60%	95%以上
季集分类	混乱无序	清晰准确
海报质量	参差不齐	高清精美
元数据完整性	大量缺失	完整丰富
多语言支持	单一语言	多语言可选

💡 进阶使用技巧

自定义元数据覆盖

如果你对某些番剧有特殊的元数据需求，可以在对应文件夹中放置以下文件：

• poster.jpg - 自定义海报
• background.jpg - 自定义背景图
• theme.mp3 - 自定义主题曲

批量处理技巧

对于大型动漫库，建议分批添加：

1. 先添加几部热门番剧测试效果
2. 确认配置正确后再批量添加
3. 定期检查元数据更新

🎉 开始你的完美动漫库之旅

现在，你已经掌握了HAMA.bundle的所有核心知识和配置技巧。从混乱到有序，从手动到自动，你的Plex动漫库即将迎来质的飞跃！

记住，一个完美的动漫库不仅仅是文件的堆积，更是对每一部作品的热爱和尊重。让HAMA.bundle帮你实现这个梦想，打造属于你自己的专业级动漫媒体中心！

立即行动：按照本文的步骤配置你的HAMA.bundle，享受从此告别手动管理元数据的快乐时光！