# 源示例 (Source Examples)

[[toc]]

本文档提供三种典型源的完整 JSON 示例，分别演示 CSS+正则、XPath+正则、JSONPath 的用法。

## 1. CSS + 正则

使用 JSOUP CSS 选择器和正则表达式的源示例。

```json
{
    "bookSourceComment": "",
    "bookSourceGroup": "CSS; 正则",
    "bookSourceName": "示例源",
    "bookSourceType": 0,
    "bookSourceUrl": "https://www.example.com",
    "bookUrlPattern": "",
    "customOrder": 0,
    "enabled": true,
    "enabledExplore": false,
    "exploreUrl": "",
    "lastUpdateTime": 0,
    "loginUrl": "",
    "ruleBookInfo": {
        "author": "##:author\"[^\"]+\"([^\"]*)##$1###",
        "coverUrl": "##og:image\"[^\"]+\"([^\"]*)##$1###",
        "intro": "##:description\"[^\"]+\"([\\w\\W]*?)\"/##$1###",
        "kind": "##:category\"[^\"]+\"([^\"]*)##$1###",
        "lastChapter": "##_chapter_name\"[^\"]+\"([^\"]*)##$1###",
        "name": "##:book_name\"[^\"]+\"([^\"]*)##$1###",
        "tocUrl": ""
    },
    "ruleContent": {
        "content": "@css:.chapter-content p@textNodes##广告文字|本站声明.*|<!\\[CDATA\\[|\\]\\]>",
        "nextContentUrl": ""
    },
    "ruleExplore": {},
    "ruleSearch": {
        "author": "@css:p:eq(2)>a@text",
        "bookList": "@css:li.clearfix",
        "bookUrl": "@css:.name>a@href",
        "coverUrl": "@css:img@src",
        "intro": "@css:.note.clearfix p@text",
        "kind": "@css:.note_text,p:eq(4)@text",
        "lastChapter": "@css:p:eq(3)@text",
        "name": "@css:.name@text"
    },
    "ruleToc": {
        "chapterList": "-:<li><a[^\"]+\"([^\"]*)\">([^<]*)",
        "chapterName": "$2",
        "chapterUrl": "$1",
        "nextTocUrl": ""
    },
    "searchUrl": "/search?q={{key}}&page={{page}}",
    "weight": 0
}
```

**要点：**

- 详情页规则使用 OnlyOne 正则（`##...###`）从 meta 标签提取信息
- 正文规则使用 CSS 选择器取文本节点，后接净化正则移除广告
- 目录规则使用 AllInOne 正则（`:` 开头），`-` 前缀使列表倒序

## 2. XPath + 正则

使用 XPath 和正则表达式的源示例。

```json
{
    "bookSourceComment": "",
    "bookSourceGroup": "XPath; 正则",
    "bookSourceName": "示例移动源",
    "bookSourceType": 0,
    "bookSourceUrl": "https://m.example.com",
    "bookUrlPattern": "",
    "customOrder": 0,
    "enabled": true,
    "enabledExplore": false,
    "exploreUrl": "",
    "lastUpdateTime": 0,
    "loginUrl": "",
    "ruleBookInfo": {
        "author": "//*[@property=\"og:novel:author\"]/@content",
        "coverUrl": "//*[@property=\"og:image\"]/@content",
        "intro": "//*[@property=\"og:description\"]/@content",
        "kind": "//*[@property=\"og:novel:category\"]/@content",
        "lastChapter": "//*[@id=\"latest-chapter\"]//li[1]/a/text()",
        "name": "//*[@property=\"og:novel:book_name\"]/@content",
        "tocUrl": "//a[text()=\"阅读\"]/@href"
    },
    "ruleContent": {
        "content": "//*[@id=\"content\"]",
        "nextContentUrl": ""
    },
    "ruleExplore": {},
    "ruleSearch": {
        "author": "//dd[2]/text()",
        "bookList": "//*[@id=\"search-result\"]/dl",
        "bookUrl": "//dt/a/@href",
        "coverUrl": "//img/@src",
        "kind": "//dd[2]/span/text()",
        "lastChapter": "",
        "name": "//h3/a/text()"
    },
    "ruleToc": {
        "chapterList": ":href=\"(/read[^\"]*html)\">([^<]*)",
        "chapterName": "$2",
        "chapterUrl": "$1",
        "nextTocUrl": "//*[@id=\"chapter-list\"]/*[position()>1]/@value"
    },
    "searchUrl": "/search,{\n  \"method\": \"POST\",\n  \"body\": \"q={{key}}\"\n}",
    "weight": 0
}
```

**要点：**

- 详情页使用 XPath 从 `og:novel` meta 标签提取信息
- 目录使用 AllInOne 正则提取链接和标题
- 目录下一页使用 XPath 的 `position()` 谓语条件
- 搜索使用 POST 方法

## 3. JSONPath

使用 JSON API 的源示例。

```json
{
    "bookSourceComment": "",
    "bookSourceGroup": "JSON",
    "bookSourceName": "示例 API 源",
    "bookSourceType": 0,
    "bookSourceUrl": "http://api.example.com",
    "customOrder": 0,
    "enabled": true,
    "enabledExplore": false,
    "header": "{\n  \"User-Agent\": \"Mozilla/5.0\"\n}",
    "lastUpdateTime": 0,
    "ruleBookInfo": {},
    "ruleContent": {
        "content": "$.chapter.body"
    },
    "ruleExplore": {},
    "ruleSearch": {
        "author": "$.author",
        "bookList": "$..books[*]",
        "bookUrl": "/book/detail?id={$._id}",
        "coverUrl": "$.cover",
        "intro": "$.shortIntro",
        "kind": "$.minorCate",
        "lastChapter": "$.lastChapter",
        "name": "$.title"
    },
    "ruleToc": {
        "chapterList": "$.chapterInfo.chapters.[*]",
        "chapterName": "$.title",
        "chapterUrl": "$.link"
    },
    "searchUrl": "/book/search?query={{key}}&start={{(page-1)*20}}&limit=20",
    "weight": 0
}
```

**要点：**

- 详情页为空（`ruleBookInfo: {}`），直接从搜索结果获取信息
- 目录 URL 使用 JSONPath 表达式 `{$._id}` 拼接
- 书列表使用递归查找 `$..books[*]`
- 搜索 URL 使用 `{{(page-1)*20}}` 计算偏移量

## 4. 调试技巧

### JS 错误处理

使用 try-catch 包裹 JS 逻辑，方便调试：

```javascript
(function(result){
    try{
        // 处理 result
        return result;
    }
    catch(e){
        return "" + e;  // 返回错误信息
    }
})(result);
```

### 调试入口

| 调试项 | 输入示例                                              |
|:----|:--------------------------------------------------|
| 搜索  | `系统`                                              |
| 发现  | `排行榜::https://www.example.com/rank?page={{page}}` |
| 详情页 | `https://www.example.com/book/12345`              |
| 目录页 | `++https://www.example.com/read/12345`            |
| 正文页 | `--https://www.example.com/chapter/12345/67890`   |

详细调试方法参见 [源调试](./debug)。