TM紙芝居 4.0 アプリ・教材・ツールチェインガイド

プロジェクトから四つの利用形態へ届ける

2 / 8　プロジェクトと成果物

作品の正本は、起点のYAML、必要に応じて取り込むYAML、ローカル素材、project.source.jsonを含む プロジェクトディレクトリです。同じ検証済みの世代（generation）からプレビューと配布成果物を作ります。

tutorial-story/
├── project.source.json
├── story.k4.yml
├── ocean.svg
├── opening.mp3
├── rescue-pose/
│   ├── model.json
│   ├── metadata.json
│   └── weights.bin
└── chapters/
    ├── rescue.k4.yml
    └── rescue-background.svg

再現性の要点: プレビューとビルドは、ソースと素材を一つの世代として安定取得します。途中保存や片側だけ新しい状態では、実行中の正常な世代を置き換えません。

include文で大きな物語を分割する

3 / 8　include文

include文を有効にすると、起点のソースから複数のYAMLを読み込み、一つの台本として合成できます。 同じ名前の宣言が重なったときに起点優先や後勝ちは行わず、 重複ID、重複する単一設定、循環を診断してから参照を解決します。

include:
  - chapters/rescue.k4.yml
kamishibai: '4.0'
assets:
  Ocean:
    kind: backdrop
    file: ocean.svg
scenes:
  opening:
    - goto: rescue

assets:
  RescueBackground:
    kind: backdrop
    file: rescue-background.svg
scenes:
  rescue:
    - stage: RescueBackground

有限な入力: 一つのソースのバイト数、ソース件数、全ファイルの合計バイト数、`include`の深さ、合成後のバイト数に上限を設け、無制限に読み込みません。

参加者の入力をシーンの出来事へ変換する

4 / 8　シーンと入力

シーンには舞台操作、アクターのアクション、音、時間、分岐、キー・タッチ・ポーズ入力を順に記述します。 ナビゲーションと作品内の入力アクションは同じ入力を競合して消費せず、その時点で意味を持つ一つの受け手へ渡します。

kamishibai: '4.0'

assets:
  Beach: backdrop
  HeroIdle: costume:Hero

actors:
  Hero: HeroIdle

scenes:
  opening:
    - stage: Beach
    - Hero.show:
        skin: HeroIdle
        x: 0
        y: -60
        scale: 30
    - Hero.say:
        text: 助けに行こう
        waitFor: advance
    - keyInputToChangeScene:
        Enter: rescue

出典: シーンを書く、Global action

教材で人・AI・プログラムの役割を分ける

5 / 8　DSL 4.0教材設計

DSL 4.0の教材では、物語と演出を決める人、画像やポーズモデルを作るAI、検証済みアクションを順に実行する プログラムの役割を分けて扱います。YAMLと素材がプロジェクト内で対応するため、変更した対象と結果を追跡できます。

教材の境界: AIの出力をそのまま利用せず、プロジェクトへ保存したソースと素材をレビューし、検証とプレビューを通した世代を使用します。

編集・検証・プレビューを一周する

6 / 8　制作のサイクル

作者はYAMLと素材を外部エディターで編集し、スキーマ診断、参照診断、プレビューの順に確認します。 変更が失敗した場合、プレビューは直前の正常な世代を保ち、ソース位置付きの診断を表示します。

出典: 保存した変更をブラウザーの確認画面へ反映する

紙芝居DSL 4.0が物語を構造化する

7 / 8　DSL 4.0説明

紙芝居DSL 4.0は、YAMLのマッピングとリストでアセット、アクター、スタイル、変数、入力設定、分岐、シーン、アクションを 構造化します。型と局所制約はJSON Schema、参照関係と実行上の制約は意味検証器が検査します。

安全な失敗: 未知のキー、型違反、重複ID、存在しない参照、危険なパスは実行前に診断し、カメラや音声を開始しません。

出典: 紙芝居DSL 4.0 Schemaリファレンス

検証・プレビュー・ビルドを同じ契約で実行する

8 / 8　DSL 4.0ツールチェイン

TM KamishibaiのCLIは配布環境と同じ正規化器、スキーマ、意味検証器、診断モデルを 使います。ビルドはディスク上の候補を再検証し、ソースとローカル素材を含む自己完結SB3を一括して出力します。

tm-kamishibai validate-dsl4 \
  --input story.k4.yml \
  --format pretty

tm-kamishibai build-dsl4 \
  --base base.sb3 \
  --project-root tutorial-story \
  --source-manifest project.source.json \
  --output dist/story.sb3 \
  --control-profile production \
  --channel bundled

配布前確認: 検証、Web Preview、ビルド後の自己完結成果物のスモークテストを、同じプロジェクトの世代に対して行います。

目的に応じて、次の文書へ進みます。

• 作品を作る: 紙芝居DSL 4.0 台本作成ガイド
• 作成中にフィールドとアクションの型を調べる: 紙芝居DSL 4.0 Schemaリファレンス
• 実装を理解・保守する: 紙芝居アプリ 4.0 ソフトウェアメンテナンスガイド