Obsidian AI配置教程：用插件接入大模型并调用
Obsidian 本身不包含 AI 功能，所谓的“AI 配置”实际是安装社区插件并填入第三方大模型服务的 API 密钥，让插件替你调用模型。
整个过程在 Obsidian 内部完成，不需要单独部署服务器，但需要你有一个可用的 API 密钥（OpenAI、Anthropic 或兼容接口均可）。
先确认两件事再动手
开始前需要准备两样东西：一是 Obsidian 桌面版（社区插件在移动端支持有限，建议在电脑上操作），二是目标模型服务商提供的 API Key 和接口地址。
如果你用 OpenAI 官方服务，密钥形如 sk-...，接口地址通常是 https://api.openai.com/v1；
如果用中转或兼容服务，以服务商给的 Base URL 为准。
打开 Obsidian，进入 设置 → 第三方插件，关闭“安全模式”（新版可能叫“限制模式”），然后点击“浏览”进入社区插件市场。
安装插件并填入密钥
以 Text Generator 为例，在插件市场搜索 Text Generator，点击安装并启用。
启用后进入 设置 → Text Generator，找到 API Key 一栏粘贴密钥。
如果服务商不是 OpenAI 官方，还需要在 Custom API Endpoint 或类似字段中填入对应的 Base URL。
另一个常用选择是 Copilot 插件，安装后在设置里选择模型提供商（OpenAI、Anthropic、本地 Ollama 等），再填入对应密钥或本地地址。
两者的区别是：Text Generator 偏向模板化生成，Copilot 偏向对话式问答和选中文本处理。
新手可以先装一个，跑通后再考虑第二个。
在笔记里验证是否可用
配置完成后不要直接依赖，先做一次最小验证。
新建一篇笔记，输入一句提示词，例如“用一句话解释什么是 Markdown”，然后通过命令面板（Ctrl+P 或 Cmd+P）搜索插件提供的命令，比如 Text Generator: Generate Text，执行后观察是否返回内容。
如果返回正常，说明密钥和网络都通。
如果报错，常见原因有三类：密钥无效或余额不足、Base URL 填错、网络无法直连该服务。
可以先用 curl 在终端测试接口是否可达：
curl https://api.openai.com/v1/models \
-H "Authorization: Bearer 你的密钥"返回 JSON 列表说明密钥有效；
返回 401 是密钥问题，返回超时多半是网络问题。
几个容易踩的坑
第一，不要把密钥直接写进笔记正文或同步到公开仓库，密钥只应保存在插件设置里。
第二，部分插件默认模型名可能已过时，需要在设置中手动改成服务商当前可用的模型名，否则会报“模型不存在”。
第三，如果你使用本地模型（如 Ollama），要确保本地服务已启动，接口地址一般填 http://localhost:11434，并注意跨域设置。
第四，插件生成的内容需要人工核对，尤其是事实性内容，不要直接当作准确答案。
配置完成后的检查清单
- 插件已启用，设置页能看到密钥输入框且已填写。
- 命令面板中能搜索到该插件的生成命令。
- 用一句简单提示词测试，能返回文本即视为通路正常。
- 若失败，按“密钥 → 接口地址 → 网络”顺序排查，而不是反复重装插件。
Obsidian AI配置教程的核心并不复杂：装插件、填密钥、测通路。
跑通之后，你可以在笔记中选中文本让 AI 改写或总结，也可以按模板批量生成内容。
建议先用一个插件跑顺，再根据实际使用习惯决定是否增加第二个。
