obsidian-smart-connections

写作时自动推荐相关笔记,零配置实现智能链接

obsidian-smart-connections 是一个 Obsidian 插件,旨在写作时自动发现并展示相关笔记和摘录,充当链接构建的副驾驶。它利用本地嵌入模型进行语义搜索,无需 API 密钥或复杂配置,即可在图形视图和列表视图中呈现相关内容。该插件解决了 Obsidian 用户在海量笔记中难以发现隐性关联和手动维护链接的痛点,通过语义理解而非关键词匹配,提升知识管理的效率与深度。其核心能力包括零设置部署、本地化隐私保护、以及支持多种主流大模型(如 ChatGPT、Claude、Gemini)的灵活集成,为笔记间的智能连接提供强大支持。

开源 freemium 对话助手
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 5467
维护状态 活跃
是否开源
定价模式 freemium

项目数据

分类对话助手
开发团队brianpetro
所属国家
定价模式freemium
价格说明基础功能免费,高级功能需订阅,具体价格见官网。
访问状态
是否开源
开源协议NOASSERTION
主要语言JavaScript
技术栈/模型chatgpt,claude,embeddings,gemini,obsidian,obsidian-md,obsidian-plugin,related-items,semantic-search,vectors
GitHub 星标★ 5467
30天Star增速
HF 下载量
上线时间2022-12-26 00:00:00
最近更新2026-09-22 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数1

使用教程

难度:入门 约 5 分钟 部署方式:本地安装 3 步

环境要求

  • 已安装 Obsidian 桌面客户端
  • Obsidian 中可访问社区插件市场(能正常联网下载插件)
  • 一个已打开的笔记库(Vault)
  • 无需 API 密钥,无需额外命令行工具或独立应用

安装与启动步骤

  1. 1安装并启用插件

    在 Obsidian 中打开设置,进入社区插件(第三方插件)浏览并搜索 Smart Connections,点击安装后启用。README 明确说明:安装并启用即可。

  2. 2等待本地嵌入生成

    启用后本地模型会立即开始为笔记创建嵌入,无需额外应用、CLI 工具或 API Key。笔记较多时首次建索引需要等待一段时间。

  3. 3打开 Connections 视图

    点击左侧边栏的 Connections 图标,或打开命令面板执行 Open: Connection view 命令,即可看到与当前笔记语义相关的笔记。

    Open: Connection view

如何确认成功

左侧 Connections 面板能列出与当前笔记语义相关的笔记(而非关键词匹配),即说明本地嵌入已生效。

常见问题

Q:需要申请 API 密钥或配置模型吗?

A:不需要。插件内置本地模型,安装启用后即自动生成嵌入;API Key 仅在你想额外接入 ChatGPT、Claude、Gemini 等模型时才涉及。

Q:必须安装额外软件或使用命令行吗?

A:不需要。README 明确写明:无需额外应用、无需 CLI 工具,直接在 Obsidian 中安装并启用插件即可。

Q:刚装好为什么没看到相关笔记?

A:本地模型正在后台为笔记创建嵌入,笔记量大时需要一定时间;等索引构建完成后,Connections 视图会逐步显示结果。

注意事项

  • 插件完全本地运行嵌入计算,笔记内容默认不出本机,隐私性较好。
  • 首次索引期间 Obsidian 可能有一定资源占用,建议在空闲时段完成首次构建。
  • Connections 视图展示的是语义相关笔记,与关键词搜索的排序结果会明显不同。
  • 如需更强模型能力,可另行接入 ChatGPT、Claude、Gemini 等服务。

核心亮点

  • 本地嵌入模型实现语义搜索,无需 API 密钥,保护隐私且零成本
  • 自动在图形和列表视图展示相关笔记,显著提升链接发现效率
  • 支持 ChatGPT、Claude、Gemini 等多种模型,灵活适配不同需求

不足之处

  • 语义搜索效果依赖本地模型能力,可能不如云端大模型精准
  • 文档/社区待观察

适用场景

  • 学术写作中快速关联相关文献和笔记
  • 知识库维护时自动发现主题间的隐性联系
  • 日常笔记记录中即时补充上下文和背景资料

替代项目

obsidian-copilot、smart-connections-obsidian、obsidian-ai

项目介绍

obsidian-smart-connections 是搜索知识领域的开源项目,由 brianpetro 开发,2022 年首次发布。

在全站 13,014 个收录项目中,它的 GitHub 星标数(5,467)位列前 9%,在搜索知识分类的 581 个项目里位列前 10%。

近 44 天,它的 GitHub 星标从 5,349 增加到 5,467,净增 118。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-22。基础功能免费,高级功能需订阅,具体价格见官网。从国内网络环境看,可直接访问。

它主要面向的使用场景是:学术写作中快速关联相关文献和笔记。同类可对比的替代方案包括 obsidian-copilot、smart-connections-obsidian、obsidian-ai。

上一篇:OpenDeepWiki

下一篇:geo-optimizer-skill

同类项目推荐

firecrawl 开源

网页抓取像喝水一样简单,开发者省下整周加班

The web data API to search, scrape, and interact at scale.

★ 183325 2026-08-09
contoso-chat 开源

一键跑通 Azure RAG 应用,从代码到评估部署全流程

This sample has the full End2End process of creating RAG application with Prompty an···

★ 766 2026-08-09
graphify 开源

整个代码库画成一张图,找问题一眼定位

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable k···

★ 120493 2026-08-09
qiaomu-youtube-ai-podcast 开源

一站式索引AI播客,快速找到有文字稿和总结的节目

AI 播客索引:整理 AI 播客、中文简介、Transcript 状态和总结入口 | Curated AI podcast ···

★ 69 2026-08-09