跳到正文

DNS 之前,浏览器在忙什么:Chrome Omnibox 原理与自定义(2):站点搜索、OpenSearch 与扩展接入

DNS 之前,浏览器在忙什么:Chrome Omnibox 原理与自定义

  1. 输入分类、候选排序与导航目标
  2. 站点搜索、OpenSearch 与扩展接入(当前)

地址栏既能访问网站,也能检索书签、历史和标签页,或进入某个站点的搜索模式。这里从用户能直接使用的功能开始,再讨论网站作者、扩展开发者和企业管理员各自能接入什么。输入怎样分类、候选怎样变成最终动作,见第一篇。源码参照 Chromium 155.0.8059.85,资料核对于 2026-10-17,具体版本来源与证据范围保存在资料快照中。

今天的地址栏都能做什么

Omnibox 的能力可以按检索对象和执行动作理解。以下以桌面 Chrome 为主;移动端、不同语言、默认搜索引擎和受管理环境,可能有不同入口。

从网站检索到浏览器内检索

最熟悉的两项仍然是访问网址和执行搜索。除此之外,地址栏还能找回历史页面、搜索书签,以及切换到已经打开的标签页。

对于后面几种检索,可以用内置快捷字明确指定范围:

输入入口 查找范围 交互方式
@tabs 已打开标签页 输入快捷字,按 Tab 或空格,再输入关键词
@bookmarks 书签 进入书签搜索模式后输入关键词
@history 浏览历史 进入历史搜索模式后输入关键词
自定义站点快捷字 某个网站的搜索结果 进入该站点的搜索模式

这些入口分别写在标签页、书签和历史记录的官方帮助里。它们能减少歧义:输入 react 可能同时得到网站和搜索建议,先进入 @tabs 模式,就明确是在找现有标签页。

地址栏也可以展示计算结果等答案型建议。例如 CalculatorProvider 会观察 SearchProvider 的返回,处理计算类候选。这类结果不能一概当作浏览器内置的离线计算器;它们可能依赖搜索引擎的建议服务、语言和当前功能配置。

浏览器操作也可以成为搜索结果

Chrome Actions 会为某些任务提供操作按钮。例如搜索与清除浏览数据相关的词时,可以出现打开对应设置的按钮。

它把「找设置」变成了一次意图匹配。点击按钮后进入相应操作入口,后续需要确认的操作仍然由对应界面完成。触发词随语言和平台变化,也不能把所有自然语言请求都视为浏览器支持的命令。

AI 搜索、页面上下文和 Gemini 是不同入口

最近的变化集中在搜索入口对上下文和多模态输入的支持,但需要分清功能归属。

AI Mode 属于 Google Search 的搜索体验。2026 年 4 月的官方更新介绍了侧边搜索体验,以及把近期标签页、图片和文件组合到搜索中的方式。同年 5 月的搜索更新继续扩展了搜索框的输入形式。这些更新涉及新标签页搜索框、AI Mode 和侧边面板,不能全部等同于传统的一行地址栏。

「Ask Google about this page」使用当前页面作为上下文。当前搜索帮助列出了从地址栏提问、选取页面区域和在侧边面板查看结果的方式,也列出了 Google 默认搜索引擎、相关设置及首次内容共享确认等条件。

按官方帮助的说明,@gemini 是从地址栏进入 Gemini 网页应用的快捷方式。这一入口不能等同于 Gemini in Chrome 的浏览器助手集成,也不表示已授予读取全部标签页的权限。

这些产品功能存在账号、地区、语言、平台和逐步开放的限制。源码里出现某个 Provider,或者官方宣布开始开放,都不能推出所有 Chrome 用户已经拥有同样的按钮。

普通用户、网站和扩展分别能自定义什么

自定义可以从最轻的一层开始。只是想少点几次鼠标,通常不需要开发扩展;只有当「把关键词放进搜索 URL」已经表达不了需求时,才需要更深的接入。

普通用户:默认搜索引擎和站点快捷字

打开设置里的「搜索引擎 → 管理搜索引擎和网站搜索」,或在地址栏输入 chrome://settings/searchEngines,就能管理默认搜索引擎与站点搜索快捷字。官方帮助把新增项分成三个主要字段:名称、快捷字,以及用 %s 代替查询内容的 URL。

例如,搜索结果页如果长这样:

https://example.com/search?q=browser

就可以把模板设为:

https://example.com/search?q=%s

这里的 example.com 是示意站点,读者应换成目标网站真实的搜索结果页。假设快捷字设为 docs,使用时就在地址栏输入 docs,按 Tab 进入该站点的搜索模式,再输入搜索词。

浏览器负责把查询放进模板,网站负责返回搜索结果。这种自定义改变的是搜索入口,没有修改网站自身的搜索算法。名称也不一定非要叫搜索引擎:文档中心、代码托管站和知识库,只要有合适的查询 URL,都可以成为候选对象。

它也有明确局限。搜索必须依赖登录时,结果页仍需要相应会话;只支持 POST、复杂请求体或页面内部状态的网站,不一定能靠一个 %s 模板完成。纯前端的搜索弹窗如果没有能从 URL 恢复查询的页面,填一个看起来像 /search?q=%s 的地址也不会凭空生效。

内置的标签页、书签和历史快捷字也能在网站搜索设置里编辑或停用。部分站点会先出现在「未启用的快捷字」区域,需要用户主动启用。受管理的浏览器则可能由管理员决定这些选项是否可以修改。

网站作者:用 OpenSearch 描述自己的搜索入口

网站可以通过 OpenSearch Description Document 向浏览器描述搜索方式。它是一个声明搜索模板的 XML 文档,浏览器可以据此发现站点搜索入口。

按 Chromium 的 Tab to Search 文档,网站首页可以在 <head> 里放一条发现链接:

<link rel="search" type="application/opensearchdescription+xml" href="/opensearch.xml" />

其中 /opensearch.xml 由网站作者提供,内容的核心是搜索 URL:

<OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/">
  <ShortName>Example Docs</ShortName>
  <Description>搜索 Example 文档</Description>
  <Url type="text/html"
       template="https://example.com/search?q={searchTerms}" />
</OpenSearchDescription>

OpenSearch 使用 {searchTerms},前面 Chrome 设置界面使用 %s,两者属于不同配置格式,不能直接互换。网站必须真的有这个搜索页面;描述文件只告诉浏览器如何调用它。

OpenSearch 还可以声明建议服务,让网站根据部分输入返回建议。这就从「回车后跳转」延伸到了「输入过程中参与候选生成」。具体格式见 OpenSearch 描述规范。

发现入口不等于默认启用,更不等于网站可以自行替换用户的默认搜索引擎。旧设计文档还介绍了从 GET 搜索表单推导模板的方式,但其中列出了表单结构限制,不能据此保证现代 SPA 的任意搜索框都会被自动识别。对用户来说,设置里的未启用快捷字和手动添加仍是更直接的确认入口。

扩展开发者:关键词模式中的动态建议

当需求变成查询多个系统、给出动态候选,或者选中结果后执行特定动作,就可以看 chrome.omnibox。

正式文档里的基本接入方式,是在扩展的 manifest.json 声明关键词:

{
  "omnibox": { "keyword": "docs" }
}

这是 manifest 的局部节选,完整扩展还需要 Manifest V3 的基础字段和后台 service worker。进入这个扩展的关键词模式以后,输入事件才交给扩展,扩展再返回候选。

下面是后台监听的接口形状,用来展示候选内容和展示文字的区别;它不是完整扩展:

chrome.omnibox.onInputChanged.addListener((text, suggest) => {
  suggest([
    {
      content: 'open:reference',
      description: '<match>参考文档</match> <dim>打开 API 索引</dim>',
    },
  ]);
});

description 是下拉列表里的文字;content 是选中后返回给扩展的内容,它可以是一个内部命令标识,浏览器不会因为它看起来像 URL 就自动替扩展完成导航。扩展要在接受输入的事件中处理它。

结合当前 API schema,关键词模式主要开放这些接入点:

接口 扩展可以做什么
onInputStarted 在一次关键词输入会话开始时准备状态
onInputChanged 根据输入生成候选,通过 suggest() 返回
setDefaultSuggestion() 设置默认候选的描述
onInputEntered 处理用户确认的内容
onInputCancelled 取消等待中的工作,清理本次会话状态
deletable 与 onDeleteSuggestion 允许删除候选,并处理删除事件
disposition 按用户意图在当前页、前台新标签页或后台新标签页展示结果

描述支持 <url>、<match>、<dim> 这几个样式标签,不是任意 HTML,也不能注入自己的 CSS。拼入外部文本时,要转义 XML 实体,不能把用户输入直接当标记处理。

实现动态建议时,还需要处理旧请求晚返回的问题:输入从 rea 变成 react 后,前一个请求的结果不应覆盖新结果。用户取消输入时可以终止请求;监听器要在 service worker 顶层注册,避免异步初始化期间漏接事件。官方 service worker 教程提供了一个可继续阅读的完整接入示例。

仅为关键词模式注册 omnibox,不需要顺手申请所有网站、历史记录或标签页读取权限。只有扩展确实要读取这些数据,或跨域请求特定服务时,才添加对应权限,并限制目标范围。查内部资料时,候选服务的访问控制仍然由服务本身负责。

无需关键词的扩展建议仍有实验边界

当前稳定版源码里确实有 UnscopedExtensionProvider,对应不先进入扩展关键词模式就参与建议的路径。它还涉及 omnibox.directInput、建议操作按钮和图标等能力。

但能找到实现,不代表它已成为普通扩展的稳定接口。该版本的权限定义里仍写着:

"omnibox.directInput": {
  "channel": "dev",
  "feature_flag": "ExperimentalOmniboxLabs",
  "extension_types": ["extension"]
}

同时,功能定义将 kExperimentalOmniboxLabs 设为默认关闭,调用入口还会同时检查功能是否启用和权限是否授予:

return base::FeatureList::IsEnabled(
           extensions_features::kExperimentalOmniboxLabs) &&
       extension->permissions_data()->HasAPIPermission(
           mojom::APIPermissionID::kOmniboxDirectInput);

当前公开 API 文档也没有把这些字段列入常规接口。因此,面向普通用户分发扩展时,应把正式的关键词模式作为可依赖入口,不能把 unscoped 模式写成已经普遍可用的能力。研究它时,还要考虑隐私差异:无需关键词就接收输入,比只在用户明确进入扩展模式后接收输入,作用范围更大。

企业管理员:统一搜索入口和企业候选

受管理的 Chrome 还有策略层,职责和个人设置、扩展不同。

SiteSearchSettings 可以统一下发站点搜索,字段包含名称、快捷字和使用 {searchTerms} 的 URL,也可以配置精选入口及是否允许用户覆盖。策略里写的快捷字本身不带 @,用户使用时可以通过普通快捷字或 @快捷字 进入。

EnterpriseSearchAggregatorSettings 则接入企业搜索聚合器,让企业内容参与地址栏和新标签页搜索框的建议。它从 Chrome 135 起支持桌面平台与 ChromeOS,当前定义要求 name、shortcut、search_url、suggest_url 等字段。

这条路径不只是静态跳转:浏览器会向 suggest_url 发 POST 请求,查询内容放在 query 参数中;require_shortcut 可以要求用户先进入企业搜索模式,再展示企业建议。若需要控制什么时候向企业服务发送查询,这个字段就直接影响使用边界。

企业搜索服务还要自己实现认证、权限过滤和返回格式。策略提供的是浏览器接入能力,不能让本来无权访问的文档变成可访问。部署后也应通过 chrome://policy 核对策略是否真的生效。

总结

普通用户可以配置站点搜索,网站用 OpenSearch 描述入口,扩展在关键词模式提供候选,企业策略统一管理搜索接入。站点搜索需要真实可用的搜索页面;扩展也可以返回本地候选或命令,按实际读取的数据和网络能力申请权限;企业服务则仍要实现认证与权限过滤。接入深度取决于需要执行的动作,实际可用入口还要核对平台、版本和受管理环境的限制。