AB
AiBoss站
教程

TabTab

教程

用 TabTab 跨窗口搜索标签页并整理浏览器标签

TabTab 是一款本地优先的 Chrome 标签管理器,把多个窗口的已打开标签页与最近浏览历史集中到一个键盘驱动的弹窗里。本文介绍从源码构建安装、用快捷键唤出并搜索标签、拼音与首字母匹配、排序与固定关闭操作,以及自动清理、关闭日志和本地数据存储的配置方法。

Chrome 窗口一多,真正难办的往往不是标签页数量,而是「那个页面到底在哪个窗口里」。TabTab 针对的正是这个场景:它把所有 Chrome 窗口中的已打开标签页,以及最近浏览历史,集中到一个快速、键盘优先的弹窗中,让你直接搜索、定位和管理目标页面。整个过程以本地处理为核心,不发送网络请求,也不包含遥测。它适合同时开着多个 Chrome 窗口、标签页数量持续增长、又偏好用键盘而不是鼠标完成切换与整理的人。

准备工作

TabTab 是一个 Chrome 扩展,当前以源码构建的方式分发。动手之前,先确认下面几项条件。

  • 浏览器版本:需要 Chrome 127 及以上版本,扩展基于 Manifest V3。
  • Node.js:需要 Node.js ^20.19.0 或 >=22.12.0。版本不满足时构建会失败,建议先执行 node -v 确认。
  • 开发工具链:项目使用 TypeScript 与 Vite 开发,构建命令由项目脚本提供,无需额外全局安装构建工具。
  • 许可证:项目采用 Apache License 2.0。
  • 权限预期:扩展会申请 tabs 权限用于查询、激活、关闭和固定标签,申请 history 权限用于搜索本机浏览历史,申请 storage 权限用于保存设置、活动数据和关闭日志。它没有申请网站主机访问权限,也没有申请未使用的 sessions 权限。

版本号、依赖版本与许可证信息都可能随项目更新而变化,安装前请以官网当前信息为准。

操作步骤

第一步:获取源码并安装依赖

把项目源码取到本地后,进入项目目录执行依赖安装:

npm install

这一步会按项目锁定的依赖树安装 TypeScript、Vite 等开发依赖。如果安装过程中出现与 Node.js 版本相关的报错,先回到准备工作核对运行时版本。

第二步:构建扩展产物

依赖装好后执行构建:

npm run build

构建完成后,项目会生成一个 dist 目录,里面就是可以直接加载的扩展文件。后续每次修改源码并重新构建,都需要在扩展管理页重新加载一次。

第三步:在 Chrome 中加载已解压的扩展

  1. 在地址栏打开 chrome://extensions。
  2. 打开页面右上角的「开发者模式」开关。
  3. 点击「加载已解压的扩展程序」。
  4. 在弹出的目录选择框中选中项目生成的 dist 目录,确认加载。

加载成功后,扩展会出现在扩展列表中。首次安装后,如果扩展还没有被固定到工具栏,TabTab 会显示一次简短引导,提示你在 Chrome 的扩展程序菜单里完成固定。固定不是强制要求,这条引导也不会在升级或浏览器重启后重复出现。

第四步:唤出弹窗并搜索

安装完成后,用 Ctrl+Shift+K 打开 TabTab 弹窗;如果这个组合被其他扩展占用,可以使用备用快捷键 Ctrl+Shift+F。

弹窗打开后,第一行是占满宽度的搜索框,直接输入关键词即可。可用的搜索输入包括:

  • 网页标题中的文字
  • URL 中的文字
  • 中文关键词
  • 完整拼音
  • 拼音首字母

搜索范围覆盖所有 Chrome 窗口中已打开的标签页,最近浏览历史则排列在已打开标签之后。中文、完整拼音和拼音首字母匹配都在本地完成,即使输入的关键词与页面标题存在一定差异,也能通过本地搜索缩小范围。历史记录同样参与本地排序。

结果数量与当前排序方式分别显示在信息行两侧。结果行只展示必要的上下文以及固定、关闭操作,完整 URL 不会直接出现在弹窗中;只有当 URL 本身命中搜索时,才会显示网站主机名。

第五步:用键盘完成选择与整理

弹窗围绕键盘操作设计,常用按键如下:

按键作用
↑ / ↓在结果之间循环选择
Enter打开当前选中的页面
Shift+Enter固定或取消固定当前标签
Ctrl+Shift+X关闭当前标签
Ctrl+Backspace清空搜索关键词
Escape关闭弹窗,不会清除当前搜索内容

底部只保留必要的键盘操作提示,齿轮按钮负责进入设置页面。这种布局把主要空间留给搜索结果,而不是被低频配置占据。

第六步:调整结果排序

搜索结果支持三种排序方式:按最近使用、按打开频率、按创建时间。在多个窗口、大量标签页的情况下,按最近使用通常最快命中刚放下的页面;按打开频率适合找回长期反复访问的站点;按创建时间则适合按时间线回溯较早打开、一直没关的页面。

第七步:修改快捷键

两类快捷键的修改入口不同,不要混淆:

  • Chrome 全局打开快捷键:在地址栏打开 chrome://extensions/shortcuts 修改。
  • 弹窗内部操作快捷键:进入扩展设置页面直接录制。录制机制不会占用正常文字编辑所需的按键。

第八步:配置自动清理与关闭日志

自动清理、历史搜索、缓存控制以及关闭日志都集中在设置页面管理。自动清理的默认规则是:普通网页在 7 天未访问后进入清理范围。以下四类标签始终受保护,不会被纳入普通清理逻辑:

  • 固定标签
  • 正在播放声音的标签
  • 当前活跃标签
  • Chrome 内部标签

如果某个标签被自动关闭,可以在关闭记录中查看,并从后台重新打开。设置中还可以限制日志条数,以及清理本地缓存。

第九步:调整外观与弹窗尺寸

设置页提供跟随系统、浅色和深色三种主题。弹窗尺寸有三个预设:380 × 520、640 × 600、760 × 600;也可以在 Chrome 800 × 600 的上限范围内自定义尺寸。

语言不需要在扩展中单独选择。TabTab 会根据 Chrome 界面语言自动匹配本地化内容,依次尝试地区语言、基础语言,最后回退到英语,并支持从右到左的文字排版。本地化覆盖 Chrome 官方支持的 55 个语言区域。

一个完整示例

下面从零走一遍完整流程,目标是把 TabTab 装好,并用它找回一个散落在其他窗口里的页面。

1. 构建并加载

cd tabtab
node -v
npm install
npm run build

确认 node -v 输出满足 ^20.19.0 或 >=22.12.0,构建结束后确认 dist 目录已生成。然后打开 chrome://extensions,开启开发者模式,点击「加载已解压的扩展程序」,选择 dist 目录。

2. 准备场景

在 Chrome 中开两个以上窗口,每个窗口放几个标签页,其中至少有一个中文标题的页面,例如一篇标题含「标签管理」的文章。再随便浏览几个其他页面,让最近浏览历史里有内容。

3. 唤出并搜索

按 Ctrl+Shift+K 打开弹窗。如果没反应,改用 Ctrl+Shift+F,或到 chrome://extensions/shortcuts 检查快捷键是否被占用。

在搜索框输入中文关键词「标签」,或者不切换输入法直接输入拼音 biaoqian,也可以只输入首字母 bq。三种输入都应能命中那个中文标题的页面。

4. 选择并打开

用 ↑、↓ 在结果间移动,按 Enter 直接跳到目标标签。此时 Chrome 会切换到该标签所在的窗口。

5. 顺手整理

再次唤出弹窗,搜索另一个不再需要的页面,选中后按 Ctrl+Shift+X 关闭它。对需要长期保留的页面,选中后按 Shift+Enter 固定;再按一次即可取消固定。

6. 验证清理与恢复

进入设置页面,确认自动清理处于开启状态,并查看关闭日志。刚才手动关闭的页面应出现在日志中,可以从后台重新打开。日志里会显示完整 URL,便于确认关掉的是哪个页面。

注意事项

数据存放位置

用户偏好保存在 chrome.storage.sync,标签活动、元数据和关闭日志保存在 chrome.storage.local。清空本地缓存时,同步设置不会被删除。这意味着清理缓存不会重置你的偏好配置,但会清掉本地的活动数据与日志。

URL 的显示差异

弹窗默认不显示完整 URL,只有 URL 本身命中搜索时才显示网站主机名;设置页的关闭日志则会显示完整 URL。如果你需要确认某个被关闭页面的确切地址,去关闭日志里看,而不是在弹窗结果里找。

自动清理的保护边界

7 天未访问是普通网页的默认清理门槛,但固定标签、正在播放声音的标签、当前活跃标签和 Chrome 内部标签始终受保护。清理不是不可逆的:被自动关闭的页面会进入关闭记录,可以从后台重新打开。日志条数可以在设置中限制,避免记录无限增长。

快捷键冲突

全局打开快捷键由 Chrome 管理,若与其他扩展冲突需要到 chrome://extensions/shortcuts 调整。弹窗内部快捷键在扩展设置页录制,录制机制设计上不会占用正常文字编辑按键。

权限与隐私

扩展不发送任何网络请求,也不包含遥测。它使用 tabs 权限查询、激活、关闭和固定标签,使用 history 搜索本机浏览历史,使用 storage 保存设置、活动数据和关闭日志,并通过 Chrome 本地 _favicon 接口显示网站图标。项目没有申请网站主机访问权限,也没有申请未使用的 sessions 权限。

版本与兼容性

当前源码标注的版本为 1.0.1,运行环境为 Chrome 127+ / Manifest V3。版本号、依赖要求、语言覆盖数量与许可证等信息都可能变化,安装与配置前请以官网当前信息为准。