Record screen, microphone or camera from macOS terminal

核心用法

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`，或先检查文件存在性 |

核心用法

该 Skill 是 macOS 平台 record CLI 工具的使用指南，面向需要在终端环境中执行音视频录制任务的用户或 AI Agent。核心能力覆盖三大场景：

1. 音频录制：通过 record audio --duration <秒> 录制麦克风输入，支持 JSON 结构化输出便于脚本解析
2. 屏幕捕获：record screen --duration <秒> 录制屏幕视频，--screenshot 参数实现截图，可选 --audio 叠加系统音或麦克风音
3. 摄像头操作：record camera --duration <秒> 录制视频流，--photo 拍摄静态照片

关键使用模式包括：管道友好设计（文件路径输出至 stdout，状态信息至 stderr）、非交互式录制（必须指定 --duration 确保自动终止）、设备枚举（--list-devices/displays/cameras）以及精确的输出控制（--output 自定义路径）。

显著优点

• 管道化设计：stdout/stderr 分离使该工具完美融入 Shell 脚本和自动化工作流
• 机器可读输出：--json 标志提供结构化数据，降低 AI Agent 解析成本
• 细粒度控制：支持指定显示器、窗口、录制时长、音频来源（系统/麦克风/混合）
• 隐私优先：SKILL.md 强制要求"显式用户同意"作为前置条件，符合 GDPR 数据最小化原则
• 零依赖风险：纯 Markdown 文档型 Skill，无可执行代码、无第三方依赖、无网络请求

潜在缺点与局限性

• 平台锁定：仅限 macOS 系统，无法跨平台使用
• 权限门槛高：需预先在系统设置中授予终端应用麦克风、屏幕录制、摄像头三项敏感权限
• T3 来源可信度：底层工具来自个人开发者维护的 Homebrew Tap（atacan/tap），非知名组织或企业背书
• 功能边界：作为文档型 Skill 不直接执行录制，实际功能依赖用户本地安装的 record 二进制，存在版本兼容性风险
• 交互限制：无 TTY 环境下必须通过 --duration 参数运行，不适合需要人工介入停止的场景

适合的目标群体

• macOS 开发者与 DevOps 工程师：需要自动化屏幕录制用于文档生成、Bug 复现或 CI 可视化
• 技术内容创作者：通过命令行快速生成教程视频素材或截图
• AI Agent 工作流设计者：构建需要多媒体输入的自动化代理流程
• 隐私敏感型用户：偏好本地录制、拒绝云端方案的数据主权捍卫者

常规使用风险

• 权限管理风险：终端应用获得屏幕录制权限后可持续捕获全屏内容，建议按需授权、用完即撤
• 敏感信息泄露：屏幕录制可能意外捕获密码、密钥、私人通讯，建议在录制前清理桌面环境
• 供应链信任：需独立审查 atacan/tap/record 源代码，警惕恶意 Tap 污染
• 临时文件残留：未指定 --output 时文件写入临时目录，存在敏感数据残留风险，建议显式指定安全路径并及时清理