《Obsidian×DeepSeek 实战》第 1 篇 · Smart Connections 4.7.2
本机实测截图
Smart Connections 侧栏与相关笔记推荐（本机真实界面）：
是什么
Smart Connections（社区 ID：smart-connections，仓库：brianpetro/obsidian-smart-connections）用本地嵌入模型给笔记建语义索引。你写「自然资源信息化」时，它会把「一张图」「国土空间」「项目管理」相关笔记推到侧边，而不只靠关键词命中。
官方 README 的重点一句话：装上并启用就行，本地模型马上开始算嵌入，不需要额外 App、CLI，也不需要 API Key。
适合谁
- 库里已经有几十上百篇笔记，全文搜索开始「搜得到词、找不到意」
- 想先体验 AI 关联，又不想一上来就烧 DeepSeek 额度
- 做 GIS / 信息化 / 项目文档混写的人（概念散落在多篇里）
安装步骤
方式 A：社区插件（推荐）
设置→社区插件→ 关闭 受限模式- 点 浏览，搜 Smart Connections
- 安装 → 启用
- 左侧或命令面板打开 Smart Connections 视图；首次会开始本地嵌入
方式 B：手动（本系列测试机做法）
把发布包放到库目录：
<你的库>/.obsidian/plugins/smart-connections/
main.js
manifest.json
styles.css
本机实测版本：4.7.2（GitHub Release tag 4.7.2）。然后在 community-plugins.json 里加入 "smart-connections"，或在设置里勾选启用。
DeepSeek Key 要不要填
核心「相关笔记」功能：不用。
若你在 Smart Connections 生态里另外开「和笔记对话 / 云端模型」类能力，再考虑 Key。本篇按官方默认路径：本地嵌入即可。
常用操作
- 打开一篇笔记，例如「会议速记-平台需求对齐」
- 看 Smart Connections 面板：应出现「自然资源信息化」「一张图」「项目管理」等语义相近笔记
- 大库可到插件设置里调嵌入模型与排除文件夹（官方有 Settings guide）
- 命令面板搜
Smart Connections可刷新索引、打开聊天类入口（视版本而定）
本机实测结果
- 插件包已落入测试库
/workspace/obsidian-ai-test-vault/.obsidian/plugins/smart-connections/，manifest.json显示 4.7.2 - 测试库准备了 12 篇中文笔记（GIS、自然资源信息化、Mapbox、项目管理、会议速记等）并带双向链接，给嵌入算法「有东西可算」
- 未强制启动 Obsidian GUI 做索引可视化（避免无头环境挂死进程）；行为以官方文档「本地模型自动嵌入」为准
- DeepSeek：本插件本篇未调用
踩坑
- 空库几乎看不出效果——先写十几篇有链接的笔记再评
- 首次索引会吃 CPU，笔记本风扇转很正常
- 不要和「必须联网的 Chat 插件」搞混：Connections 的主价值是本地相关推荐
和下篇关系
Smart Connections 解决「找得到相关笔记」。下一篇 Copilot：把 DeepSeek 接进对话，让你对着库提问、摘要、起草。
和「全文搜索 / 图谱」怎么分工
| 手段 | 擅长 | 不擅长 |
|---|---|---|
| 全文搜索 | 精确关键词、报错原文、专有名词 | 「差不多这个意思」的笔记 |
| 图谱视图 | 看已有链接结构 | 你还没链上的隐性相关 |
| Smart Connections | 语义相近、写的时候提醒 | 专有名词拼写必须命中时仍要搜索 |
实操建议：先用 Connections 找候选，再用搜索确认条文编号、接口字段名。
测试库里可以立刻试的三组
- 打开「地理信息系统入门」→ 看是否打出 Mapbox / WebGIS / 自然资源相关笔记
- 打开「会议速记」→ 看是否打出「自然资源信息化」「项目管理」
- 打开「简历关键词」→ 看是否打出「江苏 GIS 岗位观察」
若一侧空白：检查笔记是否过短、是否被排除文件夹规则滤掉、索引是否仍在跑。
