letsgal-ai — KI-gestützte LetsGal-Studio-Authoring-Toolchain

Das LetsGal-Studio-Projektformat von Grund auf reverse-engineeren und in ein Werkzeug verwandeln, mit dem KI direkt erstellen kann: Story-DSL in einer Zeile → vollständig ausführbares Projekt (Kapitel/Figuren/Szenen/Verzweigungen/Inszenierung), CLI- und MCP-Doppelkanal, null Abhängigkeiten.

• Formatreferenz (aus offizieller Vorlage + 1.11.0-Installationsprogramm reverse-engineert): docs/letsgal-format.md

• Story-DSL-Spezifikation: docs/STORY-DSL.md

Warum

LetsGal Studio ist ein Desktop-GUI-Editor (kein MCP, keine CLI), aber alles davon ist schlichtes JSON auf der Festplatte. Dieses Projekt macht das Format vollständig programmatisch:

• KI-generierte Drehbücher → mit einem Befehl zu einem Projekt kompilieren → im Studio öffnen und loslegen (Inszenierung/Assets können weiter verfeinert werden)

• Format vollständig an der offiziellen Version ausgerichtet (project.json / characters.json / scenes.json / chapters/*.json / assets/.manifest.json), Studio öffnet fehlerfrei, automatische Reparaturen, das Einfügen von Gesichtsausdrücken der Figuren und das Ersetzen von Assets funktionieren nahtlos

Schnellstart

# 安装（无需依赖，直接 clone 或 npm link）
npm link                    # 或 node bin/letsgal-ai.js …

# 1. 初始化工程骨架
letsgal-ai init my-game --name "时间的河流"

# 2. 写故事（见 examples/example.dsl）→ 编译
letsgal-ai build story.dsl -o my-game --name "时间的河流"

# 3. 校验
letsgal-ai validate my-game

# 4. 用 LetsGal Studio 打开 my-game → 播放

MCP (KI-Agent direkt aufrufbar)

letsgal-ai mcp     # stdio JSON-RPC 2.0，零依赖实现

Verfügbare Werkzeuge:

Jeder MCP-Client (Claude Code / DSH / eigene Entwicklung) konfiguriert einfach node bin/letsgal-ai.js mcp.

CLI

letsgal-ai init <dir> [--name 标题]
letsgal-ai build <story.dsl> -o <dir> [--name 标题]
letsgal-ai validate <dir>
letsgal-ai list <dir>
letsgal-ai mcp

Als Bibliothek verwenden

import { compileStory, initProject, validateProject, applyCharacterFlow, dialogue, narration, scene } from '@lilyco-42/letsgal-ai';

Entwicklung

npm test        # 冒烟测试：init → build → validate → MCP 握手

Lizenz und Danksagungen

• Dieses Werkzeug ist MIT-lizenziert; enthält keine Assets. Generierte Projekte können direkt die offiziellen LetsGal-Studio-Vorlagen-Assets verwenden (im Lieferumfang der Engine enthalten)

• Reverse-Engineering-Grundlage: LetsGal Studio 1.11.0 (Windows) Installationsprogramm + offizielles Vorlagenprojekt

Roadmap

• Ren'Py-artiger Code ↔ Block bidirektionale Konvertierung (an der offiziellen Code-Editor-Syntax ausgerichtet)

• Headless-Build (Wiederverwendung des offiziellen build-worker zur Erstellung der Web-Version)

• lilyco (Rust) native Komponente: lilyco-letsgal (siehe docs/lyco-integration.md)