Bangumi Bridge Obsidian 动画追番管理方案

Bangumi Bridge 是一个专为动画爱好者设计的 Obsidian 自动化工具集，能够将您的 Bangumi 追番信息智能导入到个人知识库，并提供实时追番更新检测功能。

🌟 项目概述

本项目由北漠海的开源项目 Bangumi-to-obsidian-lite 改版而来，欢迎前往支持原作者！在此对 @北漠海的开源项目感谢！

Bangumi Bridge 由两个核心模块组成：

📥 数据导入模块

单动画导入：通过动画名称搜索 Bangumi 数据库，创建结构化笔记
批量导入：一键导入 Bangumi 账号中的"已看"、"想看"、"在看"收藏列表

🔄 追番监控模块

网站更新检测：实时监控在线观看网站的剧集更新
本地文件监控：检测下载文件夹中的视频文件数量变化
智能看板：自动将有更新的番剧置顶显示

✨ 核心特性

智能数据导入

🎯 精准匹配：支持中文/日文名称搜索，自动匹配 Bangumi 数据库
📊 完整元数据：自动获取评分、集数、制作公司、放送时间等详细信息
🏷️ 智能分类：自动检测改编类型（小说/漫画/游戏/原创/其他）
🗂️ 自动归档：按年份/季度自动分类存储笔记

实时更新检测

🌐 双模式监控：支持网站更新检测和本地文件夹监控
🔔 智能提醒：有更新的番剧自动置顶，方便追番进度管理
📈 进度同步：自动比较已观看集数与最新剧集数量
🚀 一键跳转：直接打开观看网站或本地下载文件夹

用户体验优化

⏱️ 批量处理：支持并行检测，大幅提升更新检测速度
🛡️ 容错机制：单个条目失败不影响整体流程
📋 状态监控：实时显示导入进度和错误日志
🎨 美观界面：内置完整 CSS 样式，适配 Obsidian 主题

🚀 安装与配置

完整安装步骤

1. 安装必备插件

在 Obsidian 社区插件市场中安装以下插件：

# 必需插件：
- QuickAdd
- Dataview
- Templater

2. 配置脚本文件

数据导入脚本配置：

单动画导入脚本 (ACGbangumi.js)

// 主要配置参数
const BASIC_FOLDER_PATH = "ACG/Anime"; // 修改为你自己的笔记存储路径
const DELAY_TIME = 2000; // 请求延迟（毫秒）
const PHYSICAL_FOLDER_MAPPING = {
    "ACG/Anime": "D:/Videos/Anime",// 修改为你自己的笔记存储路径和本地动画存储路径，注意斜杠方向
};
// 功能特性：
// - 交互式动画搜索和选择
// - 自动改编类型检测
// - 用户内容保留机制
// - 物理文件夹映射支持

批量导入脚本 (BangumiBatchImport.js)

// 批量导入配置
const BASIC_FOLDER_PATH = "ACG/Anime";// 修改为你自己的笔记存储路径
...
...
...
const BATCH_CONFIG = {
    userId: "595130", // 您的Bangumi用户ID（需要修改）
    delayBetweenPages: 3000, // 分页延迟
    delayBetweenItems: 2000, // 条目间隔延迟
    skipExistingNotes: true, // 跳过已存在笔记
};

// 支持的列表类型：
// - "collect": 已看列表
// - "wish": 想看列表  
// - "do": 在看列表

追番监控脚本配置：

网站更新检测版 (追番周表-并行检测)

const ROOT_FOLDER = "ACG/Anime";// 修改为你自己的笔记存储路径
// 特性：并行异步检测，速度快，支持大量番剧同时监控

本地文件监控版 (追番周表-本地)

const ROOT_FOLDER = "ACG/Anime";// 修改为你自己的笔记存储路径
// 特性：监控本地下载文件夹，统计视频文件数量

串行检测版 (追番周表-串行检测)

const ROOT_FOLDER = "ACG/Anime";// 修改为你自己的笔记存储路径
// 特性：逐个检测，稳定性好，适合网络环境不稳定情况

3.插件配置流程

1. 配置 Dataview 插件

在 Obsidian 设置中启用 Dataview 插件
确保 JavaScript 查询功能 已启用
这是追番监控脚本正常运行的必要条件

2. 配置 QuickAdd 插件

在 Obsidian 设置中启用 QuickAdd 插件
进入 QuickAdd 插件设置
在模板文件夹路径（Template Folder Path）设置中，选择您的 数据导入脚本存放路径

3. 创建 QuickAdd 宏

在 QuickAdd 插件设置中，点击 Template，选择Macro
自定义名称，点击 Add Choice 创建新宏

4. 添加用户脚本

在新建的宏中，点击设置，点击 "User Scripts"
从脚本列表中选择 ACGbangumi.js（单动画导入脚本）
点击脚本旁边的小闪电图标启用快捷键功能

重复步骤3、4为批量导入功能创建宏，选择 BangumiBatchImport.js

5. 添加快捷键或侧边栏图标

添加快捷键：在 Obsidian 快捷键设置中，为 QuickAdd 宏设置快捷键
侧边栏图标：在 QuickAdd 设置中启用侧边栏图标，点击即可运行宏

6. 文件放置

确保 ACGbangumi.js和 BangumiBatchImport.js已放置在 QuickAdd 脚本目录：
将追番周表脚本按需选择（追番周表-并行检测.md、追番周表-本地.md、追番周表-串行检测.md）保存为 Obsidian 笔记文件位置任意
建议将这些追番监控笔记放置在易于访问的位置，如库的根目录或专门的追番文件夹

验证安装

完成以上步骤后，按以下顺序验证：

测试数据导入：
- 在 QuickAdd 中运行单动画导入
- 搜索一个动画名称，确认能正常创建笔记
测试追番监控：
- 打开任意一个追番周表笔记
- 确认能正常显示追番列表
- 检查更新检测功能是否工作
检查错误日志（批量导入版）：
- 查看导入状态和日志文件
- 根据错误信息调整相应配置

📖 使用方法

数据导入流程

单动画导入

运行脚本：在 QuickAdd 中执行单动画导入
搜索动画：输入动画名称（中文/日文）
选择结果：从搜索结果中选择正确的条目
确认信息：检查自动识别的改编类型
设置状态：选择观看状态（在看/想看/已看）
生成笔记：自动创建结构化笔记

批量导入

选择列表：选择要导入的收藏列表类型
确认操作：查看导入前预览信息
自动执行：脚本分页获取所有收藏条目
进度监控：实时查看导入状态和日志
生成报告：导入完成后显示统计信息

追番监控流程

设置监控源：
- 网站监控：在笔记中设置 观看网址字段
- 本地监控：在笔记中设置 下载路径字段
- 更新观看进度：在笔记中设置 已观看集数字段
查看追番列表：
- 打开追番周表
- 系统自动检测更新并排序
- 有更新的番剧自动置顶显示

通过以上完整的安装配置指南，您可以顺利搭建 Bangumi Bridge 系统，开始智能化的动画追番管理体验。

⚡ 性能优化建议

导入优化

合理延迟：根据网络情况调整请求间隔
错误重试：遇到失败条目可选择跳过或重试

监控优化

选择合适版本：
- 番剧数量多 → 并行检测版
- 网络不稳定 → 串行检测版
- 本地观看 → 本地监控版
定期清理：移出已看完的番剧，修改观看状态为已看，减少检测负担

🐛 故障排除

常见问题及解决方案

导入相关问题

Q: 批量导入部分条目失败

✅ 查看详细错误日志
✅ 尝试单独导入失败条目
✅ 检查动画页面是否可正常访问

监控相关问题

Q: 更新检测不准确

✅ 确认观看网址格式正确，确保网址页面能看到所有集数
✅ 检查本地文件夹路径权限
✅ 验证已观看集数字段格式

Q: 检测速度过慢

✅ 切换到并行检测版本
✅ 减少同时监控的番剧数量
✅ 检查网络连接质量

🚀 更新日志

v3.1 版： 2026 年 01 月 11 日发布；

📜 许可证

本项目采用 MIT 许可证 - 查看 LICENSE文件了解详情。

🙏 致谢

感谢北漠海的开源项目 Bangumi-to-obsidian-lite
感谢月涟_luvian 的开源项目 Bangumi-to-obsidian

Bangumi Bridge Obsidian