Obsidian Smart Connections插件自定义服务器API密钥配置指南

Obsidian Smart Connections作为一款智能笔记关联插件，近期在v2.1.48版本中新增了自定义服务器API密钥的配置功能。本文将详细介绍该功能的配置要点和技术实现背景。

功能演进

早期版本中，用户在使用自定义服务器时无法单独配置API密钥字段，这限制了与需要身份验证的自建服务的集成能力。开发团队在收到用户反馈后，快速迭代发布了v2.1.48版本，新增了专门的API密钥输入字段。

配置步骤

1. 确保插件版本升级至v2.1.48或更高
2. 在插件设置中找到"Custom Server"选项
3. 正确填写服务器端点URL（注意需包含完整路径）
4. 在新增的API Key字段中输入认证密钥

技术要点

• 端点URL需要遵循RESTful规范，通常以/v1等版本标识结尾
• API密钥采用标准Bearer Token认证机制
• 请求头会自动附加Authorization: Bearer {api_key}

典型问题解决方案

若遇到URL验证错误，建议检查：

1. URL是否包含协议头（http/https）
2. 路径是否完整（如/api/v1等端点路径）
3. 服务端是否配置了CORS策略

最新发布的v2.1.50版本已修复了URL验证逻辑问题，建议用户及时更新以获得最佳体验。该插件的快速迭代体现了开发者对用户反馈的重视，也为需要私有化部署AI服务的用户提供了更灵活的集成方案。

通过此功能，用户可以将插件与自建的语义搜索服务、本地化LLM等私有化方案深度集成，在保证数据安全的同时享受智能笔记关联的便利。