安装 · 截图 · 标注 · 导出
文档
如何安装和使用 OpenScreenShot——开源的 Chrome 截图与标注扩展。
安装
OpenScreenShot 已上架 Chrome 应用商店。
- 在 Chrome 中打开 OpenScreenShot 商店页面。
- 点击添加至 Chrome。
- 接受权限。扩展需要访问当前标签页，并获准在其中运行截图脚本。
- OpenScreenShot 图标出现在你的工具栏。点击它打开弹出窗口。
截取截图
点击工具栏中的 OpenScreenShot 图标，整页截图立即开始，无需经过菜单。一切都在浏览器本地运行。开始截图有四种方式：
- 工具栏图标 — 一键截取整页。在设置中关闭点击图标即截取整页可恢复模式选择弹窗；右键点击图标可选择其他模式和设置。
- 键盘快捷键——整页 Ctrl+Shift+S，可见区域 Alt+Shift+V，区域 Ctrl+Shift+E。macOS 上分别是 ⌘⇧S、⌘⇧V 和 ⌘⇧E。可在
chrome://extensions/shortcuts重新绑定。 - 右键菜单 — 任意页面上的 OpenScreenShot 子菜单提供相同的三种模式和设置。
- 重复区域——弹出窗口底部和右键菜单可重新截取上一次的区域矩形。这两项在你选择过一次区域后出现。
弹出窗口中的延时一行可将截图推迟 3、5 或 10 秒，工具栏徽章会倒计时。用它截取悬停状态、下拉菜单，以及你一点别处就会关闭的工具提示。
截图模式
整页
截取整个可滚动页面并拼接成一张图片。扩展逐视口滚动页面，截取每个分块，再合成到一起。固定页头在第一个分块中截取，只在顶部合成一次。滚动内部元素而非窗口的页面同样适用。
可见区域
立即截取当前视口。不滚动。想快速截下屏幕上此刻的内容就用它。
选定区域
点击并拖动画出一个矩形。每条边和每个角都有调整大小的控制点。用方向键将选区一次移动一个像素，按住 Shift 一次移动十个像素。按 Enter 确认，按 Esc 取消。
截图之后
弹出窗口中的截图后一行决定截图完成后做什么。它作用于每个入口：弹出窗口按钮、键盘快捷键和右键菜单。
- 编辑器——在新标签页打开标注编辑器。这是默认选项。
- 剪贴板——复制截图并跳过编辑器。直接粘贴到聊天、文档或 issue 里。
- 下载——把截图保存到下载文件夹并跳过编辑器。快速保存会生成 PNG。
剪贴板和下载不打开标签页，因此工具栏徽章就是完成确认。截图失败时徽章会闪烁 !。弹出窗口底部的重新打开上一张可随时在编辑器中打开最近一次截图。
标注
编辑器在完整标签页中打开，并从本地存储加载最近一次截图。每个工具都有一个单字母快捷键。
- 选择 V——移动、调整大小或删除任何标注。双击文字图层可重新编辑。
- 矩形 R——绘制边框矩形。
- 箭头 A——绘制方向箭头。
- 直线 L——不带箭头的直线。
- 画笔 P——自由绘制。
- 荧光笔 H——半透明的自由笔迹。
- 文字 T——添加文本框，大小由字号控件决定。
- 步骤编号 S——自动递增的编号徽章，删除一个后其余会重新编号。
- 模糊 B——用柔和模糊、粗块马赛克或不透明填充遮住敏感内容。不透明填充经重新压缩仍有效。
- Spotlight（聚光） O——矩形、圆角矩形或椭圆挖空区域，合并成一个变暗图层。
- 吸管 I——从截图中取色。它取样的是你看到的画面，因此聚光内或 Beautify 渐变上的颜色所见即所得。颜色行上的色块按钮可打开 Chrome 的全屏取色器，取画布之外的颜色。
- 裁剪 C——把图片修剪到选定区域。
绘制时按住 Shift 可得到正方形，以及吸附到 45° 的直线和箭头。样式栏提供绑定在 1–8 上的 8 色调色板、自定义颜色、最近使用的颜色、三种线宽和一个字号控件。你的选择会跨会话记住。撤销和重做是 Ctrl+Z / Ctrl+Shift+Z，macOS 上是 ⌘Z / ⌘⇧Z。
Beautify
顶栏中的 Beautify 面板为分享装点截图：内边距、圆角和阴影滑块，外加六种渐变预设、自定义纯色或透明背景。边框实时预览，并进入每次导出、剪贴板和 PDF。
标注已有的图片
把图片文件拖到编辑器画布上，或在文本框以外用 Ctrl+V / ⌘V 粘贴。导入的图片与截图完全同等对待，因此每个工具、Beautify 边框和每条导出路径都照常工作，顶栏会显示已导入。导入会替换画布，因此在有标注会丢失时编辑器会先询问。
导出
点击编辑器顶栏的导出，或按 Ctrl+S / ⌘S。选择格式：
- PNG——无损，保留透明。
- JPEG——文件更小，质量可调。
- WebP——质量像 JPEG 一样可调，透明像 PNG 一样保留。
- PDF——导出为一张整图页面、适配 A4/Letter，或拆分为多页并带 5mm 重叠，避免内容被从行中间截断。
缩放比例可按 25%、50%、100%、200% 或精确像素宽度导出。PDF 按页面定尺寸，因此不显示该控件。超过 Chrome 画布上限的尺寸会被拒绝，而不是写出空文件。
Ctrl+C / ⌘C 把成品图片直接复制到剪贴板。导出对话框也能把当前设置保存为新的默认值。
录制标签页
点击弹出窗口中的录屏；录制进行时按 Alt+Shift+X 停止。第一次录制时，Chrome 会为标签页录制显示一次权限提示；之后每次录制都一键开始。
开始录制
弹出窗口的录屏一行有三个开关——麦克风、标签页音频和摄像头——点击“录屏”前先打开需要的那些。开启麦克风或摄像头后，采集开始前，浏览器自己的权限提示会从页面上的一个小气泡弹出。
如果录制中的页面跳转到其他网站，控制栏需要可选的“跨网站录制”权限（见设置）才能跟过去。没有该权限时，工具栏徽章会变成琥珀色；点击工具栏图标或再与页面交互一次，即可重新附加叠加层。
控制栏
录制时页面底部有一个小控制栏：计时器、每条已启用轨道的标签，以及暂停/继续、停止和取消按钮。开启摄像头后，一个可拖动的圆形预览浮在页面上——拖到哪里，它就在余下的录制中留在哪里。
指针离开约三秒后，控制栏会自行隐藏，从而不出现在你的录像里。把光标移到页面底部中央即可让它回来。悬停在它上面时，以及录制暂停时，它保持可见。
编辑器
点击停止后会打开录屏编辑器，把你的素材放在时间轴上。编辑器会在你光标点击过的每个位置加入平滑的 2x 缩放——可以调整或删除其中任何一个，也可以按 1.5x、2x 或 3x 添加自己的手动缩放块。拖动片段两端的控制点修剪起点或终点。点击波纹标出你点击过的位置；摄像头气泡、Beautify 边框和麦克风/标签页音频音量滑块都在侧栏里。“显示光标”按录下的光标轨迹绘制平滑的指针，可在设置栏中关闭。
导出
导出会通过画布重新渲染素材，混入你设置的轨道和效果，并下载一个 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}。实时预览会显示结果。
设置保存在这台设备的本地存储中。面板底部的恢复默认设置需要点击两次。
跨网站录制——默认关闭。开启后会请求可选的 <all_urls> 主机权限，这样录制控制栏和光标叠加层就能跟随录制途中跳转到新网站的标签页。
智能体与 CLI
openscreenshot（npm）是一个独立、可选、本地的工具，用于从命令行或 AI 智能体编程截图。它驱动你机器上已有的 Chrome——无需下载浏览器，没有托管服务。如果无法自动找到你的 Chrome，请设置 CHROME_PATH。
npx openscreenshot shot https://example.com --out shot.png --full作为 MCP 服务器使用时，把以下内容加入你的 MCP 客户端配置：
{ "command": "npx", "args": ["openscreenshot", "serve"] }然后用 { "url": "https://example.com" } 调用 capture_screenshot 工具。
隐私
OpenScreenShot 的一切处理都在你的浏览器本地进行。截图保存在 Chrome 本地存储中，不会上传到任何服务器。录像、光标日志和麦克风/摄像头媒体流保留在你设备的 IndexedDB 中，直到你删除它们。扩展没有分析、没有遥测，也没有第三方服务。
完整细节见隐私政策。