🤖 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 上运行，断网环境下依然稳定可用。