开源阅读工具MyBookshelf自定义书源配置全指南

在数字阅读时代，获取网络文学内容的方式多种多样，但找到一个完全符合个人阅读习惯的工具却并不容易。MyBookshelf作为一款开源阅读工具，通过自定义书源功能解决了这一痛点。本文将从实际问题出发，提供完整的解决方案和实践指南，帮助你掌握书源规则编写技巧，轻松实现网络文学获取自由。

如何解决网络文学阅读的个性化需求？

当你在不同平台阅读网络小说时，是否遇到过章节格式混乱、内容排版不统一的问题？MyBookshelf的自定义书源功能正是为解决这类问题而生。这款工具Fork于MONKOVEL项目，目前已使用Kotlin重写并迁移至新仓库，你可以通过以下命令获取项目源码：

git clone https://gitcode.com/gh_mirrors/my/MyBookshelf

MyBookshelf的核心优势在于允许用户根据不同网站的内容格式，自定义解析规则，从而获得统一、舒适的阅读体验。

自定义书源方案：从规则格式到文件位置

书源规则基础概念

书源相关配置文件位于项目的app/src/main/assets/目录下，其中最重要的是txtChapterRule.json文件。这个JSON文件包含了所有用于解析网络小说章节的规则，每个规则对象包含四个关键字段：

字段名	描述
enable	布尔值，控制该规则是否启用
name	字符串，规则的名称，便于识别
rule	字符串，正则表达式，用于匹配章节内容
serialNumber	数字，规则的执行顺序编号

如何快速上手自定义书源？

步骤1：定位书源配置文件

首先找到txtChapterRule.json文件，路径为：app/src/main/assets/txtChapterRule.json。这个文件是所有章节解析规则的集合地。

步骤2：理解默认规则结构

打开文件后，你会看到一系列JSON对象组成的数组。以下是一个基础的规则示例：

{
    "enable": true,
    "name": "数字 分隔符 标题名称",
    "rule": "^[ 　\\t]{0,4}\\d{1,5}[\\,\\.， 、\\-].{1,30}$",
    "serialNumber": 5
}

这个规则用于匹配以数字开头，后跟分隔符和标题的章节格式，如"1. 第一章 初识"或"2- 第二章 启程"。

步骤3：启用和测试规则

你可以通过修改enable字段的值来启用或禁用特定规则。建议先在测试环境中验证新规则的效果，再应用到正式环境。

书源规则高级技巧：打造专属解析方案

目录规则深度解析

目录规则是解析小说结构的基础，以下是一个功能全面的目录规则示例：

{
    "enable": true,
    "name": "目录",
    "rule": "^[ 　\\t]{0,4}(?:(?:内容|文章)?简介|文案|前言|序章|楔子|正文(?!完|结)|终章|后记|尾声|番外|第?\\s{0,4}[\\d零一二两三四五六七八九十百千万壹贰叁肆伍陆柒捌玖拾佰仟]+?\\s{0,4}(?:章|节(?!课)|卷|集(?![合和])|部(?!分)|篇(?!张))).{0,30}$",
    "serialNumber": 0
}

这个规则能够匹配多种常见的章节标题格式，包括：

• 数字章节："第1章 开始"、"第二章 发展"
• 特殊章节："序章"、"楔子"、"后记"
• 中文数字："第一百章 高潮"、"第三卷 新的开始"

正文识别高级配置

为了准确区分正文和其他内容，你可以添加专门的正文识别规则：

{
    "enable": true,
    "name": "正文 标题/序号",
    "rule": "^[ 　\\t]{0,4}正文[ 　]{1,4}.{0,20}$",
    "serialNumber": 6
}

这个规则有助于识别以"正文"开头的特殊章节，确保内容解析的准确性。

自定义书源界面操作指南

MyBookshelf提供了直观的用户界面，让你可以轻松管理和应用自定义书源。以下是主要界面的操作流程：

阅读界面自定义

阅读界面支持多种个性化设置，包括字体大小、行间距和背景颜色等。你可以在设置中切换不同的阅读背景，提升阅读体验。

图：MyBookshelf提供的护眼漫绿阅读背景，适合长时间阅读

设置界面操作流程

1. 打开应用主界面
2. 点击右上角菜单按钮
3. 选择"设置"选项
4. 在设置界面中找到"书源管理"
5. 选择"自定义书源规则"
6. 编辑并保存你的规则

常见问题与解决方案

Q1：修改规则后没有生效怎么办？

A1：首先检查serialNumber是否正确，规则是按序号顺序执行的。其次确认enable字段是否设为true。如果问题仍然存在，可以尝试重启应用。

Q2：如何编写复杂的正则表达式规则？

A2：建议先学习基础的正则表达式语法，然后使用在线正则测试工具验证你的规则。从简单规则开始，逐步添加复杂条件。

Q3：可以导入其他人编写的书源规则吗？

A3：可以。你可以将他人分享的txtChapterRule.json文件替换到app/src/main/assets/目录下，或者在应用的书源管理界面导入规则文件。

注意事项

⚠️ MyBookshelf是开源软件，不要在任何地方购买。

⚠️ 本工具仅提供内容搜索功能，不存储任何网络文学内容，内容合法性由内容提供商负责。

⚠️ 建议通过正规渠道阅读正版图书，支持作者创作。

通过本文介绍的方法，你已经掌握了MyBookshelf自定义书源的核心技巧。现在，你可以根据自己的阅读习惯，创建专属的书源规则，享受更加个性化的阅读体验。如果你有好的书源规则，不妨分享给其他读者，共同丰富这个开源阅读社区。