---
title: Capture
description: 将电脑上的屏幕、操作和可选音频录制到组织的时间线。
---

Beeuni Capture 是独立安装的录制应用。它记录屏幕、应用、窗口标题、网页地址、屏幕文字和输入操作；组织开启音频后，也会录制音频并生成转录。你可以回看和搜索记录。当前版本负责录制、上传和索引，不会自动将操作整理成技能。

## 开启 Capture

Capture 属于组织账户，不属于项目，默认关闭。拥有 `capture.manage` 权限的人可以在 `/capture` 中选择组织并开启。所有者和管理员默认拥有此权限。关闭后，设备不能登录、上传新记录或获取新的上传凭证。

## 安装 Beeuni Capture

[Windows](/download/capture/windows) · [macOS](/download/capture/macos) · [Linux](/download/capture/linux)

1. 下载适合电脑的安装包并安装。
2. 打开 Beeuni Capture，选择 **使用 Beeuni 登录**。核对浏览器中的代码，再选择已开启 Capture 的组织。
3. macOS 会请求屏幕录制、辅助功能、输入监控和麦克风权限；仅授予需要使用的权限。

## 录制规则和访问权限

在 **Capture → 设置** 中选择录制屏幕、操作或音频，设置录制间隔、分辨率、保留天数、组织暂停和通知。音频默认关闭。实验性隐私设置支持本地个人信息遮盖，以及不录制的应用和网站。设备在录制前应用排除规则。

成员只能查看自己的设备和时间线。`capture.read_all` 允许查看其他成员的记录，相关访问会写入审计日志。`capture.manage` 允许修改组织规则和撤销任意设备。批量安装的设备可以暂不关联成员；管理员可在 **设备** 中关联。

## Agent 和 API

Agent 只能在代表某位成员的私有会话中读取该成员的时间线。共享会话或自动触发的会话不代表个人，读取会返回 `403 capture_no_human`。

使用账户 API Key 调用 API，或通过 TypeScript SDK 的 `beeuni.capture.account(accountId)` 访问。权限与网页相同。

```bash
curl -s -H "Authorization: Bearer $BEEUNI_API_KEY" \
  "https://api.beeuni.ai/v1/accounts/$ACCOUNT/capture/search?q=invoice&limit=5"
```

[SDK](/docs/zh/sdk/reference)

## 批量安装

管理员可在 **Capture → 设备 → 公司安装** 创建注册令牌，批量安装并审批设备。令牌只用于注册，不能读取录制内容。

[查看批量安装步骤](/docs/zh/capture/rollout)

## 停止录制和移除设备

在设备端暂停录制，或由管理员暂停整个组织。撤销设备会立即使设备令牌失效。撤销注册令牌只阻止新设备注册，不会停止已注册的设备。卸载应用不会立即清除电脑上的历史记录。