在 Obsidian 中通过 Copilot 插件配置 Google Gemini 2.5 Flash（当前 2026 年的主流高性能模型）非常直观。由于 Gemini 2.5 Flash 拥有极高的上下文窗口和处理速度，它非常适合处理大型 Obsidian 库。
以下是完整的安装与配置教程：
—
第一步：获取 Google Gemini API Key
在使用插件之前，你需要一个有效的 API 密钥。
访问 [链接登录后可见]。
登录你的 Google 账号。
点击左侧边栏的 “Get API key”。
点击 “Create API key”。建议为该 Key 命名（如 “Obsidian-Copilot”）以便管理。
复制并妥善保存该密钥。
—
第二步：在 Obsidian 中安装 Copilot 插件
打开 Obsidian，进入 Settings（设置） > Community plugins（社区插件）。
确保 Restricted mode（安全模式）已关闭，点击 Browse。
搜索 Copilot（由 Logan Yang 开发的版本，目前功能最全）。
点击 Install，安装完成后点击 启用。
—
第三步：配置 Gemini 2.5 Flash 模型
安装完成后，需要将 API 密钥填入并选择正确的模型。
1. 填入 API Key
2. 选择并刷新模型列表
返回 Copilot 的配置主页面。
找到 Default Model（默认模型）选项。
关键步骤： 如果下拉列表中没有看到 gemini-2.5-flash，请点击附近的 “Refresh Built-in Models”（刷新内置模型）按钮。
在下拉菜单中选择 gemini-2.5-flash。
—
第四步：进阶设置（推荐）
为了让 Gemini 更好地理解你的笔记，建议进行以下微调：
Index Vault（库索引）： 在 Copilot 设置中开启 “Vault QA” 或 “Index Vault”。Gemini 2.5 强大的上下文能力可以让你针对全库笔记进行问答。
Temperature（随机性）： 建议设置为 0.7 左右。如果你希望它更严谨地回答笔记内容，可以调低至 0.3。
Max Tokens： 建议设置得高一些（如 4096 或更高），以充分利用 Flash 模型的长文本输出能力。
—
常见问题排查
Gemini 2.5 Flash 在处理多语言（尤其是中文）和复杂逻辑推演上比 1.5 版本有显著提升，且在 API 额度内通常有非常慷慨的免费调用层级。
