Obsidian 接入 Claude、ChatGPT 与本地 Ollama 做个人双链笔记问答:主流插件配置与隐私脱敏边界

想在 Obsidian 里基于自己的双链笔记库做 AI 问答又担心隐私外泄?本文对比 Copilot 与 Smart Connections 插件,整理接入 Claude、OpenAI 官方 API 与本地 Ollama 的步骤及敏感目录隔离规则。

NNathaniel bigo··原创首发·AI 辅助撰写
12 分钟读完
资料核对于 2026-11-18 · 依据官方文档与公开资料整理 其他 账号

结论先说

  1. Obsidian 接入 AI 问答主要靠两款开源社区插件:偏重侧边栏对话与 @笔记 精准引用的选 Copilot for Obsidian,偏重双链语义自动推荐与全库块级检索的选 Smart Connections。
  2. 问答配置必须拆开看「对话模型」和「向量(Embedding)模型」两项:即便对话选 Claude 或 GPT,也应注意 Claude 官方不直接提供通用文本 Embedding 接口,向量索引通常搭配 OpenAI Embedding 或本地 Ollama 嵌入模型完成。
  3. 连接本地 Ollama 必配跨域白名单环境变量:Obsidian 桌面端请求发自 app://obsidian.md,未设置 OLLAMA_ORIGINS 时会被 Ollama 默认拦截并报连接失败。
  4. 隐私敏感仓库务必先设排除目录再建索引:在插件的排除文件夹(Excluded folders)填入日记、财务账单、客户资料和密钥笔记路径,防止全库扫描时误传云端。
  5. 长文深度整理与日常主力会员入口:若插件 API 按量计费难以预估,日常写长篇综述也可将脱敏笔记直接粘入网页端或桌面端对话,无外币卡可在本站开通 Claude Pro 或 ChatGPT Plus。

Obsidian 接入云端官方 API 与本地 Ollama 对比

图:本站根据 Obsidian 官方帮助:Community plugins 与 Ollama 官方文档 整理的示意图

本文根据 Obsidian 官方帮助中心《Community plugins》、Copilot 与 Smart Connections 开源仓库说明及 Ollama 官方文档整理,资料核对于 2026-11-18。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 Obsidian、Anthropic 或 OpenAI 官方网站。

适用于谁

  • 在 Obsidian 积累了上百篇双链 Markdown 笔记,想按语义检索旧想法、跨多篇读书笔记做汇总提问的人;
  • 纠结用 Claude / OpenAI 云端 API 还是本地 Ollama 模型,不清楚哪些内容会被发往外部服务器的人;
  • 配置本地 Ollama 时遇到连不上 11434 端口、跨域报错(CORS)或全库向量索引卡死的用户。

一、主流插件选型:Copilot 与 Smart Connections 怎么选

首次安装前,需在 Obsidian 左下角打开「设置(Settings)> 第三方插件(Community plugins)」,点击「关闭安全模式(Turn on community plugins)」,再进入「浏览(Browse)」搜索安装:

维度Copilot for ObsidianSmart Connections
核心定位侧边栏聊天助手、选中文本改写续写、Vault QA 全库问答自动发现语义相近笔记段落、构建本地向量连接图谱与对话
上下文指定方式支持输入 @笔记标题、#标签 或当前活动标签页精准喂给模型自动检索全库相似度最高的 Markdown 标题块拼入提示词
模型支持范围原生支持 Anthropic Claude、OpenAI、Gemini 与本地 Ollama支持本地内置轻量嵌入模型、Ollama 及主流云端官方 API

建议只保留其中一款开启全库向量索引,同时启用两款向量插件会导致每次保存 Markdown 文件时双倍计算嵌入向量,拖慢笔记软件响应。

二、接入 Claude、ChatGPT 官方 API 与本地 Ollama 步骤

1. 配置云端官方 API Key

先在各厂商开发者后台申请密钥(步骤见 Claude API Key 怎么获取 与 OpenAI API Key 怎么获取),随后在插件设置面板操作:

  1. 进入「设置(Settings)> Copilot(或 Smart Connections)> Model / API 设置」;
  2. 在对应厂商栏填入 Anthropic API Key 或 OpenAI API Key;
  3. 关键细节:若聊天模型选了 Claude(如 Sonnet 系列),切到「Embedding Model(嵌入模型)」选项卡时不要留空,需指定 OpenAI 的 text-embedding-3-small 或本地 Ollama 嵌入模型,否则全库 Vault QA 无法建立本地向量库。

2. 配置本地 Ollama 实现零外发离线问答

若笔记内容涉密不允许离开本机,先按 Ollama 怎么用:安装、下载模型与常用命令 拉取对话模型与中文向量模型:

bash
ollama pull qwen2.5:7b
ollama pull bge-m3

接着配置跨域放行(否则 Obsidian 内部 WebView 请求 http://127.0.0.1:11434 会返回 403 或连接错误):

  • macOS / Linux:终端执行 launchctl setenv OLLAMA_ORIGINS "app://obsidian.md*"(Linux 写入 systemd 服务环境变量)并重启 Ollama;
  • Windows:在系统环境变量新建用户变量 OLLAMA_ORIGINS,值填 app://obsidian.md(或测试期填 ),彻底退出右下角托盘羊驼图标后重开。

最后在 Obsidian 插件中将服务地址设为 http://127.0.0.1:11434(兼容模式填 /v1,详见 Ollama API 本地接口与 OpenAI 兼容写法),对话模型填 qwen2.5:7b,嵌入模型填 bge-m3。

Obsidian 个人双链笔记问答四步配置流程

图:本站根据 Obsidian 官方帮助:Community plugins 整理的示意图

深度阅读与编程联动订阅提示:插件内调 API 按每次塞入的笔记切片字数计费,频繁全库问答账单容易超支。若你想把几十篇公开读书笔记导出给高阶模型做深度综述,或直接用终端工具操作本地 Markdown 仓库,可在本站自助开通固定月费的 Claude Pro、Claude Code 或 ChatGPT Plus。

三、隐私脱敏边界:哪些数据会上传、怎么隔离敏感目录

很多用户误以为「笔记文件存在本机硬盘,装个插件提问就不会泄密」,实际数据流向取决于你配置的组合,通用安全核查可对照 AI 使用隐私与数据安全清单:

  1. 纯本地组合(Ollama 对话 + Ollama / 本地内置 Embedding):建索引与生成回答全程在本机内存完成,断网也能运行,没有任何字符发往外部。
  2. 混合组合(本地 Embedding + 云端 Claude / OpenAI 对话):平时写笔记建索引不联网;但当你发起 Vault QA 提问时,插件会把检索命中的那几段笔记原文连同你的问题一起通过 HTTPS 发给官方 API 服务器。
  3. 必做的三条脱敏防线:
  • 在插件设置找到 Excluded folders / Exclusions,把 日记/、财务/、密码与凭证/ 等私有目录加进去,建索引前先设好;
  • 不要用云端 API 全库问答模式直接扫未过滤的整个仓库,改用单次对话手动 @公开笔记名 定向投喂;
  • 团队或企业内部文档确认所绑定的官方 API 账号不属于免费公开训练层级(官方商业 API 默认不将接口输入用于训练基座模型,具体以各家 API 数据隐私条款为准)。

常见问题

问:我已经开通了网页版 ChatGPT Plus 或 Claude Pro 会员,能免 API Key 直接填进 Obsidian 插件吗?

答:不能。网页版个人订阅额度和开发者平台的 API 余额是两套完全独立的计费体系,Obsidian 社区插件走的是官方 HTTP API 接口,必须填入开发者后台生成的 API Key 按实际 Token 结算,切勿在第三方未知插件中填入网页账号 Cookie 以防触发风控封号。

问:几千篇双链笔记第一次建向量索引非常慢、风扇狂转怎么办?

答:首次全库向量化需要对每篇文档分块推理,建议先通过排除规则过滤掉附件目录、Excalidraw 画板源码文件(.excalidraw.md 体积巨大且无问答价值)和历史归档目录,并使用轻量级向量模型如 nomic-embed-text 或 bge-m3。

问:为什么 AI 回答时没有理解笔记之间的 [[双链]] 跳转关系?

答:常规向量检索只按单段文本语义相似度召回切片,不会自动顺着双链展开多层邻居节点。提问时可在 Copilot 输入框显式用 @ 同时挂载主笔记与关联笔记,让模型一次性读全上下文。

问:国内没有境外信用卡,想开通 Claude Pro、ChatGPT Plus 配合整理笔记怎么办理,支持报销开票吗?

答:可前往本站 Claude Pro 充值页、ChatGPT Plus 充值页 或 AI 会员充值中心 下单,支持支付宝、微信支付与 AlipayHK 付款,提供无需交出密码的自助卡密兑换模式,企业与科研课题组采购可开具国内增值税发票;实时价格与售后规则(掉订阅按剩余天数折退,封号不在质保范围)以页面展示为准。

相关教程

参考资料

  • Obsidian 官方帮助文档:Community plugins 安全与管理 — https://help.obsidian.md/Plugins/Community+plugins
  • Copilot for Obsidian 官方开源仓库说明 — https://github.com/logancyang/obsidian-copilot
  • Smart Connections 官方开源仓库说明 — https://github.com/brianpetro/obsidian-smart-connections
  • Ollama 官方 API 文档 — https://docs.ollama.com/api

Nathaniel 的更多内容

  1. 01

    独立开发者用 ChatGPT + Codex 跑通产品全流程:市场验证、PRD、原型到代码上线复盘清单

    单人做独立产品最容易陷入「闭门写两个月代码上线零用户」或「AI 写到一半目录越改越崩」。本文整理「ChatGPT 负责市场验证、PRD 与复盘 + Codex 负责工程实现与测试」的五阶段双轨流程,附起手提示词与 7 项上线复盘清单。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成规范文件命名规则、整理混乱目录树与合并零散发票抬头清单脚本

    面对满桌面的「新建文件夹」「最终版2」和上百张零散电子发票,手工改名抄台账耗时又容易漏重。本文分享先脱敏取样、再用 ChatGPT 生成带预演和回滚日志的本地 Python 脚本,离线安全完成目录整理与发票抬头合并去重的实战流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外邮件营销(EDM)受众分层文案、A/B 主题行测试与防进垃圾箱自检

    做海外独立站或出海 SaaS 邮件营销(EDM),最怕千人一面群发被直接送进垃圾箱。本文结合 Gmail/Yahoo 批量发件人规范,梳理用 ChatGPT 设计受众分层文案、批量生成 A/B 主题行矩阵并开展发前垃圾词与合规自检的实战提示词。

    ChatGPT0
  4. 04

    用 ChatGPT 写 Notion Formula 2.0 公式、Obsidian Dataview 查询与 Airtable 自动化脚本

    给 Notion 数据库写多条件 Formula 2.0 公式、给 Obsidian 写 Dataview 动态看板,或在 Airtable 里写自动化脚本,经常因为一个小括号或类型不匹配报错半天。本文整理三大工具的通用上下文喂料规范与三套直接可复制的生成提示词。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 处理复杂 JSON / YAML / XML 字段映射、格式转换与校验规则编写实战

    对接第三方 API、迁移 Kubernetes 配置或解析政企 XML 报文时,手工对照几百行嵌套字段既慢又容易漏掉空值与类型边界。本文整理用 ChatGPT 完成字段映射表梳理、生成确定性转换脚本以及编写 JSON Schema / Pydantic / XSD 校验规则的实战流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 准备本科/硕士毕业论文答辩:提炼答辩 PPT 结构、模拟导师犀利追问与 3 分钟自述稿

    毕业论文写完后,要在 3–5 分钟内讲清研究价值并顶住答辩评委的连环追问并不轻松。本文整理在严格遵守高校学术规范的前提下,用 ChatGPT 提炼答辩 PPT 结构、打磨 3 分钟口语自述稿并开展模拟导师犀利追问的排练流程与提示词。

    ChatGPT0

同产品的其他教程

  1. 01

    用 ChatGPT 速读英文产品手册、开源文档与 GitHub Issue 并沉淀团队中文内训手册

    团队引入海外 SaaS 工具或开源框架时,全英文文档晦涩冗长、真正的坑全藏在几十页 GitHub Issue 讨论里。本文分享速读拆解英文手册、归类 Issue 排障库以及重构团队中文内训 SOP 的完整实战流程。

    ChatGPT其他 AI 工具0
  2. 02

    用 ChatGPT 写油猴脚本(Tampermonkey)与浏览器书签小工具解决网页繁琐重复操作实战

    每天在后台系统里重复勾选几十个复选框、手工复制网页表格或清理遮挡阅读的侧边栏,既枯燥又浪费时间。本文分享不会写 JS 也能用 F12 配合 ChatGPT 写出油猴脚本与书签小工具的完整实战流程。

    ChatGPT其他 AI 工具0
  3. 03

    用 ChatGPT 写高质量 SQL 窗口函数(RANK / LAG / SUM OVER)做留存与漏斗分析实战

    做用户留存率、复购间隔与有序转化漏斗时,多层自连接既难读又拖垮数据库,窗口函数则是高效解法。本文整理数据库方言喂数规范、CTE 分层提示词以及用内置沙盒先验证再上线的完整实战流程。

    ChatGPT其他 AI 工具0
  4. 04

    ChatGPT 连接 Canva、Figma、Linear、Jira、Dropbox 等第三方应用搜不到数据或授权失效怎么办

    在 ChatGPT 接入 Canva、Figma、Linear、Jira 或 Dropbox 后,明明显示已连接却搜不到文件工单,或老提示授权失效怎么办?本文拆解账号错绑、OAuth 范围漏选、权限继承与管理员拦截 5 步排障法。

    ChatGPT其他 AI 工具0
  5. 05

    Anthropic Contextual Retrieval(上下文增强检索)是什么、怎么实现:给文档块自动补背景摘要结合缓存降失误率

    长文档切成小块后丢了公司名、年份和主语指代导致 RAG 频频搜错?本文按 Anthropic 官方技术文章详解 Contextual Retrieval 原理、官方公开评测失误率下降 49% 至 67% 的组合架构,以及用 Claude 提示词缓存低成本批量生成切片背景的完整 Python 代码。

    Claude其他 AI 工具0
  6. 06

    RAG 知识库回答不准怎么调优:切片大小(Chunking)、BM25 + 向量混合检索与 Rerank 重排序三步排查法

    搭好的 RAG 企业知识库一问具体型号、报错码或跨行表格就答非所问?本文按 OpenAI 与 Anthropic 官方检索文档,给出先隔离检索与生成故障、再按结构化切片(Chunking)、BM25 加向量混合召回(RRF)与 Rerank 重排序逐层调优的三步法。

    Claude其他 AI 工具0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~