Was macht Bewegte persönliche Homepage?
Das Endergebnis ist eine statische Website (HTML/CSS/JS, kein Build erforderlich), die aus drei Schichten besteht:
- Figurenbühne: Eine Vollbild-Leinwand, die KI-generierte Videoframes der Figur zeigt. Auf der Startseite werden entsprechend der Mausrichtung die passenden Frames des „Blickverfolgungs-Kreislaufs“ abgespielt; beim Scrollen zu einem anderen Abschnitt wird das „Übergangsstück“ zwischen den beiden Abschnitten abgespielt, wobei der Scrollfortschritt die Wiedergabeposition bestimmt. Auf dem Smartphone im Hochformat wird die Figur in der oberen Bildschirmhälfte platziert.
- Inhaltsabschnitte: Startseite / Lebenslauf / Projektverzeichnis / Ausgewählte Projekte / Ende. Text liegt über der Bühne und vermeidet die Seite, auf der sich die Figur befindet.
- Handgezeichnete Dekorationen und Effekte: Kritzeleien (die beim Erscheinen in einem Strich gezeichnet werden und dann wie eine handgezeichnete Animation zittern), sich langsam verformende Farbblöcke, Sprechblasen, die dem Kopf der Figur folgen, handgezeichnete Kreise und Pinselunterstreichungen, Rotation-Wellen-Verzerrung (React Bits „Ripple Distortion“, WebGL, verzerrt nur die Bühne; falls nicht unterstützt, Rückfall auf Leuchtstift-Nachzieheffekt), Buchstaben, die nacheinander erscheinen, und schwebende kleine Cartoon-Aufkleber.
Die Vorlage ist standardmäßig im Stil „dunkle handgezeichnete Kritzeleien + 3D-Hauptfigur“ (fast schwarzer Hintergrund + Neon-Gelbgrün/Lila/Blau/Orange, Marker-Handschrift-Titel, 3D-Cartoon-Figur mit 2D-Kritzel-Aufklebern), die gesamte Website ist auf Englisch. Ein Stilwechsel erfolgt durch Änderung von theme (Farben, Schriftarten) und der decor der einzelnen Abschnitte, ohne die Engine zu verändern.
Wie gut die Website aussieht, hängt zu siebzig Prozent davon ab, ob das Material konsistent und zusammenhängend ist (gleiche Figur, gleicher Hintergrund, der letzte Frame des vorherigen Abschnitts ist der erste Frame des nächsten), zu dreißig Prozent vom Layout. Daher legt dieses Skill den größten Teil seines Umfangs auf die Planung und Überprüfung des Materials; der Code ist bereits in template/ fertig geschrieben, in der Regel werden nur site.config.js und geringfügig CSS geändert.
Verzeichnis
template/ Direkt ausführbare Vorlage (mit Platzhalter-Assets assets/demo/)
site.config.js Gesamter Text, Asset-Pfade, Interaktionsparameter
js/ css/ Engine und Stile, normalerweise nicht zu ändern
tools/calibrate.html Kalibrierungswerkzeug für Blickverfolgungs-Keyframes
scripts/frames.py Video/Bild → Web-Frames (erfordert ffmpeg)
scripts/check-site.mjs Überprüft, ob Konfiguration und Assets vollständig sind
scripts/fetch-reactbits.mjs Lädt React Bits „Ripple Distortion“ auf die Website (Rotation-Wellen-Verzerrung beim Darüberfahren der Figur; wird aus Lizenzgründen nicht mit der Vorlage verteilt)
scripts/cutout.py Aufkleber/Kleine Figuren mit einfarbigem Hintergrund → transparentes webp (--split zum Aufteilen von Aufkleber-Sammlungen)
scripts/serve.py Lokaler Vorschau-Server (kein Cache, nach Änderung neu laden = neue Version)
scripts/shoot.mjs Abnahmescreenshots: Headless Chrome + echte Mausereignisse, Screenshots pro Abschnitt (Desktop/Mobil)
scripts/make-demo-assets.py Generiert Platzhalter-Assets neu (normalerweise nicht erforderlich)
references/
01_Planung.md Interview-Checkliste, Festlegung der Abschnitte und des Bewegungsablaufs der Figur
02_Asset-Prompts.md Prompt-Vorlagen und Abnahme für Figur, Hintergrund, Blickverfolgung, Übergänge, Projektbilder (inkl. praktischer Durchführung für Tools, die nur den ersten Frame übergeben können)
03_Website-Erstellung und Iteration.md Konfigurationsfeld-Beschreibungen, häufige Probleme und Lösungen, Feedback geben
04_Deployment.md Netlify / Vercel / GitHub Pages / Cloudflare, sowie spätere Projektergänzung
05_Open-Source-Homepage-Design-Referenzen.md Von Open-Source/öffentlich zerlegten persönlichen Homepages lernen (lesen, wenn der Benutzer sagt „sieht nicht professionell genug aus“)
Arbeitsablauf
Nach jedem Schritt dem Benutzer die tatsächlichen Ergebnisse zeigen (Screenshot, Frame-Collage oder lokale Vorschau), dann mit Bestätigung weitermachen. Wenn der Benutzer kein technisches Verständnis hat, ihn nicht die Konfiguration lesen lassen, sondern ihm nur die Bilder zeigen.
1. Interview und Planung → references/01_Planung.md lesen
Zunächst klären: Für wen ist die Homepage, welche Inhalte sollen rein (Lebenslauf, Projekte, Kontakt), wo kommt die Figur her (eigenes Foto, vorhandenes IP oder neues Design), welcher Stil gefällt (Benutzer 1–2 Referenzbilder oder Websites geben lassen), welche Bild-/Video-Generierungswerkzeuge stehen zur Verfügung. Dann eine plan.md im Website-Verzeichnis erstellen: Reihenfolge der Abschnitte, Text pro Abschnitt, Pose und Position der Figur in jedem Abschnitt, welche Aktionen die Figur in den Übergängen macht. Dieser „Bewegungsablauf der Figur“ ist die Grundlage für alle folgenden Assets – Pose und Position müssen mit dem Layout zusammenpassen (Text links, Figur rechts).
2. Assets → references/02_Asset-Prompts.md lesen
Die Reihenfolge ist wichtig, jeder Schritt baut auf dem Produkt des vorherigen auf:
- Endgültiges Figurbild: Vorderansicht, ganze Figur oder Brustbild, deutlicher Gesichtsausdruck. Bei vorhandenem IP die wiedererkennbaren Merkmale beibehalten (Gesicht, Frisur, charakteristische Accessoires), Kleidung kann thematisch angepasst werden.
- Hintergrundplatte: Ein Bild ohne Figur, für die gesamte Website gemeinsam genutzt, auch als Hintergrund aller Videos, damit der Hintergrund beim Szenenwechsel nicht flackert.
- Positions-Keyframes: Ein Bild pro Abschnitt (Figur + gleicher Hintergrund + gleiche Kameraposition), entsprechend der Pose und Position aus der Planung.
- Blickverfolgungs-Kreislauf: Von der Vorderansicht aus alle 8 Richtungen betrachten und zurück zur Vorderansicht. Wenn das Videotool den ersten und letzten Frame übergeben kann, segmentweise generieren und mit
frames.py gaze-joinzusammenfügen; kann nur der erste Frame übergeben werden (wie bei vielen Bild-zu-Video-Tools), die „Stern“-Methode verwenden: 8 kurze Videos, die alle vom Startbildschirm-Keyframe ausgehen, jede in eine andere Richtung mit einem anderen Gesichtsausdruck,frames.py gaze-starsynthetisiert sie (eine lange Sequenz, die alle 8 Richtungen durchläuft, würde das Modell zunehmend abdriften lassen). - Übergangsclips: Zwei benachbarte Positions-Keyframes als ersten und letzten Frame verwenden, um die dazwischenliegende Performance zu generieren. Wenn nur der erste Frame übergeben werden kann, in einer Kette generieren (letzter Frame des vorherigen = erster Frame des nächsten); wenn im ersten Frame eines Clips das Gesicht der Figur nicht sichtbar ist, die „Rückwärtsmethode“ verwenden (zuerst ein endgültiges Pose-Bild für das Ende generieren, die umgekehrte Aktion generieren und dann rückwärts abspielen), sonst wird das Gesicht am Ende vom Modell verändert.
- Projektcover: Wenn der Benutzer bereits vorhandene Projektbilder hat, direkt verwenden; Querformat 16:10 ist am besten geeignet.
Wenn der Benutzer nur Bilder, aber keine Videos generieren kann, funktioniert die Vorlage trotzdem: Blickverfolgung mit 9 Bildern (Vorderansicht + 8 Richtungen, mit Überblendwechsel), Übergänge mit zwei Posen-Bildern und der Option blend: true, genaue Befehle und Konfiguration siehe „Route C“ in 02. Die Wirkung ist schwächer, aber dem Benutzer muss klar gesagt werden, wo die Unterschiede liegen.
Wenn noch gar kein Asset vorhanden ist (Null-Asset-Erstversion): Zuerst die Website aufsetzen, damit der Benutzer Layout und Interaktion sehen kann – Vorlage kopieren, Text, Farben und Projekte in site.config.js mit den Benutzerinformationen ausfüllen, die Platzhalterfigur der Vorlage beibehalten. Dabei beachten:
- In Sprechblasen und Text nicht sagen „Ich bin ein Fuchs“ oder etwas, das nicht zur Platzhalterfigur passt; zunächst neutrale Sätze verwenden;
- Bei Abgabe gleich zu Beginn sagen: „Die Figur auf dem Bildschirm ist ein Platzhalter; um sie durch Ihre Figur zu ersetzen, müssen zuerst diese Bilder/Videos generiert werden“ und die Asset-Liste aus der
plan.mdbeifügen; check-site.mjsweist darauf hin, wo noch Platzhalter-Assets verwendet werden; diese Hinweise vor der Abgabe unverändert an den Benutzer weitergeben.
Wenn in der aktuellen Umgebung Bild-/Video-Generierungstools vorhanden sind (z. B. Bild- und Video-Generierungs-MCP), können diese direkt verwendet werden; wenn das Tool nur den ersten Frame übergeben kann, nach der „Kettengenerierung“ aus 02 Abschnitt für Abschnitt vorgehen. Ohne Videotool muss der Benutzer auf Plattformen wie Jimeng, Keling, Vidu, Hailuo usw. generieren – dann vollständige Prompts, welche Bilder als erster/letzter Frame hochgeladen werden müssen, Dauer und Seitenverhältnis angeben, und erklären, wie das Video nach Erhalt zu prüfen ist.
Jede Charge von Assets muss vor der Integration überprüft werden: Frames extrahieren und zu einem Bild zusammenfügen (ffmpeg -i x.mp4 -vf "fps=2,scale=320:-1,tile=6x3" sheet.jpg), Punkt für Punkt mit der Checkliste aus 02 abgleichen. Bei Problemen das Problem genau beschreiben (welche Sekunde, was hat sich geändert, wie sieht es aus), dann die Prompts überarbeiten und neu generieren.
3. Website-Erstellung → references/03_Website-Erstellung und Iteration.md lesen
cp -r <skill>/template <Website-Verzeichnis> # Vorlage kopieren, Original nicht ändern
cd <Website-Verzeichnis>
node <skill>/scripts/fetch-reactbits.mjs . # Verzerrung beim Darüberfahren der Figur, bei Fehlschlag automatischer Rückfall auf liquid
python3 <skill>/scripts/frames.py extract Übergang1.mp4 assets/clips/t1 # Jeder Übergang
python3 <skill>/scripts/frames.py gaze-join assets/clips/gaze Clip1.mp4 Clip2.mp4 … # Blickverfolgung (segmentweise mit erstem/letztem Frame)
python3 <skill>/scripts/frames.py gaze-star assets/clips/gaze L=links.mp4 UL=obenlinks.mp4 … # Blickverfolgung (nur erster Frame: Stern)
node <skill>/scripts/check-site.mjs .
python3 <skill>/scripts/serve.py 8000 # Öffnen http://localhost:8000 (kein Cache)
Die von frames.py ausgegebenen Konfigurationsausschnitte in site.config.js einfügen, dann Text, Farben (theme.bg mit den vom Skript gemeldeten Hintergrundfarben füllen, damit Seite und Video nahtlos ineinander übergehen) und Schriftarten ausfüllen. Blickverfolgungsvideos, die nicht segmentweise zusammengesetzt sind, mit http://localhost:8000/tools/calibrate.html die Keyframes und Kopfposition kalibrieren.
Referenzbilder bestimmen theme und decor: Zuerst nach der Anleitung in 03 „Stil aus Referenzbildern ableiten“ die Grundfarbe, Akzentfarbe, Titel-Schriftart, Dekorationssprache und Figuren-Zeichenstil notieren, dann die Konfiguration ändern. Die Vorlage ist standardmäßig auf Englisch (fester UI-Text in ui änderbar); bei gemischtem Chinesisch/Englisch muss hinter der englischen Titel-Schriftart unbedingt eine chinesische Schriftart stehen (z. B. "Permanent Marker", "ZCOOL QingKe HuangYou"). Wenn das Referenzbild von einem anderen Werk stammt, nur die Stilrichtung übernehmen, nicht die Figur, den Namen, den Text oder das Layout kopieren.
4. Iteration
Im Browser von Anfang bis Ende scrollen und Punkt für Punkt die Checkliste aus 03 durchgehen: Startbildschirm-Blickverfolgung in alle acht Richtungen flüssig? Beim Verlassen des Startbildschirms erst zurück zur Mitte, dann Übergang? Keine Sprünge an den Übergangsenden? Text und Kritzeleien verdecken nicht das Gesicht der Figur? Projektverzeichnis öffnet/schließt sich? Projekt-Karussell funktioniert? Figur am Ende wird nicht von der Leiste verdeckt? Handy-Hochformat.
Immer nur eine Art von Problem auf einmal beheben, dann erneut ansehen. So bleibt die Wirkung jeder Änderung klar, und bereits zufriedenstellende Teile werden nicht beschädigt. In 03 gibt es häufige Probleme und entsprechende Lösungen.
5. Deployment → references/04_Deployment.md lesen
Standardmäßig wird Netlify Drop empfohlen (Ordner per Drag & Drop auf die Webseite ziehen, schon hat man einen öffentlichen Link). Vor dem Deployment noch einmal check-site.mjs ausführen, um sicherzustellen, dass keine Platzhalter-Assets und keine fehlenden Dateien vorhanden sind.
Bei Abgabe klarstellen
- Wo sich das Website-Verzeichnis befindet, wie man es lokal vorschaut, wie man Text ändert und Projekte austauscht (welcher Abschnitt in
site.config.js). - Welche Überprüfungen tatsächlich durchgeführt wurden (in welchem Browser, bei welcher Größe; Screenshots von
shoot.mjsbeweisen nur, dass das Layout stimmt; ob die Bewegung flüssig ist, muss der Benutzer in einem echten Browser sehen) und welche nicht (z. B. nicht auf einem echten Mobilgerät getestet). - Asset-Größe und Ladezeit der Startseite; wenn zu groß, Komprimierungsmöglichkeiten angeben.