文档 · Bingsu

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

安装 Bingsu

## Install Bingsu

1. [Download Bingsu for Mac](https://bingsustudio.com/download/). It needs macOS 26 Tahoe or later.
2. Open `Bingsu.dmg` from your Downloads folder and drag Bingsu to Applications.
3. Open Bingsu. It lives in the menu bar, not the Dock.

With Homebrew instead:

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

To check the file before you open it, compare its SHA-256 with the one on the [download page](https://bingsustudio.com/download/#verify):

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

On Windows:

1. [Download Bingsu for Windows](https://bingsustudio.com/download/#windows). It needs Windows 10 (version 2004) or later.
2. Open `Bingsu.msix` from your Downloads folder and choose Install.
3. Open Bingsu from the Start menu.

On Linux:

1. [Download Bingsu for Linux](https://bingsustudio.com/download/#linux). It needs GNOME or KDE on Wayland with PipeWire; X11 works too.
2. Make the file runnable and open it:

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

下载 Mac 版 Bingsu。需要 macOS 26 Tahoe 或更高版本。
在“下载”文件夹中打开 Bingsu.dmg，把 Bingsu 拖到“应用程序”文件夹。
打开 Bingsu。它在菜单栏里，不在程序坞中。

也可以用 Homebrew 安装：

brew install --cask bingsu

打开文件前如需校验，请将它的 SHA-256 与下载页面上的值进行比对：

shasum -a 256 ~/Downloads/Bingsu.dmg

Windows 上：

下载 Windows 版 Bingsu。需要 Windows 10（2004 版）或更高版本。
在“下载”文件夹中打开 Bingsu.msix，选择“安装”。
从开始菜单打开 Bingsu。

Linux 上：

下载 Linux 版 Bingsu。需要运行在 Wayland 上并带有 PipeWire 的 GNOME 或 KDE；X11 也可以用。
给文件加上可执行权限，然后打开它：

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

允许屏幕录制

## Allow screen recording

macOS asks once, the first time you record. Turn Bingsu on in System Settings, Privacy & Security, Screen & System Audio Recording, then reopen Bingsu.

The camera and the microphone are separate questions. macOS asks for each only when you first use it. Bingsu never turns either on by itself.

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

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

录制屏幕

## Record your screen

1. Click the Bingsu icon in the menu bar, or press ⌥⇧⌘R from anywhere.
2. Pick what to record: a screen, a window, an app or an area.
3. Press Record. Press Stop and Save when you are done.

Every file is checked after it is saved: its length, its picture, its sound tracks, silence, and whether a window closed. A problem shows as a warning on the recording.

Files go to `~/Movies/Bingsu`. Change the folder in Settings.

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

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

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

选择窗口、应用或区域

## Pick a window, an app or an area

- **A window** keeps recording when other windows cover it, and takes only that app's sound.
- **An app** records all of its windows.
- **An area** records a fixed part of a screen. Drag to draw it.
- **A screen** records everything on that display.

A minimized window sends no picture. The recording repeats its last frame until you bring the window back.

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

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

声音和麦克风

## Sound and microphones

A window or app recording takes that app's sound and nothing else. A screen recording takes the Mac's sound.

Add any number of microphones. Each shows a live level, gets its own track in the file, and goes into one mixed track that every player plays. If a microphone is unplugged, its track stays silent until you plug it back in, and the recording goes on.

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

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

你的摄像头和通话来宾

## Your camera and call guests

Choose a camera in the panel's Camera row. It sits over your recording as a bubble, and it is also saved as its own video track.

- Drag the bubble anywhere. Drag its corner to resize it.
- Make it a circle, a rounded square or wide, and mirror it from its toolbar.
- Right-click it to turn the camera off or hide it.

In Zoom, Meet, Teams, FaceTime, Slack, Discord, Webex or WhatsApp, Bingsu finds the people in the call window and adds each as a bubble, up to five faces. It can follow whoever speaks, or one person. Each guest's voice comes from the call app on its own track. Finding faces runs on your Mac; nothing about a face leaves it or is kept.

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

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

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

暂停、停止和锁屏

## Pause, stop and the lock screen

- Pause and resume leave no gap in the file.
- Give a recording a length and it stops on the exact second.
- When the screen locks, Bingsu pauses and goes on when you sign back in. Change this in Settings.
- If the Mac crashes, Bingsu writes files in two-second pieces and recovers the half-written file the next time it opens.

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

修剪、剪切和裁切

## Trim, cut and crop

Open a recording in the editor.

1. Drag the handles to trim the start and the end.
2. To cut a part out, mark it with I and O, then press X. ⌘Z undoes.
3. Crop to 16:9, 9:16, 1:1 or 4:3.
4. Save a copy as HEVC, H.264, ProRes, a GIF or sound only.

The original is never changed. Each edit saves a new file next to it, named "(edited)", "(1080p)" and so on.

在编辑器中打开录像。

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

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

缩放和背景

## Zoom and backgrounds

Focus and Frame are added when you save a copy, never baked into the original.

- **Focus** zooms in smoothly where you click and type and smooths the pointer. Every zoom shows on the timeline, where you can move, change or remove it.
- **Frame** puts a window or area on a background, with padding, rounded corners and a shadow.

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

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

文字稿、字幕和章节

## Transcript, captions and chapters

Bingsu writes a transcript with times, using Apple's on-device speech model. Nothing is uploaded and nothing costs credits. On a Mac with Apple Intelligence it also writes a title, a short summary and chapters.

- Show captions on a share page, or burn them into a copy of the video.
- Cut the video by deleting words in the transcript.
- Every language your Mac supports works. macOS downloads a language's model the first time it is used.

Turn this off in Settings, General, "Understand recordings".

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

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

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

分享页面

## Share a page

Bingsu turns a recording into a folder that is a whole website: a player, the title, chapters, the transcript and captions. You publish it where you already host sites. We never see the page, its link or its viewers.

| Host | Publish the folder with |
| --- | --- |
| 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 | Ask Codex in the ChatGPT app to publish the folder |

Preview the page on your Mac before you publish. The page offers no download of the video unless you turn it on. Anyone with the address can watch it, so keep the address to the people it is for.

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 智能体

## Connect an AI agent

Copy the connect prompt from [bingsustudio.com/agents](https://bingsustudio.com/agents/#connect) into your agent app: ChatGPT for Mac, Claude, Codex, Cursor, Grok Build and others. It adds Bingsu as a local MCP server, checks that it works and tells you what it can do. The same page lists the steps for each app by hand.

The first time an agent asks to record, Bingsu asks you in its own window. Settings, Agents lists every agent you allowed, with Revoke.

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

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

让智能体来录制

## Ask an agent to record

Ask in your own words. For example:

- "Record this window while you run the tests, with sound off. When you are done, stop, check the file and tell me where it is."
- "Record the Settings window for 20 seconds, then make a share page from it and give me the folder."
- "Record my browser for 30 seconds at 60 fps, then save a GIF copy under 10 MB."

An agent checks the picture first with `bingsu_screenshot`, records with `bingsu_start`, and trusts a file only when its check says `ok`. Its recording shows in your menu bar with its name, and you can stop it at any time.

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

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

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

智能体能做什么

## What an agent can do

| Tool | What it does |
| --- | --- |
| `bingsu_sources` | Lists displays, windows, apps, microphones and cameras, with ids |
| `bingsu_screenshot` | The exact picture a recording of a source would show |
| `bingsu_start` | Records a source; with `seconds` and `wait`, returns the saved, checked file |
| `bingsu_wait`, `bingsu_stop`, `bingsu_pause` | Waits for, stops or pauses the agent's own recording |
| `bingsu_status` | What is recording, room for more, free disk space |
| `bingsu_recordings`, `bingsu_verify` | Recent recordings and their checks; checks a file again |
| `bingsu_export` | A trimmed, cut, cropped or converted copy; never overwrites |
| `bingsu_understand` | Transcript, title, summary and chapters, made on the Mac |
| `bingsu_share_page` | A website folder for a recording, ready to publish |
| `bingsu_mark`, `bingsu_script`, `bingsu_presenter` | Named steps, a narration script, and a voice or presenter clip |

Every error has a stable `error` code, a `message` and a `fix`.

工具	作用
`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。

让多个智能体同时录制

## Let several agents record at once

- Each agent records, stops and pauses only its own recordings. You see all of them in the menu bar and can stop any.
- An agent's window and app recordings take that app's sound without playing it on your speakers.
- Agents drive browsers with their own tools, never your pointer or keyboard.
- Bingsu never lowers quality to fit one more recording. When the encoders are full, an agent hears `busy` before it starts, or waits in line with `queue: true`.
- An agent that needs a whole screen can make its own virtual display with `bingsu display add`.

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

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

## Camera and microphones for agents

Agents can't use the camera or microphones until you turn on "Can use the camera and microphones" in Settings, Agents. It is off at first. Without it, an agent that asks for one gets `devices_off`, and a recording never turns one on by itself.

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

使用命令行

## Use the command line

The `bingsu` command does what the MCP tools do, with the same JSON answers.

```sh
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"
```

Exit code 3 means the file was saved but its check found a problem. Set `BINGSU_SESSION` to a value unique to your script, so its recordings stay its own.

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 设为你的脚本独有的值，这样它的录像就只归它自己管。

更新

## Updates

Bingsu checks for updates once a day by downloading a small file that lists the latest version. The request tells the server your version and nothing else. Each update is signed, and Bingsu installs only an update whose signature matches. Turn the check off in Settings. With Homebrew, run `brew upgrade`.

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

隐私

## Privacy

Recordings, transcripts and settings stay on your Mac. There is no account, no analytics, no crash reporting and no telemetry. An agent you connect sees what Bingsu returns to it, such as file paths, screenshots and transcripts, and its app may send that to its own servers under its own terms. Read the [privacy policy](https://bingsustudio.com/privacy/).

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

解决问题

## Fix a problem

| Error | What to do |
| --- | --- |
| `permission` | Allow Bingsu in System Settings, Privacy & Security, Screen & System Audio Recording |
| `sound_permission` | Allow it when macOS asks, or record with sound off |
| `device_permission` | Allow the camera or microphone in System Settings, Privacy & Security |
| `devices_off` | Turn on "Can use the camera and microphones" in Settings, Agents |
| `agents_off` | Turn scripts and agents back on in Settings, Agents |
| `not_found` | The window, app or recording is gone; the `fix` lists what exists |
| `disk_full` | Free some space; Bingsu needs 1 GB |
| `busy` | Stop a recording, or start with `queue: true` |
| `not_yours` | Leave the id out to act on your own recording |

Still stuck? [Open an issue on GitHub](https://github.com/bingsustudio/bingsu/issues).

错误	处理方法
`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。

卸载

## Uninstall

1. Quit Bingsu from its menu.
2. Drag Bingsu from Applications to the Trash.
3. Remove the command: `rm ~/.local/bin/bingsu`
4. Remove it from your agents, for example `claude mcp remove bingsu`.

Your recordings stay in `~/Movies/Bingsu` until you delete them.

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

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