🤖 05. AI 服務 (AI Services)

讓用戶知道如何配置，以及資料會如何使用。
FlashNote 深度整合了現代化多模型 AI 能力，旨在成為您寫作思考的「副駕駛 (Copilot)」，同時堅守完全本地優先與嚴格的資料隱私保護。

📑 本篇大綱

1. AI 功能有哪些？
2. 如何配置 AI 服務？
3. API 位址、模型與密鑰如何填寫？
4. 常見連接錯誤排查
5. 哪些內容會被發送給 AI 服務商？

1. AI 功能有哪些？

FlashNote 將 AI 精準嵌合在日常創作的高頻節點上，拒絕無意義的玩具功能，專注生產力：

• ✨ FrontMatter 單次往返智慧雙提：
  • 點擊工具欄的「AI 提煉」；
  • 單次 API 調用同時提煉出 150~280 字純淨正文摘要，並自動識別核心實體生成分類標籤（例如 #TypeScript、#前端架構）；
  • 相比傳統拆分提煉的兩次調用，直接節省 50% 的 API 額度和網路耗時；
• 🌐 多語言智慧對齊：系統自動識別正文語種，提煉的摘要與標籤自動對齊正文語言（如中文正文生成中文標籤，日文正文生成日文標籤）；
• 📝 智慧續寫與排版潤色：劃選指定段落，可一鍵進行錯別字修正、學術風潤色、翻譯或根據上文要點擴寫；
• 🔄 429 故障智慧切換 (Failover)：當配置了備用模型時，如果遭遇主模型調用頻控或單日配額耗盡，系統自動切換至健康備用模型，保障心流不中斷。

2. 如何配置 AI 服務？

進入 FlashNote 側邊欄左下角「設定」 -> 「AI 服務配置」，您可根據自身網路與帳戶偏好選擇任意提供商：

1. 主流雲端大模型：
   • Google Gemini：支援 Gemini 1.5 Pro / Flash 等（推薦，響應極速且提供豐厚免費額度）；
   • DeepSeek (深度求索)：高性價比首選，支援 DeepSeek-V3 / R1；
   • OpenAI：支援 GPT-4o / GPT-4o-mini 等官方與相容中轉接口；
   • Anthropic Claude：支援 Claude 3.5 Sonnet 等高文采模型；
2. 完全離線本地私有模型：
   • Ollama：支援在本地運行的 Llama 3、Qwen 2.5、Mistral 等本地大模型，斷網可用，0 隱私外洩；
   • Chrome 內建 AI (Prompt API)：支援 Chromium 瀏覽器內建的 Gemini Nano 模型，原生毫秒級響應。

3. API 位址、模型與密鑰如何填寫？

在 AI 配置表單中，各項配置說明如下：

• 提供商類型 (Provider)：從下拉選單中選擇對應平台或選擇「Custom OpenAI-Compatible（自定義相容）」；
• API 端點 (Base URL)：
  • 若使用官方服務，系統已預設填入標準官方端點；
  • 若使用第三方反向代理或私有中轉站，在此輸入例如 https://api.your-proxy.com/v1；
  • 若使用本地 Ollama，填寫 http://localhost:11434/v1；
• API 密鑰 (API Key)：
  • 貼上對應平台獲取的 Secret Key；
  • 安全儲存機制：您的 API Key 僅以強加密形式儲存在瀏覽器的本地受保護安全沙盒中，絕不會上傳至 Aicrosoft 任何伺服器；
• 模型名稱 (Model)：
  • 填寫目標模型 ID，例如 gemini-1.5-flash、deepseek-chat 或 gpt-4o-mini；
• 備用模型 (Fallback Model，可選)：
  • 填入第二順位的模型名稱，用於在主模型遇到 429 頻控時自動無縫接管。

填寫完成後，點擊表單下方的 「測試連接」，系統將發送最小化探測包，顯示連通延時與驗證狀態。

4. 常見連接錯誤排查

5. 哪些內容會被發送給 AI 服務商？

FlashNote 恪守嚴格的極簡上下文與主動觸發原則：

1. 絕無靜默上傳：FlashNote 不會在後台全量掃描、上傳或索引您的任何筆記庫；
2. 按需單次傳輸：僅在您明確點擊「AI 提煉」、「AI 潤色」等互動操作時，當前文章被請求的文本片段才會被打包進請求體直接發送給您自己填寫的 API 目標位址；
3. Prompt 消毒與脫敏：系統在組裝 Prompt 時會自動過濾掉無關的系統變量與個人敏感標識；
4. 如果您對隱私有最高要求：建議搭配本地 Ollama 使用，所有文本計算 100% 在您本機的顯卡/CPU 上運行，斷網環境下依然穩定可用。