chore: ruler files update
Signed-off-by: Dmytro Stanchiev <git@dmytros.dev>
This commit is contained in:
136
.claude/skills/huashu-design/scripts/render-narration.sh
Executable file
136
.claude/skills/huashu-design/scripts/render-narration.sh
Executable file
@@ -0,0 +1,136 @@
|
||||
#!/usr/bin/env bash
|
||||
# render-narration.sh · 一条龙：HTML 解说动画 → 最终 MP4（带人声）
|
||||
#
|
||||
# 流水线：
|
||||
# 1. render-video.js 录无声 MP4（按 timeline.totalDuration）
|
||||
# 2. mix-voiceover.sh 混入 voiceover.mp3（可选 BGM）
|
||||
# 3. 输出 <basename>-narrated.mp4
|
||||
#
|
||||
# Usage:
|
||||
# bash render-narration.sh <html> --timeline=<path> [options]
|
||||
#
|
||||
# Required:
|
||||
# <html> 解说动画的 HTML（应内嵌 NarrationStage + recording 模式 rAF 自驱）
|
||||
# --timeline=<path> timeline.json 路径（自动读 totalDuration 和 voiceover.mp3 路径）
|
||||
#
|
||||
# Optional:
|
||||
# --bgm-mood=<name> BGM 预设（educational / tech / tutorial / ...）
|
||||
# --bgm=<path> 自定义 BGM 文件
|
||||
# --bgm-volume=<0-1> BGM 静态音量，默认 0.18
|
||||
# --no-ducking 关 sidechain ducking
|
||||
# --keep-silent 保留中间产物（无声 MP4），便于 debug
|
||||
# --out=<path> 输出路径，默认 <html-basename>-narrated.mp4
|
||||
# --width=<px> 视频宽度（默认 1920）
|
||||
# --height=<px> 视频高度（默认 1080）
|
||||
#
|
||||
# Examples:
|
||||
# bash render-narration.sh demo.html --timeline=_narration/timeline.json
|
||||
# bash render-narration.sh demo.html --timeline=_narration/timeline.json --bgm-mood=educational
|
||||
#
|
||||
set -e
|
||||
|
||||
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
|
||||
SKILL_ROOT="$SCRIPT_DIR/.."
|
||||
|
||||
HTML=""
|
||||
TIMELINE=""
|
||||
BGM_MOOD=""
|
||||
BGM=""
|
||||
BGM_VOLUME="0.18"
|
||||
NO_DUCKING=""
|
||||
KEEP_SILENT=""
|
||||
OUT=""
|
||||
WIDTH="1920"
|
||||
HEIGHT="1080"
|
||||
|
||||
for arg in "$@"; do
|
||||
case "$arg" in
|
||||
--timeline=*) TIMELINE="${arg#*=}" ;;
|
||||
--bgm-mood=*) BGM_MOOD="${arg#*=}" ;;
|
||||
--bgm=*) BGM="${arg#*=}" ;;
|
||||
--bgm-volume=*) BGM_VOLUME="${arg#*=}" ;;
|
||||
--no-ducking) NO_DUCKING="--no-ducking" ;;
|
||||
--keep-silent) KEEP_SILENT="1" ;;
|
||||
--out=*) OUT="${arg#*=}" ;;
|
||||
--width=*) WIDTH="${arg#*=}" ;;
|
||||
--height=*) HEIGHT="${arg#*=}" ;;
|
||||
-*) echo "未知参数：$arg" >&2; exit 1 ;;
|
||||
*) HTML="$arg" ;;
|
||||
esac
|
||||
done
|
||||
|
||||
if [ -z "$HTML" ] || [ ! -f "$HTML" ]; then
|
||||
echo "Usage: bash render-narration.sh <html> --timeline=<path> [options]" >&2
|
||||
exit 1
|
||||
fi
|
||||
if [ -z "$TIMELINE" ] || [ ! -f "$TIMELINE" ]; then
|
||||
echo "✗ 缺 --timeline=<path>（timeline.json 由 narrate-pipeline.mjs 生成）" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# ── 从 timeline.json 读 totalDuration 和 voiceover 路径 ──
|
||||
TIMELINE_DIR="$(cd "$(dirname "$TIMELINE")" && pwd)"
|
||||
TOTAL_DURATION=$(node -e "console.log(JSON.parse(require('fs').readFileSync('$TIMELINE','utf8')).totalDuration)")
|
||||
VOICEOVER_REL=$(node -e "console.log(JSON.parse(require('fs').readFileSync('$TIMELINE','utf8')).voiceover || 'voiceover.mp3')")
|
||||
VOICEOVER="$TIMELINE_DIR/$VOICEOVER_REL"
|
||||
|
||||
if [ ! -f "$VOICEOVER" ]; then
|
||||
echo "✗ voiceover.mp3 不存在: $VOICEOVER" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# 录制时长 = 总时长 + 1s 安全缓冲
|
||||
RECORD_DURATION=$(node -e "console.log(Math.ceil($TOTAL_DURATION + 1))")
|
||||
|
||||
HTML_ABS="$(cd "$(dirname "$HTML")" && pwd)/$(basename "$HTML")"
|
||||
HTML_DIR="$(dirname "$HTML_ABS")"
|
||||
HTML_BASE="$(basename "$HTML" .html)"
|
||||
SILENT_MP4="$HTML_DIR/$HTML_BASE.mp4"
|
||||
|
||||
if [ -z "$OUT" ]; then
|
||||
OUT="$HTML_DIR/$HTML_BASE-narrated.mp4"
|
||||
fi
|
||||
|
||||
echo "═══ render-narration ═══════════════════"
|
||||
echo " HTML: $HTML_ABS"
|
||||
echo " Timeline: $TIMELINE"
|
||||
echo " Voiceover: $VOICEOVER"
|
||||
echo " Total dur: ${TOTAL_DURATION}s (录 ${RECORD_DURATION}s)"
|
||||
echo " 尺寸: ${WIDTH}×${HEIGHT}"
|
||||
[ -n "$BGM_MOOD" ] && echo " BGM mood: $BGM_MOOD"
|
||||
[ -n "$BGM" ] && echo " BGM: $BGM"
|
||||
echo " 最终输出: $OUT"
|
||||
echo "════════════════════════════════════════"
|
||||
|
||||
# ── Step 1: 录无声 MP4 ──────────────────────
|
||||
echo ""
|
||||
echo "▸ Step 1/2 · 录制 HTML 动画 (无声)"
|
||||
NODE_PATH=$(npm root -g) node "$SCRIPT_DIR/render-video.js" "$HTML_ABS" \
|
||||
--duration="$RECORD_DURATION" \
|
||||
--width="$WIDTH" \
|
||||
--height="$HEIGHT"
|
||||
|
||||
if [ ! -f "$SILENT_MP4" ]; then
|
||||
echo "✗ 无声 MP4 没生成: $SILENT_MP4" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# ── Step 2: 混入人声 ──────────────────────
|
||||
echo ""
|
||||
echo "▸ Step 2/2 · 混入人声"
|
||||
MIX_ARGS=("$SILENT_MP4" "--voiceover=$VOICEOVER" "--out=$OUT")
|
||||
[ -n "$BGM_MOOD" ] && MIX_ARGS+=("--bgm-mood=$BGM_MOOD")
|
||||
[ -n "$BGM" ] && MIX_ARGS+=("--bgm=$BGM")
|
||||
[ -n "$BGM_MOOD$BGM" ] && MIX_ARGS+=("--bgm-volume=$BGM_VOLUME")
|
||||
[ -n "$NO_DUCKING" ] && MIX_ARGS+=("$NO_DUCKING")
|
||||
|
||||
bash "$SCRIPT_DIR/mix-voiceover.sh" "${MIX_ARGS[@]}"
|
||||
|
||||
# 清理中间产物
|
||||
if [ -z "$KEEP_SILENT" ]; then
|
||||
rm -f "$SILENT_MP4"
|
||||
fi
|
||||
|
||||
echo ""
|
||||
echo "✓ 完成: $OUT"
|
||||
[ -n "$KEEP_SILENT" ] && echo " (中间产物保留: $SILENT_MP4)"
|
||||
Reference in New Issue
Block a user