悬景 · HoverVista
鼠标悬停图片自动放大预览 · 网页图片预览 · Image Hover Zoom
无需点击，鼠标移动到网页图片上即可自动显示更大的图片预览；移开鼠标后立即消失。
适用于文章图片、论坛图片、缩略图、图片站等网页场景。
🌐 在线介绍页（功能演示 · 配置面板实时预览 · 安装指引）：https://ydgg123.github.io/hover-image-zoom/
✨ 主要功能
- 🖱️ 鼠标悬停自动放大
- 🔍 智能自适应预览
- 🎯 固定倍数放大
- 🖼️ 高清图资源升级：7 族尺寸识别 + srcset / data-* 原图，只升不降
- ⚡ 动态图片支持：部分 AJAX、SPA、无限滚动
- 🌐 背景图片支持：CSS 背景大图完整预览
- 🎞️ Lightbox / Fancybox 兼容
- 🎚️ 滚轮缩放
- 🌎 网站独立配置
- 🛡️ 减少菜单、弹窗、播放器等误触发
- 🎛️ 全新配置面板：8 分区 + 图示化选择，改动自动保存
- ▶️ 视频悬停预览：B站 / YouTube 卡片与页面视频
- 🖼️ 图集翻页与打包：
←/→ 翻页、z 打包 ZIP
- 🕘 历史记录：列表 / 画廊视图，随时回看
- ⌨️ 键位自定义：13 个动作 + 2 项全局快捷键可视化改绑
- ⌨️ 按一下键才触发：按一下触发键（默认 h）才允许放大一次
- 🎚️ 总开关快捷键：默认 g，一键启用 / 停用本站放大
- 💾 配置备份与恢复：导出 / 导入 JSON
- 🏷️ 图片信息与图说：尺寸 / 格式 / 来源 + alt / title
- ⇄ 换图规则与站点适配：三层规则 + 点图选图
- 🇬🇧 英文界面：跟随浏览器 / 中文 / English
- 🩺 复制诊断信息：一键汇总反馈所需信息
🎯 适合哪些场景？
- 网页缩略图太小
- 看论坛图片需要反复点击
- 浏览图片站时不想打开新页面
- 想快速查看图片细节
- 希望鼠标移动到图片上就能看到大图
⚙️ 配置
提供可视化配置面板（v5.9.0 起为 8 分区新版，v5.9.1 起支持中文 / English，v5.9.2 起支持「按一下才触发」与总开关快捷键），可调整：
- 放大模式（智能自适应 / 固定倍数）
- 预览尺寸（小 / 中 / 大 / 跟随视口）
- 放大倍数、最小图片尺寸、小图目标宽度 / 高度
- 出现位置与出现方式
- 触发延迟、滚轮行为、视频预览、信息浮层、图集邻图预加载
- 动作快捷键（13 项）+ 全局快捷键（2 项），共 15 项可自定义
- 图片规则与站点适配、历史记录
- 网站独立配置
例如：
example.com → 智能模式
forum.example.com → 2 倍
image.example.com → 3 倍
📦 安装
在本页面点击安装即可。也可以使用 Tampermonkey 或 Violentmonkey 打开脚本发布页进行安装。
🛡️ 兼容性
主要针对桌面端鼠标悬停场景设计，并持续优化普通图片、动态图片、缩略图、部分背景图片、Lightbox / Fancybox、Bilibili、Discuz 以及部分 AJAX / SPA 页面。
🪟 窗口切换说明
“窗口失焦时自动收起放大图”默认开启。关闭后，Alt+Tab、切换其他应用或文件管理器覆盖浏览器时，会尽量保留当前预览；切回浏览器后，如果光标仍在原图片区域，可以继续查看。
如果光标已经真正离开原图片区域，脚本仍会按正常规则立即收起。
❓ 常见问题
为什么有些图片没有反应？
脚本会根据图片尺寸、网页结构以及当前页面状态判断是否适合预览。
支持动态加载图片吗？
支持部分 AJAX、无限滚动以及 SPA 页面。
会不会和网站的图片查看器冲突？
针对 Lightbox / Fancybox 等常见查看器进行了兼容处理，并会主动避让网站自身的图片查看界面。
可以每个网站使用不同设置吗？
可以，网站配置会独立保存。
📝 更新日志
v5.9.2
- 新增：按一下键才触发。开启后悬停不再自动放大——按一下触发键（默认
h）给一次「可放大」许可，移到图片上才弹出，用完要再按一下；图片、视频、CSS 背景图三条路径都覆盖。适合图片密集、容易误触发的页面，也可当作「手动确认」模式。
- 新增：悬浮预览总开关快捷键。默认
g，按一下启用 / 停用当前网站的悬停放大，等价于点面板总开关或右下角控制球；可改绑，输入框内不触发。
- 改进：同一设置在面板多处可改。总开关快捷键并入「启用图片放大」卡片；「触发与交互」区也提供一份「触发方式」；两项快捷键同时并进「键位」区（共 15 项）——在哪一处改都一样，其余处自动同步。
- 修复：「一次一放」收紧。一次按键只放行一次显示——预览弹出后移到别的图不再自动弹，图集翻页也要重新按一下（会给出轻提示）。
- 修复：英文界面下少数提示仍显示中文（提示文案漏判当前界面语言）。
- 本版无新增权限、无协议变更（仍 GPL-3.0）。
查看更早版本
v5.9.1
- 新增：背景图接入预览。CSS 背景图预览并入同一条基础设施，一次性继承全部能力：高清升级、滚轮缩放 / 拖拽、旋转翻转、保存 / 复制、全屏、图片信息与图说、历史记录、
Esc 关闭——「Esc 关不掉、永远只显示缩略图」的问题随之终结。
- 新增：高清升级能力扩容。尺寸家族从 1 族扩到 7 族（京东 /
?w=·?h= / _Nw.·_Nh. / _NxN. / 七牛 imageView2 / OSS x-oss-process），每族推 1200 / 1600 / 2400 三档，并带两道防误伤闸门（w=+h= 同带不展开、宽高不等不展开）；网页自己声明的原图纳入候选池（13 个 data-* 属性 + <picture> + srcset）。
- 新增：反负升级闸门。新增「当前图文件像素宽」判定，比它小的候选一律不采——宁可没有候选，也绝不让预览从清晰退回模糊；顺带修掉
srcset / sizes 密度量纲错算（naturalWidth 是密度换算后的 CSS 像素，与 w 描述符不同量纲）。
- 新增：英文界面。面板语言切换（跟随浏览器 / 中文 / English），345 条界面文案双语，中英随时来回切；默认跟随浏览器，中文浏览器行为不变。
- 新增：历史记录画廊视图。历史区「列表 / 缩略图墙」分段切换，画廊悬停浮出操作条，缩略图加载失败自动隐藏。
- 新增：一键复制诊断信息。面板底部按钮，把版本 / UA / 站点 / 配置 / 规则包版本与验签状态等汇成一段纯文本，反馈问题直接粘贴。
- 新增：图集邻图预加载。预览出现 300ms 后静默预热前后各 2 张的高清首选地址；只借浏览器 HTTP 缓存（不探测、不建 DOM），省流量 / 2G 自动跳过；面板可关（按域名保存，默认开）。
- 改进：规则包更快更省。条件请求（
If-None-Match，服务端回 304 免下载）+ jsDelivr 双镜像回退（主源不通时依次尝试；签名与逐域哈希校验照旧执行，信任链不变）；手动「立即更新」仍破缓存拿最新包。
- 修复：规则包三个缓存缺陷。① 每次开页都无条件重探；② 条件请求「站点盲」（304 整包早退绕过缓存守卫）；③ 单槽缓存互踢（多站共用一格缓存互相顶掉，导致跨站规则覆盖失效）。
- 修复：图片卡片覆盖层只能从边缘触发（如 58pic 千图网）——卡片层被误判成「菜单浮层」而拒绝触发，现整张图都能正常悬停放大。
- 修复：淘宝 / 天猫图片不升级高清。「阿里 CDN 缩略图去后缀」并入高清升级链：首页 460×460 → 1280×1280，搜索页 580×580 → 800×800。
- 修复：淘宝首页超宽横幅误触发（如 7680×120 细长条幅悬停也会弹预览），新增「细长条幅」闸门。
- 修复：站点规则背景图「延迟计时器饿死」（开发期回归，未泄出）；淘宝 / 天猫已失效的内置规则表退役，顺带消除两个站上无停止条件的定时器。
- 本版无新增权限、无协议变更（仍 GPL-3.0）。
v5.9.0
- 新增：全新配置面板。左侧 8 分区导航；数值参数改为「滑块 + 数字框」双通道；放大模式 / 预览尺寸 / 出现位置 / 出现方式改为图示化卡片，带缩略示意与动画对比；改动自动保存。
- 新增：视频悬停预览。悬停页面内视频或 B站 / YouTube 卡片即静音浮出播放；
←/→ 快退快进，Esc 关闭；预览期间锁定页面滚动。
- 新增：图集翻页与打包。同一组图片
←/→ 翻页，按 z 打包成 ZIP 下载。
- 新增：历史记录。最近放大过的图片自动记录（仅本机保存，最多 60 条），可打开、复制地址、删除、清空。
- 新增：键位自定义。13 个动作可视化改绑；冲突自动让位；支持一键恢复默认。
- 新增：图片信息与图说。放大图下方显示尺寸 / 格式 / 来源，并带出图说（alt / title）。
- 新增：换图规则与站点适配。三层规则（我的 → 云端 → 内置）；「点图选图」自动生成规则；支持手写正则并导出片段。
- 新增：设置备份与恢复（v5.8.0 起）。导出 / 导入 JSON。
- 新增：iframe 内图片支持（v5.8.0 起）。跨域框架内也能悬停放大，多框架自动仲裁。
- 新增：单次出现位置避让。关闭视频预览后，下一次图片预览自动避让到原图旁边。
- 改进：滚轮缩放不滚动页面；重采样分级；高清升级规则统一；B站全屏音量修正可选开关。
- 修复：旋转 / 翻转后外壳框不跟随旋转。
- 修复：键位被抢走后无处回退。
- 修复：面板滚轮穿透；「使用说明」弹窗背景透明、会穿透触发下层图片放大。
- 修复：面板被站点同名 CSS 规则染色。
- 修复：404 / 死链出现空白框 + 空信息栏；
data:image/svg+xml 不触发；1×1 占位图被误放大。
- 修复：部分图片站（如 Unsplash）悬停不出预览、滚轮无法缩放；灯箱 / 浮层误判导致整页失效。
- 新增
GM_listValues 权限；旧版管理器自动降级为仅备份当前站点。
v5.8.0
- 新增：支持 iframe 内图片。此前嵌套在框架页（iframe）里的图片无法悬停放大，现已支持，含跨域框架；各框架间自动仲裁，不会同时弹出多个预览。
- 新增：设置备份与恢复。配置面板底部新增「导出 / 导入」，可把全部站点配置与自定义规则导出为 JSON 文件，换设备或重装脚本后一键恢复。
- 新增：图片信息浮层。放大图左下角显示尺寸、格式与来源域名，成功升级到原图时标注「原图」；可在「快捷开关」中关闭。
- 修复：部分图片站（如 Unsplash）悬停不出预览。这类图片同时带有
src 与 srcset，而浏览器只会加载 srcset 选中的那张，脚本此前却取了未被加载的 src；当 src 不是图片地址时预览会加载失败。现已改为取浏览器实际加载的地址。
- 修复：放大后滚轮无法缩放、页面跟着滚动。部分站点会在窗口层拦截滚轮事件，而脚本的监听挂在更靠后的层级，导致收不到事件、也无法阻止页面滚动。现已改到更靠前的层级接管。
- 本次新增
GM_listValues 权限用于枚举配置项；若脚本管理器提示权限变更，允许即可（不支持的旧版管理器会自动降级为仅备份当前站点）。
v5.7.2
- 修复：部分图片站（如 Unsplash）悬停无法触发放大。根因有二：① 带 background-image 的真实图片被误判为不合格而跳过；② 页面存在 aria-modal 元素时被全局误判为"已打开灯箱"，导致整页悬停预览失效。
- 收敛灯箱 / 浮层判定：不再把通用 role="dialog" / aria-modal 当作灯箱或阻挡层，仅对真正的"覆盖式"（position:fixed/absolute）浮层生效；真实灯箱仍照常拦截。
- 界面与暗色模式（v5.7.1）无变化。
v5.7.1
- 新增暗色模式：自动跟随系统外观，深色环境下配置面板、使用说明与更新弹窗自动换色。
- 配置面板无障碍增强：快捷开关与参数折叠支持键盘操作（回车/空格），补齐焦点样式与读屏状态。
- 视觉统一：收纳一套设计变量（颜色/圆角/字号），修正文字对比度与琥珀色按钮可读性。
- 折叠区新增参数数量提示；参数区保持两列并排，节省纵向空间。
- 修复“使用说明”按钮悬停误变红；并跟进系统“减少动态效果”偏好。
v5.7.0
- 提升悬停预览稳定性：切换图片或移开鼠标时，旧的异步加载结果不再影响当前预览。
- 离开或切换时立即取消加载中的高清图请求，避免残留与错位。
v5.6.47
- 优化配置面板布局与开关、参数的对齐显示，减少纵向占用。
- 删除反馈相关内容，修复配置面板入口与状态同步，并优化界面细节。
v5.6.46
- 增加对放大图使用“滚轮控制放大图缩放”
- 优化“滚轮控制放大图缩放”：滚轮缩放步进为约 8%，连续缩放更细腻。
- 移除反馈提交与规则分享功能，不再通过这些功能收集或上传用户信息。
v5.6.42
- 优化 Lightbox 状态检测
- 减少高 DOM 变化页面中的无效检测
- 降低普通固定面板、播放器等结构被误判为 Lightbox 的可能性
- 保持原有悬停放大与即时消失行为
v5.6.41
- 新安装默认最小原图尺寸调整为 51px
- 完善核心模块化结构
v5.6.11 ～ v5.6.40
- 持续优化悬停放大体验
- 增强动态图片兼容
- 优化 Lightbox / Fancybox
- 增加网站独立配置
- 增强高清图处理
- 优化 Bilibili / Discuz 等场景
v4.3.0
- 新增放大图黑边自动裁剪
- 新增论坛缩略图高清化
- 优化放大图加载稳定性
- 优化背景图卡片站点悬停放大
v4.2.2
- 修复遮罩层导致的误判与递归问题
- 新增配置面板问题反馈
v4.1.2
- 新增悬浮控制台
- 新增图形化配置面板
- 新增智能自适应 / 固定倍数双模式
- 新增站点级配置
- 整合 B站辅助模块
v3.3.1 ～ v3.1.x
- 持续优化滚轮、懒加载、悬停自愈、主页排除、点击冲突及配置面板
🔗 项目地址
🔎 搜索关键词
鼠标悬停图片放大、图片悬停预览、网页图片预览、缩略图放大、高清图预览、Image Hover Zoom
📄 License
GPL-3.0（GNU General Public License v3.0）
Copyright (C) 2025-2026 益达哥哥
本项目为自由软件：你可以依据自由软件基金会发布的 GNU 通用公共许可证（第 3 版，或你选择的任何更高版本）的条款重新发布或修改它。
发布本项目的目的是希望它有用，但不作任何担保；甚至不隐含适销性或特定用途适用性的担保。详见 GNU 通用公共许可证第 3 版。
