AOI Demo Clip Maker（macOS）

S-DNA：AOI-2026-0215-SDNA-CLIP01

这是什么

一款仅通过终端运行（面向公众安全）的实用技能，专为在macOS上制作黑客松演示视频而设计。

该工具封装了 ffmpeg/ffprobe，支持以下功能：

• 列出音视频捕获设备（avfoundation）
• 录制指定时长的屏幕画面
• 裁剪顶部状态栏（菜单栏 / 标题栏）
• 剪辑视频片段
• 提供简易预设配置

这不是什么

• 不支持上传至 YouTube
• 不涉及表单提交
• 不执行任何外部发布操作
• 不处理任何密钥或敏感信息

运行要求

• macOS 系统
• 已安装 ffmpeg 和 ffprobe
• 终端应用已获得“屏幕录制”系统权限

命令说明

1）列出可用设备（avfoundation）

aoi-clip devices

2）录制屏幕

# 默认启用 pixel_format 自动回退机制
# （尝试顺序：uyvy422 → nv12 → yuyv422 → 0rgb → bgr0）
aoi-clip record --out tempo_demo_raw.mp4 --duration 15 --fps 30 --screen "Capture screen 0"

# 可选：强制指定特定 pixel format
# aoi-clip record --out tempo_demo_raw.mp4 --duration 15 --fps 30 --screen "Capture screen 0" --pixel uyvy422

3）裁剪顶部状态栏

# 手动指定裁剪高度
aoi-clip crop --in tempo_demo_raw.mp4 --out tempo_demo_crop.mp4 --top 150

# 根据视频高度自动推荐裁剪值（仍会执行裁剪，但自动选择 top 值）
aoi-clip crop --in tempo_demo_raw.mp4 --out tempo_demo_crop.mp4 --top auto

4）剪辑视频

aoi-clip trim --in tempo_demo_crop.mp4 --out tempo_demo_15s.mp4 --from 0 --to 15

5）预设：terminal

aoi-clip preset terminal --out demo.mp4

安全与审计策略

本技能仅本地调用 ffmpeg/ffprobe，且对可执行二进制文件及命令行参数采用严格白名单机制进行管控。

发布治理（公开）

我们免费发布 AOI 技能，并持续优化改进。每次发布均须通过我们的安全审查门禁（Security Gate），并附带可审计的变更日志（changelog）。我们不会发布任何削弱安全性或模糊许可证条款的更新。若重复违反政策，将触发渐进式限制措施（警告 → 暂停发布 → 存档下线）。

支持

• 问题反馈 / Bug 报告 / 功能请求：https://github.com/edmonddantesj/aoi-skills/issues
• 请在提交时注明技能标识符（slug）：aoi-demo-clip-maker

许可证

MIT