letsgal-ai — Cadena de herramientas de creación asistida por IA para LetsGal Studio

Ingeniería inversa del formato de proyecto de LetsGal Studio desde cero, convirtiéndolo en una herramienta que la IA puede crear directamente: DSL de historia en una línea → proyecto completo y ejecutable (capítulos/personajes/escenas/ramas/actuaciones), con doble vía CLI y MCP, cero dependencias.

• Referencia de formato (ingeniería inversa de la plantilla oficial + paquete de instalación 1.11.0): docs/letsgal-format.md

• Especificación del DSL de historias: docs/STORY-DSL.md

Por qué

LetsGal Studio es un editor GUI de escritorio (sin MCP, sin CLI), pero todo lo que contiene son archivos JSON ordinarios en disco. Este proyecto lleva ese formato completamente al ámbito programático:

• Guion generado por IA → compilado a un proyecto con un solo comando → ábrelo en Studio y juega (luego puedes refinar actuaciones/recursos)

• Formato totalmente alineado con el oficial (project.json / characters.json / scenes.json / chapters/*.json / assets/.manifest.json), Studio lo abre sin errores, y la inserción automática de expresiones de personajes y el reemplazo de recursos funcionan de forma natural

Inicio rápido

# 安装（无需依赖，直接 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 (llamada directa desde agentes de IA)

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

Herramientas expuestas:

Cualquier cliente MCP (Claude Code / DSH / desarrollo propio) puede configurarse con 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

Uso como biblioteca

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

Desarrollo

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

Licencia y agradecimientos

• Esta herramienta es MIT; no incluye recursos. Los proyectos generados pueden usar directamente los recursos de la plantilla oficial de LetsGal Studio (incluidos con el motor)

• Base de la ingeniería inversa: paquete de instalación de LetsGal Studio 1.11.0 (Windows) + plantilla oficial del proyecto

Hoja de ruta

• Conversión bidireccional entre código estilo Ren'Py ↔ Block (alineada con la sintaxis del editor oficial)

• Compilación sin interfaz (reutilizando el build-worker oficial para generar la versión web)

• Componente nativo lilyco (Rust): lilyco-letsgal (ver docs/lyco-integration.md)