算力猫
← 返回教程列表

接入软件

Obsidian Copilot 插件

在 Obsidian 的 Copilot 插件里添加一个自定义提供方(免费版可用)。

约 5 分钟适合:用 Obsidian 记笔记、想在库里用 AI 的用户

开始之前

  • Obsidian 已安装 Copilot 插件并启用
  • 一把 Key 和一个模型名

步骤 1 · STEP 0x01

添加自定义提供方

Settings → Copilot → BYOK
1
Add a provider
2

提供方

Add a custom provider
示意图,以软件当前版本界面为准

打开 Settings → Copilot → BYOK,点 Add a provider,选最下面的 Add a custom provider(Ollama、LM Studio 是本地模型用的)。

官方说明:BYOK 不需要 Copilot 账号、许可证或信用卡,免费版就能用;移除许可证也不会删掉你的 BYOK 提供方。

去创建 Key →

步骤 2 · STEP 0x02

填 Key、Base URL 并选模型

Add a custom provider
1

API key

<你的 Key>
2

Base URL

https://api.suanlimao.shop/v1
3

模型

从发现的列表里选,或直接输入 <模型名>
4
Test
5
Save
示意图,以软件当前版本界面为准
  • Base URL 填 https://api.suanlimao.shop/v1:官方说模型发现用的是地址下的 /v1/models,示例也都是带 /v1 的写法。
  • 模型可以从发现的列表里搜,也可以直接输入精确的模型 ID。
  • 点 Test,显示 Verified 后点 Save。
模型名不要自己猜:到「模型广场」点模型卡片上的「复制模型名」,再粘贴到软件里。模型名写错是最常见的报错原因。

打开模型广场 →

步骤 3 · STEP 0x03

在 Copilot 聊天里用

Copilot 聊天面板
1

模型选择

<模型名>
2

输入框

总结当前笔记
示意图,以软件当前版本界面为准
  • 打开 Copilot 聊天面板,选这个模型,发一句话。
官方提示:Test 通过但 Quick Chat 发不出消息时,编辑该提供方并打开 Enable CORS。Key 保存在本机的 Obsidian 密钥链里,不会写进库的 data.json。

✓ 怎么确认成功了

  • 提供方状态显示 Verified,聊天有回答;控制台「用量」页出现请求。

常见问题

状态显示 Invalid key?

Key 没复制全或已吊销。

状态显示 Check failed?

官方解释是连接或限速问题,悬停可看详情。先检查 Base URL 是否为 https://api.suanlimao.shop/v1。

模型列表为空?

直接输入模型 ID 即可,不依赖列表。

相关教程

还是不行?

先看排错教程;仍然解决不了,提交工单时附上 request_id、时间、模型和报错原文(不要贴 Key)。