📖 FlashNote 用戶使用手冊
歡迎使用 FlashNote (流光筆記)！本手冊將幫助您快速熟悉側邊欄雙軌創作工作台、Tiptap 富文本編輯器、Mermaid 互動圖表、KaTeX 數學公式以及網盤差量同步的完整工作流。
🚀 一、 快速入門
1. 喚起側邊欄與快捷鍵
- 側邊欄常駐：點擊瀏覽器右上角擴充功能欄的 FlashNote 圖示，或在 Chrome 側邊欄面板中選擇 FlashNote；
- 閃電呼出：按下預設全局快捷鍵
Command+Shift+F（Mac）或Ctrl+Shift+F（Windows），即可秒級喚起極速速記彈窗。
2. 雙軌工作區切換
- 獨立速記 (Notes)：適合日常隨手記錄臨時想法、會議備忘、常用代碼片段與待辦清單；
- 書籍專欄 (Books)：適合編寫多章節書籍、系統課程大綱或深度技術專著；
- 點擊頂部導航圖示即可在速記與書籍專欄之間無縫切換。
✍️ 二、 編輯器模式與排版體驗
1. 4 種視界形態
- 可視化模式 (Visual)：所見即所得。直接在輸入時呈現富文本排版；
- 雙欄對照 (Split)：左側富文本編輯，右側同步顯示純文本 Markdown 源碼；
- Markdown 源碼 (Source)：原生純文本敲擊體驗，快捷語法自動閉合；
- 純網頁預覽 (Preview)：模擬最終讀者排版，超連結可直接安全點擊。
2. 代碼塊與語法高亮
- 在編輯器中輸入
```即可創建代碼塊； - 代碼塊右上角提供語言切換下拉選單與一鍵复制代码按鈕，左側附帶不可選中的防複製行號。
📐 三、 數學公式與 Mermaid 圖表
1. KaTeX LaTeX 公式
- 行內公式：輸入
$E=mc^2$，光標離開後即刻完成渲染； - 塊級公式：輸入
$$回車，或點擊工具列的公式圖示喚起專用公式編輯器； - 彈窗內支援常用符號快捷點擊插入與毫秒級即時渲染預覽。
2. Mermaid 圖表全功能套件
- 在代碼塊中選擇
mermaid語言，輸入流程圖或時序圖代碼，即可即時渲染可視化圖表； - 畫布平移：滑鼠指針懸停於圖表上將切換為小手光標，按住左鍵自由拖動畫布；雙擊畫布任意區域立即居中復位；
- 全屏燈箱：點擊圖表右上角的放大鏡圖示，即可進入 94vw × 88vh 沉浸式大圖視界，支援 30%～350% 無級縮放；
- 高清導出：點擊導出按鈕，支援導出向量 SVG 或 2x 視網膜高清 PNG（帶 24px 呼吸邊距與純白底色）。
🚀 四、 部落格直通實戰：把 FlashNote 作為 MagicNote 靜態站專用編輯器
FlashNote 不僅是個人靈感速記本，更原生設計為現代技術部落格（如基於 VitePress 深度定制的個人開源部落格主題 MagicNote）的現代化可視化寫作與發佈中樞。
1. 為什麼需要部落格直通？
- 告別繁瑣的手工流：傳統靜態部落格維護必須依賴本地終端、手動創建文件、手敲易錯的 YAML 屬性頭、費力拷貝插圖；
- 側邊欄隨時隨地開寫：無論在查閱資料、看技術文檔還是日常瀏覽，隨時喚起 FlashNote，利用 Tiptap 富文本排版、Mermaid 圖表與 KaTeX 公式暢快寫作，一鍵直通編譯即可無縫交給 MagicNote 構建上線。
2. 啟用部落格直通目錄
- 在 FlashNote 中進入「設定」 -> 「目錄與分類管理」；
- 為您打算公開發佈的物理目錄（如
tech、life、notes）開啟 【部落格直通】 開關； - 未開啟直通的私有目錄（如
private）將保持絕對物理隔離，編譯時自動攔截，杜絕私密筆記誤公開。
3. FrontMatter 自動化與高級字段映射
在撰寫文章時，您無需手動編寫 YAML 頭，FlashNote 會在直通編譯時自動注入標準 5+ 要素元數據：
- 標題 (
title) 與 永久鏈接 (slug)：在文檔屬性面板中配置英文或拼音 Slug，生成整潔美觀的永久鏈接（如posts/tech/modern-frontend-arch.md）； - 分類 (
category) 與 標籤 (tags)：直接在界面中打標籤與選分類，自動與 MagicNote 的分類頁面（/pages/category）與標籤歸檔（/pages/tags）無縫對接； - 加權置頂 (
order)：在筆記屬性中設置大於 0 的數值（如order: 9），MagicNote 編譯期將自動倒排置頂並在首頁標題前呈現 📌 圖釘； - 導讀摘要 (
description)：支援富文本與原生 Markdown 語法，自動重寫相對資源路徑，進入文章正文詳情頁時智能規避重複首屏大圖。
4. 伴生配圖與 Mermaid 架構圖規範
- 在 FlashNote 中插入的配圖或導出的 Mermaid 流程圖，直通編譯時會自動規整到專屬伴生目錄（如
posts/{folder}/{slug}/）； - 嚴格遵循 MagicNote 的內容資產權責隔離規範，不污染
public/開發者全局目錄，由靜態部落格資產管道直接編譯分發。
5. 編譯發佈與自動化上線閉環
- 本地快速導出：點擊頂部工具列的【部落格直通】按鈕，可直接將當前文章或整目錄一鍵打包為符合 MagicNote 規範的壓縮包，解壓放入部落格項目的
posts/目錄； - 雲端網盤直通：結合網盤同步，FlashNote 可直接將編譯產物輸出至同步目錄的
posts/結構下，配合 Webhook 或 CI/CD（如 Azure DevOps / GitHub Actions），遠端拉取後自動觸發pnpm build，實現從瀏覽器側邊欄到公網生產環境（如blog.aicro.net）的自動化極速切流。
☁️ 五、 百度網盤差量雲同步
1. 綁定與授權
- 進入「設定」 -> 「雲同步設定」，按照指引完成百度網盤授權綁定；
- 所有同步數據均嚴格保存在您的個人網盤
/apps/flashnote/專屬目錄下。
2. 差量分卷上傳
- 引擎自動針對每個書籍章節進行分卷切片與 SHA-256 雜湊指紋比對，僅上傳發生改動的章節；
- 同步完成後，雲端將自動生成一份完整的單體長篇電子書
${safeBookName}.md與結構規範的SUMMARY.md。
🌐 六、 全局智能網頁剪藏與靈感捕獲
1. 右鍵上下文剪藏
- 瀏覽任意網頁時，點擊滑鼠右鍵選擇 FlashNote 選單項：
- 剪藏網頁正文：智能剝離導航條、側邊廣告與頁腳，提取核心文章內容存入速記；
- 剪藏選中文本：劃詞選中網頁精彩段落，一鍵保存至流光筆記；
- 剪藏連結 / 圖片：右鍵點擊網頁連結或圖片，自動提取並存入筆記。
2. 動態保存氣泡與溯源
- 輕量原生 Web Toast：剪藏成功後，網頁右上角立即浮現精緻動效保存氣泡，無需申請作業系統通知權限；
- 智能溯源連結：每條剪藏筆記均自動記錄原始網頁標題與 URL，方便日後隨時回溯出處；
- 自動展開定位：在設定中開啟「剪藏時自動打開側邊欄」，保存後側邊欄將平滑滑出並聚焦剛剛生成的筆記。
🤖 七、 AI 智能創作助手使用與配置
1. AI 引擎接入
進入「設定」 -> 「AI 助手設定」，支援自由選擇與編排端雲大模型：
- Chrome 內建端側 AI (Gemini Nano)：完全離線運行、零網路延遲且 100% 本地隱私安全；
- Google Gemini API：輸入 Google AI Studio 申請的官方 API Key，直接調用 Gemini 1.5 / 2.0 Flash 等最新模型；
- 自訂 OpenAI 相容介面：支援接入任何遵循 OpenAI 規範的第三方模型端點。
2. 獨立浮動助手操作
- 在編輯器中點擊頂欄 AI 圖示呼出浮動助手面板；
- 自由拖拽與縮放：按住面板頂欄可自由拖拽位置，拖動右下角可無級縮放面板尺寸；
- 開箱即用寫作指令：支援一鍵文本潤色、語法修正、中英日多語言學術翻譯、文章要點總結、大綱擴寫與自由自訂 Prompt；
- 一鍵採納：生成結果支援【追加至正文】、【替換選中內容】或【一鍵複製】。
📊 八、 產品與數據分析偏好 (Google Analytics 4)
1. 匿名度量說明
- FlashNote 集成 Google Analytics 4 Measurement Protocol，用於了解冷啟動耗時、格式化工具採納率與整體運行健康度，幫助開發者持續優化效能；
- 100% 隱私脫敏：絕不監控打字按鍵，絕不讀取筆記正文與個人資訊，僅回報脫敏的時間分箱與功能頻次。
2. 用戶自主控制 (一鍵關閉)
- 進入「設定」 -> 「產品與數據分析」；
- 隨時取消勾選【啟用 Google Analytics 4 匿名分析】核取方塊；
- 關閉後，擴充功能將立即停止發送一切遙測與分析事件，完全遵從您的隱私偏好。
📬 九、 反饋與技術支援
如果您在使用過程中遇到任何問題或有新功能建議，歡迎隨時與我們聯繫：
- 官方支援信箱：[email protected]
- 官方主頁：https://aicrosoft.com