> 如何安装 Bingsu、录制屏幕、编辑、制作分享页，以及连接 Claude、ChatGPT、Codex 和其他 AI 智能体。一页涵盖所有任务。

Source: https://docs.bingsustudio.com/zh-cn/

# 文档

1. [安装 Bingsu](https://docs.bingsustudio.com/zh-cn/#install-bingsu)
2. [允许屏幕录制](https://docs.bingsustudio.com/zh-cn/#allow-screen-recording)
3. [录制屏幕](https://docs.bingsustudio.com/zh-cn/#record-your-screen)
4. [选择窗口、应用或区域](https://docs.bingsustudio.com/zh-cn/#pick-a-window-an-app-or-an-area)
5. [声音和麦克风](https://docs.bingsustudio.com/zh-cn/#sound-and-microphones)
6. [你的摄像头和通话来宾](https://docs.bingsustudio.com/zh-cn/#your-camera-and-call-guests)
7. [暂停、停止和锁屏](https://docs.bingsustudio.com/zh-cn/#pause-stop-and-the-lock-screen)
8. [修剪、剪切和裁切](https://docs.bingsustudio.com/zh-cn/#trim-cut-and-crop)
9. [缩放和背景](https://docs.bingsustudio.com/zh-cn/#zoom-and-backgrounds)
10. [文字稿、字幕和章节](https://docs.bingsustudio.com/zh-cn/#transcript-captions-and-chapters)
11. [分享页面](https://docs.bingsustudio.com/zh-cn/#share-a-page)
12. [连接 AI 智能体](https://docs.bingsustudio.com/zh-cn/#connect-an-ai-agent)
13. [让智能体来录制](https://docs.bingsustudio.com/zh-cn/#ask-an-agent-to-record)
14. [智能体能做什么](https://docs.bingsustudio.com/zh-cn/#what-an-agent-can-do)
15. [让多个智能体同时录制](https://docs.bingsustudio.com/zh-cn/#let-several-agents-record-at-once)
16. [智能体使用摄像头和麦克风](https://docs.bingsustudio.com/zh-cn/#camera-and-microphones-for-agents)
17. [使用命令行](https://docs.bingsustudio.com/zh-cn/#use-the-command-line)
18. [更新](https://docs.bingsustudio.com/zh-cn/#updates)
19. [隐私](https://docs.bingsustudio.com/zh-cn/#privacy)
20. [解决问题](https://docs.bingsustudio.com/zh-cn/#fix-a-problem)
21. [卸载](https://docs.bingsustudio.com/zh-cn/#uninstall)

[Markdown](https://docs.bingsustudio.com/zh-cn/index.md) [llms.txt](https://docs.bingsustudio.com/docs/llms.txt)

Bingsu 在你的电脑上录制屏幕、摄像头和通话，也能让 AI 智能体录下自己的工作。下面每个任务都能复制成提示词，交给你的智能体替你完成。

## 安装 Bingsu

1. [下载 Mac 版 Bingsu](https://bingsustudio.com/download/)。需要 macOS 26 Tahoe 或更高版本。
2. 在“下载”文件夹中打开 `Bingsu.dmg`，把 Bingsu 拖到“应用程序”文件夹。
3. 打开 Bingsu。它在菜单栏里，不在程序坞中。

也可以用 Homebrew 安装：

```
brew install --cask bingsu
```

打开文件前如需校验，请将它的 SHA-256 与[下载页面](https://bingsustudio.com/download/#verify)上的值进行比对：

```
shasum -a 256 ~/Downloads/Bingsu.dmg
```

Windows 上：

1. [下载 Windows 版 Bingsu](https://bingsustudio.com/download/#windows)。需要 Windows 10（2004 版）或更高版本。
2. 在“下载”文件夹中打开 `Bingsu.msix`，选择“安装”。
3. 从开始菜单打开 Bingsu。

Linux 上：

1. [下载 Linux 版 Bingsu](https://bingsustudio.com/download/#linux)。需要运行在 Wayland 上并带有 PipeWire 的 GNOME 或 KDE；X11 也可以用。
2. 给文件加上可执行权限，然后打开它：

```
chmod +x ~/Downloads/Bingsu.AppImage && ~/Downloads/Bingsu.AppImage
```

## 允许屏幕录制

第一次录制时，macOS 会询问一次。在“系统设置”>“隐私与安全性”>“录屏与系统录音”中打开 Bingsu，然后重新打开 Bingsu。

摄像头和麦克风分别单独询问。macOS 只在你第一次使用时才会询问。Bingsu 从不自行打开它们。

## 录制屏幕

1. 点按菜单栏中的 Bingsu 图标，或在任何地方按 ⌥⇧⌘R。
2. 选择要录制的内容：屏幕、窗口、应用或区域。
3. 按“Record”。录完后按“Stop and Save”。

每个文件保存后都会接受检查：时长、画面、音轨、静音，以及窗口是否被关闭。发现问题时，录像上会显示警告。

文件保存在 `~/Movies/Bingsu`。可在“Settings”中更改文件夹。

## 选择窗口、应用或区域

- **窗口**被其他窗口遮住时仍会继续录制，而且只录该应用的声音。
- **应用**会录制它的所有窗口。
- **区域**录制屏幕上固定的一部分。拖动即可画出区域。
- **屏幕**录制该显示器上的所有内容。

最小化的窗口不发送画面。录像会重复最后一帧，直到你把窗口恢复。

## 声音和麦克风

录制窗口或应用时，只录该应用的声音。录制屏幕时，录的是 Mac 的声音。

可以添加任意数量的麦克风。每个麦克风都显示实时音量，在文件中各占一条音轨，并汇入一条所有播放器都能播放的混音音轨。拔掉某个麦克风后，它的音轨会保持静音，直到你重新插上，录制不会中断。

## 你的摄像头和通话来宾

在面板的“Camera”一行中选择摄像头。它以气泡形式叠在录像上方，同时另存为单独的视频轨道。

- 气泡可以拖到任何位置。拖动它的一角可调整大小。
- 可在它的工具栏中设为圆形、圆角方形或宽屏，也可以镜像。
- 右键点按可关闭摄像头或将其隐藏。

在 Zoom、Meet、Teams、FaceTime、Slack、Discord、Webex 或 WhatsApp 中，Bingsu 会找到通话窗口里的人，并为每个人添加一个气泡，最多五张脸。它可以跟随正在说话的人，也可以只跟随某一个人。每位来宾的声音取自通话应用，各占一条音轨。人脸识别在你的 Mac 上运行；与人脸相关的任何信息都不会离开你的 Mac，也不会被保留。

## 暂停、停止和锁屏

- 暂停和继续不会在文件中留下空隙。
- 给录制设定时长，它会准时在那一秒停止。
- 屏幕锁定时，Bingsu 会暂停，你重新登录后继续录制。可在“Settings”中更改。
- Bingsu 以两秒为单位分段写入文件，所以即使 Mac 崩溃，下次打开时也能恢复写了一半的文件。

## 修剪、剪切和裁切

在编辑器中打开录像。

1. 拖动两端的手柄，修剪开头和结尾。
2. 要剪掉中间某一段，用 I 和 O 标出，然后按 X。按 ⌘Z 撤销。
3. 裁切为 16:9、9:16、1:1 或 4:3。
4. 存储为 HEVC、H.264、ProRes、GIF 或纯音频副本。

原始文件永远不会被修改。每次编辑都会在旁边另存一个新文件，命名为“(edited)”“(1080p)”等。

## 缩放和背景

聚焦和画框会在你存储副本时加上，从不写进原始文件。

- **聚焦**会在你点按和输入的位置平滑放大，并让指针移动更顺滑。每次放大都会显示在时间线上，你可以移动、修改或删除。
- **画框**把窗口或区域放到背景上，加上留白、圆角和阴影。

## 文字稿、字幕和章节

Bingsu 使用 Apple 的设备端语音模型生成带时间码的文字稿。不上传任何内容，也不消耗任何额度。在支持 Apple Intelligence 的 Mac 上，它还会生成标题、简短摘要和章节。

- 在分享页上显示字幕，或把字幕烧录进视频副本。
- 在文字稿中删除文字，即可剪掉对应的视频片段。
- 你的 Mac 支持的所有语言都可以使用。某种语言第一次使用时，macOS 会下载它的模型。

可在“Settings”>“General”>“Understand recordings”中关闭此功能。

## 分享页面

Bingsu 会把录像变成一个文件夹，这个文件夹就是一个完整的网站：播放器、标题、章节、文字稿和字幕。你把它发布到你平时托管网站的地方。我们永远看不到这个页面、它的链接或它的观看者。

| 托管 | 发布文件夹的方式 |
| --- | --- |
| Cloudflare Pages | `npx wrangler pages deploy <folder> --project-name <name>` |
| Vercel | `npx vercel deploy <folder> --prod --yes` |
| Netlify | `npx netlify-cli deploy --dir <folder> --prod` |
| GitHub Pages | `npx gh-pages --add -d <folder> -e <name>` |
| ChatGPT Sites | 在 ChatGPT 应用中让 Codex 发布这个文件夹 |

发布前先在 Mac 上预览页面。除非你开启，否则页面不提供视频下载。任何拿到地址的人都能观看，所以只把地址发给要看的人。

## 连接 AI 智能体

把 [bingsustudio.com/agents](https://bingsustudio.com/agents/#connect) 上的连接提示词复制到你的智能体应用中：ChatGPT Mac 版、Claude、Codex、Cursor、Grok Build 等。它会把 Bingsu 添加为本地 MCP 服务器，检查能否正常工作，并告诉你它能做什么。同一页面也列出了每个应用的手动设置步骤。

智能体第一次请求录制时，Bingsu 会在自己的窗口里询问你。“Settings”>“Agents”列出你允许过的每个智能体，并可点“Revoke”。

## 让智能体来录制

用你自己的话提要求。例如：

- “运行测试时录下这个窗口，关掉声音。完成后停止录制、检查文件，并告诉我文件在哪里。”
- “把设置窗口录 20 秒，然后用它做一个分享页，把文件夹给我。”
- “把我的浏览器以 60 fps 录 30 秒，然后存一个小于 10 MB 的 GIF 副本。”

智能体先用 `bingsu_screenshot` 查看画面，再用 `bingsu_start` 录制，只有当检查结果为 `ok` 时才信任这个文件。它的录制会带着它的名字显示在你的菜单栏中，你随时可以停止。

## 智能体能做什么

| 工具 | 作用 |
| --- | --- |
| `bingsu_sources` | 列出显示器、窗口、应用、麦克风和摄像头，附带 id |
| `bingsu_screenshot` | 录制某个来源时画面会是什么样，一模一样地呈现 |
| `bingsu_start` | 录制一个来源；配合 `seconds` 和 `wait`，返回已保存并检查过的文件 |
| `bingsu_wait`, `bingsu_stop`, `bingsu_pause` | 等待、停止或暂停智能体自己的录制 |
| `bingsu_status` | 正在录制什么、还能再录多少、剩余磁盘空间 |
| `bingsu_recordings`, `bingsu_verify` | 最近的录像及其检查结果；重新检查文件 |
| `bingsu_export` | 生成修剪、剪切、裁切或转换格式后的副本；从不覆盖原文件 |
| `bingsu_understand` | 文字稿、标题、摘要和章节，都在 Mac 本机生成 |
| `bingsu_share_page` | 为录像生成一个网站文件夹，可直接发布 |
| `bingsu_mark`, `bingsu_script`, `bingsu_presenter` | 命名步骤、旁白脚本，以及配音或出镜片段 |

每个错误都有稳定的 `error` 代码、`message` 和 `fix`。

## 让多个智能体同时录制

- 每个智能体只能录制、停止和暂停它自己的录像。你能在菜单栏中看到所有录制，并可以停止其中任何一个。
- 智能体录制窗口和应用时，会获取该应用的声音，但不会从你的扬声器里播放出来。
- 智能体用自己的工具操作浏览器，从不使用你的指针或键盘。
- Bingsu 从不为了多容纳一段录制而降低画质。编码器满载时，智能体会在开始前收到 `busy`，或用 `queue: true` 排队等待。
- 需要整块屏幕的智能体可以用 `bingsu display add` 创建自己的虚拟显示器。

## 智能体使用摄像头和麦克风

在你于“Settings”>“Agents”中打开“Can use the camera and microphones”之前，智能体无法使用摄像头或麦克风。此项默认关闭。未开启时，请求使用它们的智能体会收到 `devices_off`，而且录制从不会自行打开它们。

## 使用命令行

`bingsu` 命令能做 MCP 工具能做的事，返回相同的 JSON 结果。

```
bingsu record "Safari" --for 30s --json
bingsu edit <id> --start 3.5 --end 1:20 --format gif --max-mb 10
bingsu share-page <id> --title "Design review, new onboarding"
```

退出码 3 表示文件已保存，但检查发现了问题。把 `BINGSU_SESSION` 设为你的脚本独有的值，这样它的录像就只归它自己管。

## 更新

Bingsu 每天检查一次更新，方法是下载一个列出最新版本的小文件。这个请求只告诉服务器你的版本号，别的什么都不发送。每次更新都有签名，Bingsu 只安装签名匹配的更新。可在“Settings”中关闭检查。使用 Homebrew 时，运行 `brew upgrade`。

## 隐私

录像、文字稿和设置都留在你的 Mac 上。没有账户、没有分析、没有崩溃报告，也没有遥测。你连接的智能体能看到 Bingsu 返回给它的内容，例如文件路径、截图和文字稿，它的应用可能会依照自己的条款把这些内容发送到它自己的服务器。请阅读[隐私政策](https://bingsustudio.com/privacy/)。

## 解决问题

| 错误 | 处理方法 |
| --- | --- |
| `permission` | 在“系统设置”>“隐私与安全性”>“录屏与系统录音”中允许 Bingsu |
| `sound_permission` | 在 macOS 询问时允许，或关掉声音录制 |
| `device_permission` | 在“系统设置”>“隐私与安全性”中允许使用摄像头或麦克风 |
| `devices_off` | 在“Settings”>“Agents”中打开“Can use the camera and microphones” |
| `agents_off` | 在“Settings”>“Agents”中重新打开脚本和智能体 |
| `not_found` | 窗口、应用或录像已经不在了；`fix` 会列出现有的内容 |
| `disk_full` | 腾出一些空间；Bingsu 需要 1 GB |
| `busy` | 停止一个录制，或用 `queue: true` 开始 |
| `not_yours` | 不填 id，即可操作你自己的录制 |

还是没解决？[在 GitHub 上提交 issue](https://github.com/PapayaSound/bingsu/issues)。

## 卸载

1. 从 Bingsu 的菜单中退出 Bingsu。
2. 把 Bingsu 从“应用程序”拖到废纸篓。
3. 删除命令：`rm ~/.local/bin/bingsu`
4. 从你的智能体中移除它，例如 `claude mcp remove bingsu`。

你的录像会一直保存在 `~/Movies/Bingsu`，直到你删除它们。

## 下次，直接*演示*给人看。

录一次，发个链接就行。也可以让你的智能体来录。

[下载 版](https://docs.bingsustudio.com/zh-cn/download/#all) [连接你的智能体](https://docs.bingsustudio.com/zh-cn/agents/#connect)