让笔记变成你的知识库：obsidian-yolo RAG 检索搭建全解，含免 API Key 的本地嵌入模型

【免费下载链接】obsidian-yoloAgent-native AI assistant — chat, write, whiteboard, learning, all in one.项目地址https://gitcode.com/gh_mirrors/ob/obsidian-yolo点击查看免费下载obsidian-yolo 是运行在 Obsidian 里的 Agent 原生 AI 助手它的Vault RAG能力可以给你的笔记库建索引让 AI 按语义读懂整个库而不只是逐篇引用。这篇教程带新手从零搭好 RAG 检索重点是教你用免 API Key 的本地嵌入模型在设备端建索引笔记内容不出本机。先搞懂没建索引会怎样不用索引也能对话。AI 自带一个「知识库检索」工具没索引时它会自动降级成纯关键词检索——只能找到字面匹配的笔记找不到说法不同、意思相近的内容。界面上会提示知识库索引已关闭。建好索引后同一个工具自动升级为向量检索 关键词混合。你不需要手动切换什么RAG 模式AI 判断需要查笔记时会自己调用。相关实现见 ragEngine.ts 与 vault_search 工具定义。第一步准备嵌入模型索引的前提是有一个嵌入模型否则点开启会被拦下。它有两种来源任选其一。方案 A本地嵌入模型免 API Key推荐新手打开设置 → YOLO → 知识库在嵌入模型区域找到「本地设备端」货架。模型直接跑在你电脑上笔记内容不出本机也不需要任何 API Key。仅支持桌面端移动端会显示不可用。模型语言维度体积适合场景BGE Small (English)英语384约 33MB轻量、英文库BGE Small (Chinese)中文512约 23MB轻量中文库首选Multilingual E5 Small多语言384约 129MB混合语言Nomic Embed Text v1.5英语768约 132MB长上下文8192 tokenBGE-M3多语言1024约 560MB质量高、偏重Qwen3 Embedding (0.6B)多语言1024约 1.13GB最重、质量最高点「下载」会显示进度完成后自动校验文件完整性。支持CPU / GPUWebGPU切换设备不支持 GPU 时该选项会被禁用。模型清单定义在 catalog.ts本地运行依赖「嵌入引擎」这个运行时组件未安装时设置页会提示你先去启用。两个新手坑本地模型文件存在插件自己的目录里不在你的库里、不参与同步。删除需在模型条目上点两次确认。量化格式反直觉q8int8模型只能跑 CPU放到 WebGPU 上反而更慢。部分模型提供专供 GPU 的 fp16 变体。方案 BAPI 嵌入模型如果想用云端模型先切到设置 → YOLO → 模型标签页给某个提供商添加嵌入模型比如 OpenAI 的text-embedding-3-small再回到知识库标签页在「API 模型」一行选中它。选中后还要点一次「设为当前」才生效。因为切换嵌入模型会让所有已有向量失效、等于全库重建多这一步是为了防止你手滑点错下拉框就触发一次全量重建。远端与本地两条路径的切换逻辑见 embedding.ts。第二步开启并建立索引嵌入模型就位后点状态条上的「开启并建立索引」。索引进度会实时显示在状态条和底部状态栏包括当前正在处理哪个库、百分比、当前文件名。建好之后卡片显示状态已就绪 / 索引中 / 待更新 / 排队中 / 需要关注、文档数、向量块数、占用体积。AI 检索时自动走混合模式无需你干预。进阶多知识库与高级设置拆分成多个知识库把库拆成几个独立知识库各自管不同范围如工作笔记和读书笔记。点「新建知识库」每个库只配三项名称必填、不能重名描述建议写这段文字会提供给模型帮它判断该查哪个库包含 / 排除范围可视化目录选择器规则向子目录传递检索时 AI 会按名称和描述自动判断该查哪一个不指定就合并所有库的结果。所有知识库共用同一个嵌入模型和同一套分块设置。常用高级参数知识库标签页底部有一组默认折叠的全局设置设置默认说明索引 PDF开大库里不用检索 PDF 时关掉可提速分块大小1000改完需手动重建索引才真正生效最小相似度0.0调高可过滤勉强相关的结果限制10每次检索返回的条数嵌入并发数10遇到 429 限流报错就调低免费档常见调到 2–3 通常正常什么时候必须手动重建换了嵌入模型、或改了分块大小只影响之后新索引的内容已有向量不会自动重算。改完记得全量重建否则新旧向量混在一起检索质量会莫名变差。自动更新默认开启——编辑笔记后空闲约 5 分钟会同步进索引。手动入口有状态条「立即更新」、卡片菜单「重建此库」、命令面板的更新修改文件的索引 / 重建整个库索引。检索是怎么发生的你基本不需要做任何事。AI 判断需要查笔记时会自己调用「知识库检索」工具若你要强制它看某篇具体笔记用引用更直接——引用是确定的检索是概率的。另外侧栏「灵光写作」标签页里的相似笔记面板基于当前打开的笔记做向量检索列出相关笔记并可展开命中片段、插入链接。它同样依赖知识库索引没配好时面板会给出引导按钮。相似笔记的相似度分级实现见 similarNotes.ts。完整参数与边界情况可继续阅读官方文档 知识库与检索 和 模型与提供商。赞分享【免费下载链接】obsidian-yoloAgent-native AI assistant — chat, write, whiteboard, learning, all in one.项目地址https://gitcode.com/gh_mirrors/ob/obsidian-yolo点击查看免费下载相关推荐艾尔登法环存档编辑器5个实用技巧重塑你的交界地冒险艾尔登法环存档编辑器5个实用技巧重塑你的交界地冒险 ER Save Editor是一款开源的艾尔登法环存档编辑工具专为想要个性化游戏体验的玩家设计。无论你是桌面应用Qwen-7B-Chat 接入 LangChain 搭建知识库助手基于 RAG 的本地检索问答实战Qwen 7B Chat 接入 LangChain 搭建知识库助手基于 RAG 的本地检索问答实战 本篇技术指南基于 Datawhale self llm 仓大模型人工智能教程本地部署微调ARIS 集成指南为 /research-lit 接入 Obsidian 知识库与 arXiv 双引擎检索让文献综述从你的笔记开始ARIS 集成指南为 /research lit 接入 Obsidian 知识库与 arXiv 双引擎检索让文献综述从你的笔记开始 本文围绕 ARISAuAI 技能/插件AI 评测科研人工智能MCP 服务dsh-plugin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考