# 从一句话开始

专为大疆无人机航拍打造的 AI 出片工作流。你做导演，AI 负责创意与执行；从 DJI microSD 卡、初选起止点到聊剧本与出片，不定位为通用视频剪辑工具。

准备一个能读写本地文件、执行命令的 AI Agent，以及 Python 3.9+、带 libx264/libx265/AAC 的 FFmpeg 和 ffprobe。脚本不需要额外 Python 包、剪辑 App、安装型 skill 或模型 API key；Agent 服务自身的账号与使用条件另计。

## 首次使用

把仓库位置告诉 Agent，然后说：

> 先读这里的 README.md 和 AGENTS.md，检查并准备依赖。帮我从这张 DJI 卡导入一个项目。我会告诉你初选素材和起止点，然后一起聊剧本，再由你制作。

安装前检查已有环境。常用方式：

- Mac 已有 Homebrew：`brew install python ffmpeg`。
- Arch：`sudo pacman -S python ffmpeg`，保持系统包版本一致，不做局部升级。
- Debian/Ubuntu：`sudo apt install python3 ffmpeg`。
- Windows：使用 python.org 的 Python，以及 ffmpeg.org/download.html 链接的 Windows 构建；也可先让 Agent 查询 winget 当前包信息，再安装选定版本。重新打开终端，通常使用 `py -3` 或 `python` 代替 `python3`，排除商店别名。

运行 `python3 tools/aerial.py doctor` 核实实际可执行文件、编码器和滤镜。首次系统授权由人处理，不假装可以绕过。

## 没有素材也能试

```sh
python3 tools/demo.py /absolute/path/to/new-demo
python3 -m unittest discover -s tests -v
```

使用一个尚不存在的目录。演示会在本地合成色块镜头和测试音，实际执行导入校验、初选记录、预览、10-bit 成片、可选字幕轨与封面提取；加 `--4k` 可做短 4K 输出。不需要私人影片、旧成片、DJI 品牌素材或下载音乐。测试音只验证链路，不代表创作效果。

## 创作 Flow

插卡 → 聊天要求导入 → 复制校验与素材索引 → 你查看素材并给初选和起止点 → 聊故事和剧本 → AI 二次选材、编排、找配乐和执行制作 → 看预览、听音乐、聊天反馈 → 定稿导出 → 可选归档和影院。

你不需要写配置或手敲命令，Agent 按工作流 (in starter: docs/agent-workflow.md)操作。初选圈定可用素材池，不意味着全部完整采用；明确要求保留的动作或排除镜头会成为硬约束。剧本、时间线和执行记录保存在作品目录，换会话或换 Agent 可继续。

插卡不会自动启动后台程序；卡候选发现与实际设备身份确认分开，默认只导入声明范围，原片不动。观看试听可用普通播放器，不需要剪辑 App。

## 能力边界

通用脚本负责 SDR 直切、保比例缩放、8/10-bit 软件编码、音乐响度与淡化、可选 SRT 字幕轨、预览与技术校验；字幕不烧录字体，原片声音默认不进入这个基础渲染器。HDR/BT.2020 已知输入会拒绝，未知 Log/HDR 需 Agent 检查，不自动乱标色彩。

路线、调色、照片推进、烧录排版、叠化和拼屏仍可由 Agent 参考项目文档、编写作品专属命令行脚本；它们不是通用脚本已支持的开关。选曲、许可核实与审美判断不等于字段填写成功。4K 软件编码可能较慢。

OpenClaw、GPT Dot、Grokbot、Claude Code、Codex CLI 等是否可用，取决于实际配置能否访问本机和执行命令，不凭品牌承诺全兼容。平台验证范围见兼容性 (in starter: docs/compatibility.md)。Windows 归档与观星台影院 (in starter: docs/optional-integrations.md)是可选项，其他人不用配置作者的设备。原始代码和原创文档为 MIT，第三方素材另计。