安装 · 截图 · 标注 · 导出

# 文档

如何安装和使用 OpenScreenShot——开源的 Chrome 截图与标注扩展。

## 本页目录

- [安装](https://openscreenshot.app/zh-cn/docs/#install)
- [截取截图](https://openscreenshot.app/zh-cn/docs/#capture)
- [截图模式](https://openscreenshot.app/zh-cn/docs/#modes)
- [截图之后](https://openscreenshot.app/zh-cn/docs/#after-capture)
- [标注](https://openscreenshot.app/zh-cn/docs/#annotate)
- [Beautify](https://openscreenshot.app/zh-cn/docs/#beautify)
- [标注已有的图片](https://openscreenshot.app/zh-cn/docs/#import)
- [导出](https://openscreenshot.app/zh-cn/docs/#export)
- [录制标签页](https://openscreenshot.app/zh-cn/docs/#record)
- [草稿](https://openscreenshot.app/zh-cn/docs/#drafts)
- [键盘快捷键](https://openscreenshot.app/zh-cn/docs/#shortcuts)
- [设置](https://openscreenshot.app/zh-cn/docs/#settings)
- [智能体与 CLI](https://openscreenshot.app/zh-cn/docs/#agents-cli)
- [隐私](https://openscreenshot.app/zh-cn/docs/#privacy)
- [获取帮助](https://openscreenshot.app/zh-cn/docs/#support)

## 安装

OpenScreenShot 已上架 Chrome 应用商店。

1. 在 Chrome 中打开 [OpenScreenShot 商店页面](https://chromewebstore.google.com/detail/hdabbojjccojlapnfjpdppcpfcnhgmdp)。
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 会切换到你的页面。

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

### 录制标签页

录制时，录制标签页显示计时器以及暂停/继续、停止和取消按钮。被录制的页面上不会添加任何内容，所以视频里不会出现控件。回到该标签页即可停止，或按 `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 中，直到你删除它们。扩展没有分析、没有遥测，也没有第三方服务。

完整细节见[隐私政策](https://openscreenshot.app/zh-cn/privacy/)。

## 获取帮助

常见问题和已知限制见[支持与常见问题](https://openscreenshot.app/zh-cn/support/)页面。如需更多帮助，请在 [GitHub](https://github.com/pghqdev/OpenScreenShot/issues) 提交 issue。

## 安装 OpenScreenShot

免费、开源、私密。已上架 Chrome 应用商店。

[添加至 Chrome](https://chromewebstore.google.com/detail/hdabbojjccojlapnfjpdppcpfcnhgmdp) [添加到 Firefox](https://addons.mozilla.org/firefox/addon/openscreenshot/)

---

Canonical page: https://openscreenshot.app/zh-cn/docs/