收藏与状态同步
比较本地与 Bangumi 的评分、标签、短评、收藏状态和章节进度，按字段选择同步方向。
支持全面同步与增量同步 OPEN SOURCE · OBSIDIAN PLUGIN v6.15.1
喜欢的作品，
值得好好收藏。
让 Bangumi 与 Obsidian 连接起来。把收藏、评分、短评与观看进度，整理为可编辑、可检索、真正存放在自己手中的 Markdown 笔记。
本地 Markdown
可审阅的同步
自由模板
记录不再散落收藏与笔记，归于一处
⇄Bangumi × Obsidian你的作品，你的知识库
为每一种热爱而设计
✿ 动画▤ 漫画与书籍◈ 游戏♫ 音乐▣ 影视
WHAT IT DOES
不只是同步。
让收藏成为自己的资料库。
既能轻松导入第一批收藏，也能长期管理不断增长的作品笔记。
本地笔记，自由编辑
收藏落地为普通 Markdown 文件。Frontmatter、正文和自定义属性都可以按自己的习惯整理。
与 Obsidian 工作流衔接统一的模板系统
作品分类树、内容模板与路径规则分别继承，支持内置预设、Markdown 文件和自定义内容。
可预览、导入、备份模板集中管理收藏
使用控制面板筛选、搜索、快速打开条目，或在确认后进行批量编辑与封面管理。
搜索添加与批量处理逐集记录进度
在笔记中查看章节列表与标记状态，追踪动画、漫画及相关作品的观看或阅读进度。
保留未选择的章节记录重视本地文件安全
写入前检查数据变化，遇到异常时提供本地事务恢复机制，尽可能避免意外覆盖。
Recovery Center · 明确的恢复流程A SIMPLE WORKFLOW
从喜欢，到珍藏。
只需几步。
无需放弃原来的 Bangumi 习惯，让 Obsidian 成为长期积累的地方。
连接 Bangumi
在插件设置中填写个人 Access Token。
选择要同步的作品
按作品类型、收藏状态筛选，在执行前审阅条目与差异。
生成本地笔记
根据有效模板输出 Frontmatter、正文和文件路径。
继续记录生活
自由编辑、补充想法，之后按需同步状态与进度。
BUILT AROUND YOU
你的笔记，
当然由你定义。
同一棵作品分类树，统一管理内容和文件路径；小说、漫画、动画都能有自己的规则。需要特殊设计时，也可以直接引用你写好的 Markdown 模板。
- 内容模板与路径规则独立继承
- 切换来源保留自定义草稿
- 支持只读预览与模板包备份
- 路径变更不自动移动现有笔记
book / comic / template.mdMARKDOWN
01 ---
02 中文名: "{{name_cn}}"
03 作品分类: "{{category}}"
04 个人评分: {{my_rate}}
05 阅读状态: "{{my_status}}"
06 ---
07
08 # {{name_cn}}
09 ## 阅读记录
10 {{#if episodes}}
11 {{episodes}}
12 {{/if}}
13 ## 感想
输出路径 · 自由配置
ACGN/漫画/作品名称.mdLOCALSEE IT IN ACTION
看看它实际工作的样子。
以下来自项目仓库中的真实截图。点击图片可放大查看。
提示：部分仓库截图可能来自较早的界面版本；当前功能以最新发布说明和文档为准。
DESIGNED WITH CARE
收藏很重要。
你写下的文字更重要。
保留原生 Markdown，区分同步方向；写入时检查预览与文件变化。本地事务发生异常时，可以通过 Recovery Center 查看和处理恢复操作。
透明的边界：Bangumi 云端与本地文件不是一个原子事务。部分成功时，请根据结果页检查已发生的云端更新。
了解恢复机制GET STARTED
让收藏进入 Obsidian。
安装并启用插件，几分钟内完成基本配置。
推荐
通过 GitHub Release 安装
- 下载文件从同一版本的 Release 下载
main.js、manifest.json和styles.css。 - 放入插件目录将三个文件放到 Vault 中的以下目录。
.obsidian/plugins/bangumi-sync/ - 启用插件进入 Obsidian「设置 → 社区插件」，启用 Bangumi Sync。
- 连接 Bangumi获取并填入 Access Token，选择同步方式，即可开始使用。
我的收藏会存在哪里？
插件将条目保存为 Obsidian Vault 内的普通 Markdown 文件。你可以用 Obsidian 或其他文本编辑器继续整理，不依赖专有数据库才能读取正文。
需要安装 Dataview 吗？
默认模板包含 Dataview 内联查询。建议安装并启用 Dataview 以正确显示这些动态字段；即使未安装，Markdown 源文件仍然存在。
修改模板会自动更名或覆盖旧笔记吗？
不会因为修改模板就自动迁移已有文件。路径变化请使用插件提供的诊断与路径迁移预览；同步时仍以 Bangumi Subject ID 识别条目。
可以从 Obsidian 同步回 Bangumi 吗？
可以针对评分、短评、标签、收藏状态及章节进度等支持的字段选择同步方向。插件会在执行前复核相关数据；云端与本地跨系统更新不能保证完全原子化。
这个插件免费且开源吗？
是的。项目以 MIT 许可证开源，源码、版本说明、问题反馈和安装文件均可在 GitHub 查看。
KEEP WHAT YOU LOVE
你的热爱，
值得长久保存。
开始将 Bangumi 收藏整理成属于自己的 Obsidian 笔记。