Skip to content

huangxin-design/blender-beginner / skills/huanghuayu-tutorial-video

huanghuayu-tutorial-video

Verified

制作黄花鱼频道的复古科技风教程视频与封面,复用 CRT 电视视觉、中文字体、配音、稳定转场和荧光半调封面。将当前案例的真实作品、对话经验与工程讲解组织成一条 3:4 教程。适用于“复用黄花鱼教程模板”“按上次风格做教程/封面”;不用于单独建模或普通成片渲染。

FileKindSize
SKILL.mdskill md7.2 KB
agents/openai.yamlconfig437 B
assets/approved-reference.pngbinary556.2 KB
assets/cover/approved-cover.pngbinary1.9 MB
assets/cover/crt_blank.pngbinary1.9 MB
assets/cover/crt_blank_prompt.txtmarkdown1.7 KB
assets/cover/footer_halftone.pngbinary39.0 KB
assets/cover/footer_halftone.svgother170.8 KB
assets/cover/main_glass_mask.pngbinary8.3 KB
assets/cover/main_glass_mask.svgother366 B
assets/cover/screen.jsonconfig166 B
assets/cover_example/artwork_example.jsonconfig661 B
assets/cover_example/background_example.jsonconfig605 B
assets/cover_example/flower_artwork_example.pngbinary180.2 KB
assets/cover_example/flower_poster_example.pngbinary2.1 MB
assets/cover_example/two_line_example.jsonconfig651 B
assets/example_project/card_example.jsonconfig1.3 KB
assets/example_project/lesson.jsonconfig4.3 KB
assets/example_project/media/crystals.pngbinary7.5 KB
assets/example_project/media/flow.pngbinary29.7 KB
assets/example_project/media/flower.pngbinary180.2 KB
assets/example_project/media/flower_motion.mp4binary41.5 KB
assets/example_project/media/frost.pngbinary12.9 KB
assets/example_project/media/silence.wavbinary93.8 KB
assets/example_project/media/veins.pngbinary20.4 KB
assets/example_project/preview.pngbinary123.9 KB
assets/example_project/render_verification.jsonconfig710 B
assets/graphics/tv_caption_blank_v1.pngbinary1.5 MB
assets/graphics/tv_caption_blank_v1_prompt.txtmarkdown1.6 KB
package-manifest.jsonconfig6.3 KB
references/cover.mdmarkdown7.9 KB
references/visual-style.mdmarkdown2.8 KB
references/voice.mdmarkdown4.5 KB
references/workflow.mdmarkdown5.0 KB
requirements.txtmanifest29 B
scripts/image_backdrop.pyscript1.7 KB
scripts/render_cover.pyscript19.1 KB
scripts/render_tutorial.pyscript23.0 KB
scripts/synthesize_voice.pyscript8.8 KB

scripts/synthesize_voice.py

View on GitHub
"""Build narration and subtitle timing; importing this module never uses the network."""
import argparse
import array
import asyncio
import json
import math
import re
import subprocess
import sys
import wave
from pathlib import Path

SAMPLE_RATE = 48000
DEFAULTS = {'voice': 'zh-CN-XiaoxiaoNeural', 'rate': '+12%', 'pitch': '-2Hz',
            'gap_seconds': 0.15}


def read_config(path, reuse_audio=False):
    config = json.loads(path.read_text(encoding='utf-8-sig'))
    settings = DEFAULTS | config.get('voice_settings', {})
    if not isinstance(settings['voice'], str) or not settings['voice'].strip():
        raise ValueError('voice_settings.voice must be a voice name')
    for key, pattern in [('rate', r'[+-]\d+%'), ('pitch', r'[+-]\d+Hz')]:
        if not isinstance(settings[key], str) or not re.fullmatch(pattern, settings[key]):
            raise ValueError(f'voice_settings.{key} requires a signed value, e.g. {DEFAULTS[key]}')
    gap = settings['gap_seconds']
    if not isinstance(gap, (int, float)) or not math.isfinite(gap) or gap < 0:
        raise ValueError('voice_settings.gap_seconds must be a finite nonnegative number')
    shots = config.get('shots')
    if not isinstance(shots, list) or not shots:
        raise ValueError('shots must be a nonempty list')
    seen = set()
    for shot in shots:
        shot_id = shot.get('id', '')
        if not isinstance(shot_id, str) or not re.fullmatch(r'[A-Za-z0-9_-]+', shot_id) or shot_id in seen:
            raise ValueError('Each shot needs a unique filename-safe id')
        seen.add(shot_id)
        parts = shot.get('narration_parts', [])
        if not isinstance(parts, list):
            raise ValueError(f'{shot_id}: narration_parts must be a list')
        for part in parts:
            if not isinstance(part.get('text'), str) or not part['text'].strip():
                raise ValueError(f'{shot_id}: each narration part needs text')
            lines = part.get('subtitle_lines')
            if not isinstance(lines, list) or not lines or not all(isinstance(s, str) and s.strip() for s in lines):
                raise ValueError(f'{shot_id}: each narration part needs nonempty subtitle_lines')
            if reuse_audio and not (path.parent / part.get('source_audio', '')).is_file():
                raise ValueError(f'{shot_id}: --reuse-audio requires an existing source_audio for each part')
        duration = shot.get('duration_seconds', 0)
        if not isinstance(duration, (int, float)) or not math.isfinite(duration) or duration < 0:
            raise ValueError(f'{shot_id}: duration_seconds must be a finite nonnegative number')
    if reuse_audio:
        generated = set()
        for shot in shots:
            generated.add((path.parent / 'audio' / f'{shot["id"]}.wav').resolve())
            generated.update((path.parent / 'audio' / f'{shot["id"]}_part_{i:02}.wav').resolve()
                             for i in range(1, len(shot.get('narration_parts', [])) + 1))
        if any((path.parent / part['source_audio']).resolve() in generated
               for shot in shots for part in shot.get('narration_parts', [])):
            raise ValueError('source_audio overlaps generated output; use a new working directory or shot id')
    config['voice_settings'] = settings
    return config


def read_pcm(path):
    with wave.open(str(path), 'rb') as source:
        if (source.getframerate(), source.getnchannels(), source.getsampwidth()) != (SAMPLE_RATE, 1, 2):
            raise ValueError(f'Expected 48000 Hz mono PCM s16le: {path}')
        data = source.readframes(source.getnframes())
    samples = array.array('h', data)
    if sys.byteorder != 'little':
        samples.byteswap()
    peak = max((abs(s) for s in samples), default=0)
    clipped = sum(s in (-32768, 32767) for s in samples)
    if peak <= 100 or clipped:
        raise ValueError(f'Silent or clipped audio: {path}')
    return data, {'pcm_format': '48000 Hz mono s16le', 'non_silent': True,
                  'peak_dbfs': round(20 * math.log10(peak / 32768), 2), 'clipped_samples': clipped}


def write_json(path, data):
    path.write_text(json.dumps(data, ensure_ascii=False, indent=2) + '\n', encoding='utf-8')


async def synthesize(config_path, config, reuse_audio=False):
    # Only explicit synthesis imports the online client. Offline reuse has no TTS dependency.
    if not reuse_audio:
        import edge_tts
    root = config_path.parent
    audio_dir = root / 'audio'
    audio_dir.mkdir(exist_ok=True)
    settings = config['voice_settings']
    gap_frames = round(settings['gap_seconds'] * SAMPLE_RATE)
    records = []
    for shot in config['shots']:
        parts = shot.get('narration_parts', [])
        if not parts:
            continue
        shot_id = shot['id']
        pcm, cues, sources = bytearray(), [], []
        for index, part in enumerate(parts, 1):
            raw = (root / part['source_audio']).resolve() if reuse_audio else audio_dir / f'{shot_id}_source_{index:02}.mp3'
            normalized = audio_dir / f'{shot_id}_part_{index:02}.wav'
            if not reuse_audio:
                await edge_tts.Communicate(part['text'], settings['voice'],
                                          rate=settings['rate'], pitch=settings['pitch']).save(str(raw))
            subprocess.run(['ffmpeg', '-hide_banner', '-loglevel', 'error', '-y', '-i', str(raw),
                            '-af', 'loudnorm=I=-18:TP=-2:LRA=9', '-ar', str(SAMPLE_RATE),
                            '-ac', '1', '-c:a', 'pcm_s16le', str(normalized)], check=True)
            data, _ = read_pcm(normalized)
            start = len(pcm) / (2 * SAMPLE_RATE)
            pcm.extend(data)
            cues.append({'start': round(start, 6), 'end': round(len(pcm) / (2 * SAMPLE_RATE), 6),
                         'lines': part['subtitle_lines'], 'narration': part['text']})
            sources.append(str(raw) if reuse_audio else raw.relative_to(root).as_posix())
            if index < len(parts):
                pcm.extend(bytes(gap_frames * 2))
        duration = len(pcm) / (2 * SAMPLE_RATE)
        for current, following in zip(cues, cues[1:]):
            current['end'] = following['start']
        output = audio_dir / f'{shot_id}.wav'
        with wave.open(str(output), 'wb') as target:
            target.setnchannels(1)
            target.setsampwidth(2)
            target.setframerate(SAMPLE_RATE)
            target.writeframes(pcm)
        _, verification = read_pcm(output)
        shot['audio_file'] = output.relative_to(root).as_posix()
        shot['audio_duration_seconds'] = round(duration, 6)
        shot['duration_seconds'] = max(shot.get('duration_seconds', 0), round(duration, 6))
        shot['subtitle_events'] = cues
        cue_path = audio_dir / f'{shot_id}_subtitle_cues.json'
        write_json(cue_path, {'duration_seconds': round(duration, 6),
                             'gap_seconds': gap_frames / SAMPLE_RATE, 'cues': cues})
        records.append({'id': shot_id, 'file': shot['audio_file'], 'source_files': sources,
                        'narration': ''.join(p['text'] for p in parts),
                        'duration_seconds': round(duration, 6), 'subtitle_events': cues,
                        'subtitle_cues_file': cue_path.relative_to(root).as_posix(),
                        'verification': verification})
        print(f'{shot_id}: {duration:.3f}s', flush=True)
    manifest = {'schema_version': 1, 'voice_settings': settings,
                'provider': 'Existing local audio' if reuse_audio else 'Microsoft Edge online neural speech via edge-tts',
                'sample_rate': SAMPLE_RATE, 'channels': 1, 'format': 'PCM s16le WAV',
                'normalization': 'FFmpeg loudnorm I=-18 LUFS, TP=-2 dBTP, LRA=9',
                'audio_played_during_production': False, 'segments': records,
                'total_narration_seconds': round(sum(r['duration_seconds'] for r in records), 6)}
    write_json(root / 'audio_manifest.json', manifest)
    voiced_path = config_path.with_name(config_path.stem + '.voiced.json')
    write_json(voiced_path, config)
    print(f'READY {voiced_path}', flush=True)
    return voiced_path


def main():
    parser = argparse.ArgumentParser(description=__doc__)
    parser.add_argument('--config', required=True, type=Path, help='Lesson JSON; relative media paths resolve beside it')
    parser.add_argument('--validate-only', action='store_true', help='Validate configuration without network or file writes')
    parser.add_argument('--reuse-audio', action='store_true', help='Use local narration_parts[].source_audio, without network')
    args = parser.parse_args()
    path = args.config.resolve()
    config = read_config(path, args.reuse_audio)
    if args.validate_only:
        print(f'VALID {path}: {len(config["shots"])} shots; no synthesis or network')
    else:
        asyncio.run(synthesize(path, config, args.reuse_audio))


if __name__ == '__main__':
    main()
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