# 脚本エディターの概要

> 意味を持つ9種類の行ノード、Tabと数字キーによる種別変更、4層の構造、統一された取り消し機能、本文と資料の蓄積連携を説明します。

Source: https://loomworld.ai/ja/docs/editor-overview

## Loomworldにおけるエディターの位置づけ

脚本エディターはLoomworldの中核です。資料モジュール、タイムライン、伏線、そしてAI協働は、すべて本文を中心に展開されます。脚本は実際に執筆されたシーンを記録し、ライブラリは作家が意図して維持・管理する設定事実を記録します。両者は参照と構造によって結びついていますが、互いを勝手に書き換えることは決してありません。

## 9種類の構造化ノード

脚本は9種類のノードタイプで構成され、それぞれが明確な意味を持っています：

- 描写：シーンの叙述や通常の散文。
- 登場人物：発言者の名前。キャラクターカードと紐づきます。
- セリフ：該当する登場人物の発言内容。
- ト書き：セリフと並行して行われる舞台上の動作。
- ナレーション：語り手の声、または画面外からの声。
- メモ：作者自身のための控え。現在の話者コンテキストを終了します。
- トランジション：シーン間の切り替えマーク。
- 時空（シーン設定）：同一シーン内の場所や時間の切り替え（カード上の表示は「時空」）。
- シーン：ドラマの単位となる構造アンカー。

構造化の恩恵はすぐに実感できます。エディターはタイプごとにレンダリングや折りたたみを行い、AIは「セリフ」と「ト書き動作」を正確に識別し、ライブラリは原稿内のキャラクターやロケーションを正確に検索・特定できます。

## 素早い種別変更：Tab、スラッシュ、数字キー

執筆のリズムが書式設定によって中断されてはなりません。Loomworldはノードの種別変更を直感的なマッスルメモリーに変えます：

- `Tab` でタイプメニューを開きます。空行の行頭では `/` も使用できます；
- `1`〜`9` の数字キーで対応するタイプを選択できます；
- 登場人物行の後にEnterを押すとデフォルトでセリフ行になり、その他のコンテンツ行の後にEnterを押すと描写行に戻ります。

種別変更はノードのタイプ属性を変更するだけであり、入力済みの文章が改変されることはありません。文字が失われる心配はありませんので、安心して操作してください。

## 4層の構造とシーンアンカー

脚本は、章、シーン、時空（シーン設定）、脚本ノードの4層で編成されます。シーンはドラマの1つの単位を確立し、時空はその内部における場所と時間の推移を記録します。章ごとの執筆意図にはその章で進めるべき展開を記録でき、チャットボックスに続きの執筆を依頼する際のゴールとしても機能します。

## 本文とライブラリの連携

脚本内の選択範囲を右クリックすることで、キャラクター、ロケーション、小道具、世界観設定にリンクできます。世界観設定の解説などの長文フィールドでは、@ を入力して参照を挿入できます。章のコンパニオンパネルは、章、シーン、時空の構造表示と調整のみを行い、AIの提案を直接保持することはありません。

各項目の入口や自動・手動の機能境界について詳しくは、[エンティティへの言及と@](https://loomworld.ai/ja/docs/references) および [モジュール間の連携](https://loomworld.ai/ja/docs/cross-sync) をご覧ください。

## 既存原稿インポート時の挙動

プロジェクトロビーでTXTまたはDOCXファイルを「原稿としてインポート」すると、テキストは元の順序のままローカルで各行のコンテンツに解析されます。AIモデルによる書き換えは行われず、キャラクター、ロケーション、小道具が勝手に作成されることもありません。処理が中断された場合でも、重複することなくカーソル位置からインポートを再開できます。既存の原稿からライブラリを育てたい場合は、取り込み完了後に各行の種別を設定し、文章をリンクしてください。

## 制限事項とトラブルシューティング

- 印刷組版エンジンではありません。フォントサイズ、余白、用紙規格などの設定はありません。納品用には「設定」→「プロジェクトデータ」→「納品用エクスポート」からWord、PDF、またはQuilldown形式をご利用ください。
- コピー操作では書式スタイルは保持されず、複数行を選択してコピーするとプレーンテキストとして取得されます。
- シーン番号は脚本内のシーンノードの順序に厳密に従います。手動で作成されたシーンと脚本のシーンが混在する場合でも、脚本上の順序に基づいて番号が振られます。
- 空のフィールドはレンダリングビューで余白を占有しません。また、ナレーションは唯一の語り手ノードであり、ほぼ同義の重複するノードタイプを二重に管理する必要はありません。
