AOI Demo Clip Maker (macOS)

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

功能说明

一个仅限终端运行（公共安全）的实用工具技能，用于在 macOS 上制作黑客松演示视频片段。

它封装了 ffmpeg/ffprobe，实现以下功能：

• 列出可用的捕获设备（avfoundation）
• 录制屏幕 N 秒
• 裁剪顶部菜单栏（标题栏）
• 剪辑视频片段
• 使用简单预设配置

不包含的功能

• 无 YouTube 上传功能
• 无表单提交
• 无外部发布
• 无敏感信息处理

系统要求

• macOS 操作系统
• 已安装 ffmpeg 和 ffprobe
• 已为终端应用授予屏幕录制权限

命令列表

1) 列出设备（avfoundation）

aoi-clip devices

2) 录制屏幕

# 像素格式自动回退已启用（默认行为）
# 尝试顺序：uyvy422 → nv12 → yuyv422 → 0rgb → bgr0
aoi-clip record --out tempo_demo_raw.mp4 --duration 15 --fps 30 --screen "Capture screen 0"

# 可选：强制指定特定像素格式
# 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

# 自动推荐顶部裁剪值（基于视频高度，仍会执行裁剪，但自动选择数值）
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) 预设：终端风格

aoi-clip preset terminal --out demo.mp4

安全与审计策略

此技能仅本地调用 ffmpeg/ffprobe，并使用严格白名单控制可执行的二进制文件和参数。

发布治理（公开）

我们免费发布 AOI 技能，并持续改进。每次发布必须通过安全审查，并附带可审计的更新日志。我们不发布削弱安全性或许可证清晰度的更新。重复违规将触发逐步限制措施（警告 → 发布暂停 → 归档）。

支持渠道

• 问题 / 错误 / 功能请求：https://github.com/edmonddantesj/aoi-skills/issues
• 请在提交时注明技能标识符：aoi-demo-clip-maker

许可证

MIT