FraGament リファレンス

1. FraGament とは

FraGament は、ゲームや読書、映画、動画視聴など、作品に向き合っている最中に立ち上がる “気づきの断片” をそのまま残すための、完全ローカルのノートアプリです。

ショートタグ、経過時間管理、自動保存、JSON バックアップなど、レビューや創作の補助にも役立つ設計になっています。

作品ごとにノートを分けるための最上位の単位です。小説、ゲーム、映画など、自由に作成できます。

プレイ中・視聴中・読書中に感じた “気づき” を個別に書き残すカードです。 1 行目が表題となり、以降は自由にメモを書くことができます。

・タグの抽出
・時間によるソート
・セッションとの紐付け
など、FraGament 内のさまざまな機能と連動します。

FraGament のメモは CodeMirror6 をベースにしたテキストエディタです。入力と同時に IndexedDB へ保存されます（完全ローカル / 自動保存）。

メモ中の #タグ をリアルタイムに抽出し、断片リストに表示します。

断片ごとに Markdown モードを ON/OFF できます。断片カード右上の M アイコンをタップすると切り替わります。

Markdown モードが ON の断片は、メモが整形されてプレビュー表示されます。プレビューをクリックすると編集モードに切り替わり、フォーカスを外すと再びプレビューに戻ります。

対応要素：見出し / リスト / コードブロック / テーブル / 打ち消し線 / タスクリスト
タスクリストのチェックボックスはプレビュー上でクリック操作が可能です。

断片にスクリーンショットなどの画像を添付できます。
クイックキャプチャを開いた時点でクリップボードに画像があれば、自動で読み込まれます。
Ctrl+V での貼り付け、またはエリアをタップしてファイルから選択することも可能です。

添付画像はブラウザの Origin Private File System（OPFS）にローカル保存されます。
エクスポート時は ZIP ファイルに画像も含まれます。

FraGament では、メモに @f や@t を入力し、改行を押すと自動的にタグへ変換されます。

時間タグの形式は、設定「ショートタグに時間を含める」により#fun-1:23（ハイフン結合）または#fun 1:23（スペース分離）に変化します。

@t⏎ のように、入力後にスペースまたは改行で変換されます。

タイトルを開くたびに自動的に「セッション」が作成されます。セッションとは、作業時間のまとまりを表す単位です。

・開始時刻 / 終了時刻
・経過時間のリアルタイム表示
・セッション内で作成した断片の数

これらはすべて自動で記録され、プレイ・読書・作業の進行と思考の変化を紐づけることができます。

すべてのデータを ZIP ファイルとして出力できます。
ZIP には、テキストデータ（JSON）とすべての添付画像が含まれます。

別の端末への移行や復元が可能です。ファイル形式に応じて自動で処理されます。

※ インポート時は現在のデータが上書きされます。

断片を結合し、レビュー原稿として出力できます。