zenstory-ai/video-recap-skills / skills/video-recap
video-recap
Verified把一段或多集视频做成带画框字幕的中文解说成片或纯原声高光短片。用户提供 .mp4 / .mov / .mkv / .webm,要求做影视解说、短剧二创、加旁白配音、跨集混剪或导出剪映草稿时使用;串联完成看片识台词、定主线与留原声、按台词停顿切镜头、写词检查、TTS 配音与混音加字幕。触发词:视频解说、影视解说、视频旁白、生成解说、视频 recap、video recap、voiceover、narration、recap。
scripts/export_jianying.py
View on GitHub"""Optional 剪映 / JianYing (CapCut) draft exporter — decoupled, stdlib + ffprobe only.
Reads a backend-neutral `timeline.json` (see timeline.py) and writes a 剪映 draft
folder (`draft_content.json` + `draft_info.json` + `draft_meta_info.json`) that the
desktop app can open and the user can keep editing: video clips on the main track,
the narration and BGM as their own audio tracks, the recap lines as a subtitle
track, and the gap-fill ducking carried as native volume keyframes.
The public entrypoints stay small (`us`, `build_draft`,
`export_timeline_to_jianying`, CLI). Internally the exporter is split into schema/templates, a thin
normalized build context, material/segment builders, track layout metadata, and
a safe writer/bundler. This mirrors the useful schema boundaries from duo-video
while ffmpeg remains the canonical renderer and JianYing export remains an
optional sidecar.
Schema and the draft skeleton are informed by the open-source pyJianYingDraft
(© GuanYixuan, Apache-2.0) and capcut-mate (© Hommy, Apache-2.0). JSON protocol
templates pinned from duo-video are vendored under its MIT license; builders
are implemented locally and no upstream executable code, resource package,
adapter binary, or credential is included. See ACKNOWLEDGEMENTS / 致谢.
"""
import json
import subprocess
import uuid
from jianying.builders import build_timeline_track as _build_timeline_track
from jianying.model import DraftBuildContext as _DraftBuildContext
from jianying.schema import draft_content_skeleton as _draft_content_skeleton
from jianying.schema import meta_info as _meta_info
from jianying.schema import us
from jianying.timeline_contract import normalize_timeline as _normalize_timeline
from jianying.writer import write_draft as _write_draft
__all__ = ["us", "build_draft", "export_timeline_to_jianying", "main"]
def _default_id():
return str(uuid.uuid4()).upper()
def _probe_media(path):
"""Return (duration_us, width, height) via ffprobe.
A probe failure raises: a draft that silently carries a zero or guessed media
duration is worse than a failed optional export. Still images legitimately
report no duration (0).
"""
result = subprocess.run(
[
"ffprobe",
"-v",
"error",
"-of",
"json",
"-show_entries",
"format=duration:stream=width,height,codec_type",
str(path),
],
capture_output=True,
text=True,
timeout=30,
)
if result.returncode:
raise RuntimeError(f"ffprobe failed for JianYing media {path}: {result.stderr.strip()}")
data = json.loads(result.stdout)
duration = data["format"].get("duration")
width = height = 0
for stream in data.get("streams", []):
if stream.get("codec_type") == "video":
width, height = int(stream["width"]), int(stream["height"])
break
return (us(float(duration)) if duration is not None else 0), width, height
def build_draft(timeline, new_id=None, probe=None):
"""Build the 剪映 draft_content dict and companion meta from a timeline."""
timeline = _normalize_timeline(timeline)
new_id = new_id or _default_id
probe = probe or _probe_media
ctx = _DraftBuildContext.from_timeline(timeline, new_id, probe)
for timeline_track in timeline["tracks"]:
_build_timeline_track(ctx, timeline_track)
ctx.finalize_tracks()
draft_id = new_id()
content = _draft_content_skeleton(
draft_id,
ctx.width,
ctx.height,
ctx.fps,
ctx.total_us,
ctx.materials,
ctx.tracks,
)
meta = _meta_info(draft_id, ctx.total_us)
return content, meta, ctx.notes
def export_timeline_to_jianying(
timeline, out_dir, draft_name="recap", new_id=None, probe=None, bundle_media=True
):
"""Write a 剪映 draft folder under out_dir/draft_name. Returns (folder, notes).
Referenced media is bundled by default so the draft is self-contained and
portable. Pass bundle_media=False only when external absolute paths are
intentionally required.
"""
content, meta, notes = build_draft(timeline, new_id=new_id, probe=probe)
return _write_draft(
content,
meta,
notes,
out_dir,
draft_name,
bundle_media_enabled=bundle_media,
)
def main():
import argparse
ap = argparse.ArgumentParser(
description="Export a timeline.json to a 剪映/JianYing draft folder."
)
ap.add_argument("timeline", help="path to timeline.json")
ap.add_argument(
"--out-dir", required=True, help="parent dir to create the draft folder in"
)
ap.add_argument("--name", default="recap", help="draft folder name")
bundle_group = ap.add_mutually_exclusive_group()
bundle_group.add_argument(
"--bundle-media",
dest="bundle_media",
action="store_true",
help="copy referenced media into the draft folder (default)",
)
bundle_group.add_argument(
"--no-bundle-media",
dest="bundle_media",
action="store_false",
help="keep external media paths instead of making a portable draft",
)
ap.set_defaults(bundle_media=True)
args = ap.parse_args()
with open(args.timeline, encoding="utf-8") as f:
timeline = json.load(f)
draft_dir, notes = export_timeline_to_jianying(
timeline,
args.out_dir,
args.name,
bundle_media=args.bundle_media,
)
for note in notes:
print(f" 注意: {note}")
print(
json.dumps({"status": "exported", "draft_dir": draft_dir}, ensure_ascii=False)
)
if __name__ == "__main__":
main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |