如何用免费插件给 Obsidian 装上完全离线的本地 AI 助手obsidian-local-gpt 保姆级教程【免费下载链接】obsidian-local-gptLocal Ollama and OpenAI-like GPTs assistance for maximum privacy and offline access项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-local-gptobsidian-local-gpt 是一款免费开源的 Obsidian 插件它把你电脑上自己运行的本地大模型直接接进笔记工作流选中任意一段文字就能让 AI 帮你续写、总结、改语法、提取待办。全程离线运行笔记内容一步都不会离开你的设备真正同时兼顾AI 好用和数据隐私这两件事。动手前先花两分钟搞懂它到底在做什么很多新手第一次接触这类插件会觉得概念好多。别急我用一句话给你捋顺本地 AI 模型就像你在家里请的一位贴身秘书而插件负责把这位秘书的电话接通到 Obsidian 上。具体来说整个工作流是这样跑的你在笔记里选中一段文字插件把这段文字和你选中的动作比如总结、续写打包成一个请求请求经由配套的 AI Providers 插件转发给你本地的模型模型给出回答插件把结果粘贴回笔记。为什么要坚持本地而不是直接开个 ChatGPT 网页版三个理由足够硬核第一是隐私你的日记、研究笔记、未公开的想法永远不会上传到任何云端第二是免费只要电脑跑得动模型调用次数不设上限第三是稳定断网也能照常用不受任何服务商限制。开工前的准备三样东西缺一不可在安装插件之前请先把下面的地基打好否则后面会四处碰壁。第一样一个本地模型运行环境。最推荐的是 Ollama它相当于模型界的应用商店 运行器。去官网下载对应你系统的安装包装好即可。第二样至少一个对话模型。打开终端执行下面这行命令拉一个通用模型ollama pull llama3如果你之后想让插件看懂你的知识库也就是 RAG后面会讲建议再补两个嵌入模型——嵌入模型负责把文字变成向量方便快速检索相似内容ollama pull nomic-embed-text ollama pull bge-m3 小贴士nomic-embed-text 处理英文又快又准如果笔记以中文为主选 bge-m3 效果更好。第三样AI Providers 插件。它相当于一个接线员负责把 Obsidian 的请求转交给不同的模型服务商。在 Obsidian 的社区插件商店搜索 AI Providers 安装并启用然后在它的设置里创建一个 Provider把地址指向本地的 Ollama默认是 http://localhost:11434。这三样备齐我们再请主角登场。正式安装两条路任你选路线一官方插件商店新手首选。打开 Obsidian → 设置 → 社区插件 → 浏览搜索 Local GPT点安装、点启用30 秒完事无需任何命令行操作。路线二手动安装适合想折腾源码的玩家。先克隆代码仓库git clone https://gitcode.com/gh_mirrors/ob/obsidian-local-gpt进入目录后安装依赖并构建cd obsidian-local-gpt npm install npm run build然后把生成的main.js、manifest.json、styles.css三个文件复制到你的库目录下的.obsidian/plugins/local-gpt文件夹再回到 Obsidian 启用它。装好后别忘了两件小事回到插件设置页在主模型里选中你刚才配置的 AI Provider再去 Obsidian 设置 → 热键里搜索 Local GPT给显示上下文菜单和动作面板各绑一个顺手的热键比如CtrlM和CtrlJ。第一次调用从一个选区开始现在进入最有成就感的时刻。随便打开一篇笔记选中一段话按一下你绑定的热键或直接右键就会弹出一个动作菜单——这就是插件的核心入口。插件默认给你备好了 6 个现成动作继续写作选中一段文字让 AI 顺着思路往下写总结长文一键提炼要点修复拼写和语法改完后会直接替换原文省得手动复制查找行动项把会议纪要里的待办提取成- [ ]清单通用帮助把选中的文字直接当提问丢给模型想怎么问都行新建系统提示让 AI 帮你设计一个新的系统提示词等于教它学会一项新技能。如果还想更快按CtrlJ打开动作面板。它长得像 Obsidian 自带的命令面板支持输入过滤、一键执行任意动作特别适合不选中任何文字、直接向 AI 提问的场景。进阶玩法让 AI 真正读懂你的整个知识库只处理选中的文字其实只是开胃菜。这个插件最有含金量的功能叫RAG检索增强生成——简单说就是当你选中一段提到[[某篇笔记]]的文字时插件会自动沿着链接把目标笔记的内容抓过来一起塞进提示词让 AI 结合上下文作答。更厉害的是它支持多跳链接A 笔记链接 B 笔记B 又链接 C 笔记插件会一路顺着追下去默认最多追 10 层把整个知识网络都搬进上下文。反向链接也就是谁链接了你同样会被纳入PDF 文献也不在话下——在笔记里插入 PDF 链接AI 就能读取里面的内容参与分析。想调整这些上下文在提示词里的位置插件提供了一套模板关键字完整说明写在docs/prompt-templating.md里{{SELECTION}}指定选中文字插入的位置{{CONTEXT}}指定上下文插入的位置{{CONTEXT_START}}和{{CONTEXT_END}}当上下文为空时整段内容自动省略避免提示词里残留空壳。另外只要你的模型支持视觉比如bakllava、llava这类多模态模型插件还能把图片内容直接喂给 AI。截图里的文字提取、扫描件的智能解读都能在本地一键完成。新手最容易踩的 4 个坑坑一报错模型未找到。十有八九是 Provider 里填的模型名和 Ollama 实际拉取的模型名不一致。执行ollama list核对一遍名字一字不差地填回去即可。坑二提示词太长、内存被吃爆。本地模型对内存很挑剔尤其是同时抓取多篇笔记做上下文时。建议在设置里把上下文限制调低一些或者换个内存更充裕的模型。坑三中文回答质量差。原因多半是用了偏英文的嵌入模型。把 RAG 的嵌入模型换成bge-m3中文笔记的关联效果会有肉眼可见的提升。坑四动作面板空空如也。依次检查三件事AI Providers 插件有没有启用、Provider 有没有创建成功、主模型有没有选中。三者缺一个插件都会叫不应模型。写在最后obsidian-local-gpt 走的是一条小而美的路线不搞云、不上传、不收费却把总结、续写、语法检查、知识库问答这些高频场景全部覆盖而且项目仍在持续迭代社区动作模板也在不断扩充。如果你正纠结AI 很方便但不想交出笔记内容现在就可以动手装上 Ollama拉一个模型30 分钟后你的 Obsidian 就是一座完全私有的智能知识库。【免费下载链接】obsidian-local-gptLocal Ollama and OpenAI-like GPTs assistance for maximum privacy and offline access项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-local-gpt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考