Kurs vibe coding z Claude Code · Moduł 10: Klon TikToka

Duet, stitch i edytor: małe kroki i lista TODO

8 min czytania
W tej lekcji11

Załoga ma już feed, dźwięki i nagrywarkę. Teraz chce odpowiadać na klipy innych: nagrać się obok klipu kapitana, czyli zrobić duet, albo wyciąć z cudzego klipu kilka sekund i dograć po nich własne zakończenie, czyli zrobić stitch. Każde nagranie trzeba jeszcze przyciąć i podpisać, zanim trafi do feedu. To trzy funkcje naraz, a przy wideo to prosta droga do komponentu, który wygląda na gotowy, choć połowa przycisków nic nie robi.

Czego się nauczysz

  • podzielić dużą funkcję na trzy małe polecenia i czytać trzy małe diffy zamiast jednego wielkiego;
  • wymagać od Claude listy rzeczy, których nie zrobił, zamiast cichych atrap;
  • sprawdzić, czy typ i interfejs używają tego samego zbioru wartości;
  • przeczytać edytor, który nie zostawia w pamięci adresów do nagrań.

Duet i stitch w Treasure Reels

W klonie duet to Twoje nagranie obok klipu kogoś innego, na podzielonym ekranie, w jednym z dwóch układów: obok siebie albo góra i dół. Stitch to fragment cudzego klipu, po którym gra Twoje nagranie. TikTok w zapowiedzi stitcha z 2020 roku pozwalał wybrać do pięciu sekund oryginału, a w Treasure Reels ten limit to stała MAX_STITCH_SECONDS. W prawdziwym TikToku autor może też wyłączyć duety i stitche swoich filmów jednym ustawieniem ponownego użycia treści, więc w przyszłości klon będzie potrzebował podobnej flagi.

Dlaczego trzy kroki

Jedno polecenie "zrób duet, stitch i edytor" daje kilkaset linii w kilku plikach. Agent przy takim zakresie chętnie zostawia w środku atrapę: funkcję wywołaną, ale nigdzie niezdefiniowaną, albo przycisk z pustą obsługą kliknięcia. W wielkim diffie łatwo to przeoczyć. Trzy małe polecenia dają trzy diffy, z których każdy przeczytasz w kilka minut, i trzy commity, do których możesz wrócić.

Polecenie dla Claude Code (krok 1):

Krok 1 z 3. W types/duet.ts typy duetu i stitcha: układy duetu jako
jedna stała tablica DUET_LAYOUTS, z której wynika typ DuetLayout,
DuetVideo z miksem głośności, StitchVideo z fragmentem do 5 sekund
i fazy tworzenia stitcha. W lib/duet.ts funkcje createDuet
i createStitch z testami. Nic więcej. Na koniec testy i typy.

Co napisał Claude: jeden zbiór układów

Otwórz w Cursorze types/duet.ts. Na górze stoi tablica, z której wynika typ:

export const DUET_LAYOUTS = ["side-by-side", "top-bottom"] as const;
export type DuetLayout = (typeof DUET_LAYOUTS)[number];

as const zamienia tablicę w listę dokładnie tych dwóch napisów, a (typeof DUET_LAYOUTS)[number] buduje z niej unię "side-by-side" | "top-bottom". Typ i przyciski wyboru będą czytać z jednego miejsca. Niżej plik ma typ faz stitcha: "select-clip", potem "record-reaction", na końcu "preview", czyli wybór fragmentu, nagranie odpowiedzi i podgląd całości.

W lib/duet.ts jest funkcja, która składa nowy duet:

export function createDuet(originalVideoId: string, layout: DuetLayout): DuetVideo {
  return {
    id: crypto.randomUUID(),
    originalVideoId,
    layout,
    audioMix: { original: 0.5, duet: 0.5 },
  };
}

crypto.randomUUID() to wbudowany generator unikalnych identyfikatorów, więc nie trzeba pisać własnego. Według MDN w przeglądarce działa tylko w bezpiecznym kontekście, czyli na HTTPS albo na localhost, tak jak kamera. audioMix startuje po równo: połowa głośności oryginału i połowa Twojego nagrania. createStitch przycina fragment tak, żeby miał od 1 do 5 sekund i nie wychodził poza długość oryginału.

Krok 2: widok z listą TODO

Polecenie dla Claude Code (krok 2):

Krok 2 z 3. components/DuetRecorder.tsx i strona app/duet/[videoId]:
oryginał po jednej stronie, miejsce na kamerę po drugiej, wybór układu
z DUET_LAYOUTS. Na razie bez kamery i nagrywania. Wszystko, czego nie
robisz, oznacz komentarzem TODO(duet) i wypisz na końcu odpowiedzi.

Ostatnie zdanie zmienia ciche atrapy w jawną listę. W tym kroku lista powinna mieć jeden punkt: podgląd z kamery i nagrywanie. Wyszukaj w projekcie (Cmd+Shift+F na Macu, Ctrl+Shift+F na Windowsie) TODO(duet) i porównaj trafienia z listą. Każde TODO spoza listy to atrapa, o której nikt Ci nie powiedział.

Co napisał Claude: wybór układu

Otwórz components/DuetRecorder.tsx. Przyciski powstają z tablicy, a napisy z mapy:

const LAYOUT_LABELS: Record<DuetLayout, string> = {
  "side-by-side": "Obok siebie",
  "top-bottom": "Góra i dół",
};

Record<DuetLayout, string> to obiekt, który musi mieć napis dla każdego układu z unii. Same przyciski powstają z tablicy (tu bez klas Tailwinda):

{DUET_LAYOUTS.map((value) => (
  <button key={value} type="button" role="radio" aria-checked={layout === value} onClick={() => setLayout(value)}>
    {LAYOUT_LABELS[value]}
  </button>
))}

Nowy układ dopisany do tablicy pojawi się wśród przycisków sam, a kompilator dopilnuje napisu. U nas dopisanie "green-screen" do tablicy bez napisu skończyło się błędem TS2741 z linią Property '"green-screen"' is missing in type. Przyciski mają role="radio" i aria-checked, bo to wybór jednej opcji z kilku. Strona /duet/v1 pokazała u nas po kliknięciu "Góra i dół" oryginał na górze i miejsce na kamerę pod nim.

Krok 3: edytor klipu

Polecenie dla Claude Code (krok 3):

Krok 3 z 3. components/VideoEditor.tsx dla nagrania
z @components/VideoRecorder.tsx: podgląd, przycinanie początku i końca
w granicach durationSec, filtry, które naprawdę zmieniają podgląd,
podpis do 150 znaków i zapis. Adres podglądu twórz raz na plik
i zwalniaj przy sprzątaniu. Użyj edytora na stronie /nagraj po
nagraniu. Na koniec lint, typy, testy i build.

Co napisał Claude: adres nagrania

Nagranie z nagrywarki to Blob, czyli plik w pamięci przeglądarki. Element <video> potrzebuje adresu, więc Claude tworzy go w efekcie:

useEffect(() => {
  const url = URL.createObjectURL(blob);
  const video = videoRef.current;
  if (video) video.src = url;
  return () => URL.revokeObjectURL(url);
}, [blob]);

Według MDN każde wywołanie createObjectURL tworzy nowy adres, nawet dla tego samego pliku, a dopóki adres żyje, plik nie może zostać usunięty z pamięci. Dlatego adres powstaje raz na plik i jest zwalniany przy sprzątaniu efektu. W trybie deweloperskim (npm run dev) React uruchamia efekt dwa razy, żeby wyłapać brak sprzątania: u nas przeglądarka pokazała dwa utworzone adresy i jeden zwolniony, a wideo grało z drugiego. Strona /nagraj daje edytorowi key={recording.id}, więc nowe nagranie dostaje świeży edytor z nowym końcem przycięcia.

Co napisał Claude: filtry i przycinanie

Filtr to klucz z mapy, a podgląd naprawdę z niego korzysta:

const FILTERS = {
  none: { label: "Brak", css: "none" },
  sepia: { label: "Stara mapa", css: "sepia(0.8)" },
  mono: { label: "Czarno-biały", css: "grayscale(1)" },
  cold: { label: "Chłodny", css: "hue-rotate(180deg)" },
} as const;

Element <video> dostaje style={{ filter: FILTERS[filter].css }}, czyli filtr CSS nakładany na obraz. Trzeba to powiedzieć uczciwie: filtr zmienia tylko podgląd, a nie plik. Zapis wysyła wybrany filtr jako informację, a wypalenie go w nagraniu to osobna praca. Przycinanie działa w podglądzie tak:

function handleTimeUpdate() {
  const video = videoRef.current;
  if (video && video.currentTime >= trimEnd) video.currentTime = trimStart;
}

timeupdate to zdarzenie, które odtwarzacz wysyła kilka razy na sekundę w trakcie grania. Gdy czas dojdzie do końca przycięcia, podgląd wraca na początek. Koniec przycięcia startuje od durationSec z metadanych nagrywarki, a nie od liczby wpisanej na sztywno. U nas z końcem ustawionym na 2 sekundy klip po 3,5 sekundy grania stał na 1,35 sekundy, czyli zawrócił.

Przegląd kapitana

  1. Wszystko zdefiniowane i zaimportowane. Typowy błąd agenta to wywołanie funkcji, której nigdzie nie ma, na przykład generateId(), albo hook bez importu. Tu kompilator jest po Twojej stronie: u nas npx tsc --noEmit zgłosił error TS2304: Cannot find name 'generateId', a build skończył się linią Failed to type check.. Uruchamiasz więc typy po każdym kroku, nie raz na koniec.
  2. Adres w rysowaniu. Drugi typowy błąd to const videoUrl = URL.createObjectURL(blob) w ciele komponentu. U nas przeszedł lint i tsc, a test, który wpisuje trzy litery podpisu, zgłosił expected 4 to be 1: cztery adresy zamiast jednego, żaden niezwolniony. Wyszukaj createObjectURL i sprawdź, czy obok stoi revokeObjectURL.
  3. Przyciski, które coś robią. Filtr, który zmienia tylko podświetlenie przycisku, to komponent, który wygląda gotowo. Wyszukaj w pliku FILTERS[filter]: jeśli wybrany filtr nie trafia do style podglądu, przyciski są dekoracją. Potem kliknij każdy w przeglądarce.
  4. Jeden zbiór wartości. Typ układu i przyciski wyboru czytają z DUET_LAYOUTS. Wartość wpisana ręcznie w selektorze albo trzecia wartość w osobnej unii to znak, że zbiory się rozjadą.

Następny krok

Po każdym kroku poproś o commit, a po trzecim uruchom recenzję ze świeżymi oczami z lekcji 2_9. /code-review bez argumentu sprawdza commity, których nie ma jeszcze w repozytorium zdalnym, i niezapisane zmiany, więc obejmie wszystkie trzy kroki. Każde znalezisko traktujesz jak hipotezę: sprawdzasz je, zanim poprosisz o poprawkę jednym wąskim poleceniem. Punkt z listy TODO, czyli kamera w duecie, to kolejne małe polecenie na innym rejsie: wykorzysta tę samą nagrywarkę, więc nie wymaga nowego kodu kamery.

W edytorze poniżej czeka duet z wyborem układu i edytor z licznikiem adresów obiektów. Wpisz podpis z oboma błędami agenta wyłączonymi, potem włącz błąd adresu i wpisz jeszcze kilka liter. Na koniec włącz drugi błąd i poklikaj filtry.

Zapamiętaj: dwóch piratów w duecie musi śpiewać w tej samej tonacji, a kapitan, który dzieli rejs na krótkie etapy, wie na każdym postoju, co już jest w ładowni, a czego jeszcze brakuje.

Kod do tej lekcji: App.jsx
// Duet i edytor w miniaturze: układy z jednej tablicy, filtry i licznik adresów obiektów
import { useEffect, useState } from 'react';

const DUET_LAYOUTS = ['side-by-side', 'top-bottom'];
const LAYOUT_LABELS = { 'side-by-side': 'Obok siebie', 'top-bottom': 'Góra i dół' };

const FILTERS = {
  none: { label: 'Brak', css: 'none' },
  sepia: { label: 'Stara mapa', css: 'sepia(0.8)' },
  mono: { label: 'Czarno-biały', css: 'grayscale(1)' },
  cold: { label: 'Chłodny', css: 'hue-rotate(180deg)' },
};

const CAPTION_MAX = 150;
const MIN_CLIP = 0.5;
// Metadane z nagrywarki: prawdziwa długość nagrania
const recording = { durationSec: 8.4, blob: new Blob(['udawane nagranie'], { type: 'video/webm' }) };

const stats = { created: 0, revoked: 0 };

function makeUrl(blob) {
  stats.created += 1;
  return URL.createObjectURL(blob);
}

function revokeUrl(url) {
  stats.revoked += 1;
  URL.revokeObjectURL(url);
}

function Editor({ urlBug, filterBug }) {
  const [trimStart, setTrimStart] = useState(0);
  const [trimEnd, setTrimEnd] = useState(recording.durationSec);
  const [filter, setFilter] = useState('none');
  const [caption, setCaption] = useState('');

  // Dobra wersja: jeden adres na plik, powstaje w efekcie i jest zwalniany przy sprzątaniu
  useEffect(() => {
    if (urlBug) return;
    const url = makeUrl(recording.blob);
    // w prawdziwym edytorze: videoRef.current.src = url
    return () => revokeUrl(url);
  }, [urlBug]);

  // Błąd agenta: nowy adres przy każdym rysowaniu, nigdy nie zwolniony
  const buggyUrl = urlBug ? makeUrl(recording.blob) : null;

  const previewFilter = filterBug ? 'none' : FILTERS[filter].css;

  return (
    <div className="space-y-3">
      <div
        className="flex h-40 items-center justify-center rounded-xl bg-gradient-to-br from-amber-400 via-rose-500 to-indigo-700 text-sm"
        style={{ filter: previewFilter }}
      >
        Podgląd: {trimStart.toFixed(1)}-{trimEnd.toFixed(1)} s
      </div>
      {buggyUrl && <p className="truncate text-xs text-gray-400">Nowy adres: {buggyUrl}</p>}
      <label className="flex items-center gap-2 text-sm">
        Początek
        <input type="range" min={0} max={trimEnd - MIN_CLIP} step={0.1} value={trimStart} onChange={(e) => setTrimStart(Number(e.target.value))} className="flex-1" />
      </label>
      <label className="flex items-center gap-2 text-sm">
        Koniec
        <input type="range" min={trimStart + MIN_CLIP} max={recording.durationSec} step={0.1} value={trimEnd} onChange={(e) => setTrimEnd(Number(e.target.value))} className="flex-1" />
      </label>
      <div className="flex flex-wrap gap-2">
        {Object.keys(FILTERS).map((id) => (
          <button
            key={id}
            type="button"
            aria-pressed={filter === id}
            onClick={() => setFilter(id)}
            className={filter === id ? 'rounded-full bg-white px-3 py-1 text-black' : 'rounded-full bg-gray-700 px-3 py-1'}
          >
            {FILTERS[id].label}
          </button>
        ))}
      </div>
      <label className="flex flex-col gap-1 text-sm">
        Podpis
        <textarea value={caption} maxLength={CAPTION_MAX} onChange={(e) => setCaption(e.target.value)} rows={2} className="rounded bg-gray-800 p-2" />
      </label>
      <p className="text-right text-xs text-gray-400">{caption.length}/{CAPTION_MAX}</p>
    </div>
  );
}

function UrlCounter() {
  const [counts, setCounts] = useState({ ...stats });
  useEffect(() => {
    const id = setInterval(() => {
      setCounts((prev) => (prev.created === stats.created && prev.revoked === stats.revoked ? prev : { ...stats }));
    }, 200);
    return () => clearInterval(id);
  }, []);
  return <p>Adresy obiektów: utworzone <strong>{counts.created}</strong>, zwolnione <strong>{counts.revoked}</strong></p>;
}

export default function App() {
  const [layout, setLayout] = useState('side-by-side');
  const [urlBug, setUrlBug] = useState(false);
  const [filterBug, setFilterBug] = useState(false);
  const [showEditor, setShowEditor] = useState(true);

  return (
    <div className="min-h-screen space-y-4 bg-gray-950 p-4 text-white">
      <section className="space-y-2">
        <h2 className="font-bold">Duet</h2>
        <div role="radiogroup" aria-label="Układ duetu" className="flex gap-2">
          {DUET_LAYOUTS.map((value) => (
            <button
              key={value}
              type="button"
              role="radio"
              aria-checked={layout === value}
              onClick={() => setLayout(value)}
              className={layout === value ? 'rounded-full bg-white px-3 py-1 text-black' : 'rounded-full bg-gray-700 px-3 py-1'}
            >
              {LAYOUT_LABELS[value]}
            </button>
          ))}
        </div>
        <div className={layout === 'side-by-side' ? 'grid h-32 grid-cols-2 gap-1' : 'grid h-32 grid-rows-2 gap-1'}>
          <div className="flex items-center justify-center rounded bg-sky-800 text-sm">Klip kapitana</div>
          <div className="flex items-center justify-center rounded bg-gray-800 text-sm text-gray-400">TODO(duet): kamera</div>
        </div>
      </section>

      <section className="grid gap-4 md:grid-cols-2">
        <div>
          <h2 className="mb-2 font-bold">Edytor klipu ({recording.durationSec} s z nagrywarki)</h2>
          {showEditor ? (
            <Editor key={urlBug ? 'bug' : 'ok'} urlBug={urlBug} filterBug={filterBug} />
          ) : (
            <p className="rounded bg-gray-800 p-4 text-sm">Edytor zamknięty.</p>
          )}
        </div>
        <div className="space-y-2 text-sm">
          <UrlCounter />
          <button type="button" onClick={() => setShowEditor((s) => !s)} className="rounded bg-gray-700 px-3 py-1">
            {showEditor ? 'Zamknij edytor' : 'Otwórz edytor'}
          </button>
          <label className="flex items-center gap-2"><input type="checkbox" checked={urlBug} onChange={(e) => setUrlBug(e.target.checked)} /> Błąd agenta: adres w każdym rysowaniu</label>
          <label className="flex items-center gap-2"><input type="checkbox" checked={filterBug} onChange={(e) => setFilterBug(e.target.checked)} /> Błąd agenta: filtry niepodłączone do podglądu</label>
        </div>
      </section>
    </div>
  );
}

Widzisz błąd w tej lekcji?

Sprawdź się

Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.

  1. 1. Czym jest duet w Treasure Reels?

  2. 2. Co opisuje pole audioMix w DuetVideo?

To 2 z 9 pytań do tej lekcji. Pozostałe rozwiążesz w grze.

Zadania praktyczne w grze

  • Układanie w pionie

    Uporządkuj kroki budowy duetu i edytora z lekcji (od pierwszego):

  • Układanie w pionie

    Uporządkuj elementy wyboru układu duetu tak, żeby każdy korzystał z poprzedniego:

  • Edytor kodu

    Duet recording interface

  • Układanie w poziomie

    Ułóż linię, która buduje typ DuetLayout z tablicy DUET_LAYOUTS:

  • Układanie w pionie

    Uporządkuj fazy tworzenia stitcha z typu StitchPhase (od pierwszej):

  • Edytor kodu

    Video editing interface

  • Układanie w poziomie

    Ułóż linię sprzątania efektu, która zwalnia adres nagrania:

  • Klikanie w kolejności

    Zbuduj warunek, który zawraca podgląd na początek przycięcia (klikaj po kolei):

  • Układanie w pionie

    Uporządkuj linie efektu, który tworzy i zwalnia adres nagrania (z góry na dół):

  • Klikanie w kolejności

    Zbuduj obsługę kliknięcia przycisku układu duetu (klikaj po kolei):

  • Układanie w pionie

    Uporządkuj drogę nagrania od kamery do edytora (od pierwszego kroku):

  • Układanie w poziomie

    Ułóż początek mapy, która musi mieć napis dla każdego układu duetu:

  • Klikanie w kolejności

    Zbuduj pole z unikalnym identyfikatorem nowego duetu (klikaj po kolei):

  1. PytanieDuet w Treasure Reels
  2. Ułóż w kolejnościTrzy kroki zamiast jednego
  3. Ułóż w kolejnościOd tablicy układów do przycisków
  4. Zadanie z kodemPraktyka: Duet recorder
  5. PytaniePole audioMix
  6. PytaniecreateStitch i limit fragmentu
  7. Ułóż w kolejnościTyp z tablicy układów
  8. Ułóż w kolejnościFazy stitcha
  9. PytanieLista TODO w poleceniu
  10. Zadanie z kodemPraktyka: Video editor
  11. PytanieAdres nagrania w efekcie
  12. Ułóż w kolejnościZwalnianie adresu nagrania
  13. Kliknij w kolejnościPowrót do początku przycięcia
  14. Ułóż w kolejnościEfekt z adresem nagrania
  15. PytanieFiltry podłączone do podglądu
  16. Kliknij w kolejnościWybór układu po kliknięciu
  17. Ułóż w kolejnościOd kamery do edytora
  18. PytanieDuet a stitch
  19. Ułóż w kolejnościMapa napisów układów
  20. Kliknij w kolejnościIdentyfikator duetu
  21. PytanieKiedy usunąć worktree
  22. PytanieWorktree a lint i testy

Przydatne artykuły