核心用法
record 是一款专为 macOS 设计的命令行多媒体捕获工具，提供三大核心功能：
1. 音频录制（record audio）：从系统麦克风捕获音频，支持指定时长、JSON 输出、自定义输出路径
2. 屏幕捕获（record screen）：录制屏幕视频或截取静态截图，支持多显示器、指定窗口、系统/麦克风音频混录
3. 摄像头录制（record camera）：调用内置或外接摄像头录制视频或拍照
工具采用 stdout 输出文件路径、stderr 输出状态信息 的设计，天然支持 Shell 管道和自动化脚本集成。AI 代理可通过 --json 获取结构化数据，通过 --duration 实现非交互式定时录制。
显著优点
- AI/自动化友好：无需 TTY 交互，支持 JSON 输出和管道链式操作
- 功能完备：单工具覆盖音频、视频、截图三大场景，减少依赖碎片化
- 权限管理清晰：明确列出 macOS 系统权限要求（麦克风、屏幕录制、摄像头）
- 设备枚举支持：可列出可用音频设备、显示器、窗口、摄像头，便于动态选择
- 灵活输出控制：支持自定义路径、
--overwrite覆盖、临时目录自动管理
潜在缺点与局限性
- 平台锁定：仅支持 macOS，无跨平台能力（Linux/Windows 需替代方案）
- 外部依赖：需通过 Homebrew 安装，首次使用需配置系统隐私权限
- 非交互模式限制：无
--duration时必须人工按键终止，AI 场景必须显式传参 - 权限门槛：终端应用需提前获得系统隐私授权，否则直接失败
- 无内置压缩/转码：输出格式受系统 API 限制，后期处理需额外工具
适合人群
- 开发者与 DevOps 工程师：构建自动化测试、CI/CD 录屏、文档生成流程
- AI 代理与自动化系统：需要在无头或半交互环境中捕获多媒体
- 技术内容创作者：快速生成终端演示、教程截图、配音素材
- macOS 高级用户：偏好命令行效率，厌恶 GUI 工具的点击操作
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| **隐私泄露** | 录音/录屏/拍照可能捕获敏感信息 | 始终先征求用户明确同意，明确告知录制范围和时长 |
| **权限滥用** | 终端被授予永久权限后可能被恶意脚本利用 | 定期审查「系统设置 > 隐私与安全」中的授权列表 |
| **存储占用** | 未压缩视频/音频可能快速占满磁盘 | 指定 `--output` 到监控目录，配合定时清理任务 |
| **误操作覆盖** | `--overwrite` 可能意外删除已有文件 | 避免在关键目录使用 `--overwrite`，或先检查文件存在性 |