feat(reader): legado 书源规则引擎 Go 移植 + 阅读 P0 后端

- internal/service/reader/rule/：逐方法移植 legado analyzeRule 包（AnalyzeRule/AnalyzeByJSoup/AnalyzeByJSonPath/AnalyzeByXPath/ AnalyzeByRegex/AnalyzeUrl/RuleAnalyzer），JS 规则留 P2 接入点 - 书源导入（JSON数组/对象/Base64/URL）、多源聚合搜索（legado 四档排序合并）、详情/目录/正文（nextContentUrl 翻页合并） - 数据模型 4 表注册迁移；/api/reader/* 路由组（书源/搜索/书架/进度/调试） - 单测 + httptest 全链路端到端测试 - docs/reader-ui-spec.md：legado UI 交互仿制规格（供 P1 前端使用）
2026-10-03 04:26:36 +08:00 · 2026-09-30 15:41:58 +08:00
parent c84f2604ed
commit b8e6418326
28 changed files with 5736 additions and 14 deletions
@@ -0,0 +1,140 @@
+// Package reader — legado 书源兼容的阅读子系统服务层。
+// 本文件对应 legado data/entities/BookSource.kt 的 JSON 结构。
+package reader
+
+import (
+	"encoding/json"
+	"strings"
+)
+
+// BookSource 书源 JSON 结构（字段与 legado 实体一致，未知字段忽略）。
+type BookSource struct {
+	BookSourceURL     string         `json:"bookSourceUrl"`
+	BookSourceName    string         `json:"bookSourceName"`
+	BookSourceGroup   *string        `json:"bookSourceGroup"`
+	BookSourceType    *int           `json:"bookSourceType"` // 0文本 1音频 2图片 3文件 4视频
+	BookURLPattern    *string        `json:"bookUrlPattern"`
+	CustomOrder       *int           `json:"customOrder"`
+	Enabled           *bool          `json:"enabled"`
+	EnabledExplore    *bool          `json:"enabledExplore"`
+	EnabledCookieJar  *bool          `json:"enabledCookieJar"`
+	ConcurrentRate    *string        `json:"concurrentRate"`
+	Header            *string        `json:"header"`
+	LoginURL          *string        `json:"loginUrl"`
+	BookSourceComment *string        `json:"bookSourceComment"`
+	LastUpdateTime    *int64         `json:"lastUpdateTime"`
+	RespondTime       *int64         `json:"respondTime"`
+	Weight            *int           `json:"weight"`
+	ExploreURL        *string        `json:"exploreUrl"`
+	SearchURL         *string        `json:"searchUrl"`
+	RuleExplore       *ExploreRule   `json:"ruleExplore"`
+	RuleSearch        *SearchRule    `json:"ruleSearch"`
+	RuleBookInfo      *BookInfoRule  `json:"ruleBookInfo"`
+	RuleToc           *TocRule       `json:"ruleToc"`
+	RuleContent       *ContentRule   `json:"ruleContent"`
+	VariableComment   *string        `json:"variableComment"`
+	Variables         map[string]any `json:"-"`
+	RawVariables      *string        `json:"variables"`
+}
+
+// SearchRule 搜索规则。
+type SearchRule struct {
+	CheckKeyWord *string `json:"checkKeyWord"`
+	BookList     *string `json:"bookList"`
+	Name         *string `json:"name"`
+	Author       *string `json:"author"`
+	Kind         *string `json:"kind"`
+	WordCount    *string `json:"wordCount"`
+	LastChapter  *string `json:"lastChapter"`
+	Intro        *string `json:"intro"`
+	CoverURL     *string `json:"coverUrl"`
+	BookURL      *string `json:"bookUrl"`
+}
+
+// BookInfoRule 详情规则。
+type BookInfoRule struct {
+	Init         *string `json:"init"`
+	Name         *string `json:"name"`
+	Author       *string `json:"author"`
+	Kind         *string `json:"kind"`
+	WordCount    *string `json:"wordCount"`
+	LastChapter  *string `json:"lastChapter"`
+	Intro        *string `json:"intro"`
+	CoverURL     *string `json:"coverUrl"`
+	TocURL       *string `json:"tocUrl"`
+	CanReName    *string `json:"canReName"`
+	DownloadUrls *string `json:"downloadUrls"`
+}
+
+// TocRule 目录规则。
+type TocRule struct {
+	PreUpdateJs *string `json:"preUpdateJs"`
+	ChapterList *string `json:"chapterList"`
+	ChapterName *string `json:"chapterName"`
+	ChapterURL  *string `json:"chapterUrl"`
+	IsVolume    *string `json:"isVolume"`
+	UpdateTime  *string `json:"updateTime"`
+}
+
+// ContentRule 正文规则。
+type ContentRule struct {
+	Content        *string `json:"content"`
+	NextContentURL *string `json:"nextContentUrl"`
+	WebJs          *string `json:"webJs"`
+	SourceRegex    *string `json:"sourceRegex"`
+	ReplaceRegex   *string `json:"replaceRegex"`
+	ImageStyle     *string `json:"imageStyle"`
+	PayAction      *string `json:"payAction"`
+}
+
+// ExploreRule 发现规则。
+type ExploreRule struct {
+	BookList      *string `json:"bookList"`
+	Name          *string `json:"name"`
+	Author        *string `json:"author"`
+	Kind          *string `json:"kind"`
+	WordCount     *string `json:"wordCount"`
+	LastChapter   *string `json:"lastChapter"`
+	Intro         *string `json:"intro"`
+	CoverURL      *string `json:"coverUrl"`
+	BookURL       *string `json:"bookUrl"`
+	ExploreURL    *string `json:"exploreUrl"`
+	ExploreKinds  *string `json:"exploreKinds"`
+	CheckKeyWord  *string `json:"checkKeyWord"`
+}
+
+// ParseBookSource 将书源 JSON 解析为结构体。
+func ParseBookSource(raw string) (*BookSource, error) {
+	var bs BookSource
+	if err := json.Unmarshal([]byte(raw), &bs); err != nil {
+		return nil, err
+	}
+	if bs.RawVariables != nil && strings.TrimSpace(*bs.RawVariables) != "" {
+		_ = json.Unmarshal([]byte(*bs.RawVariables), &bs.Variables)
+	}
+	return &bs, nil
+}
+
+// Type 返回书源类型（默认文本）。
+func (b *BookSource) Type() int {
+	if b.BookSourceType == nil {
+		return 0
+	}
+	return *b.BookSourceType
+}
+
+// SPtr 取字符串指针字段值。
+func SPtr(s *string) string {
+	if s == nil {
+		return ""
+	}
+	return *s
+}
+
+// IPtr 取整型指针字段值。
+func IPtr(i *int) int {
+	if i == nil {
+		return 0
+	}
+	return *i
+}