autoRecording · demo videos, scripted

Claude Code / Codex 技能 · 开源 · MIT

把 Web 应用变成
带解说的演示视频

写一个 Python 分镜文件,自动完成录制、1080p60 渲染和逐项核验。旁白可有可无:语言(普通话、英语等十种)和引擎(本机 GPU、本机 CPU、远程 API)由你选。支持 Windows、macOS、Linux。

  • 1920×1080 · 60 fps
  • 镜头 / 标注 / 字幕 / 章节
  • 旁白可选 · 本地 / 远程引擎
Demo

1 分钟看完

示例成片:督办证据工作台。视频中的任务、部门、材料均为模拟数据。 下载 1 分钟 MP4
How

一分钟看懂

01

录制

Playwright 驱动无头 Chromium,按 story 点击、输入、滚动、等待。临时实例独占端口和数据,绝不动正在使用的服务。

02

渲染

逐帧合成 1920×1080、60 fps 视频:推近镜头、框选元素、编号步骤、原文高亮、章节条和字幕。

03

配音与核验

旁白可选:本机 Qwen3-TTS(GPU)、本机 Kokoro(CPU)、远程 API(OpenAI 兼容 / ElevenLabs / 百炼)。Whisper 重听、CAM++ 核对音色、包哈希证明画面未被改动。

  • 旁白可选
  • 十种语言
  • 三种配音引擎
  • Windows / macOS
  • 原文高亮
  • 编号步骤
  • 数字核验
Start

快速开始

git clone https://github.com/OrrrGE/autoRecording \
    ~/.claude/skills/autoDemoRecordingSkill
cd ~/.claude/skills/autoDemoRecordingSkill
python3 scripts/demo_env.py setup

PY=~/.cache/auto-demo-recording/venv/bin/python
$PY scripts/demo_record.py --story examples/selftest/story.py --work /tmp/demo-selftest
$PY scripts/demo_render.py --work /tmp/demo-selftest --check
$PY scripts/demo_render.py --work /tmp/demo-selftest --out /tmp/demo-selftest/selftest.mp4
$PY scripts/demo_voice.py --work /tmp/demo-selftest

录制和渲染不需要显卡。最后一条配音可选:有 NVIDIA 显卡用 Qwen,没有就用 Kokoro(demo_env.py setup --kokoro)或远程 API;不要旁白就跳过。环境检查:python3 scripts/demo_env.py。

Guide

使用教程

隔离应用

用另一个端口和独立数据目录启动副本,例如 DATA_DIR=/tmp/demo-data python -m myapp --port 8799。把数据目录写进 story 的 wipe,每次录制都从相同状态开始。

写 story

复制 story_template.py,填 TITLE、CHAPTERS、launch(),然后用 d.say、d.click、d.zoom、d.mark 写分镜。一条字幕一个意思,字幕同时就是解说稿。

试录、正式录制、检查

demo_record.py --quick 快速抓选择器和状态问题;正式录制后运行 demo_render.py --check,按输出修正,直到没有 注意:。

渲染与配音

demo_render.py --out 生成无声成片;demo_voice.py 加普通话解说。配音检查以 没有发现问题 结尾才算完成。

修改与重跑

改字幕、标注、镜头:重录 → 重渲染 → 重配音。只改配音设置:demo_voice.py build。某一句念错:删掉它的 take,再 demo_voice.py takes N。

Requirements

环境要求

录制 / 渲染

  • Linux / Windows / macOS
  • Python 3.10+
  • ffmpeg:libx264、aac、atempo、ebur128
  • Chromium、Noto Sans CJK
  • 不需要显卡

配音(可选)

  • Qwen:NVIDIA 显卡,约 6 GB 空闲显存
  • Kokoro:任意 CPU,约 400 MB 模型
  • 远程:OpenAI 兼容 / ElevenLabs / 百炼,密钥留本机
  • 十种语言;Whisper + CAM++ 核验
Docs

文档