Internet Archive BookReader v5.0.0-92 版本发布：搜索插件架构重构解析

Internet Archive BookReader 是一个开源的在线电子书阅读器解决方案，它提供了丰富的功能来展示和阅读数字化书籍。该项目由 Internet Archive 维护，广泛应用于各类数字图书馆和电子书阅读平台。

本次发布的 v5.0.0-92 版本主要对搜索功能进行了重大重构，将原有的搜索实现迁移到了新的 BookReaderPlugin 系统。这一变化不仅带来了架构上的改进，也为开发者提供了更灵活的自定义选项。

搜索插件架构重构

本次重构的核心是将搜索功能从核心代码中解耦，使其成为一个独立的插件。这种模块化的设计带来了几个显著优势：

1. 代码组织更清晰：搜索相关逻辑现在集中在 SearchPlugin 类中，不再分散在核心代码各处
2. 维护性提升：插件系统提供了标准化的接口，便于未来扩展和维护
3. 自定义能力增强：开发者现在可以通过配置更精细地控制搜索行为

配置变更详解

重构后，搜索相关的配置选项都移动到了 options.plugins.search 命名空间下。以下是主要变更点：

搜索标记配置

原先的 searchInsidePreTag 和 searchInsidePostTag 现在简化为 preTag 和 postTag，位于插件配置中。这些标记用于高亮显示搜索结果。

搜索端点URL重构

searchInsideUrl 现在支持更强大的字符串模板功能（StringWithVars），开发者可以动态构建搜索URL。新特性包括：

• 支持从根选项中引用变量（如 {{server}}）
• 自动URL编码功能（{{query|urlencode}}）
• 可以访问 preTag 和 postTag 配置
• 不再局限于Internet Archive特定的逻辑

初始搜索词配置

initialSearchTerm 现在也移到了插件配置中，保持配置结构的一致性。

废弃项说明

searchInsideProtocol 配置项已被弃用，推荐使用新的URL模板变量功能替代。

API变更与兼容性

本次重构对API进行了整理，大部分搜索相关的方法和属性现在都位于 SearchPlugin 实例中。值得注意的是：

• br.search 仍然保留作为快捷访问方式
• 原有的搜索相关属性和方法（如 searchResults, searchXHR 等）都已迁移到插件内部
• 搜索高亮相关方法（updateSearchHilites, removeSearchResults 等）也移到了插件中

这种变更虽然带来了一些破坏性变化，但为未来的功能扩展奠定了更好的基础。

升级建议

对于正在使用BookReader的项目，升级到本版本时需要注意：

1. 检查所有搜索相关的配置，按照新的结构进行调整
2. 如果直接调用了搜索相关API，需要更新调用路径
3. 利用新的URL模板功能简化搜索端点的配置
4. 测试搜索高亮功能，确保 preTag 和 postTag 配置正确

总结

v5.0.0-92 版本通过对搜索功能的插件化重构，显著提升了BookReader的架构质量。虽然带来了一些破坏性变更，但这些改进为开发者提供了更强大、更灵活的自定义能力，同时也为未来的功能扩展铺平了道路。建议所有使用搜索功能的项目规划升级，以利用这些改进带来的好处。