playchat/docs/notes-guide.md

# 共有ノートの使い方

ユーザーとAIが同じノートを一緒に編集できる機能。ページをタブで切り替え、関連するページ同士は
セクションでグループ化できる。実装の詳細は `docs/architecture.md` の「共有ノート」節、
API 仕様は `docs/api.md` の「共有ノート」節を参照。

## 開き方

画面右上ヘッダーの **「ノート」** ボタンをクリックすると、右側にノートパネルが開く。
もう一度クリックすると閉じる。

## ページの操作

| 操作 | 方法 |
|---|---|
| ページを開く | タブをクリック |
| ページを新規作成 | タブ列右端の **＋** をクリック（末尾に「新しいページ」が追加される） |
| タイトルを変更 | タブを**ダブルクリック**すると入力欄になるので書き換えて Enter（または欄外をクリック） |
| ページを削除 | タブ内の **×** をクリック（確認ダイアログあり） |
| 本文を編集 | ページを開いた状態で下の編集エリアに直接入力 |

本文は入力を止めてから少し待つと自動保存される。保存待ちの間はタブに **●**（未保存マーク）が付く。
ページが1つも無い場合は「＋ 最初のページを作成」から始められる。

## セクションでまとめる

複数のページを1つのグループとしてタブ上にまとめられる。

| 操作 | 方法 |
|---|---|
| ページをセクションに入れる | タブにマウスを乗せると出てくる **🏷** をクリックし、セクション名を入力 |
| セクション名を変更する | セクションのラベル（タブ群の左上に表示される名前）をクリックし、新しい名前を入力 |
| セクションを解除する | 🏷 またはセクションラベルをクリックした際、名前を**空欄**にして確定 |

同じセクションに入れたページは、タブ列上で必ず隣り合って表示される
（新しくセクションに追加したページは、そのセクションの末尾に自動的に移動する）。
セクション名を変更すると、そのグループに属する全ページのラベルが一括で変わる。

## タブをドラッグで動かす

タブは**ドラッグ&ドロップ**でも操作できる（🏷 やセクションラベルのクリックと同等の結果になる）。

| 操作 | 方法 |
|---|---|
| 同じグループ内で順番を変える | タブを掴んで、移動先のタブの左半分/右半分にドロップ（左=そのタブの前、右=後ろに入る） |
| 別のセクションへ移動する | 移動先のセクション内のタブにドロップ（そのタブと同じセクションに入る） |
| セクションから外す | 未分類のタブにドロップ、またはタブ列の一番右（＋ボタンの手前の細い枠）にドロップ |

ドラッグ中はドロップ位置に青い線が表示される。タイトル編集中（ダブルクリックで入力欄になっている間）のタブはドラッグできない。

## AIとの連携

- 全ページの**タイトル一覧**は、会話のたびに自動でAIに渡される（セクションがあれば見出し付きで）。
  ただし本文はここには含まれない。
- AIは `read_note` ツールでページ本文を読み、`write_note` ツールで追記・置き換え・新規ページ作成ができる。
  「ノートに書いておいて」「〇〇について記録して」のように頼むと、AIが該当ページを判断して書き込む。
- AIがノートを書き換えると、開いているノートパネルは自動的に最新の内容へ更新される。
- 自分が編集中（未保存）のページは、AIの更新で上書きされない。