Bible Search and Reader

圣经检索与阅读 (Bible Search and Reader) v3.0.2

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

📖 使用教程（含演示视频）：公众号教程

功能特性

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

---

快速开始

首次安装引导

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

📦 所有圣经数据以内置 JSON 形式存放在插件目录（vault 内 .obsidian/plugins/bible-search-reader/），仓库不会增加额外文件。

数据缺失自动检测

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

跨书卷选中管理

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

版本管理

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

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

---

圣经版本

标准版本映射表

插件支持以下 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）版本

平台支持

• 移动端与桌面端均支持
• 数据文件统一通过 Obsidian 的 Vault Adapter API 读写（vault 内 .obsidian/plugins/bible-search-reader/），桌面端与移动端行为一致

---

Overview

Bible Search and Reader is an Obsidian plugin for searching, reading, and projecting multiple Chinese Bible versions in parallel. It features built-in multi-version data, smart search syntax, side-by-side comparison reading, fullscreen projection modes, inline Bible reference highlighting inside your notes, and a first-run setup wizard.

Installation

Method 1 — Obsidian Community Plugins (recommended):

1. In Obsidian, open Settings → Community plugins → Browse
2. Search for "Bible Search and Reader" and click Install
3. Click Enable to activate the plugin

Method 2 — From GitHub Releases (manual):

1. Download main.js, manifest.json, and styles.css from the latest release
2. Create the folder .obsidian/plugins/bible-search-reader/ in your vault
3. Copy the three files into that folder
4. Enable the plugin in Settings → Community plugins

First-run setup:

1. After enabling, a version selection wizard opens automatically
2. Tick the Bible version(s) you want (multiple allowed), then click "Next"
3. Missing data files are downloaded automatically from GitHub
4. Once done, open the plugin via the 📖 icon in the left ribbon

The plugin works on desktop and mobile. Data files are stored inside the vault at .obsidian/plugins/bible-search-reader/, so no external files are added to your vault.

Usage

• Search: click the 📖 ribbon icon (or run the "Open Bible Search" command). Pick the search type (theme / outline / verse) and range, type a query, and search.
• Search syntax: verse references like 太1:1, 路一1～3, 加1:1-2:5, plus keyword matching. Space/、 = AND, ，/, = ordered AND, ；/; = ordered OR, 。/. = unordered OR.
• Comparison reading: click the "对照" button to enable side-by-side versions. The top version is the primary one; drag to reorder. Each version's verses have independent checkboxes for copying and projection.
• Reader view: switch to the "圣经阅读" tab, pick a book and chapter, then read. Selected verses can be copied or projected.
• Projection: select verses, then choose "逐节 / 并列 / 混合投影". Controls: ←/→/Space to navigate, +/- for font size, T to toggle theme, ESC to exit.
• Reference highlighting: while reading notes, Bible references in the text are automatically highlighted; hover to see the verse, click to jump to the reader view.
• Version management: in plugin settings, enable/disable versions, set the primary version, delete versions, or download new ones.

---

许可证

MIT License

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

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