Formerly KrillinAI, VideoTranslation and Dubbing Tool for 120+ Languages. Open-source AI workspace for creators, powered by Codex. Video downloader, video translation, create videos, images, audios, and edits with Agents in one place. For your Social Media like YouTube, TikTok, Instagram, etc.
Leitfaden für Beiträge (Deutsch)
English | 简体中文 | 日本語 | 한국어 | Bahasa Indonesia | Español | Français | Deutsch | Português | Русский | العربية
Danke, dass du zu OpenCreator beitragen möchtest. OpenCreator ist ein Local-First-Workspace für Kreative auf Basis des Codex-Agent-Loops, und der größte Mehrwert entsteht durch fokussierte Ergänzungen: ein Skill-Ordner, ein Creation-Template, ein klar abgegrenzter Fix. Dieser Leitfaden zeigt, wo jede Art von Beitrag hingehört und welche Anforderungen ein PR vor dem Merge erfüllen muss.
Beitrags-Übersicht
| Wenn du … | Dann fügst du hinzu | Ort | Umfang |
|---|---|---|---|
| einen Bug beheben oder einen Workflow verbessern möchtest | Code | apps/web/, apps/daemon/ |
ein fokussierter PR mit Tests |
| einen wiederverwendbaren Agent-Workflow hinzufügen möchtest | einen Skill | skills/<dein-skill>/ |
ein Ordner mit SKILL.md und optionalen Referenzen → Anleitung |
| ein wiederverwendbares Bild-, Video- oder Cover-Preset hinzufügen möchtest | ein Creation-Template | template/<module>/<id>/<version>/ |
ein Ordner mit template.json und Assets → Anleitung |
| Illustrationen, Icons oder UI-Designs beisteuern möchtest | Design-Assets | vereinbarter Asset-Ort | ein PR mit Vorschauen, Quelldateien und Lizenz |
| einen KI- oder Mediendienst anbinden möchtest | eine Service-Integration | relevantes Web- oder Daemon-Modul | ein PR mit Fehlerbehandlung, Credential-Sicherheit und Tests |
| Dokumentation oder Übersetzungen verbessern möchtest | Docs | README.md, docs/, docs/<locale>/README.md |
ein PR |
Fragen und Reviews
Eröffne ein Issue, um eine Idee zu besprechen oder den richtigen Bereich zu finden. Erwähne bei einem PR das zuständige Mitglied des Teams für Code und Fehlerbehebungen, Vorlagen, Design und Assets oder Skills und Dokumentation. Das Team hilft bei Standards, Reviews und Community-Fragen; für die Zusammenführung gelten die Berechtigungen und erforderlichen Prüfungen des Repositorys.
Lokale Einrichtung
Die vollständige Einrichtung steht im README-Quickstart. Kurzfassung für Contributors:
git clone https://github.com/krillinai/OpenCreator.git
cd OpenCreator
corepack enable # wählt die gepinnte pnpm-Version aus packageManager
pnpm install
pnpm web:dev # Web + lokaler Daemon bei Bedarf
pnpm typecheck # TypeScript-Prüfungen im gesamten Repository
pnpm test # Unit- und Integrationstests des Workspaces
Node.js 22+ und eine Codex-CLI sind erforderlich. Nach pnpm web:dev http://127.0.0.1:19861/ öffnen; die Runtime erstellt beim ersten Start automatisch ein Standardprojekt, und der Composer ist bereit, sobald die Verbindung steht.
So trägst du bei
- Beschreibe das Problem, den Anwendungsfall und das erwartete Verhalten in einem Issue.
- Erstelle einen fokussierten Feature- oder Fix-Branch vom aktuellen Entwicklungsbranch.
- Folge der bestehenden Architektur: Allgemeine Produktfunktionen werden einmal in Web und Daemon implementiert; Desktop-native Unterschiede werden über explizite Capabilities isoliert (z. B.
canSelectDirectory). - Füge für Verhaltensänderungen passende Unit-, Integrations- oder E2E-Tests hinzu und liste im PR sowohl durchgeführte als auch übersprungene Verifizierungen auf.
- Committe niemals
.runtime/, lokale Zugangsdaten, Codex-Sessions, Build-Caches oder andere Nutzerdaten.
Was Reviewer prüfen
- Eine einzige Implementierung für geteiltes Verhalten. Dieselbe Funktion darf nicht getrennt für Browser Bridge und Desktop Bridge implementiert werden.
- Capability-Gating statt stiller Stubs. Ein plattformspezifischer Einstieg muss ausgeblendet werden, wenn die Capability nicht verfügbar ist — niemals einen Button zeigen, der still nichts tut.
- Tests passend zum Änderungsrisiko. Kleine Text- oder Style-Anpassungen brauchen nur gezielte Prüfungen; Änderungen an geteiltem State, Persistenz oder Runtime-Verträgen erfordern mindestens Modultests und Typecheck.
- Dokumentation wird mit dem Verhalten aktualisiert. Wenn deine Änderung einen nutzersichtbaren Workflow verändert, aktualisiere im selben PR die README oder die relevante Datei in
docs/.
Häufige Gründe für zurückgewiesene PRs
- Dieselbe Logik wurde getrennt in Web- und Desktop-Pfaden hinzugefügt statt im geteilten Service-Layer.
- Ein von der Plattform nicht unterstützter Button ist sichtbar, aber der Handler kehrt still zurück.
- Verhalten geändert ohne Tests oder Verifizierungshinweis.
- Der PR mischt ein unrelated Refactoring oder einen fremden Fix in eine Feature-Änderung.
- Generierte Dateien,
.runtime/-Daten oder Zugangsdaten wurden committet.
OpenCreator · Create locally, work continuously.