Record screen, microphone or camera from macOS terminal

🎥 终端一键录屏录音录像

macOS 终端录屏、录音、录像命令行工具,支持 AI 代理非交互式调用,输出结构化 JSON,需用户明确授权。

收藏
8.8k
安装
2.3k
版本
0.1.0
CLS 安全性认证2026-08-11
点击查看完整报告 >

使用说明

record 是一款专为 macOS 设计的命令行多媒体捕获工具,支持麦克风录音、屏幕录制/截图、摄像头录像/拍照三大核心功能。其设计亮点在于管道友好:文件路径输出至 stdout,状态信息输出至 stderr,便于脚本和 AI 代理捕获处理。通过 --json 参数提供结构化输出,--duration 参数支持非交互式定时录制,解决了自动化场景下"等待按键终止"的痛点。

显著优点

  • 一体化设计,单工具覆盖音频/视频/图像捕获需求
  • 安装便捷,Homebrew 一键部署
  • 权限管理透明,遵循 macOS 隐私安全框架
  • 灵活的输出控制,支持自定义路径和覆盖选项
  • 支持系统音频+麦克风混合录制场景

潜在局限

  • 仅支持 macOS 平台,跨平台兼容性为零
  • 首次使用需手动配置终端应用的隐私权限(麦克风/录屏/摄像头)
  • 作为第三方开源工具(atacan/tap),非 Apple 官方出品,长期维护依赖社区
  • 无内置文件管理或云同步功能

适合人群

  • 开发者与 DevOps 工程师,需要自动化截图/录屏集成到 CI/CD 或文档生成流程
  • AI 代理开发者,构建需要感知 macOS 桌面环境的智能体
  • 技术内容创作者,追求命令行效率与脚本化工作流
  • 隐私敏感用户,偏好本地工具而非云服务

常规风险

  • 隐私泄露:录音/录像/截图可能捕获敏感信息,工具强制要求用户明确授权机制,但代理自动调用时仍需人工确认
  • 权限持久化:终端应用获得录屏/摄像头权限后,后续调用不再提示,存在滥用风险
  • 存储管理:临时目录自动生成的文件若未清理可能累积占用空间
  • 供应链风险:Homebrew tap 第三方维护,需关注更新源可信度

总体评估为专业级效率工具,在受控场景下能显著提升自动化多媒体处理效率,但不适合普通用户日常替代系统原生截图工具。

安全解读

核心用法

record 是一个专为 macOS 设计的命令行多媒体录制工具,通过 Homebrew 分发安装。它提供三大核心子命令:record audio(麦克风录音)、record screen(屏幕录制/截图)、record camera(摄像头录制/拍照)。AI 代理使用时可通过 --duration 参数实现非交互式录制,通过 --json 获取结构化输出路径,便于下游任务链处理。工具支持设备枚举(--list-devices)、指定输出路径(--output)、屏幕音频混合录制等进阶功能,完全适配脚本自动化场景。

显著优点

终端原生集成:直接输出文件路径到 stdout,状态信息分离到 stderr,完美兼容 shell 管道和变量捕获,是自动化工作流的理想组件。结构化数据支持--json 开关为 AI 代理提供机器友好的输出格式,消除路径解析的不确定性。多模态覆盖单一工具:音频、视频、图像三种采集需求统一接口,降低工具链复杂度。权限提示完善:文档明确标注所有敏感权限需求(麦克风、屏幕录制、摄像头),强制要求用户显式授权,符合隐私合规最佳实践。

潜在缺点与局限性

平台锁死:仅支持 macOS 系统,跨平台部署不可行。外部依赖风险:底层二进制通过个人开发者 Homebrew Tap 分发,非官方 Homebrew Core,长期维护稳定性存疑。TTY 依赖陷阱:未指定 --duration 时等待键盘输入终止,在无真实 TTY 的环境(如某些 CI/CD)将陷入阻塞。权限配置繁琐:首次使用需在系统设置中手动授权三项敏感权限,无法通过命令行自动化完成,打断流畅体验。

适合的目标群体

macOS 自动化开发者:需要将音视频采集嵌入 shell 脚本、Makefile 或 CI 流水线的工程师。AI Agent 构建者:为 macOS 环境智能体赋予感知能力的开发者,可利用其结构化输出实现"录制→上传→分析"闭环。技术内容创作者:追求命令行效率的教程博主、直播主,快速生成演示素材而无须打开图形界面。隐私敏感型用户:偏好开源工具、可审计代码来源,不愿使用闭源商业录屏软件的技术人群。

常规风险

性能开销:持续屏幕录制(尤其高分辨率+系统音频)将显著消耗 CPU 与磁盘 I/O,长时任务需评估系统负载。依赖项单点故障:若 atacan/tap/record Tap 下线或二进制兼容性问题出现, Skill 将完全失效,建议锁定版本或本地缓存二进制。隐私泄露误操作:AI 代理若未严格遵循"显式用户授权"要求,可能在用户不知情时触发敏感权限,引发合规风险。输出目录管理:默认临时目录可能触发 macOS 的安全删除机制,重要录制务必显式指定 --output 到持久化路径。

Record screen, microphone or camera from macOS terminal 内容

references文件夹
手动下载zip · 5.1 kB
audio.mdtext/markdown
请选择文件