Smart Preview：Shift+点击即刻预览网页链接的浏览器扩展 #

Smart Preview 是什么？ #

Smart Preview 是一款基于「Shift+点击」交互的浏览器扩展，让你在不打开新标签页的情况下快速预览链接内容。

在日常浏览中，我们常常因为一个并不确定是否值得阅读的链接而不断堆积标签页，回头再逐个关闭，既打断思路也消耗注意力。Smart Preview 针对这一痛点，把「打开链接」变成「浮窗速览」：在任意网页按住 Shift 键点击链接，内容会直接呈现在一个悬浮预览窗口中，阅读完按 Esc 或点击窗口外部即可关闭，标签栏始终保持整洁。除了预览本身，它还提供智能窗口管理——居中模式让窗口固定在屏幕中央，智能模式则会记忆并恢复上一次的窗口位置与大小；同时支持自定义窗口宽高、多语言界面、白名单站点「始终小窗打开」以及打开次数记忆等进阶能力。扩展基于 WXT 框架开发，采用 MIT 开源协议，代码托管于 GitHub，可跨 Chrome、Firefox 等主流浏览器使用，适合研究人员、内容编辑、开发者和任何需要高频筛选链接的浏览场景。

Smart Preview 有哪些亮点特色？ #

• Shift+点击秒速预览：在任意网页按住 Shift 键点击一个链接，即可在弹出窗口中直接查看目标页面内容，不新增标签页、不打断当前页面的阅读节奏，是这个扩展最核心、也是最省心的使用方式。
• 两种智能窗口模式：提供「居中模式」与「智能模式」两种窗口管理策略——居中模式将预览窗口稳定显示在屏幕中央，智能模式则会记忆并自动恢复上一次的窗口位置和大小，多屏或大屏用户无需反复拖拽调整。
• 白名单「始终小窗模式」：对于你经常需要速览的网站（例如资讯站、论坛、文档站），可以将其加入白名单，此后该站点内的链接点击都会始终以小窗形式打开，把「偶尔预览」升级为「默认工作流」。
• 记忆小窗功能：不仅记住小窗的尺寸和位置，还会记录「以小窗打开」的累计次数；当某个场景下以小窗打开的次数达到设定阈值后，后续相关链接会自动沿用这种打开方式，让扩展逐步适配你的浏览习惯。
• 窗口尺寸与多语言自定义：在设置中可直接调整预览窗口的宽度和高度，并切换界面语言，让预览面积与你的屏幕、阅读习惯相匹配，中文用户也能获得完整的本地化体验。
• 预览窗内一站式快捷操作：预览窗口顶部提供「复制链接」「在新标签页中打开」「在当前标签页中打开」等按钮，看完觉得有价值可以一键把链接转入正式浏览，按 Esc 键或点击窗口外部区域即可快速关闭。
• 跨浏览器兼容：使用 WXT 框架开发，官方分别提供 Chrome 与 Firefox 两个安装包，主流浏览器用户都能安装使用；项目已获得约 195 个 GitHub Star 与 7 次 Fork，社区关注度持续积累。
• 开源可审计、可自建：项目采用 MIT 许可证开源，技术栈为 Vue + WXT + daisyUI，开发者可自行克隆仓库、安装依赖并通过 pnpm run dev / pnpm run build / pnpm run zip 完成调试与打包，透明度与可定制性都有保障。

免费下载 Smart Preview #

以下为官方提供的浏览器安装包，点击链接即可下载对应版本。

提示：两个安装包均为解压后通过「加载已解压的扩展程序」方式安装，请勿在解压后删除原始文件夹，否则扩展会失效。

Smart Preview 如何使用？ #

Smart Preview 安装完成后没有复杂的启动流程，交互基本围绕「Shift+点击」展开，上手成本极低：

1. 确认扩展已启用：安装完成后，在浏览器工具栏的扩展列表中确认 Smart Preview 图标处于启用状态（建议将其固定到工具栏，便于随时查看）。
2. Shift+点击链接预览：打开任意网页，按住键盘上的 Shift 键并点击页面中的链接，预览窗口会立即弹出并加载目标页面内容，当前标签页保持不变。
3. 在预览窗内处理内容：预览窗口顶部带有操作按钮，点击可「复制链接」「在新标签页中打开」或「在当前标签页中打开」；如果只是随便看看，直接按 Esc 键或点击窗口外部区域即可关闭。
4. 调整窗口偏好：进入扩展的设置页面，可以选择「居中模式」或「智能模式」，并自定义预览窗口的宽度和高度；需要中文界面时可在多语言设置中切换。
5. 配置白名单与小窗记忆：把常用站点加入白名单，使其链接始终以小窗方式打开；配合「记忆小窗」功能，扩展会记录小窗的尺寸位置与打开次数，逐步按你的习惯自动选择打开方式。

对于开发者用户，仓库还提供了完整的本地开发命令：pnpm i 安装依赖、pnpm run dev 启动调试、pnpm run build 构建项目、pnpm run zip 打包扩展，可在此基础上进行二次开发。

Smart Preview 的常见问题？ #

Q1：为什么我 Shift+点击链接没有出现预览窗口？ 请先确认扩展已成功加载并在扩展管理页面中处于启用状态。若扩展被禁用、浏览器处于无痕/隐私模式且未授权扩展运行，或目标页面本身禁止被嵌入（如部分设置了框架限制的站点），预览可能无法正常显示，此时可改用常规方式在新标签页中打开。

Q2：Smart Preview 支持哪些浏览器？ 官方提供了 Chrome 与 Firefox 两个安装包，扩展本身基于跨浏览器的 WXT 框架开发，因此可覆盖主流浏览器。使用前请下载与浏览器内核匹配的版本，避免装错包导致无法加载。

Q3：预览窗口的位置总是挡住正文，可以固定吗？ 可以。在设置中启用「居中模式」，预览窗口会稳定显示在屏幕中央；若更希望它出现在你习惯的位置，可切换到「智能模式」，扩展会记忆并恢复上一次的窗口位置和大小，后续预览会沿用该布局。

Q4：怎么让某个网站的链接每次都自动用小窗打开？ 将该网站加入白名单，即可启用「始终小窗模式」——此后该站点内的链接点击都会以小窗形式打开。此外「记忆小窗」功能会记录小窗打开的次数，当次数达到阈值后，扩展会自动倾向于用小窗方式处理链接，减少手动切换。

Q5：扩展会收集我的浏览数据吗？ 项目在 GitHub 上以 MIT 许可证开源，全部代码可公开查阅，官网文档未提及任何数据上传或云端同步功能，预览内容均在本地浏览器中渲染。如果你对隐私有更高要求，可以自行审查源码或从仓库本地构建安装（官网未提供第三方隐私政策说明，以上基于开源仓库现状整理）。

Q6：预览窗里的内容无法交互或显示不完整怎么办？ 预览窗口本质上是在浮层中加载目标页面，部分登录态受限、需要复杂脚本交互或带有防嵌入策略的站点可能出现显示异常。此时建议点击窗口顶部的「在新标签页中打开」按钮，转入正式标签页浏览（参考社区常见反馈整理）。

Smart Preview 如何安装？ #

Smart Preview 以 zip 压缩包形式分发，需要通过浏览器的「开发者模式」手动加载，具体步骤因浏览器而异。

Chrome / Edge 等 Chromium 内核浏览器 #

1. 下载 smart-preview-chrome.zip 安装包到本地。
2. 将压缩包解压到一个固定文件夹（建议放在不会被清理的目录，安装完成后不要删除该文件夹）。
3. 在地址栏输入 chrome://extensions（Edge 为 edge://extensions）并回车，打开扩展管理页面。
4. 打开页面右上角的「开发者模式」开关。
5. 点击「加载已解压的扩展程序」，在弹出的目录选择框中选中第 2 步解压出来的文件夹并确认。
6. 扩展加载成功后，可在工具栏的扩展菜单中将其固定，方便随时查看状态与进入设置。

Firefox 浏览器 #

1. 下载 smart-preview-firefox.zip 安装包并解压到固定文件夹。
2. 打开 Firefox 的附加组件管理页面（地址栏输入 about:addons）查看扩展状态。
3. 由于官方分发包为解压安装形式，Firefox 用户可参考 Firefox 官方开发者文档的方式，在 about:debugging#/runtime/this-firefox 页面中选择「临时载入附加组件」，并选中解压目录中的扩展清单文件完成加载。
4. 需要注意的是，临时载入的扩展在浏览器完全重启后通常需要重新载入；若希望长期使用，建议关注项目发布页面是否提供已签名的正式版本。

说明：官网给出的通用安装流程为「下载 zip → 解压 → 打开扩展管理页面 → 启用开发者模式 → 加载已解压的扩展程序」，不同浏览器的具体入口存在差异，请以你所用浏览器的扩展管理界面为准。

Smart Preview 如何卸载？ #

Smart Preview 是浏览器扩展，卸载无需通过系统控制面板，直接在浏览器内操作即可。

Chrome / Edge 等 Chromium 内核浏览器 #

1. 在地址栏输入 chrome://extensions（Edge 为 edge://extensions）进入扩展管理页面。
2. 找到 Smart Preview 卡片，点击「移除」并在确认弹窗中选择确认。
3. 卸载后可手动删除此前解压的扩展文件夹，释放磁盘空间。

Firefox 浏览器 #

1. 打开 about:addons 附加组件管理页面，切换到「扩展」标签。
2. 找到 Smart Preview，点击右侧的「…」菜单并选择「移除」。
3. 若你是通过 about:debugging 临时载入的方式使用，关闭浏览器或点击「移除」按钮即可结束该临时扩展。

残留清理提示 #

扩展移除后，其在浏览器本地保存的设置（如窗口宽高、居中/智能模式、白名单站点、小窗打开次数记录等）通常会随扩展一并清除，无需额外操作。如有特殊需要，可在卸载前记录白名单等重要配置，便于日后重装时快速恢复。