最近很多小伙伴反馈，「Obsidian」的「Copilot插件」升级，界面大变样，之前的教程对不上啦。
也有很多小伙伴装好之后，不知道怎么接AI，遇到各种各样的问题。
今天这篇，我就按照最新的操作，更新一版部署「Obsidian」+「Copilot插件」的教程，并给出一些常见问题的解答。
排排坐，开始！
安装软件
「Obsidian」软件，可直接打开官网下载安装，官网地址：
https:///
不用注册会员，不用充值，可以一直在本地免登录使用。
有的小伙伴从官网下载的时候，也可能遇到下载失败的情况。可以换个浏览器试试，或者去离线包里下载（下面会讲）。
「Copilot插件」需要进入「Obsidian」的插件市场下载。由于插件市场放在Github上，国内网络无法直接访问，很多小伙伴卡在了这一步。
那要怎么办呢？有三种解决方法：
方法1，离线安装
我把之前教程里提到的插件，包括「Obsidian」的安装包，都放到了百度网盘上，大家可以去百度网盘上下载。如下：
地址：https://pan.baidu.com/s/1mlIq0zf3dDVdgwsOi8q7LQ?pwd=4f2d
离线包中的「Copilot插件」已更新至v2.8.8版本（后续还会不定期更新哈）。「Copilot插件」新增了Command功能，可参见《「AI写网文」工作台重要更新，写网文更丝滑了！》了解详情。
下载了离线版的「Copilot插件」后，要怎么安装呢？
首先，你得先创建一个笔记仓库。打开「Obsidian」，首次使用出现的窗口如下：
点【创建】，然后在下方窗口填写仓库名称、选择存放位置即可。
注意你选择的仓库位置，你需要在这个位置找到你的笔记仓库，它是一个文件夹，文件夹名称就是笔记仓库名称。
进入到这个文件夹里面，会有个.obsidian文件夹，类似这样：
从百度网盘中，把「Copilot」文件夹复制下来，放在 .obsidianplugins 下面，如下图：
你可能会发现，.obsidian文件夹下不存在plugins文件夹，没关系，手动创建一个再放进去就可以了。
放完之后，关闭「Obsidian」软件再重新打开，就有「Copilot插件」了。其他插件离线安装也是一样的方法。
方法2，直接使用样板包
我之前做过一个样板包，把之前介绍过的插件、文件结构、页面布局都做好了，放了一点简单的提示词进去。只需要把整个包下载下来，用「Obsidian」打开文件夹即可，不需要再自己安装插件。
参见《「AI写网文」工作台样板，插件、提示词、结构框架全都打包好了》一文，文中附视频教程。
方法3，搜索国内资源
网上有很多其他人分享的资源，我看有小伙伴用过一些国内的「Obsidian」插件，可用来下载其他插件，或者从第三方渠道下载「Obsidian」插件离线安装。也有技术大佬会做一些汉化版的插件，方便大家使用。
这块就需要大家自己去找了，我主要用官方渠道的插件，没有花精力去了解这方面的资源。
如何获取API
装好「Copilot插件」只是具备了接入AI的能力，还没有真正接入AI的服务。
国内国外大模型厂商非常多，具体接哪一家，需要你自己选择一下。
要用「Copilot插件」接入AI，我们可以先看看「Copilot插件」需要获得哪些信息，如下：
主要是以下几项：
Model Name：模型名称，注意，这一项不可以乱填，每个模型都有特定的名称用来调用，程序也要参考此项来进行模型选择。
Display Name：展示名，这个可以按照你的喜好随便填。
Provider：供应商，即你使用的AI服务来自哪里。可选项如下图：
（点下面的下拉符号，还有个DeepSeek）
注意，这里不是添模型的品牌，而是你实际使用的API来源。
比如仅当你从Gemini官网获得的API，这里才选Gemini。如果你是从国内某个网站获得的Gemini API，这里就选OpenAI Format。
不在以上列表中的供应商，都选【OpenAI Format】，它表示遵从OpenAI的API格式的第三方供应商。
Base URL：调API的链接，每个供应商都会有个固定的链接。注意，如果你的供应商是Provider列表中除OpenAI Format以外的其他选项，可以不用填此项，因为「Copilot插件」已经内置了。
API Key：一串编码，供应商计费的依据，所以千万不要泄露给其他人。
知道了要填哪些信息，接下来就是去获取这些信息啦。
在我的样板包中，做了一些常见AI的接入教程，如果是使用样板包的小伙伴，直接去看其中对应的内容即可。
在这里给大家介绍一下通用的方法。
第1步：找到你要接API的网站
以DeepSeek为例，搜索DeepSeek进入官网，再进入「API开放平台」。
可能有的AI直接搜，会进网页对话，这个时候你在关键词加上“开放平台”或者“API”，就可以进入接API的地方。
第2步：查看文档
进入平台后，查看它的文档：
接入API的平台一定会有文档，找一找。Base URL和Model Name都会在文档中写明，如图：
别家文档可能直接进去不是这样的内容，那就去文档里找例如“接入API”、“OpenAI 接口”、“所有模型”之类的文档，一般也都能找到相应的内容。
获取到这些信息，并在这些网站上创建API Key，就齐活儿了。
注意，有的网站API Key只会在创建的时候完整出现一次，以后都看不到完整的API Key了，只能看到带*号加密的内容，建议把API Key复制出来保存好，方便以后填写。
第3步：添加API Key（针对部分供应商的模型）
如果你使用的是OpenAI、Anthropic（Claude）、Gemini、Cohere、OpenRouter等官方的API，建议将这些API填入【配置】→【Copilot】→【Basic】页面的【Set Keys】中，如下：
在此填入对应的API Key，这样后面添加这些厂商的模型，就不必重复添加API Key了。
记得要点【Verify】验证通过哦~
如何接入AI
接下来就是接入AI的具体配置操作啦。
进入【配置】→【Copilot】→【Model】，如图：
这里有两处添加模型的入口，上面是添加大语言模型，下面是添加embedding模型。是点击上面列表下方的【Add Custom Model】哦～
将以上Model Name、Provider、Base URL、API Key填入表中。如果你用的模型，已经在前面【Set Keys】中添加过API Key，这一步就不需要重复填API Key了，Base URL也不需要填，只需要填Model Name和Provider即可。
填写完以上信息后，需要点【Verify】验证。
这一步需要注意看提示，如果“Without CORS”后面跟的是“successful”，直接点【Add Model】即可。如果不是，在“With CORS”后面跟的是“successful”，那就需要勾选【Enable CORS】，再点【Add Model】。
这样，模型就添加好啦~
常见问题
在部署和接入AI的时候，有一些常见的问题，在此我也列一下。
问题1：离线装了「Copilot插件」，但打开「Obsidian」后找不到了
通常都是目录层级问题导致，注意「Copilot」文件夹要放在 .obsidianplugins 下面，中间还有「plugins」这一层文件夹（没有就手动建）。放错层级，就会找不到插件。
问题2：API key is not provided for the model:gpt-4o|openai
这是因为「Copilot插件」默认选择的模型是4o，而你没有添加OpenAI的API Key，就会出现这个提示。只需要把默认模型改成我们添加的模型，就不会出现这个提示了。配置位置在【配置】→【Copilot】→【Basic】，如下：
问题3：Model request failed：Error fetching from XXXXXXXXX
网络问题，检查下网络是否可连通官网。
问题4：Error：Connection error
有可能是Token limit的设置问题。不同模型的最大输出长度不一样，如果你配置的Token limit超过模型的最大输出长度，就有可能报这个错误。Token limit的配置位置在【配置】→【Copilot】→【Model】的大语言模型列表下面，如图：
问题5：User location is not supported for the API use
你的IP不在供应商的服务区。
问题6：出现错误码429
资源耗尽。
也有可能模型不适用于免费账户，如果你是免费账户的话。
问题7：出现错误码401、402
没有充钱，账户里没有余额。
问题8：回答断掉并出现Failed to parse stream提示
Gemini常出现这个问题，把Token limit调为0，可以一定程度上降低出现此提示的概率。据说关闭流式输出能解决，但「Copilot插件」暂不支持此配置项，只能等插件升级或Gemini自己改进了。
小结
以上是新版的「Obsidian」+「Copilot插件」搭建「AI写网文」工作台的新版教程，总结了大家常见的疑问与解决办法，希望对你有帮助。
我真是个勤奋的人，不考虑给我点个赞吗~
▼