文档

安装

OpenScreenShot 已上架 Chrome 应用商店。

1. 在 Chrome 中打开 OpenScreenShot 商店页面。
2. 点击添加至 Chrome。
3. 接受权限。扩展需要访问当前标签页，并获准在其中运行截图脚本。
4. OpenScreenShot 图标出现在你的工具栏。点击它打开弹出窗口。

截取截图

点击工具栏中的 OpenScreenShot 图标，整页截图立即开始，无需经过菜单。一切都在浏览器本地运行。开始截图有四种方式：

• 工具栏图标 — 一键截取整页。在设置中关闭一键 Express 模式可恢复模式选择弹窗；右键点击图标可选择其他模式和设置。
• 键盘快捷键——整页 Ctrl+Shift+S，可见区域 Alt+Shift+V，区域 Ctrl+Shift+E。macOS 上分别是 ⌘⇧S、⌥⇧V 和 ⌘⇧E。截取元素没有默认快捷键。可在 chrome://extensions/shortcuts 设置或更改其中任何一个。
• 右键菜单 — 任意页面上的 OpenScreenShot 子菜单提供相同的四种模式和设置。
• 重复区域——弹出窗口底部和右键菜单可重新截取上一次的区域矩形。这两项在你选择过一次区域后出现。

弹出窗口中的延时一行可将截图推迟 3、5 或 10 秒，工具栏徽章会倒计时。用它截取悬停状态、下拉菜单，以及你一点别处就会关闭的工具提示。

截图模式

整页

截取整个可滚动页面并拼接成一张图片。扩展逐视口滚动页面，截取每个分块，再合成到一起。固定页头在第一个分块中截取，只在顶部合成一次。滚动内部元素而非窗口的页面同样适用。超过单张图片上限（32,000 设备像素）的页面最多保存为六张图片：下载会为每个部分分别命名，编辑器或剪贴板会在单独的编辑器标签页中打开每个部分。

可见区域

立即截取当前视口。不滚动。想快速截下屏幕上此刻的内容就用它。

选定区域

点击并拖动画出一个矩形。每条边和每个角都有调整大小的控制点。用方向键将选区一次移动一个像素，按住 Shift 一次移动十个像素。按 Enter 确认，按 Esc 取消。

元素

将鼠标悬停在页面上，选中卡片、图表、表格、图片或其他元素，然后点击或按 Enter，按其边界精确截取。↑ 选择父元素，↓ 选择子元素，←/→ 选择相邻元素。如果元素没有完全可见，选择器会改为提供整页截图。

截图之后

弹出窗口中的截图后一行决定截图完成后做什么。它作用于每个入口：弹出窗口按钮、键盘快捷键和右键菜单。

• 编辑器——在新标签页打开标注编辑器。这是默认选项。
• 剪贴板——复制截图并跳过编辑器。直接粘贴到聊天、文档或 issue 里。
• 下载——把截图保存到下载文件夹并跳过编辑器。快速保存会生成 PNG。

剪贴板和下载不打开标签页，因此工具栏徽章就是完成确认。截图失败时徽章会闪烁 !。弹出窗口底部的重新打开上一张可随时在编辑器中打开最近一次截图。

标注

编辑器在完整标签页中打开，并从本地存储加载最近一次截图。每个工具都有一个单字母快捷键。

• 选择 V——移动、调整大小或删除任何标注。双击文字图层可重新编辑。
• 形状 R——绘制矩形、圆角矩形、椭圆或三角形。填充可设为无或使用描边颜色的实心填充；按住 Shift 可使各边相等，椭圆因此变为圆形。
• 箭头 A——绘制方向箭头，箭头样式可选实心、空心、双向或圆点。拖动中间的圆形控制点可将其弯成曲线。
• 直线 L——不带箭头的直线。
• 画笔 P——自由绘制。
• 荧光笔 H——半透明的自由笔迹。
• 文字 T——添加文本框，大小由字号控件决定。
• 步骤编号 S——自动递增的编号徽章，删除一个后其余会重新编号。
• 模糊 B——用柔和模糊、粗块马赛克或不透明填充遮住敏感内容。不透明填充经重新压缩仍有效。
• Spotlight（聚光） O——矩形、圆角矩形或椭圆挖空区域，合并成一个变暗图层。
• 吸管 I——从截图中取色。它取样的是你看到的画面，因此聚光内或 Beautify 渐变上的颜色所见即所得。颜色行上的色块按钮可打开 Chrome 的全屏取色器，取画布之外的颜色。
• 裁剪 C——把图片修剪到选定区域。
• Cut（裁切） X——在长截图上标记水平条带并将其删除，带实时预览。

绘制时按住 Shift 可得到等边形状，以及吸附到 45° 的直线和箭头。样式栏提供绑定在 1–8 上的 8 色调色板、自定义颜色、最近使用的颜色、四种随截图尺寸缩放的线宽和一个字号控件。你的选择会跨会话记住。在工具条上拖动工具可把常用工具排到前面，也可以用 Alt+↑ / Alt+↓ 移动当前聚焦的工具。撤销和重做是 Ctrl+Z / Ctrl+Shift+Z，macOS 上是 ⌘Z / ⌘⇧Z。

Beautify

顶栏中的 Beautify 面板为分享装点截图：一个样式预设，外加内边距、圆角和阴影滑块，以及背景，可选六种渐变、自定义纯色或透明。边框实时预览，并进入每次导出、剪贴板和 PDF。

标注已有的图片

把图片文件拖到编辑器画布上，或在文本框以外用 Ctrl+V / ⌘V 粘贴。导入的图片与截图完全同等对待，因此每个工具、Beautify 边框和每条导出路径都照常工作，顶栏会显示已导入。导入会替换画布，因此在有标注会丢失时编辑器会先询问。

导出

点击编辑器顶栏的保存图片，或按 Ctrl+S / ⌘S，打开导出对话框。旁边的复制会把 PNG 放到剪贴板，PDF 一键保存 PDF。在对话框中选择格式：

• PNG——无损，保留透明。
• JPEG——文件更小，质量可调。
• WebP——质量像 JPEG 一样可调，透明像 PNG 一样保留。
• PDF——导出为一张整图页面、适配 A4/Letter，或拆分为多页并带 5mm 重叠，避免内容被从行中间截断。

缩放比例可按 25%、50%、100%、200% 或精确像素宽度导出。PDF 按页面定尺寸，因此不显示该控件。超过 Chrome 画布上限的尺寸会被拒绝，而不是写出空文件。

Ctrl+C / ⌘C 把成品图片直接复制到剪贴板。导出对话框也能把当前设置保存为新的默认值。

录制标签页

Chrome 版支持录制标签页；Firefox 版目前只支持截图。点击弹出窗口中的录屏，会在页面旁打开录制标签页。录制进行时，在任何标签页按 Alt+Shift+X 都能停止。第一次录制时，Chrome 会请求一次标签页捕获权限。

开始录制

录制标签页会显示页面的图片和摄像头的实时画面。在那里打开麦克风、标签页音频或摄像头；浏览器自己的权限请求会出现在该标签页中。在图片上拖动可以只录制页面的一部分，也可以保留整个标签页。点击开始录制，OpenScreenShot 会切换到你的页面。

如果录制过程中跳转到其他网站，点击记录需要可选的“跨网站录制”权限（见设置）才能跟随。没有该权限时，工具栏徽标会变成琥珀色，视频剩余部分的缩放和点击效果会停止。视频本身会继续录制。

录制标签页

录制时，录制标签页显示计时器以及暂停/继续、停止和取消按钮。被录制的页面上不会添加任何内容，所以视频里不会出现控件。回到该标签页即可停止，或按 Alt+Shift+X。停止后，同一个标签页会打开编辑器。

摄像头会以圆形气泡加入导出，位置在编辑器中设置；编辑器会把视频裁剪到你选择的区域。

编辑器

点击停止后会打开录屏编辑器，把你的素材放在时间轴上。编辑器会在你光标点击过的每个位置加入平滑的 2x 缩放——可以调整或删除其中任何一个，也可以按 1.5x、2x 或 3x 添加自己的手动缩放块。拖动片段两端的控制点修剪起点或终点。点击波纹标出你点击过的位置；摄像头气泡、Beautify 边框和麦克风/标签页音频音量滑块都在侧栏里。“显示光标”按录下的光标轨迹绘制平滑的指针，可在设置栏中关闭。

导出

导出会通过画布重新渲染素材，混入你设置的轨道和效果，默认下载 MP4 文件（H.264 和 AAC），也可在按钮旁的选择器中改为 WebM。MP4 最大为 4096×2304，因此更大的标签页会缩小以适应。不支持 MP4 录制的浏览器只能导出 WebM。

草稿

编辑内容随时本地保存。如果编辑器标签页关闭或崩溃，下一个编辑器标签页会把草稿还给你。恢复始终只需一次点击，因此过期的草稿永远不会覆盖你想重新开始的截图。裁剪后的图片有自己的草稿，标注永远不会恢复到错误的图片上。

键盘快捷键

在编辑器中按 ? 查看完整快捷键表。除上面的工具字母外还有：

• 1–8——设置标注颜色。
• Ctrl+C / ⌘C——复制到剪贴板。
• Ctrl+S / ⌘S——导出。
• Backspace——删除所选标注。
• Esc——取消选择，或取消裁剪。
• Ctrl / ⌘ 加 +、− 或 0——放大、缩小、实际大小。F 适应屏幕。
• Space + 拖动——平移画布。

Alt+Shift+X 可在任何地方停止当前录制——不需要打开编辑器或弹出窗口。

设置

打开弹出窗口中的齿轮图标可设置：

• 主题——浅色、深色或跟随系统。
• 默认格式——PNG、JPEG、WebP 或 PDF。
• 质量——用于 JPEG、WebP 和 PDF。
• 文件名模板——点击占位符即可插入 {date}、{time}、{title}、{domain}、{w} 或 {h}。实时预览会显示结果。加入 / 可保存到“下载”中的文件夹，例如 Screenshots/{title}。

设置保存在这台设备的本地存储中。面板底部的恢复默认设置需要点击两次。

跨网站录制——默认关闭。开启时会请求可选的 <all_urls> 主机权限，让点击记录能跟随录制中跳转到新网站的标签页。

智能体与 CLI

openscreenshot（npm）是一个独立、可选、本地的工具，用于从命令行或 AI 智能体编程截图。它驱动你机器上已有的 Chrome——无需下载浏览器，没有托管服务。如果无法自动找到你的 Chrome，请设置 CHROME_PATH。

pnpm dlx openscreenshot shot https://example.com --out shot.png --full

作为 MCP 服务器使用时，把以下内容加入你的 MCP 客户端配置：

{ "command": "pnpm", "args": ["dlx", "openscreenshot"] }

然后用 { "url": "https://example.com" } 调用 capture_screenshot 工具。可选输入有 fullPage（默认 false）、width（200–3840，默认 1280）、height（200–2160，默认 800）和 redact，后者会在截图前用黑色方块遮盖 CSS selectors、文本 patterns（email、phone、secret）和像素 rects。该工具会向你的客户端返回 PNG 图像内容。使用托管模型的客户端可能会把该图片发送给其提供方；对于不能离开设备的数据，请使用 redact，并检查客户端的数据设置。

隐私

OpenScreenShot 的一切处理都在你的浏览器本地进行。截图保存在 Chrome 本地存储中，不会上传到任何服务器。录像、光标日志和麦克风/摄像头媒体流保留在你设备的 IndexedDB 中，直到你删除它们。扩展没有分析、没有遥测，也没有第三方服务。

完整细节见隐私政策。

获取帮助

常见问题和已知限制见支持与常见问题页面。如需更多帮助，请在 GitHub 提交 issue。