Obsidian 装了一堆插件笔记囤了几千条真到想找点东西的时候还是得靠人肉搜索。这不是 Obsidian 的问题是我一直缺一个能直接和笔记库对话的入口。前阵子我把 Copilot 插件和硅基流动SiliconFlow的模型接起来之后这个局面才算真正改观。这篇文章就把我完整配置的过程、遇到的坑、以及最后是怎么让 AI 老老实实基于我的笔记回答问题的全部摊开来讲。Copilot 插件本身是 Obsidian 社区里比较成熟的 AI 助手类插件它支持接入各种模型服务而硅基流动提供的 API 兼容 OpenAI 格式国内直连、开通简单、有免费额度两件事凑在一起就成了一个很务实的方案。整个过程不需要自己搭服务器也不需要折腾复杂的网络环境适合大多数 Obsidian 用户直接照着做。1. 为什么我用 Obsidian Copilot 硅基流动这套组合1.1 我在笔记场景里遇到的真实痛点我的 Obsidian 库大概用了两年多里面存的东西很杂技术笔记、读书摘录、会议记录、临时想法还有一些从网页上剪藏的长文。库一大问题就来了——明明记得自己写过某个东西但就是想不起关键词搜索也搜不出来。尤其是那些当时觉得“以后肯定用得上”就丢进去的碎片信息真到用的时候它们就跟消失了一样。我试过给笔记打标签、建 MOC、做关系图谱有用但维护成本很高。标签打多了会乱MOC 建了之后还得定期更新图谱看久了也就是个自我安慰。我真正想要的是能直接问一句“我之前记录过关于缓存失效的几种处理方式吗”然后它帮我把相关内容翻出来并且用我笔记里的原话组织成答案。这其实就是一种“基于笔记库的对话式检索”比传统全文搜索更符合人的提问习惯。1.2 市面上几类 AI 辅助笔记方案为什么这套组合最省心在选定 Obsidian Copilot 之前我把能想到的路线都过了一遍大致分成三类。第一类是 Obsidian 官方的 AI 插件比如 Copilot、Text Generator、Smart Connections。Copilot 的优势在于它专攻对话交互界面就是聊天窗口左侧直接能看到笔记上下文用起来最“原生化”。Smart Connections 更偏自动关联它不擅长直接问答Text Generator 偏生成文本比如批量写摘要做对话也不是它的强项。第二类是本地模型方案用 Ollama、LM Studio 在笔记本上跑一个本地模型。好处是隐私性好、免费但问题是效果参差不齐。我拿自己的笔记试过7B 参数级别的模型理解长上下文的能力偏弱经常答非所问而且把几千条笔记喂进去建索引内存直接拉满。除非你的笔记库很小、且对效果要求不高否则本地方案当前还是有点折腾。第三类是接云端 API也就是用 OpenAI、Claude 或者国内的模型服务平台。OpenAI 需要考虑支付和接口访问的稳定性Claude 的配置路径也类似但对国内用户来说开通和支付的复杂程度高一些。这时候硅基流动的优势就体现出来了它兼容 OpenAI 接口格式有免费的模型额度注册简单而且不需要额外处理海外支付的问题。所以最后我选了“Copilot 插件 硅基流动 API”的组合。插件负责提供对话界面和笔记上下文硅基流动负责提供模型推理能力各管一段链路清晰。2. 拿到可用的“API 钥匙”硅基流动账号准备与额度说明2.1 注册开通与实名认证先去硅基流动的官网云平台完成注册。这一步比较常规手机号验证一下就进去了。有一点提醒一下平台现在要求实名认证才能调用 API。认证过程就是身份信息验证几分钟能通过。我自己当时图省事想着先不认证、看看能不能白嫖额度结果创建 API Key 之后调用接口直接返回 403。所以别绕弯子注册完顺手把认证做了。认证通过之后控制台左侧的菜单会完全解锁可以看到模型广场、API 密钥管理、费用账单这些入口。2.2 创建 API Key 和管理密钥API Key 相当于你调用模型的钥匙。在控制台找到“API 密钥”页面点新建会生成一串以sk-开头的字符串。注意这串密钥只在创建时完整显示一次页面刷新之后就看不到了所以创建完立刻复制到本地临时文件里。这里有一个很小的安全习惯值得养成别把 API Key 直接嵌在笔记正文里尤其如果你的 Obsidian 库会同步到 GitHub 或者公开仓库。我见过有人把带密钥的配置截图发到群里然后第二天账号被刷爆。硅基流动后台支持创建多个 Key建议一个 Key 专门给 Obsidian Copilot 用另一个留给其他项目出了问题方便单独吊销。密钥的作用域也顺便说一下目前平台不区分“只读”和“可写”权限一个 Key 可以调用所有你有权限访问的模型。所以保管好它比事后止损容易得多。2.3 模型定价与免费额度硅基流动的模型很多覆盖文本生成、向量化、重排序、语音等类型但 Copilot 主要用到的是文本生成模型。平台提供免费额度注册认证后可以领取一定量的免费 token具体数值以平台活动规则为准通常够你配置完做几轮实测。另外有一部分开源模型提供永久免费或极低价调用比如某些小尺寸模型日常问答完全够用适合想零成本跑通流程的朋友。付费模型按 token 计费模型尺寸越大越贵。我的使用强度是每天几十次问答每次几百到几千 token一个月下来费用在几块钱到十几块钱之间属于完全可以接受的范围。对比 OpenAI 的订阅或者 API 费用硅基流动的价格优势对国内用户还是很明显的。选模型的时候不用盲目追最新最大。如果你的笔记问答场景偏中文、偏知识检索很多中尺寸模型的性价比比大模型高得多。这一点我在后面第 4 部分会给出具体模型清单。3. Obsidian 端操作插件安装与 Copilot 基础配置3.1 安装社区插件Obsidian 装插件有两个入口一个是“设置 → 第三方插件 → 关闭安全模式”一个是“社区插件 → 浏览”。首先确保你的 Obsidian 设置里允许使用社区插件。这一步如果没开浏览社区插件列表的时候就什么都搜不到。在社区插件搜索框输入 “Copilot”会找到由 logancyang 开发的 Copilot 插件作者名字对得上就行。点击安装然后启用。装完之后左侧边栏会出现一个聊天气泡图标点开就是 Copilot 的主界面。这里补充一个版本相关的细节。Obsidian 插件生态更新很频繁Copilot 的界面和设置项在不同版本之间会有一点差异比如老版本没有“打开聊天视图”的按钮新版本则支持分栏模式。如果你看到我的截图和你本地的界面不完全一样大概率是版本不同核心配置项的名称一般不会变。3.2 Copilot 页面布局和工作原理第一次打开 Copilot会看到一个类似 ChatGPT 的聊天窗口底部是输入框。左侧或顶部会有模型选择的下拉框这里现在大概率是空的因为你还没接任何模型。Copilot 的本质是一个“对话壳子”。它自己不产生 AI 能力而是把你在聊天框里输入的内容连同你在 Obsidian 中选定的笔记内容、当前打开的文档上下文一起组装成请求发给你在后台配置好的模型服务然后拿回结果展示在界面上。理解这一点很重要。因为很多配置问题归根结底就是要么请求没发出去要么请求的格式不被模型服务识别要么模型服务返回了错误但插件界面没给你的提示不够明确。后面排查章节会反复用到这个思路。3.3 核心设置项逐条说明点开 Copilot 的设置你会发现选项非常多。我先只讲第一次配置必然要碰到的几个其他的进阶选项后面再说。首先是模型提供方Provider。Copilot 内置了 OpenAI、Azure、Ollama、Google 等多个提供方选项。如果你的插件版本列表里已经有SiliconFlow直接选它最省事如果没有可以选择OpenAI作为提供方然后手动修改 Base URL效果是一样的。实际上硅基流动的接口设计就是兼容 OpenAI 格式的所以用 OpenAI 兼容模式接入是完全可行的。然后是 API Key 填写位置。注意有些版本里 API Key 在全局设置里填有些版本里需要点开“模型”Tab在对应模型条目下面填还有的版本两者都是同一个字段。保险起见全局设置和模型设置里的 API Key 都填同一个值不会冲突。另外还有一个容易被忽略的选项叫Chat Context或Conversation Mode它决定 Copilot 会把多少上下文信息带进对话请求。新手阶段先保持默认等配置通了再慢慢调。4. 把模型“接”进 ObsidianSiliconFlow API 连接配置实操4.1 Provider 选择与 Base URL 填写这一步是整个配置过程的核心。我按“在 Copilot 设置里手动添加自定义模型提供方”的路子来写。如果你在 Copilot 的 Provider 下拉列表里找不到 SiliconFlow就选 OpenAI。随后会出现Base URL输入框填入https://api.siliconflow.cn/v1注意结尾这个/v1不能省。很多朋友填 URL 时习惯性只填到域名结果请求路径拼出来是https://api.siliconflow.cn/chat/completions少了/v1段接口直接 404。这是我见过的最常见的低级错误之一。API Key 填你之前从硅基流动控制台复制的那串sk-字符串。4.2 模型名称精确填写与可用模型清单配置完 Base URL 和 API Key 之后需要在 Copilot 的模型列表里指定具体用哪个模型。这里有个容易踩的坑模型名称必须和硅基流动平台上的“模型标识”完全一致不能写模型的显示名称更不能自己起名。比如你想用 DeepSeek 系列模型在 Copilot 里填的模型名应该是类似deepseek-ai/DeepSeek-V3deepseek-ai/DeepSeek-R1如果是 Qwen 系列Qwen/Qwen2.5-72B-Instruct如果是 GLM 系列THUDM/glm-4-9b-chat那怎么确认当前平台上准确的模型标识两个办法。第一直接在硅基流动控制台的“模型广场”里找到你想要的模型点进去可以看到模型名称和 API 调用示例示例代码里那个model字段的值就是你在 Copilot 里要填的。第二在 Copilot 的模型设置页里有的版本会提供一个“拉取模型列表”的按钮能直接列出该 API 下可用的模型 ID点一下然后从列表里选比自己手输要稳妥得多。我个人的建议首次配置先用一个免费或者极低价的模型比如 Qwen 系列的小尺寸版本先把链路跑通然后再切到更大的模型。这样即使哪里配置错了亏的也只是几分钟排查时间不会产生费用。4.3 首次对话验证与常见配置问题配置完成之后在 Copilot 的聊天窗口输入一句测试内容比如“简单介绍一下你自己并说明你当前接入的模型服务类型。”然后回车。如果一切正常模型会返回一段正常的文本回复。如果报错最有可能是下面几种情况401 UnauthorizedAPI Key 填错了或者复制的时候多了空格。404 Not FoundBase URL 的/v1路径不对。400 Bad Request模型名称填了平台不存在的标识或者请求参数不被兼容。429 Too Many Requests触发限流或者账号没有可用额度。这些我在第 6 部分会展开成一套排查思路这里先不展开。首次对话通过之后恭喜你链路已经通了接下来才是真正好玩的阶段。5. 让它干活Vault QA、文本总结与写作辅助的实测效果5.1 基于笔记库的问答Copilot 最有价值的场景就是Vault QA也就是基于整个笔记库的问答。它的工作方式是先对你的笔记库做一次向量化索引把文本切块、嵌入成向量存到本地然后当你提问时先在库里召回最相关的片段再把这些片段和问题一起发给模型让模型基于这些片段组织答案。这个功能需要额外设置一个嵌入模型Embedding Model默认会使用 OpenAI 的 embedding 接口。如果不想走 OpenAI硅基流动也提供 Embedding 模型名称形如BAAI/bge-m3将嵌入模型也切到硅基流动就可以全部走国内接口了。设置完成后Copilot 会让你先建立索引。库如果很大建立索引可能要等几分钟到十几分钟这期间 Obsidian 界面会有一点卡顿正常现象。索引建好之后聊天的体验非常奇妙。我拿自己最头疼的场景测试过问它“我之前记录的关于 TypeScript 类型体操的笔记里有哪些关于递归类型的使用案例”它能把藏得很深的一条笔记拽出来还能结合其他几条相关内容给出一个综合性的回答。这种效果靠全文搜索几乎做不到因为你不记得关键词搜索就无从谈起。还有一点值得说召回的质量依赖文本分块方式。Copilot 默认的分块策略对大多数笔记已经够用但如果你笔记里有大量很长的代码块建议在设置里把分块大小调小一点避免代码片段被截断得四不像影响召回效果。5.2 对长篇笔记做结构化总结除了 Vault QACopilot 还能直接操作当前打开的笔记。比如打开一篇几千字的会议记录然后在聊天框里输入/summarize它会自动把当前笔记的内容抓取出来生成一个带要点的摘要。这种“能感知当前文档”的机制非常实用。我常用的一个操作是打开一篇技术调研笔记然后让它“提取出这篇文章里的关键结论、待办事项和风险点”它给出的结果比我自己回看一遍快得多。而且 Copilot 还支持批量总结比如选中多条笔记然后一次生成摘要。对于读书笔记类的资料整理这个功能能省下大量时间。如果你觉得默认提取结果不够贴合需求可以在设置里调整 prompt 模板。Copilot 的 prompt 是可以自定义的改成一个更符合你工作习惯的指令模板让它每次总结时自动带上你要求的维度比每次手动补充指令高效得多。5.3 写作辅助与改写写作场景是我最初没预期到、但实际使用频率很高的一个功能。在 Obsidian 里写博客草稿时经常写着写着卡住需要换个说法或者补一段论述。这时候我直接选中卡住的那段文字在 Copilot 里输入改写指令比如“把这段话改得更口语化、更适合博客读者阅读”它能在几秒内给出几个候选版本。这种用法不完全是为了“让 AI 代笔”更像是把它当成一个随时在旁边的润色工具。更妙的是因为对话上下文里带着你笔记库的相关内容它改写出来的内容会比纯在线聊天工具更贴合你的个人风格。我还试过用它来写每日工作总结。给 Copilot 一个简单的指令模板比如“根据我今天记录的日志笔记生成一份包含完成事项、遇到的问题、明日计划的工作日报”它会检索当天的笔记并自动填充。虽然生成的初稿还需要人工微调但至少有 70% 的内容可以直接用比从零开始写舒服多了。5.4 提示词模板分享以下是我实际在用的几个提示词模板供参考问答模板请基于笔记库中的相关内容回答我的问题。如果笔记中没有足够信息请直接说明“当前笔记库中没有找到相关答案”不要编造内容。问题{你的问题}总结模板请将当前笔记内容概括为核心要点按“结论 / 依据 / 行动项”三部分输出语言简洁条目不超过 8 条。反查模板请找出笔记库中所有与“{某个主题}”相关的笔记标题和所在路径并按相关度从高到低排列。改写模板请将选中的文本改写为更适合“{目标平台}”的风格保持原意不变语气自然段落间衔接流畅。提示词的核心原则是“明确边界”。尤其是问答类提示词一定要告诉模型“不知道就说不知道”否则它会非常自然地编造一个看起来像模像样的答案这在知识管理场景里是致命的。6. 踩坑记录报错排查与配置细节的补充6.1 401 Unauthorized 鉴权失败这个报错最常见原因也非常简单直接API Key 不对或者没有正确传递。排查链路我建议按这个顺序走先在硅基流动控制台打开“API 密钥”页面确认该 Key 状态是“启用”而不是“已吊销”。复制完整 Key回到 Copilot 设置里重新粘贴特别注意前后有没有多余的空格。复制粘贴时Key 末尾如果带了一个回车符就会导致鉴权失败。确认你粘贴的 Key 是不是属于当前登录的账号。我有一次为了图方便把同事的 Key 复制过来先测结果一直报 401还以为是网络问题。Key 和账号是一一对应的串了就会这样。6.2 400 Bad Request 请求格式错误如果报 400基本可以确定是请求参数的问题。最常见的是model字段填了一个不存在的模型标识。排查方法去硅基流动控制台“模型广场”找到你想用的模型查看它的 API 调用示例复制model字段的值回到 Copilot 里粘贴。不要手动改大小写模型标识是大小写敏感的。比如DeepSeek-V3和deepseek-v3可能对应不同的标识填错就是 400。另外Copilot 某些版本会在请求中带上max_tokens参数如果你的模型在硅基流动侧对单次生成长度有限制且请求参数超出了限制也会表现为 400。这种时候去 Copilot 设置里把Max Tokens调低一点比如改成 1024 或 2048。6.3 429 限流与余额不足429 报错要分情况看。一种是真的触发平台的限流策略比如短时间发了几十个请求。这种情况在 Obsidian 里手动对话时极少发生更多是因为你配置了某些自动调用功能比如启动时自动为所有笔记生成摘要结果一次性发太多请求。解决方式是调整 Copilot 的自动触发设置限制并发数。另一种 429 其实是欠费或者免费额度用尽的状态提示。去硅基流动控制台看余额和用量记录如果免费额度已经用光那就需要充一点钱。别觉得充钱心疼实际价格低到可以忽略关键是别耽误事。6.4 关于“指定模型不可用”的理解有时候配置看起来完全正确但聊天时会提示模型不受支持或不可用。这通常是因为硅基流动平台的模型列表是会动态调整的。一些模型可能在特定时间段内因为资源调度暂时下线或者你选择的模型只对特定用户开放。遇到这种问题我一般直接在平台“模型广场”筛选出“可在线体验”或“API 可用”的模型找一个尺寸相近的替代品把 Copilot 里的模型名改过去。实测下来在同一个模型家族里切换比如从 Qwen2.5-72B 换到 Qwen2.5-32B对话效果差异不会特别大但能不能稳定调用才是更重要的。写在最后的一点个人体会这套配置我已经稳定使用了两三个月每天打开 Obsidian 的第一件事就是顺手问一句今天要处理的东西有没有相关的历史笔记。Copilot 加上硅基流动确实把“笔记本”从一个只能被动检索的仓库变成了一个可以主动对话的工作台。如果你也想搭一套我的建议是先别追求一步到位。用免费模型把链路跑通随便聊两句感受一下然后再去配置 Vault QA 的向量索引最后再慢慢试不同的提示词模板和更大尺寸的模型。一步一个脚印比一次性把所有细节都搞完美要实际得多。另外配置完记得定期去硅基流动控制台看一眼用量。虽然单次费用很低但如果你开着自动总结之类的功能积累下来的量也会变成一个不容忽视的数字。我自己就是某天闲着没事翻账单才发现居然有一笔两块钱的“巨款”仔细一看是上周给一整个文件夹做笔记摘要时刷掉的。控制台里能设置用量预警顺手打开能省很多不必要的惊吓。最后再分享一个很小但很实用的技巧在 Copilot 的设置里可以把 Chat 的快捷键设成一个顺手的组合键。我设置的是CtrlShiftC在任何笔记界面都能一键呼出对话窗口比鼠标点图标快得多。这个细节虽然不起眼但实际用起来体验提升非常明显。希望你也一样能享受这种“问笔记”的快乐。