Obsidian AI 插件安装与 API 配置教程
这篇笔记整理了在 Obsidian 中安装 AI 插件，并接入智谱清言、通义千问、DeepSeek、Kimi 以及 GitHub 免费 GPT 接口的完整流程。思路并不复杂，关键是把插件装对，把 Base URL、模型名和 API Key 对齐。
安装 Obsidian
先准备好 Obsidian 本体，再创建或打开一个 Vault，后面的配置都会在这个工作空间里完成。
- 下载 Obsidian：访问 Obsidian 官网，选择适合自己系统的版本，安装即可。
- 创建或打开 Vault：启动 Obsidian 后，选择一个已有的 Vault，或者新建一个专门用于测试 AI 功能的工作空间。
安装 AI 插件
Obsidian 的 AI 能力通常依赖社区插件。这里以 Copilot 一类的 AI 插件为例，流程是类似的。
- 打开 Obsidian 设置，进入'社区插件'。
- 关闭'安全模式'，否则第三方插件无法安装。
- 点击'浏览'，搜索
copilot。 - 找到对应插件后安装，并在安装完成后启用。
安装好之后，回到主界面或命令面板里确认插件已经可用。一般来说，插件启用后会在设置项、侧边栏或命令面板中出现入口。
API 配置
接下来是最容易出问题的部分：不同厂商的模型，虽然都能走兼容接口，但 Base URL、模型名和密钥必须严格对应。只要这三项填错，测试连接大概率就会失败。
智谱清言（GLM-4-Flash）
先到 智谱 AI 开放平台 注册或登录，进入 API 管理页面生成密钥。然后在 Obsidian 的 AI 插件设置里填写：
- 模型名称：
GLM-4-Flash - Base URL：
https://open.bigmodel.cn/api/paas/v4 - API Key：填写刚生成的密钥
保存后做一次连接测试，如果返回正常，说明这组参数已经通了。
通义千问（qwen-max）
通义千问需要到阿里云的模型市场获取接口信息。登录后生成 API Key，再在插件里填入下面这些值：
- 模型名称：
qwen-max - Base URL：
https://dashscope.aliyuncs.com/compatible-mode/v1 - API Key：填写密钥
这里的 compatible-mode/v1 很关键，很多兼容型客户端都依赖这个路径来对接阿里云的大模型接口。
DeepSeek
DeepSeek 的配置比较直接。前往 DeepSeek Platform 注册并生成 API Key，然后在插件里设置：
- 模型名称：
deepseek-chat - Base URL：
https://api.deepseek.com - API Key：填写密钥
保存后测试连接即可。
Kimi
Kimi 对应的是 Moonshot AI 的开放平台。先在 Moonshot AI - 开放平台 注册并生成密钥，再配置：
- 模型名称：
moonshot-v1-8k - Base URL：
