Obsidian 插件：Hymns

概述

Hymns 是一款专为诗歌爱好者设计的 Obsidian 插件，旨在解决在笔记软件中高效浏览、搜索和播放诗歌的需求。它支持按编号（如 D116）或关键词（如“恩典 耶稣”）进行实时搜索，并能在侧边栏或独立标签页中预览 PDF 歌词、播放 MP3 音频。插件内置收藏与播放列表功能，允许用户管理个人歌单，实现从查找、阅读到聆听的一站式体验，且完全兼容桌面端与移动端。

典型使用场景包括快速定位特定诗歌和沉浸式学习。例如，当你需要查找某首关于“恩典”的诗歌时，只需输入关键词即可从大本诗歌、补充诗歌等多个分类中即时筛选出结果；或者在聚会前，你可以利用内置的“窗口投影”功能，将 PDF 歌词投射到全屏或独立窗口，配合 MP3 播放，方便带领唱诗或自我练习，同时支持左右滑动切换上一首或下一首诗歌。

相比其他通用媒体插件，Hymns 的特色在于其对特定诗歌体系的深度适配与联动能力。它自动识别大本诗歌、儿童诗歌等七大类，并支持 PDF 与 MP3 的同步切换，确保视听一致。此外，插件具备智能索引功能，即使 PDF 文件名仅含编号，也能从正文中提取歌名显示；还支持将诗歌链接或嵌入代码直接复制到笔记中，方便在文档中引用。

使用前需注意，插件本体较小，但配套的 PDF 和 MP3 资源体积较大（约 4 GB），需另行下载并放入仓库，插件启动时会自动扫描建立索引。该插件仅支持特定的诗歌系列，若你使用的是其他宗教诗歌集或非标准命名格式的文件，可能无法被正确识别。此外，它主要服务于诗歌浏览与播放，不适合用于复杂的音频编辑或大规模非诗歌类媒体库管理。