浏览器自带的截图只能拍到当前视口。想存一整篇长文、一张完整订单页,就得一屏屏截图再手工拼, 拼出来的图还常常在滚动衔接处错位。系统截图工具也没有标注能力,框出问题区域之后, 还得另开一个编辑器画箭头。
留影把这三步收在一处:整页采集、区域框选、就地标注。 整页长图按绝对滚动位置逐屏拼接,衔接处不会重;区域截图拖一下就裁; 截完直接进入编辑器,方框、箭头、文字、马赛克都在同一条工具栏上。
另一个实际问题是隐私。很多截图工具要求上传图片到服务器做拼接和识别 —— 订单、账单、后台数据这类页面并不适合这么处理。留影不联网、不上传, 拼接和标注全部在浏览器本地完成。
安装部署
前置要求:Chrome / Edge(Manifest V3)。扩展尚未上架应用商店,需要通过开发者模式加载本地目录。
方式一 · 下载安装包(推荐)
- 到 Releases 下载
webshot-v1.0.0.zip。 - 解压到一个固定目录,比如
D://ext//webshot。 - 打开
chrome://extensions,打开右上角「开发者模式」。 - 点「加载已解压的扩展程序」,选中该目录;建议把图标固定到工具栏。
方式二 · 从源码加载
git clone https://github.com/limaosou/webshot.git- 在
chrome://extensions打开开发者模式,点「加载已解压的扩展程序」,选中仓库根目录。
装好之后先自检
装完别急着用,先跑一遍这 6 项。任何一项不对,说明环境或权限还没到位。
- 工具栏出现留影图标,网页上右键能看到「框选区域截图」和「整页长截图」两项。
- 按 Ctrl+Shift+X(Mac 为 ⌘+Shift+X)能进入区域框选,拖拽时有尺寸提示,Esc 能取消。
- 按 Ctrl+Shift+E(Mac 为 ⌘+Shift+E)能开始整页采集,工具栏图标显示进度百分比。
- 截完自动进入编辑器,数字键 1–6 能切换矩形、椭圆、箭头、画笔、文字、马赛克。
- Ctrl+Z 撤销、Ctrl+Shift+Z 重做都正常工作。
- Ctrl+S 能保存 PNG 到下载目录,Ctrl+C 能复制到剪贴板。
前台使用
三种触发方式
点工具栏图标、按快捷键、在网页上右键选菜单项 —— 三种方式效果相同,按当时的习惯来就行。快捷键是区域 Ctrl+Shift+X、整页 Ctrl+Shift+E,Mac 上把 Ctrl 换成 ⌘。
整页长图
扩展自动滚动逐屏采集,按绝对滚动位置拼成一张完整长图,最大 30000px。采集过程中工具栏图标会显示进度百分比,完成后直接进入编辑器。超过上限的页面会提示分段截图,避免浏览器内存溢出。
区域框选
触发后页面变暗,拖拽出矩形,过程中实时显示尺寸;松开即裁剪并进入编辑器。按 Esc 随时取消,不会留下任何文件。
标注编辑器
工具栏上依次是矩形、椭圆、箭头、自由画笔、文字、马赛克打码,支持撤销、重做和一键清空。键盘快捷键:1 矩形 · 2 椭圆 · 3 箭头 · 4 画笔 · 5 文字 · 6 马赛克 · 0 选择模式;Ctrl+Z 撤销、Ctrl+Shift+Z 重做、Ctrl+S 保存、Esc 关闭。
导出
保存为 PNG / JPG 到浏览器下载目录,或一键复制到剪贴板直接粘进聊天窗口、文档和工单系统。文件名由设置里的模板决定,支持日期、时间、网页标题等变量。
后台与设置
界面语言
编辑器工具栏最右侧的齿轮打开设置抽屉,第一项就是界面语言:简体中文 / English,选完立即生效,编辑器和弹窗同步切换。未手动选择时跟随浏览器界面语言。
下载文件命名
用模板自定义文件名,输入框下方会实时显示预览。可用变量:{date} 日期、{time} 无分隔时间、{datetime} 日期+时间、{timestamp} 毫秒时间戳、{title} 网页标题、{mode} 截图方式(full / region)。
快捷键管理
设置里可以重新指定区域与整页截图的快捷键。不要用 Alt+Shift 系组合键 —— 中文 Windows 默认用它切换输入语言,系统先截走了按键,扩展收不到。如果快捷键被其它软件占用,也可以用网页右键菜单绕过。
使用帮助
截图存在哪里了
点「保存」会走浏览器下载管理器,文件名按设置里的模板生成;点「复制」则进系统剪贴板,不会落盘。扩展本身不保存任何截图副本。
会不会把页面内容上传
不会。扩展不联网、不埋点,整页拼接和标注全部在本地完成。它申请的权限(activeTab、scripting、downloads、clipboardWrite 等)都对应本地操作,没有网络上传权限。
长截图在某些页面上错位
少数页面用固定定位的悬浮层或虚拟滚动列表,滚动时内容本身不按常规方式移动。遇到这种情况优先用区域框选分段截取;整页拼接按绝对滚动位置工作,对虚拟滚动无能为力。
几个真实用法
| 场景 | 怎么做 |
|---|---|
| 留存整页资料 | 长文、商品页、后台报表一次截全,不用一段段拼图。 |
| 标注反馈 | 框住问题区域,画箭头加两行文字,发给同事就能说清楚。 |
| 打码后分享 | 订单、账单这类带隐私的页面,马赛克涂掉敏感字段再复制或保存。 |
常见问题
整页长图最长能截多少?
30000px。超过这个高度的页面会提示分段截图,避免浏览器内存溢出。
截图会上传到服务器吗?
不会。扩展不联网,拼接和标注全部在本地完成,只落到你指定的下载目录或剪贴板。
快捷键被输入法占用怎么办?
不要用 Alt+Shift 系组合键,中文 Windows 会先拿它切换输入法。弹窗里点「修改快捷键」可在设置页重新指定,也可以用网页右键菜单。
问题解决
先按下面的顺序自查一遍,九成问题能在三步内定位,再往下才是具体现象的对照表。
- 确定范围:只有这一台设备/这一个页面出问题,还是全部都这样。只在一处出现,基本是环境或权限;全都这样,先怀疑版本与配置。
- 看最先报错的地方:前台报错的原文、浏览器控制台的第一行红字、后台日志里最早的那一条,比最后一条有用。
- 退回默认:关掉自己加的配置或与其他插件/脚本的冲突项,用默认设置复现一次。默认能用,问题就在改动里。
| 现象 | 原因 | 处理 |
|---|---|---|
| 按快捷键没反应 | 快捷键被输入法或其它软件占用。 | 换用网页右键菜单;或在设置里重新指定快捷键,避开 Alt+Shift 系组合。 |
| 整页长图在某处断开或重复 | 页面用了虚拟滚动或固定定位元素,滚动位置与内容不对应。 | 改用区域框选分段截取;普通长文页面一般不会出现这个问题。 |
| 复制后粘不出来 | 编辑器的复制写入的是图片数据,部分老旧应用只接受文本。 | 改用「保存 PNG」再插入;或粘贴到支持图片的聊天工具与文档里。 |
| 工具栏图标显示进度后卡住 | 页面特别长或图片极多,拼接耗时较长。 | 保持页面在前台,等进度走完;超过 30000px 的页面会改为提示分段截图。 |
以上之外的问题,带上产品名、版本号、报错原文、操作步骤反馈到 hi@qinghuali.com,四项齐了基本一次能定位。
能力边界
这一节比功能列表更值得先看——它决定了你会不会在错误的场景里浪费时间。
- 整页长图上限 30000px,超过会提示分段截图。
- 虚拟滚动列表和固定定位悬浮层可能导致拼接错位,这类页面建议用区域框选。
- 扩展只在用户主动触发时截取当前页面,不做后台定时截图。
- 不联网、不上传,因此也没有云端历史记录;关掉页面后不会留下截图副本。
版本记录
| 版本 | 日期 | 变更 |
|---|---|---|
| 1.0.0 | 2026-11-18 | 首个版本:整页长图、区域框选、标注编辑器与文件名模板。 |