Was macht xiaohongshu-tech-card-report?
Codex-Fähigkeit zur Erstellung wöchentlicher GitHub-Trend-Hot-Karussellpakete für Xiaohongshu mit Live-Trending-Daten, SEO-optimierten Bildunterschriften, 3:4-Bildvalidierung und sauberen PNG-Zip-Dateien.
Überblick
Diese Fähigkeit automatisiert die Erstellung wöchentlicher GitHub-Trend-Berichte, die als Xiaohongshu-Karussell-Pakete veröffentlicht werden. Sie ruft Live-Trending-Daten von GitHub ab, generiert SEO-fertige Bildunterschriften, validiert Bilder auf das korrekte 3:4-Seitenverhältnis und erstellt saubere PNG-Zip-Archive.
Verwendung
Voraussetzungen
- Codex CLI installiert und konfiguriert
- Python 3.8+ mit den folgenden Bibliotheken:
requestsPillowjinja2- Standardbibliotheken:
json,zipfile,os,datetime,io
Installation
-
Klonen Sie das Repository:
git clone https://github.com/SkyNotSilent/xiaohongshu-tech-card-report.git cd xiaohongshu-tech-card-report -
Installieren Sie die Abhängigkeiten:
pip install -r requirements.txt -
Richten Sie Codex ein, um diese Fähigkeit zu verwenden:
codex --load-skill ./skill.md
Befehle
| Befehl | Beschreibung |
|---|---|
fetch-trending [sprache] | Ruft die aktuellen GitHub-Trending-Repositories ab (Standard: 'python') |
validate-images [pfad] | Überprüft Bilder auf das 3:4-Seitenverhältnis und gibt eine Zusammenfassung |
generate-zip [ausgabe] | Erstellt ein ZIP-Archiv mit generierten PNG-Karten und einer metadata.json |
create-report | Führt den vollständigen Workflow aus: Abrufen, Generieren, Validieren, Packen |
Workflow
-
Trending-Daten abrufen: Der Befehl
fetch-trendingruft die GitHub Trending API auf und ruft die Top-Repositories der Woche ab (z. B. Sterne, Forks, Beschreibung). -
Karten generieren: Verwenden Sie die abgerufenen Daten, um für jedes Repository eine Bildkarte zu erstellen. Jede Karte enthält:
- Repository-Name und Beschreibung
- Sternenanzahl und Sprache
- Einheitliches 3:4-Seitenverhältnis (z. B. 1080x1440 px)
-
Bilder validieren: Der Befehl
validate-imagesprüft jedes generierte Bild auf das korrekte 3:4-Seitenverhältnis. Bei Abweichungen werden die Bilder automatisch zugeschnitten oder skaliert, um dies zu korrigieren. -
Paket generieren: Der Befehl
generate-ziperstellt ein ZIP-Archiv mit:- Allen gültigen PNG-Karten (benannt nach
repo_name.png) - Einer
metadata.jsonmit SEO-fertigen Bildunterschriften (auf Deutsch), Erstellungsdatum und Repository-Details
- Allen gültigen PNG-Karten (benannt nach
Beispiel
# Vollständigen Bericht generieren
codex run-skill SkyNotSilent/xiaohongshu-tech-card-report create-report
Erwartete Ausgabe:
xiaohongshu_weekly_report_2025_W10.zipmetadata.jsonpytorch.pngtransformers.pngopenai-gym.png- ...
Konfiguration
| Umgebungsvariable | Beschreibung | Standardwert |
|---|---|---|
OUTPUT_DIR | Verzeichnis für generierte Dateien | ./output |
IMAGE_WIDTH | Breite der Karten in Pixeln | 1080 |
IMAGE_HEIGHT | Höhe der Karten in Pixeln | 1440 |
TRENDING_LANGUAGE | Standard-Programmiersprache für Trending | python |
MAX_REPOS | Maximale Anzahl von Repositories pro Bericht | 10 |
Lizenz
Mitwirken
Beiträge sind willkommen! Bitte öffnen Sie ein Issue oder einen Pull Request für Vorschläge.
Fehlerbehebung
-
Problem:
fetch-trendinggibt einen leeren Datensatz zurück.- Lösung: Überprüfen Sie Ihre Internetverbindung und ob die GitHub Trending API erreichbar ist.
-
Problem: Bilder haben nicht das 3:4-Seitenverhältnis.
- Lösung: Führen Sie
validate-imagesmit der Option--auto-fixaus, um sie automatisch zuzuschneiden.
- Lösung: Führen Sie
-
Problem: Das ZIP-Archiv ist beschädigt.
- Lösung: Stellen Sie sicher, dass alle Dateien gültige PNGs sind und führen Sie
generate-ziperneut aus.
- Lösung: Stellen Sie sicher, dass alle Dateien gültige PNGs sind und führen Sie