📖 FlashNote ユーザーマニュアル

FlashNote (フラッシュノート) へようこそ！本マニュアルでは、サイドバーのデュアルトラック執筆ワークスペース、Tiptap リッチテキストエディタ、インタラクティブ Mermaid 図表、KaTeX 数式、クラウド差分同期の基本操作をご案内します。

🚀 1. クイックスタート

1. サイドバーの起動とショートカットキー

サイドバー常駐：ブラウザ右上の拡張機能アイコンをクリックするか、Chrome サイドパネルから FlashNote を選択します。
瞬速呼び出し：グローバルショートカット Command+Shift+F（Mac）または Ctrl+Shift+F（Windows）を押すと、即座にクイックメモポップアップが表示されます。

2. デュアルトラックワークスペースの切り替え

クイックメモ (Notes)：日常のアイデアメモ、会議の議事録、コードスニペット、ToDo リストの記録に最適です。
体系的な書籍 (Books)：複数章にわたる技術解説書、研究ノート、カリキュラムの執筆に最適です。
上部ナビゲーションアイコンをクリックすることで、メモと書籍のワークスペースをシームレスに切り替えられます。

✍️ 2. エディタモードと組版

1. 4 つの表示モード

ビジュアルモード (Visual)：WYSIWYG 方式。入力中に見出し、タスクリスト、テーブルなどのリッチテキストを直接確認・編集できます。
2画面対照モード (Split)：左側にリッチテキスト、右側に Markdown ソースコードを同期表示します。
Markdown ソースモード (Source)：軽快なプレーンテキスト Markdown 入力体験を提供します。
Web プレビューモード (Preview)：読者視点のクリーンなレイアウトで、リンクの安全なクリックに対応しています。

2. コードブロックと構文ハイライト

``` と入力するとコードブロックが挿入されます。
右上には言語選択メニューとワンクリックコピーボタンを備え、左側にはコピー除外の行番号が表示されます。

📐 3. 数式入力と Mermaid 図表

1. KaTeX LaTeX 数式

インライン数式： $E=mc^2$ と入力すると、カーソルが離れた瞬間にリアルタイム描画されます。
ブロック数式：$$ を入力して Enter を押すか、ツールバーの数式アイコンをクリックします。
数式ダイアログでは、よく使われる記号やギリシャ文字をワンクリックで挿入でき、リアルタイムプレビューも確認できます。

2. インタラクティブ Mermaid 図表スイート

コードブロックで言語に mermaid を指定して構文を入力すると、リアルタイムに図表がレンダリングされます。
キャンバスのパン移動：図表上にカーソルを置くと手のひらアイコンに変わり、ドラッグで自由に移動できます。ダブルクリックで即座に中央リセットされます。
全画面ライトボックス：図表右上の拡大鏡アイコンをクリックすると、94vw × 88vh の大画面モーダルで表示され、30%〜350% の無段階ズームが可能です。
高解像度エクスポート：エクスポートボタンから、ベクター SVG または 2x Retina 高解像度 PNG（24px 余白保護＋純白背景）を出力できます。

🚀 4. ブログ出力の実践：FlashNote を MagicNote 静的サイト専用エディタとして活用

FlashNote は単なる個人メモ帳にとどまらず、VitePress をベースに高度にカスタマイズされた個人ブログテーマ MagicNote などのモダンな技術ブログ向けに設計された、軽量で洗練された執筆・公開ハブです。

1. なぜブログ出力が必要なのか？

手作業の負担から解放：従来の静的ブログの更新には、ターミナルの起動、ファイルの手動作成、記述ミスが起きやすい YAML ヘッダーの入力、画像のコピーなど、煩雑な手順が必要でした。
サイドバーからいつでも執筆：Web 閲覧や技術ドキュメントの調査中であっても、FlashNote を開くだけで Tiptap リッチテキスト、Mermaid 図表、KaTeX 数式を駆使して執筆可能。ワンクリックでコンパイルされ、MagicNote へシームレスに引き渡せます。

2. ブログ直接出力ディレクトリの有効化

FlashNote の「設定」 -> 「フォルダ・カテゴリ管理」に移動します。
公開対象とするフォルダ（tech、life、notes 等）の 【ブログ直接出力】 スイッチを有効にします。
出力を有効にしていないプライベートフォルダ（private 等）は完全に隔離され、コンパイル時に自動的に除外されるため、非公開メモの誤公開を防ぎます。

3. FrontMatter の自動生成と高度な属性マッピング

記事の執筆中に YAML ヘッダーを手入力する必要はありません。FlashNote は直結コンパイル時に標準のメタデータを自動注入します：

タイトル (title) と パーマリンク (slug)：ドキュメント属性パネルで Slug を設定することで、美しい URL（例: posts/tech/modern-frontend-arch.md）を生成。
カテゴリ (category) とタグ (tags)：UI 上で選択した内容が、MagicNote のカテゴリ一覧（/pages/category）やタグ一覧（/pages/tags）と自動連動。
加重ピン留め (order)：プロパティで 0 より大きい数値（例: order: 9）を設定すると、MagicNote のビルド時に自動でトップ固定され、タイトル前に 📌 ピンが表示されます。
リード文・概要 (description)：リッチテキストおよび Markdown 記法に対応。相対パスの画像リンクを自動置換し、本文表示時には重複する先頭アイキャッチ画像をスマートに非表示化。

4. 伴生画像と Mermaid アーキテクチャ図の仕様

FlashNote に挿入された画像やエクスポートされた Mermaid フローチャートは、コンパイル時に専用の同階層フォルダ（例: posts/{folder}/{slug}/）へ自動整理されます。
MagicNote のアセット分離規約に厳格に従い、public/ 開発者用グローバルフォルダを汚染せず、静的ブログのアセットパイプラインで安全に配信されます。

5. コンパイル公開と自動デプロイのサイクル

ローカルエクスポート：上部ツールバーの【ブログ出力】ボタンをクリックすると、現在の記事またはフォルダ全体を MagicNote 仕様の ZIP に一括パッケージ化。解凍してブログの posts/ フォルダに配置できます。
クラウド同期直結：Baidu Netdisk 等のクラウド同期と組み合わせることで、同期ディレクトリ内の posts/ 構造に直接出力。Webhook や CI/CD（Azure DevOps / GitHub Actions）と連動させることで、遠隔地での自動ビルド・デプロイ（blog.aicro.net 等）が瞬時に完了します。

☁️ 5. クラウド差分同期

1. 連携と認証

「設定」 -> 「クラウド同期設定」に移動し、画面の指示に従って認証を完了します。
すべてのデータはお客様専用のプライベートディレクトリ /apps/flashnote/ に安全に保管されます。

2. スライス分割差分アップロード

各章ごとにスライス分割と SHA-256 フィンガープリント照合を行い、変更があった章のみを効率的にアップロードします。
同期完了時、クラウド上には自動で目次アンカー付きの完全な単一電子書籍 ${safeBookName}.md と標準的な SUMMARY.md が生成されます。

🌐 6. 全画面対応スマート Web クリップ＆インスピレーション収集

1. 右クリックコンテキストメニューによる収集

Web ページ閲覧中に右クリックして FlashNote メニューを選択：
- ページ本文のクリップ：ナビゲーションや広告、フッターを自動で除外し、メイン記事本文のみを抽出してメモに保存；
- 選択テキストのクリップ：ハイライトした文章をワンクリックで瞬時に保存；
- リンク / 画像のクリップ：画像や URL を直接メモとして取り込み。

2. 軽量ネイティブトーストと出典の自動記録

Web Toast フィードバック：クリップ成功時、ページ右上にアニメーション付きの保存完了カプセルが表示（OS の通知権限の許可は不要）；
出典 URL の自動記録：元の Web ページタイトルと URL が自動保存され、いつでも参照元を確認可能；
サイドバー自動フォーカス：設定で「クリップ時にサイドバーを自動で開く」を有効にすると、保存後にサイドバーが自動展開し、保存したメモがハイライト表示されます。

🤖 7. AI 執筆アシスタントの設定と活用

1. AI エンジンの設定

「設定」 -> 「AI アシスタント設定」から、お好みの LLM モデルを自由に設定可能：

Chrome 内蔵 AI (Gemini Nano)：完全オフライン実行、ネットワーク遅延ゼロ、100% 端末内プライバシー保護；
Google Gemini API：Google AI Studio で取得した API キーを入力し、最新の Gemini 1.5 / 2.0 Flash などのモデルを直接利用；
カスタム OpenAI 互換エンドポイント：OpenAI 規格に準拠したサードパーティのエンドポイントに自由に接続可能。

2. 独立フローティングアシスタントの操作

エディタのツールバーにある AI アイコンをクリックしてフローティングパネルを表示；
自由なドラッグ＆リサイズ：ヘッダーをドラッグして位置を移動、右下をドラッグして無段階にサイズを調整可能；
即戦力の執筆コマンド：文章の推敲、誤字脱字修正、多言語学術翻訳、要約、アウトライン展開、カスタムプロンプトに対応；
ワンクリック反映：生成された結果を【末尾に追加】【選択範囲を置換】【クリップボードにコピー】からワンクリックで適用。

📊 8. プロダクト＆データ分析の設定 (Google Analytics 4)

1. 匿名テレメトリの概要

FlashNote は Google Analytics 4 Measurement Protocol を採用し、起動速度やツール利用率、動作の健全性を測定して製品改善に役立てています；
100% 匿名化・脱感作：キーボード入力の監視やメモ本文の収集は一切行わず、時間区分と利用頻度のみを安全に集計します (Non-PII)。

2. ユーザーによる完全な制御 (ワンクリック無効化)

「設定」 -> 「プロダクト＆データ分析」に移動；
【Google Analytics 4 匿名分析を有効化】のチェックをいつでも外すことができます；
無効化すると、すべての分析イベントの送信が直ちに完全に停止します。

📬 9. サポートとお問い合わせ

ご不明な点や機能のご要望がございましたら、いつでもお気軽にお問い合わせください：

サポート窓口：[email protected]
公式サイト：https://aicrosoft.com