Kurs vibe coding z Claude Code · Moduł 10: Klon TikToka
Duet, stitch i edytor: małe kroki i lista TODO
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
- 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 nasnpx tsc --noEmitzgł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. - Adres w rysowaniu. Drugi typowy błąd to
const videoUrl = URL.createObjectURL(blob)w ciele komponentu. U nas przeszedł lint itsc, a test, który wpisuje trzy litery podpisu, zgłosiłexpected 4 to be 1: cztery adresy zamiast jednego, żaden niezwolniony. WyszukajcreateObjectURLi sprawdź, czy obok stoirevokeObjectURL. - 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 dostylepodglądu, przyciski są dekoracją. Potem kliknij każdy w przeglądarce. - 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. Czym jest duet w Treasure Reels?
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):
Zadania po tej lekcji
- PytanieDuet w Treasure Reels
- Ułóż w kolejnościTrzy kroki zamiast jednego
- Ułóż w kolejnościOd tablicy układów do przycisków
- Zadanie z kodemPraktyka: Duet recorder
- PytaniePole audioMix
- PytaniecreateStitch i limit fragmentu
- Ułóż w kolejnościTyp z tablicy układów
- Ułóż w kolejnościFazy stitcha
- PytanieLista TODO w poleceniu
- Zadanie z kodemPraktyka: Video editor
- PytanieAdres nagrania w efekcie
- Ułóż w kolejnościZwalnianie adresu nagrania
- Kliknij w kolejnościPowrót do początku przycięcia
- Ułóż w kolejnościEfekt z adresem nagrania
- PytanieFiltry podłączone do podglądu
- Kliknij w kolejnościWybór układu po kliknięciu
- Ułóż w kolejnościOd kamery do edytora
- PytanieDuet a stitch
- Ułóż w kolejnościMapa napisów układów
- Kliknij w kolejnościIdentyfikator duetu
- PytanieKiedy usunąć worktree
- PytanieWorktree a lint i testy