搜索与导航

充分利用聚合搜索、本地文件搜索与书签,提升日常效率。

6 个小节 · 约 5 分钟读完

聚合搜索

顶部搜索栏(快捷键 Ctrl/⌘ + K)按 12 大分类检索:网页、音乐、影视、图书、文档、论文、图片、视频、文件、软件、技能与 AI。同一个分类下只要凑够两个可执行源,就会出现「聚合」按钮,一次并发问多家、结果边到边出。控制台与桌面视图里,Ctrl/⌘ + K 直接进整页搜索视图。

分类聚合时会问哪些源要不要 Key
网页你配置的搜索引擎(豆包 / Tavily / Serper / 自建 SearXNG 任选其一)需要一个;没配则该源不参加,只给六引擎快捷跳转
音乐iTunes、网易云音乐(自家 Navidrome 库也在这一类)不要
影视TMDB、TMDB 华语(自家 Jellyfin / Emby 库也在这一类)TMDB 需 Key,未配则自动少一家
图书Google Books、Open Library不要
文档Wikipedia不要
论文arXiv、Semantic Scholar不要
图片Wikimedia、Pixabay(自家 Immich 相册也在这一类)Pixabay 需 Key
视频bilibili、Wikimedia不要
软件GitHub + Docker Hub + Gitee(三家内部并行)不要
技能skills.sh + Smithery + GitHub(三家内部并行)不要
  • 为压住首屏时间,每个分类最多挑 2 个源进聚合——聚合总耗时约等于最慢那一家,单个源 5 秒超时后静默标记未响应,不拖累其它家
  • 同一个关键词同一个源 5 分钟内复用结果,反复切换分类不会重复外呼
  • 文件分类不进聚合:它查的是本地索引(SQLite),行里没有网址与封面
  • AI 分类是提问而不是检索,因此也不参与聚合
  • 音乐结果可直接播放;Navidrome 命中的是你自己的曲库,点了就播
关键词选定分类多源并发边到边出合并去重或 Ctrl+K12 类最多 8 路 · 单源 5sSSE 流式回推一份列表
图:一次聚合的链路——分类决定问哪几家,各家独立超时,谁先回谁先显示,最后合并去重成一份列表。

网页分类没配任何引擎时,聚合入口不会出现,但六引擎快捷跳转仍然可用——那是纯跳转,不需要 Key,也完全免费。自定义搜索源(URL 模板 + 结果解析规则)为 Pro 功能。

把自己的媒体库一起搜

已经配好的服务集成会自动登记成可搜源,不用另外配置:单源可搜,也能和其他源一起进聚合。搜的是你自己的库,结果不经过任何第三方。

  • Jellyfin / Emby → 影视分类:命中库内影片与剧集,带海报直达详情页
  • Navidrome → 音乐分类:命中自家曲目,点击即在面板内播放
  • Immich → 图片分类:命中你自己相册里的照片
  • 判据是「这个服务能不能按关键词回结构化条目并带缩略图」——纯状态类服务(如监控、下载队列)不会被塞进搜索结果里凑数

库里搜不到东西时先确认该集成已启用且凭据有效;聚合里某一家显示「未响应」通常是它自己的 5 秒超时,不影响其余源。

自定义搜索源

除了内置引擎,Pro 用户可接入任意搜索 API 作为自定义搜索源。在「搜索 → API 设置 → 自定义搜索源」中配置。

  • 空白模板:从零配置任意 API 的请求地址、参数与结果字段
  • 预设模板:提供文档搜索、论坛搜索等常用模板,开箱即用
  • 智能填充:配置 AI 后可自动分析接口、填入字段映射
  • 字段映射:自定义标题 / 链接 / 缩略图字段,支持正则提取
  • 配置后可先测试连接,通过再保存
  • 自定义源同样进聚合:它属于哪个分类,就在哪个分类下和其它源并发执行

自定义搜索源由你自行配置,需对接口来源的合法性与内容合规性负责;请通过官方渠道申请所需 API Key。

本地文件搜索

文件分类对服务器上的共享目录建立全文索引(SQLite),按文件名与内容检索,点击直达文件。索引与文件都在你自己的设备上。

书签快速跳转

书签卡片支持搜索与分组折叠,输入标题关键词即可模糊匹配并直接打开;导入浏览器书签后自动同步到「收藏」分类。

  • 拼音也能搜:输入 xunlei 或 xl 都能命中「迅雷」,全拼与首字母缩写都支持
  • 中英混输、大小写不敏感,命中片段会高亮
  • 搜索范围覆盖分组名与站点说明,不只是标题
  • 结果可直接回车打开新标签,或按住修饰键在当前页打开

拼音匹配在浏览器本地完成,不需要联网,也不会把你的输入发给任何服务。

AI 问答

在 Pro 面板的 AI 设置中配置你自己的 OpenAI 兼容接口(baseURL + apiKey + model,支持本地 Ollama)后,即可在 AI 分类下自然语言提问并获得回答。请求直连你配置的接口,不经过 BestNav 官方服务器。

Aggregated Search

The top search bar (Ctrl/Cmd+K) covers 12 categories: Web, Music, Movies, Books, Docs, Papers, Images, Video, Files, Software, Skills and AI. Whenever a category has at least two executable sources, an Aggregate button appears and runs them concurrently, rendering results as they land. In Console and Desktop, Ctrl/Cmd+K opens the full-page search view.

CategorySources queried when aggregatingKey required?
WebWhichever engine you configured (Doubao / Tavily / Serper / self-hosted SearXNG)Yes — if none is set the source simply does not join, quick-jump links still work
MusiciTunes, Netease (plus your own Navidrome library)No
MoviesTMDB, TMDB Chinese (plus your Jellyfin / Emby library)TMDB needs a key; it drops out when unset
BooksGoogle Books, Open LibraryNo
DocsWikipediaNo
PapersarXiv, Semantic ScholarNo
ImagesWikimedia, Pixabay (plus your own Immich library)Pixabay needs a key
Videobilibili, WikimediaNo
SoftwareGitHub + Docker Hub + Gitee (three run in parallel internally)No
Skillsskills.sh + Smithery + GitHub (three run in parallel internally)No
  • At most two sources per category join an aggregate, to keep the first screen fast — total latency is roughly the slowest source, and each source times out silently after 5 s
  • The same keyword and source reuse a cached result for 5 minutes, so switching categories does not re-call everything
  • Files never joins an aggregate: it queries your local SQLite index and its rows have no URL or thumbnail
  • AI is a conversation, not a retrieval source, so it is excluded too
  • Music results play inline; a Navidrome hit is your own track and plays on click
KeywordCategoryConcurrentStream inMergeor Ctrl+K12 categoriesup to 8 · 5 s eachover SSEone list
Diagram: the category decides who gets asked, each source times out on its own, early results render first, then everything merges.

With no web engine configured at all the Aggregate button does not appear, but the six quick-jump engines still work — they are plain links, key-free and free of charge. Custom search sources (URL template + parsing rules) are a Pro feature.

Search Your Own Media Libraries Too

Configured integrations register themselves as searchable sources — nothing extra to set up. Each one works as a single source or inside an aggregate, and the results come from your own library, never through a third party.

  • Jellyfin / Emby → Movies: matches films and series in your library, poster straight to the detail page
  • Navidrome → Music: matches your own tracks and plays them in the panel
  • Immich → Images: matches photos in your own albums
  • The test is whether a service returns structured entries with thumbnails for a keyword — status-only services (monitors, download queues) are not stuffed into search results

If a library returns nothing, check that the integration is enabled with valid credentials. A source marked unresponsive in an aggregate is just its own 5 s timeout and does not hold up the others.

Custom Search Sources

Beyond the built-in engines, Pro users can plug in any search API as a custom source. Configure it in Search → API Settings → Custom Sources.

  • Blank template: configure any API endpoint, params and result fields from scratch
  • Preset templates: ready-made templates for docs / forum search
  • Smart fill: with AI configured, auto-analyze the API and fill field mappings
  • Field mapping: define title / link / thumbnail fields, with regex extraction
  • Test the connection before saving
  • Custom sources join aggregates as well — they run concurrently with the other sources of their category

Custom sources are self-configured — you are responsible for the legality of the source and content compliance. Obtain any required API keys through official channels.

Local File Search

The Files category builds a full-text index (SQLite) over shared directories on your server — search file names and contents, click to open. Index and files never leave your device.

Bookmark Jump

The bookmark card supports search and collapsible groups; type part of a title to fuzzy-match and open it. Imported browser bookmarks sync into the Favorites category.

  • Pinyin works too: typing xunlei or xl matches a bookmark named 迅雷 — full spelling and initials both work
  • Mixed Chinese/English input, case-insensitive, with the matched fragment highlighted
  • The search covers group names and site descriptions, not only titles
  • Press Enter to open in a new tab, or hold a modifier to open in the current page

Pinyin matching runs entirely in your browser — nothing is sent to any service.

AI Answers

Configure your own OpenAI-compatible endpoint (baseURL + apiKey + model, local Ollama works) in the Pro panel AI settings, then ask in natural language from the AI category. Requests go straight to your endpoint — never through BestNav servers.