不启动浏览器也能做视频动效：Geneva 用 JSON 与 HTML/CSS 驱动剪辑

给视频加标题卡、字幕条或片头动画，常见做法是把 HTML 页面交给浏览器逐帧截图，再交给 FFmpeg 编码。这条管线灵活，却也多了浏览器依赖、进程协调和逐帧截图开销。Geneva 走了另一条路：它是一个 Rust 编写的命令行视频编辑器，剪辑工程用 JSON 描述，图形层用 HTML/CSS 编写，但排版与绘制由原生渲染器完成，不需要启动 Chromium。

它尤其适合开发者把视频处理纳入脚本或 Agent 工作流：输入和输出都能明确描述，工程文件可以纳入版本控制，重复渲染也比手工点选更容易复现。Geneva 使用 FFmpeg 的媒体编解码库；项目页面说明支持 Linux x64/arm64、Apple 芯片 Mac 和 Windows x64，许可证为 MIT。

从几条常用命令开始

Geneva 将常见剪辑操作包装成 CLI。例如裁剪片段、拼接并添加转场、转换格式、烧录字幕和探测媒体信息：

geneva trim match.mp4 -o goal.mp4 --from 41:10 --to 41:40
geneva concat day1.mp4 day2.mp4 -o trip.mp4 --crossfade 1s
geneva convert talk.mov -o talk.mp4 --for web
geneva subtitles talk.mp4 -o talk-subbed.mp4 --burn talk.srt
geneva probe talk.mp4

每条命令都会转换成 JSON 文档再渲染，--show-timeline 可以打印对应时间线。这样的设计把“快捷命令”和“可检查的工程描述”连接起来：先用 CLI 处理常见任务，遇到复杂合成时再直接编辑文档。

用 HTML/CSS 做标题卡

Geneva 的一个有辨识度的能力，是把 HTML 文件当作图形素材。下面是官方 README 中的简化结构：HTML 负责卡片内容与样式，JSON 则把视频和卡片放到图层中，并指定卡片出现的时间段。

<div class="card">
  <h1>Dragon CRS-17</h1>
  <p>BERTHING AT THE ISS · NASA</p>
</div>

{
  "geneva": "1.1",
  "output": { "width": 1280, "height": 720, "fps": 30 },
  "assets": {
    "iss": { "src": "iss.mp4" },
    "card": { "src": "card.html" }
  },
  "layers": [
    { "id": "footage", "clips": [
      { "source": { "kind": "video", "asset": "iss" } }
    ] },
    { "id": "card", "clips": [
      { "source": { "kind": "html", "asset": "card" },
        "start": "2s", "duration": "4s" }
    ] }
  ]
}

渲染时运行 geneva render edit.json -o dragon.mp4。官方示例还展示了 CSS 动画、相对画面尺寸的百分比定位、字幕以及多图层合成。需要注意，Geneva 不是完整浏览器：文档列出 Flexbox、渐变、阴影、滤镜、裁切路径和 @keyframes 等支持项，同时明确不支持 CSS Grid、浮动、静态 transform、transition 和 JavaScript。把网页视觉直接搬进工程前，应先对照其标记支持列表。

为什么 Agent 工作流会用得上

当 Agent 生成视频包装素材时，传统“打开浏览器、截帧、再编码”的方式需要协调多种工具。Geneva 把编辑描述、图形素材和渲染命令放在一个工程里；其 README 还提到 geneva guide 可输出手册、geneva explain 可解释诊断信息，并支持命令的 JSON 格式输出。这些接口让自动化程序更容易读取能力说明和处理错误，而不是只能解析人类可读的界面。