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

MyBookshelf是一款开源阅读工具，支持通过自定义书源获取网络文学内容。本指南将聚焦"自定义书源配置"核心功能，帮助你掌握规则定义、文件路径与界面操作，打造个性化阅读体验。

一、功能总览：自定义书源核心价值

1.1 什么是自定义书源？

自定义书源是MyBookshelf的核心功能，通过配置规则文件，让应用能够解析不同网站的小说内容结构，实现跨平台阅读体验。

1.2 为什么需要配置书源？

• 📚 解决单一平台资源限制
• 🛠️ 适配不同网站的内容格式
• 🎨 个性化阅读规则

二、配置基础：书源文件定位与结构

2.1 三步定位书源文件

1. 项目根目录下进入app/src/main/assets/
2. 找到并打开txtChapterRule.json文件
3. 该文件包含所有章节解析规则

2.2 书源规则文件结构

每个规则对象包含四个核心字段：

{
  "enable": true,          // 是否启用规则
  "name": "目录",           // 规则名称
  "rule": "^[ 　\\t]{0,4}...", // 正则表达式规则
  "serialNumber": 0        // 规则优先级序号
}

三、界面导览：配置入口与阅读体验

3.1 访问书源设置界面

通过主界面→设置→书源管理，进入规则配置界面。在这里可以启用/禁用现有规则，调整规则优先级。

3.2 阅读界面背景设置

应用提供多种背景主题选择，位于app/src/main/assets/bg/目录，如：

护眼漫绿背景：适合长时间阅读，减轻视觉疲劳

宁静夜色背景：低亮度环境下的理想选择

四、规则详解：从基础到高级配置

4.1 核心规则字段解析

• enable：布尔值，控制规则开关
• name：规则标识名称，建议清晰描述规则用途
• rule：正则表达式，决定内容解析方式
• serialNumber：数字越小，优先级越高

4.2 常用规则示例与应用场景

基础目录规则

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

功能：匹配各类章节标题，支持中文数字和多种章节单位

数字分隔符规则

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

功能：匹配"1. 第一章"这类带数字和分隔符的标题格式

4.3 正则规则编写指南

1. 基础语法：使用^和$限定行首行尾
2. 字符集：用[ 　\\t]匹配各类空白字符
3. 分组：使用(?:...)创建非捕获组
4. 限定符：{0,4}控制匹配长度范围
5. 前瞻断言：(?!完|结)排除特定关键词

五、使用规范：合法与安全指南

5.1 免责声明

MyBookshelf仅提供内容搜索工具，第三方网站返回的内容与本工具无关。使用时请遵守各网站的使用条款及当地法律法规。

5.2 正版阅读倡议

本工具旨在帮助用户发现优质内容，建议通过正规渠道支持正版图书，尊重版权方权益。

六、常见问题：配置与使用解答

6.1 Q: 为什么添加新规则后不生效？

A: 可能原因：

1. 未启用规则（enable设为true）
2. 规则优先级（serialNumber）设置不当
3. 正则表达式存在语法错误
4. 需重启应用使配置生效

6.2 Q: 如何调试自定义规则？

A: 通过"书源调试"功能（位于设置-高级选项），可以实时查看规则匹配效果，逐步优化正则表达式。

6.3 Q: 规则文件损坏怎么办？

A: 可以从项目仓库重新获取原始配置文件：

git clone https://gitcode.com/gh_mirrors/my/MyBookshelf
cp MyBookshelf/app/src/main/assets/txtChapterRule.json 你的项目路径

6.4 Q: 如何分享自定义规则？

A: 导出txtChapterRule.json文件，通过应用内"导入书源"功能分享给其他用户。

6.5 Q: 哪些网站格式需要特殊规则？

A: 论坛类、动态加载内容或采用特殊排版的网站可能需要定制规则，建议参考已有规则修改，或在社区寻求帮助。