Skip to content

zenstory-ai/video-recap-skills / skills/video-recap

video-recap

Verified

把一段或多集视频做成带画框字幕的中文解说成片或纯原声高光短片。用户提供 .mp4 / .mov / .mkv / .webm,要求做影视解说、短剧二创、加旁白配音、跨集混剪或导出剪映草稿时使用;串联完成看片识台词、定主线与留原声、按台词停顿切镜头、写词检查、TTS 配音与混音加字幕。触发词:视频解说、影视解说、视频旁白、生成解说、视频 recap、video recap、voiceover、narration、recap。

FileKindSize
SKILL.mdskill md18.4 KB
assets/dashboard/app.jsscript16.2 KB
assets/dashboard/index.htmlother867 B
assets/dashboard/styles.cssother22.6 KB
assets/dashboard/tokens.cssother8.9 KB
assets/dashboard/views.jsscript31.4 KB
references/audio-modes.mdmarkdown3.6 KB
references/config-playbook.mdmarkdown8.1 KB
references/creative-editing-playbook.mdmarkdown12.3 KB
references/data-schema.mdmarkdown34.6 KB
references/index-tts.mdmarkdown2.1 KB
references/jianying/LICENSE.duo-videoother1.0 KB
references/jianying/SOURCE.mdmarkdown703 B
references/jianying/empty_draft_meta_info.jsonconfig1.7 KB
references/jianying/empty_jy_material_video.jsonconfig1.8 KB
references/jianying/empty_jy_meta_material_value.jsonconfig358 B
references/jianying/empty_jy_project_info.jsonconfig3.6 KB
references/jianying/empty_jy_segment.jsonconfig1.3 KB
references/jianying/empty_jy_text_styles.jsonconfig440 B
references/jianying/empty_yj_material_audio.jsonconfig865 B
references/jianying/empty_yj_material_text.jsonconfig2.4 KB
references/packaging.mdmarkdown6.8 KB
references/promotional-copy.mdmarkdown4.1 KB
references/prompt-templates.mdmarkdown2.0 KB
references/research-guide.mdmarkdown2.7 KB
references/resource-library.mdmarkdown12.1 KB
references/shot-review.mdmarkdown4.8 KB
scripts/agent_text.pyscript2.7 KB
scripts/artifacts.pyscript972 B
scripts/asr.pyscript12.5 KB
scripts/asr_timing_evidence.pyscript4.2 KB
scripts/assemble.pyscript31.0 KB
scripts/assemble_constants.pyscript894 B
scripts/assembly_contract.pyscript10.3 KB
scripts/assembly_settings.pyscript3.8 KB
scripts/audio_automation.pyscript6.6 KB
scripts/audio_mix.pyscript18.5 KB
scripts/briefing/__init__.pyscript101 B
scripts/briefing/builder.pyscript31.1 KB
scripts/briefing/context.pyscript6.1 KB
scripts/briefing/timeline.pyscript23.0 KB
scripts/codec_peak.pyscript5.1 KB
scripts/cut.pyscript148 B
scripts/cut_cli.pyscript12.4 KB
scripts/cut_contract.pyscript13.3 KB
scripts/cut_qc.pyscript1.9 KB
scripts/cut_render.pyscript13.2 KB
scripts/dashboard/__init__.pyscript159 B
scripts/dashboard/data.pyscript24.6 KB
scripts/dashboard/io.pyscript7.1 KB
scripts/dashboard/runs.pyscript21.8 KB
scripts/dashboard/templates.pyscript9.6 KB
scripts/dashboard_server.pyscript9.3 KB
scripts/detect.pyscript22.2 KB
scripts/doctor.pyexecutablescript12.9 KB
scripts/entry_suggestion.pyscript4.6 KB
scripts/export_jianying.pyscript5.6 KB
scripts/extract.pyscript2.5 KB
scripts/final_qc.pyscript19.0 KB
scripts/frame_grid.pyscript10.6 KB
scripts/jianying/__init__.pyscript49 B
scripts/jianying/builders.pyscript11.3 KB
scripts/jianying/model.pyscript2.7 KB
scripts/jianying/optional.pyscript1012 B
scripts/jianying/schema.pyscript2.5 KB
scripts/jianying/templates.pyscript1.0 KB
scripts/jianying/timeline_contract.pyscript5.8 KB
scripts/jianying/tracks.pyscript2.0 KB
scripts/jianying/writer.pyscript7.8 KB
scripts/lib.pyscript29.6 KB
scripts/library.pyscript31.1 KB
scripts/lint_summary.pyscript5.0 KB
scripts/loudness.pyscript14.7 KB
scripts/materials.pyscript22.1 KB
scripts/media.pyscript18.8 KB
scripts/narration_audio.pyscript13.5 KB
scripts/narration_lint.pyscript24.1 KB
scripts/narrative_selection.pyscript8.9 KB
scripts/packaging.pyscript6.1 KB
scripts/packaging_fonts.pyscript12.0 KB
scripts/packaging_plates.pyscript31.2 KB
scripts/packaging_studio.pyscript34.1 KB
scripts/providers/__init__.pyscript72 B
scripts/providers/fish_audio.pyscript3.1 KB
scripts/providers/index_tts.pyscript8.8 KB
scripts/recap.pyscript183 B
scripts/recap_cli.pyscript6.9 KB
scripts/recap_inspect.pyscript16.5 KB
scripts/recap_runner.pyscript22.0 KB
scripts/recap_runtime.pyscript11.8 KB
scripts/recap_source.pyscript1.8 KB
scripts/recap_stage_qc.pyscript2.7 KB
scripts/recap_timeline.pyscript7.7 KB
scripts/render_preflight.pyscript1.7 KB
scripts/resources/__init__.pyscript200 B
scripts/resources/lock.pyscript6.8 KB
scripts/resources/project_binding.pyscript16.1 KB
scripts/sentence_boundaries.pyscript28.8 KB
scripts/sentence_gate.pyscript8.6 KB
scripts/sfx_mix.pyscript14.6 KB
scripts/shot_review.pyscript18.9 KB
scripts/source_subtitles.pyscript7.2 KB
scripts/speech_ownership.pyscript9.3 KB
scripts/storyboard.pyscript21.8 KB
scripts/subtitles/__init__.pyscript56 B
scripts/subtitles/core.pyscript19.0 KB
scripts/subtitles/render.pyscript8.0 KB
scripts/timeline.pyscript8.2 KB
scripts/timeline_emit.pyscript5.4 KB
scripts/tts_audio.pyscript9.6 KB
scripts/tts_cache.pyscript4.5 KB
scripts/understand.pyscript171 B
scripts/understanding_brief.pyscript6.3 KB
scripts/understanding_cache.pyscript8.0 KB
scripts/understanding_runner.pyscript9.8 KB
scripts/understanding_storyboard.pyscript11.9 KB
scripts/validate.pyscript5.7 KB
scripts/visual_render.pyscript10.1 KB
scripts/vlm.pyscript16.4 KB
scripts/voiceover.pyscript28.0 KB

scripts/source_subtitles.py

View on GitHub
"""Agent-calibrated original-dialogue subtitle loading and gap placement."""

from artifacts import _load_work_json
from audio_mix import _seg_place_window
from lib import CONFIG, log
from assemble_constants import (
    _MIN_GAP_TO_SUBTITLE,
    _MIN_READABLE_SECONDS,
)
from subtitles.core import (
    _bracketed_original_chunks,
    _bridge_narration_micro_gaps,
    _subtitle_entries,
)


def _source_subtitle_mask():
    """Whether the source-subtitle mask runs, and why, for visual QC and the manifest.

    Masking is opt-in (MASK_SOURCE_SUBTITLES, or a measured --subtitle-y-top/bot band) and
    needs burned recap subtitles: a mask-only band would hide captions without replacing them.
    """
    burn = CONFIG["burn_subtitles"]
    requested = CONFIG["mask_source_subtitles"]
    active = requested and burn
    if not requested:
        trigger = "mask_off"
        reason = "source subtitle masking not requested"
    elif burn:
        trigger = "burned_subtitles"
        reason = "masking runs only with burned recap subtitles"
    elif CONFIG["burn_subtitles_degraded"]:
        trigger = "burn_subtitles_degraded"
        reason = (
            "subtitle burn-in degraded to the .srt sidecar; a mask-only black band is "
            "forbidden without burned recap subtitles"
        )
    else:
        trigger = "burn_subtitles_disabled"
        reason = "mask-only black band is forbidden without burned recap subtitles"
    return {
        "active": bool(active),
        "scope": (
            "measured_source_subtitle_band"
            if active and 0 <= CONFIG["subtitle_y_top"] < CONFIG["subtitle_y_bot"]
            else ("bottom_source_subtitle_band" if active else "none")
        ),
        "trigger": trigger,
        "reason": reason,
        "burn_subtitles": burn,
    }


def _load_agent_original_subtitles(work_dir):
    """Agent-calibrated original-dialogue subtitles (`original_subtitles.json`).

    OUTPUT-time `[{start, end, text}]` authored alongside `narration.json`. Only clean,
    verified lines actually audible in narration gaps belong here — never coarse ASR guesses.
    """
    if work_dir is None:
        return None
    data = _load_work_json(work_dir, "original_subtitles.json")
    if not data:
        return None
    out = []
    for index, row in enumerate(data, start=1):
        try:
            start, end, text = float(row["start"]), float(row["end"]), str(row["text"]).strip()
        except (KeyError, TypeError, ValueError) as exc:
            raise ValueError(
                f"original_subtitles.json 第 {index} 条缺少或无法解析 start/end/text: {row!r}"
            ) from exc
        if end <= start or not text:
            raise ValueError(
                f"original_subtitles.json 第 {index} 条无效(需要 end > start 且 text 非空): {row!r}"
            )
        out.append({"start": start, "end": end, "text": text})
    return out or None


def _narration_gap_windows(tts_segments, video_duration, min_gap=_MIN_GAP_TO_SUBTITLE):
    """OUTPUT-timeline stretches with NO narration (the original-audio blocks)."""
    placed = sorted(map(_seg_place_window, tts_segments), key=lambda w: w[0])
    merged = []
    for s, e in placed:
        if e - s <= 0:
            continue
        if merged and s <= merged[-1][1]:
            merged[-1][1] = max(merged[-1][1], e)
        else:
            merged.append([s, e])
    gaps, cursor = [], 0.0
    for s, e in merged:
        if s - cursor >= min_gap:
            gaps.append((cursor, s))
        cursor = max(cursor, e)
    if video_duration - cursor >= min_gap:
        gaps.append((cursor, float(video_duration)))
    return gaps


def _source_subtitle_mask_covers_gaps():
    """Whether the effective source mask hides hardcoded subtitles outside narration."""
    if not _source_subtitle_mask()["active"]:
        return False
    return CONFIG["subtitle_mask_opacity"] >= 1.0 - 1e-9 and CONFIG["source_subtitle_mask_timing"] == "all"


def _source_subtitles_already_visible_in_gaps():
    """True when source hardcoded subtitles remain visible in gaps (narration-only or translucent mask)."""
    if not _source_subtitle_mask()["active"]:
        return False
    return not _source_subtitle_mask_covers_gaps()


def _original_gap_subtitle_entries(tts_segments, work_dir, video_duration, *, max_chars=None):
    """Subtitle entries for agent-verified original dialogue (`original_subtitles.json`) in gaps.

    Never invents cues from coarse ASR and never slices Chinese text mid-sentence.
    """
    delivering = CONFIG["burn_subtitles"] or bool(CONFIG["burn_subtitles_degraded"])
    if not (delivering and CONFIG["subtitle_original_in_gaps"]):
        return []
    agent = _load_agent_original_subtitles(work_dir)
    if not agent:
        return []
    if _source_subtitles_already_visible_in_gaps():
        log("跳过 original_subtitles.json:当前遮罩未全片不透明覆盖留白段,保留原片可见硬字幕避免叠字")
        return []
    gaps = _narration_gap_windows(tts_segments, video_duration)
    if not gaps:
        return []
    limit = int(max_chars or CONFIG["subtitle_max_chars"])
    entries = []
    for seg in agent:
        seg_start, seg_end, text = seg["start"], seg["end"], seg["text"]
        best = max(
            ((max(seg_start, gs), min(seg_end, ge)) for gs, ge in gaps),
            key=lambda pair: pair[1] - pair[0],
            default=(0.0, 0.0),
        )
        cs, ce = best
        if ce - cs >= _MIN_READABLE_SECONDS:
            entries.extend(_bracketed_original_chunks(text, cs, ce, limit))
    return entries


def _load_narration_highlights(work_dir):
    """Load optional per-segment or plan-wide subtitle highlight keywords."""
    if work_dir is None:
        return {}, []
    by_idx = {}
    narr = _load_work_json(work_dir, "narration.json")
    if isinstance(narr, list):
        for idx, row in enumerate(narr):
            if isinstance(row, dict) and isinstance(row.get("highlights"), list):
                by_idx[idx] = [str(x).strip() for x in row["highlights"] if str(x).strip()]
    plan = _load_work_json(work_dir, "packaging_plan.json")
    global_hl = []
    if isinstance(plan, dict) and isinstance(plan.get("subtitle_highlights"), list):
        global_hl = [str(x).strip() for x in plan["subtitle_highlights"] if str(x).strip()]
    return by_idx, global_hl


def _combined_subtitle_entries(
    narration, work_dir, video_duration, *, max_chars=None, bridge_gap_seconds=None
):
    """Narration subtitle entries plus verified original-dialogue entries in the gaps."""
    by_idx, global_hl = _load_narration_highlights(work_dir)
    entries = _subtitle_entries(narration, max_chars=max_chars, highlights_by_index=by_idx)
    if global_hl:
        for item in entries:
            merged = list(item.get("highlights") or ()) + [
                h for h in global_hl if h not in (item.get("highlights") or ())
            ]
            item["highlights"] = merged
    entries.extend(
        _original_gap_subtitle_entries(narration, work_dir, video_duration, max_chars=max_chars)
    )
    entries.sort(key=lambda x: (x["start"], x["end"]))
    bridge = (
        CONFIG.get("subtitle_bridge_gap_seconds", 0.0)
        if bridge_gap_seconds is None
        else bridge_gap_seconds
    )
    return _bridge_narration_micro_gaps(entries, bridge)
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall