接入软件
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 提供方。
步骤 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)。