Bible Search and Reader

Obsidian 插件，用于多版本圣经数据的检索、阅读与投影。支持内置多版本对照、智能检索语法和投影模式。

功能特性

• 多版本圣经支持：同时加载多个圣经版本，支持恢复本、新标点和合本及自定义版本
• 多版本对照阅读：检索和阅读时可选开启对照模式，在主版本经文下方显示其他版本
• 版本选择引导：首次安装或数据缺失时自动弹出引导窗口，帮助用户选择并下载所需的圣经版本
• 版本管理设置：全新的版本管理界面，支持启用/禁用版本、设置主版本、删除版本、下载新版本
• 圣经搜索：支持主题、纲目、经文三种检索类型；可按全部圣经或自定义书卷范围搜索
• 智能检索语法：支持经文出处（太1:1、路一1～3）、关键词（多词组合匹配）、以及混合检索
• 阅读模式：书卷/章节网格浏览，快速跳转，字体调节，主题与纲目同屏显示
• 投影模式：选中内容后可逐节、并列或混合投影，支持键盘/滚轮/触屏操作
• 自动更新：支持启动时自动检测新版本，一键下载并安装更新

快速开始

首次安装引导

1. 安装插件：从 Obsidian 社区插件市场搜索 "Bible Search and Reader" 安装启用
2. 版本选择引导：启用后自动弹出引导窗口，显示已安装的版本和可下载的版本
3. 选择版本：勾选需要的圣经版本（可多选），点击「下一步」
4. 自动下载：若选择的版本本地不存在，插件自动从 GitHub 下载对应数据文件
5. 开箱即用：下载完成后直接点击左侧 📖 图标开始使用

📦 所有圣经数据以内置 JSON 形式存放在插件目录，仓库不会增加额外文件。

数据缺失自动检测

插件每次启动时都会真实扫描插件目录下的圣经数据文件。如果数据文件被删除或从未下载，会自动弹出版本选择引导窗口，确保始终至少有一个可用的圣经版本。

跨书卷选中管理

阅读视图中，选中内容仅在当前书卷内有效。切换书卷时会自动过滤掉旧书卷的选中项，避免计数跨书卷累加。同一书卷内跨章节选中不受影响，方便投影连续章节内容。

版本管理

在插件设置中可管理已安装的版本：

• 启用/禁用：控制哪些版本可用
• 设置主版本：选择检索和阅读时的默认版本
• 删除版本：移除不再需要的版本数据
• 下载新版本：从列表中选择并下载新的圣经版本

圣经版本

标准版本映射表

插件支持以下 14 个标准中文圣经版本：

💡 默认提供版本：恢复本 (CRV) 和新标点和合本 (CUVS) 在 Release 中默认提供。

自定义版本命名规则

使用其他中文圣经版本时，请按以下规则准备数据文件：

1. 文件命名：bible-{缩写}-data.json
   • 示例：bible-cuvs-data.json、bible-crv-data.json
   • 缩写建议：使用 3-6 个字母的小写英文缩写
2. 数据格式：JSON 数组，每条记录包含以下字段：

   {
     "bookId": 1,
     "chapter": 1,
     "verse": 1,
     "type": "verse",
     "content": "起初神创造天地。",
     "testament": "OT",
     "bookShortName": "创",
     "bookFullName": "创世记",
     "lineIndex": 0
   }
   

3. 放置位置：将文件放到插件目录（.obsidian/plugins/bible-search-reader/）下
4. 自动识别：插件启动时会自动识别该版本，在设置中可启用并设为主版本

数据文件命名规范

使用指南

搜索

1. 点击左侧边栏 📖 图标或运行命令「打开圣经检索」
2. 点击「对照」按钮，在侧边栏勾选要使用的圣经版本（可多选）
3. 勾选多个版本时，最上方的版本为主版本，其余为对照版本，可拖动调整顺序
4. 选择检索种类（主题/纲目/经文）和范围，输入内容后点击「🔍 查询」
5. 开启多版本对照后，搜索结果下方会显示其他版本的对照经文
6. 点击结果卡片选中（可排序、标记并列），对照版本也有独立的候选框可选中
7. 点击「逐节/并列/混合投影」进行投影

阅读

1. 切换到「圣经阅读」选项卡
2. 点击书卷简称 → 章节编号 → 阅读内容
3. 开启多版本对照后，每节经文下方会显示其他版本对照
4. 点击卡片或对照版本的候选框选中内容，可进行复制或投影

对照设置说明

• 全局对照面板：点击「对照」按钮打开，同时影响圣经检索和圣经阅读视图
• 版本排序：拖动调整版本顺序，最上方为显示优先级最高的主版本
• 独立操作：对照版本的经文拥有独立的候选框，可独立选中用于复制和投影
• 简洁显示：对照经文不再显示版本全名，直接显示经文内容，复制/投影时自动补上版本简称和出处
• 投影支持：逐节、并列、混合投影均支持同时显示多个版本，对照版本自动弱化显示

全局操作与本页操作

全局操作（作用于整个书卷或所有已选中内容）：

• 全局全选：按顺序选中当前书卷所有章节的主版本内容（含主题）
• 全局取消：取消所有已选中的内容（跨所有章节）
• 全局复制：复制所有已选中的内容
• 逐节/并列/混合投影：投影所有已选中的内容

本页操作（仅作用于当前章节）：

• 本页全选：选中当前章的主版本内容（第一章额外包含主题）
• 本页复制：仅复制当前章已选中的内容
• 复制经文：复制当前章主版本的全部经文
• 复制纲目：复制当前章主版本的纲目

投影操作

• ←/→ 或 空格：翻页
• +/-：调整字体大小
• T：切换深色/浅色主题
• ESC：退出投影

检索语法速查

经文出处

关键词匹配

分隔符决定匹配行为：

更新

插件支持自动检测更新：

• 自动检测：设置 → 自动检测更新（默认开启），启动时自动检查新版本
• 手动检查：设置 → 立即检查更新
• 一键更新：检测到新版本后，点击「立即更新」即可自动下载并安装

兼容性说明

数据源模式

• 2.1.0 起仅支持内置数据模式，移除了外置数据模式，简化架构
• 旧版本数据自动迁移：自动检测旧版 bible-data.json 并迁移为恢复本（CRV）版本

平台支持

• 移动端与桌面端均支持
• 自动下载功能在桌面端更稳定

许可证

MIT License

☕ 如果觉得这款插件对您有帮助，也可以支持我的项目

加6:10 所以我们有了时机，就当向众人行善，尤其是向信仰之家的人。