record 是一款专为 macOS 设计的命令行工具，能够在终端环境中录制麦克风音频、屏幕视频或截图，以及从摄像头捕获视频或照片。该工具特别针对同时服务于人类用户和 AI 智能体而设计，输出文件路径通过标准输出（stdout）打印，状态信息则写入标准错误（stderr），使其具备良好的管道兼容性。在使用前，必须获得用户的明确授权，因为录制音频、屏幕或摄像头会涉及敏感数据，可能引发隐私担忧。因此，在执行任何录制命令之前，系统会主动提示用户确认是否有意进行录制、将要捕获的内容类型及预计时长。 该工具支持三种主要子命令：`record audio` 用于录制麦克风输入的音频；`record screen` 可录制整个屏幕的视频流或单独截取屏幕快照；`record camera` 则用于从连接的摄像头录制视频或拍摄静态照片。每种子命令都提供丰富的参数选项，例如 `–duration` 可用于设定录制时长，确保非交互式环境下命令能自动终止。此外，用户还可以通过 `–list-devices`、`–list-displays`、`–list-windows` 和 `–list-cameras` 等选项列出可用的输入设备，方便选择目标源。所有子命令均支持 `–json` 参数以生成结构化的机器可读输出，便于集成到自动化脚本或工作流中。
核心功能特点
- 支持录制麦克风音频、屏幕视频/截图及摄像头视频/照片
- 输出文件路径通过 stdout 输出，状态信息写入 stderr，兼容命令行管道操作
- 支持 JSON 格式输出，便于 AI 智能体解析和处理结果
- 提供设备列表功能（音频设备、显示器、窗口、摄像头），方便选择录制源
- 可通过 –duration 参数控制录制时长，避免交互式等待
- 支持自定义输出路径和覆盖已有文件
适用场景
record 工具非常适合需要在终端中快速执行多媒体捕获任务的场景。对于开发者或运维人员来说，它可以在不依赖图形界面的情况下，直接从命令行发起屏幕录制或音频采集，尤其适用于远程协作、故障排查演示或自动化测试流程中记录操作过程。例如，当需要向团队展示某个应用崩溃时的界面状态时，只需在终端运行 `record screen –duration 10 –output /tmp/debug.mp4` 即可生成视频文件，无需打开额外软件。 AI 智能体在处理多模态任务时也能充分利用 record 的能力。比如，在一个需要收集用户反馈的工作流中，系统可以先询问用户是否愿意分享一段语音说明，然后调用 `record audio –duration 30 –json` 获取录音文件路径，并将其上传至云端进行分析。同样，在训练视觉模型的数据准备阶段，可以通过脚本批量截取特定应用程序窗口的截图，使用 `record screen –screenshot –window “Safari” –output /data/snapshots/` 实现高效采集。 此外，该工具对权限管理有清晰要求，确保符合 macOS 的安全规范。终端应用必须在系统设置中开启麦克风、屏幕录制或摄像头权限，否则命令将失败。这种设计既保障了用户隐私控制权，又为合法用途提供了便利。无论是个人日常使用还是企业级部署，record 都能以轻量级、无干扰的方式满足多样化的媒体录制需求。