letsgal-ai — AI 支援 LetsGal Studio 制作ツールチェーン

LetsGal Studio のプロジェクトフォーマットをゼロからリバースエンジニアリングして、AI が直接制作できる ツールにする： 一行式ストーリー DSL → 完全に実行可能なプロジェクト（章/キャラクター/シーン/分岐/演出）、CLI と MCP の2系統、ゼロ依存。

• フォーマット参考（公式テンプレートと 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）インストーラ + 公式テンプレートプロジェクト

ロードマップ

• Ren'Py スタイルコード ↔ Block 双方向変換（公式コードエディタの文法に準拠）

• ヘッドレスビルド（公式 build-worker を再利用して web 版を生成）

• lilyco（Rust）ネイティブコンポーネント：lilyco-letsgal（docs/lyco-integration.md を参照）