AI API Key 配置

核心功能（检索、标注、引用、浏览器抓取）完全离线可用，无需 API key。只有 AI 驱动的功能才需要配置密钥。

哪些功能需要 API key

功能	是否需要
混合语义检索（本地 embedding）	✗
混合语义检索（云端 embedding）	✓
选区改写 / 润色	✓
订阅源 AI 摘要	✓
会话自动重命名	✓
Agent 工具（MCP）	✗（使用 agent 自身的密钥）

支持的供应商

打开设置 → AI API 进行配置：

• OpenAI — GPT-4o、GPT-4o mini
• Anthropic — Claude Sonnet、Claude Haiku
• Google Gemini — Gemini 1.5 Pro、Flash
• DeepSeek — DeepSeek V3、V3 Flash
• OpenAI 兼容端点 — Ollama、LM Studio 或任意自定义端点

每个供应商支持多账号。密钥存储在 macOS Keychain——不会以明文保存。

添加密钥

1. 打开设置 → AI API。
2. 点击对应供应商旁的 +。
3. 粘贴 API key，Scholardo 会立即验证。
4. 可选：在任务路由下配置模型分层（快速改写、长文写作、结构化输出各走不同模型）。

Embedding 供应商

语义检索需要在设置 → AI API → Embedding 供应商中配置：

• Jina — 高质量多语言 embedding（推荐）
• OpenAI — text-embedding-3-small / text-embedding-3-large
• Ollama — 本地 embedding，零网络请求

未配置 embedding 供应商时，Scholardo 回退到 FTS5 全文检索。

隐私说明

密钥仅在需要时从 Keychain 读取，不会在内存中缓存超出单次请求的范围，不记录日志，不遥测。