核心用法
AOI Demo Clip Maker 是一款面向 macOS 用户的命令行录屏工具，专为黑客松、技术演示和快速原型展示设计。用户通过简单的子命令即可完成从设备发现到成片输出的完整 workflow：
1. 设备枚举：aoi-clip devices 调用 avfoundation 列出可用采集设备
2. 屏幕录制：aoi-clip record 支持自定义分辨率、帧率、时长，内置像素格式自动降级策略（uyvy422 → nv12 → yuyv422 → 0rgb → bgr0），确保兼容性
3. 智能裁剪：aoi-clip crop 可移除 macOS 顶部菜单栏/标题栏，避免敏感信息泄露
4. 精准修剪：aoi-clip trim 按时间码截取片段，精确到秒级控制
5. 场景预设：aoi-clip preset terminal 一键应用终端演示优化参数
显著优点
- 完全本地化：仅调用系统 ffmpeg/ffprobe，无网络传输、无云端依赖，杜绝数据外泄风险
- 权限最小化：严格限定 Screen Recording 权限仅作用于终端应用，不请求麦克风、摄像头等无关权限
- 审计友好：采用白名单机制限制可执行二进制文件及参数组合，便于企业安全团队审查
- 零配置开箱：自动像素格式回退、预设场景模板，降低 ffmpeg 学习成本
- 开源可信：MIT 协议发布，代码可审计，符合企业开源合规要求
潜在局限
- 平台受限：仅支持 macOS，Windows/Linux 用户无法直接使用
- 依赖外部二进制：需预装 ffmpeg/ffprobe，未提供捆绑版本，增加部署复杂度
- 功能边界明确：明确排除 YouTube 上传、表单提交、密钥处理等能力，不适合需要一键分发的场景
- 无 GUI 界面：纯终端交互，对非技术用户存在使用门槛
适合人群
- 参与黑客松、技术竞赛的开发者
- 需要录制 CLI 演示、API 调试过程的技术博主
- 企业内部培训、Code Review 录屏存档的工程师
- 重视数据主权、拒绝 SaaS 录屏方案的安全敏感团队
常规风险
- 权限配置风险：若 Screen Recording 权限授予不当，可能导致录制失败或需反复授权
- ffmpeg 版本差异：不同版本 ffmpeg 的 avfoundation 实现存在行为差异，可能出现编码失败
- 存储敏感信息：用户需自行确保输入/输出路径不包含敏感文件，工具本身不做内容审查
- 供应链风险：依赖系统环境内的 ffmpeg，若来源非可信渠道（如非官方 Homebrew）可能引入恶意代码
治理与更新
技能遵循 AOI 公开发布治理模型：所有更新必须通过安全门控，附带可审计变更日志；安全或许可违规将触发渐进式限制（警告→暂停发布→归档），确保长期维护质量。