letsgal-ai — AI-ассистируемый инструментарий для творчества в LetsGal Studio

С нуля реверс-инжиниринг формата проектов LetsGal Studio, превращающий его в инструмент, с которым AI может творить напрямую: однострочный DSL для историй → полностью рабочий проект (главы/персонажи/сцены/ветвления/постановка), два канала — CLI и MCP, ноль зависимостей.

• Справка по формату (реверс-инжиниринг из официальных шаблонов + установочного пакета 1.11.0): docs/letsgal-format.md

• Спецификация DSL для историй: docs/STORY-DSL.md

Зачем

LetsGal Studio — это настольный GUI-редактор (без MCP, без CLI), но всё в нём — это обычные JSON-файлы на диске. Данный проект полностью программатизирует этот формат:

• AI генерирует сценарий → одна команда компилирует его в проект → Studio открывает и можно играть (постановку/материалы можно дорабатывать вручную)

• Формат полностью выровнен с официальным (project.json / characters.json / scenes.json / chapters/*.json / assets/.manifest.json), Studio открывает без единой ошибки, автоматическое исправление при слиянии выражений лиц персонажей, замена материалов — всё естественно

Быстрый старт

# 安装（无需依赖，直接 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 (прямой вызов AI-агентом)

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

Доступные инструменты:

Любой MCP-клиент (Claude Code / DSH / собственный) настраивается командой 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

Использование как библиотеки

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

Разработка

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

Лицензия и благодарности

• Этот инструмент — MIT; без материалов. Сгенерированные проекты могут напрямую использовать официальные материалы шаблонов LetsGal Studio (поставляются с движком)

• Основание для реверс-инжиниринга: установочный пакет LetsGal Studio 1.11.0 (Windows) + официальные шаблоны проектов

Roadmap

• Двустороннее преобразование кода в стиле Ren'Py ↔ Block (выравнивание с синтаксисом официального редактора кода)

• Безголовая сборка (переиспользование официального build-worker для выпуска web-версии)

• Нативный компонент lilyco (Rust): lilyco-letsgal (см. docs/lyco-integration.md)