当前位置：首页 > news >正文

EhViewer搜索功能深度解析：从基础查询到高级筛选的完整指南

news 2026/6/13 15:15:09

EhViewer搜索功能深度解析：从基础查询到高级筛选的完整指南

【免费下载链接】EhViewerEhViewer overhauled with Material Design 3 and more, forked from https://github.com/Ehviewer-Overhauled/Ehviewer项目地址: https://gitcode.com/gh_mirrors/ehvie/EhViewer

EhViewer作为一款基于Material Design 3设计的开源漫画阅读器，其搜索系统提供了远超基础查询的精细控制能力。本文将深入探讨如何充分利用EhViewer的搜索功能，从简单的关键词搜索到复杂的标签过滤，帮助您构建精准的内容发现工作流。

场景化搜索策略：不同需求下的最佳实践

1. 快速发现新内容：分类筛选与趋势浏览

当您希望探索新内容但没有明确目标时，EhViewer的分类系统是您的第一选择。系统内置了10种主要漫画类型，包括同人志、漫画、艺术家CG、游戏CG等，这些分类在SearchFilter.kt中通过categoryTable数组定义：

private val categoryTable = arrayOf( EhUtils.DOUJINSHI to R.string.doujinshi, EhUtils.MANGA to R.string.manga, EhUtils.ARTIST_CG to R.string.artist_cg, // ... 其他分类 )

实用技巧：您可以同时选择多个分类进行组合搜索。例如，同时选择"漫画"和"游戏CG"可以找到游戏改编的漫画作品。这种多选功能通过位运算实现，允许您构建复杂的分类组合。

2. 精确内容定位：高级搜索选项的实战应用

当您有明确的内容需求时，高级搜索选项将成为您的得力助手。EhViewer提供了以下关键过滤维度：

语言筛选：系统支持多种语言标签，包括日语、英语、中文等。语言筛选不仅基于原始标签，还支持通过EhTagDatabase进行本地化翻译显示，确保非英语用户也能准确理解。

评分过滤：您可以设置1-5星的最低评分门槛。这个功能特别适合筛选高质量内容，避免在低质量作品上浪费时间。

页数范围控制：通过fromPage和toPage参数，您可以精确控制作品的页数范围。这个功能支持三种模式：

"至少X页"：筛选长篇作品
"至多Y页"：寻找短篇内容
"X-Y页"：精确的页数区间

特殊过滤条件：

AdvanceTable.SH：仅显示有封面的作品
AdvanceTable.STO：仅显示翻译作品
过滤器禁用选项：临时绕过特定过滤规则

低多边形风格的熊猫形象，体现了EhViewer简洁现代的设计理念

标签系统的深度应用：从基础到专家级技巧

理解标签层次结构

EhViewer的标签系统采用命名空间架构，每个标签都属于特定的类别，如"artist"、"character"、"parody"等。这种结构在GalleryTag.kt中通过GalleryTagGroup类实现，确保标签的组织性和可读性。

标签交互的进阶操作

点击搜索：直接点击任何标签，系统会自动执行以该标签为条件的搜索。这是最快速的标签应用方式。

长按操作：长按标签会触发触觉反馈并打开上下文菜单，提供以下选项：

添加到收藏标签
查看标签详情
复制标签文本
执行反向搜索（排除该标签）

标签翻译系统：当启用翻译功能后，系统会通过EhTagDatabase.getTranslation()方法获取标签的本地化版本。这个功能对于非英语用户特别有价值：

val translation = text.translate(ns) val tag = ns.value + ":" + text

标签权重可视化

标签旁的小图标表示该标签在作品中的重要程度：

实心图标：核心标签，作品的主要特征
空心图标：次要标签，作品的附加特征
无图标：普通标签

这个视觉提示帮助您快速判断作品的主要内容和次要特征。

搜索性能优化与高级技巧

1. 构建高效搜索查询

URL构建机制：所有搜索参数最终通过ListUrlBuilder类转换为URL查询字符串。这个类封装了搜索状态管理，支持分页、范围搜索和跳转功能：

data class ListUrlBuilder( var mode: Int = MODE_NORMAL, var category: Int = EhUtils.NONE, var keyword: String? = null, var language: Int = -1, var advanceSearch: Int = -1, // ... 其他参数 )

搜索状态持久化：您可以将复杂的搜索条件保存为快速搜索条目，通过QuickSearchDao进行管理。这对于频繁使用的搜索组合特别有用。

2. 避免常见搜索陷阱

性能优化：

避免同时启用过多高级过滤器
对于复杂标签组合，考虑分步筛选
使用"禁用过滤器"选项测试搜索性能

准确性提升：

利用标签的命名空间前缀确保精确匹配
结合评分和页数过滤减少误匹配
定期清理无效的快速搜索条目

3. 多条件组合搜索策略

场景示例：寻找高质量长篇日漫

选择分类："漫画"
设置语言："日语"
评分过滤：最低4星
页数范围：至少100页
启用"仅显示有封面"选项

这种组合策略通过多个维度的交叉验证，确保找到符合所有条件的高质量内容。

技术实现深度解析

搜索逻辑架构

EhViewer的搜索系统采用分层架构：

UI层：SearchFilter组件处理用户交互和参数收集
业务逻辑层：ListUrlBuilder构建搜索请求
数据层：GalleryListParser解析搜索结果
持久化层：QuickSearchDao管理搜索历史

标签系统的技术实现

标签渲染在GalleryTags组件中完成，该组件负责：

标签分组显示
翻译功能集成
交互事件处理
视觉状态管理

@Composable context(_: Context) fun GalleryTags( tagGroups: List<GalleryTagGroup>, onTagClick: (String) -> Unit, onTagLongClick: (String, String, VoteStatus) -> Unit, modifier: Modifier = Modifier, ) { // 标签渲染逻辑 }