2026年6月6日 · 阅读 —

笔记越写越多却越来越难找?这个 Obsidian 插件让 AI 替你养 Wiki

知识与内容工具AI 工程实践

笔记越写越多却越来越难找?这个 Obsidian 插件让 AI 替你养 Wiki

记笔记最荒唐的一刻,不是没东西可写,而是明明写过,却死活找不到。

人物、概念、项目和观点散在几百篇文档里。搜索能找到关键词,却很难告诉你两年前的想法和昨天的会议记录到底有什么关系。

于是 Obsidian 用着用着,知识库没有长成第二大脑,先长成了一个装修精致的仓库。

Karpathy LLM Wiki 想接管的,就是仓库管理员这份活:读取源笔记,提取实体和概念,自动生成带双向链接的 Wiki 页面,再负责查询、去重、修断链和维护索引。

它不是给笔记加个聊天框,而是重新编译一遍知识库

很多“AI 笔记助手”的玩法,是把文档切成碎片,塞进向量库,然后给你一个聊天框。

这个插件走的是 Andrej Karpathy 提出的 LLM Wiki 思路:把笔记当原材料,让 LLM 从中提取人物、组织、产品、事件、理论、方法和术语,再生成结构化页面与链接网络。

它遵循三层分离:

sources/     # 📄 你的源文档(只读)
  ↓ ingest
wiki/        # 🧠 LLM 生成的 Wiki 页面
  ↓ query / maintain
schema/      # 📋 Wiki 结构配置(命名规范、页面模板、分类规则)

源笔记继续由你写,生成内容放进 wiki/,结构规则放进 schema/。这就像把原始资料、编译产物和编译配置分开,AI 可以反复整理知识库,却不需要在你的原文上乱动刀。

截至 2026 年 6 月 6 日,最新正式版是 1.16.1,于 2026 年 6 月 5 日发布;最低支持 Obsidian 1.6.6,插件并非仅桌面端,采用 MIT 许可证。

双向链接终于不用全靠人肉缝

Obsidian 本来就擅长链接思考,问题是每条链接都要人自己发现、自己补。

Karpathy LLM Wiki 会从笔记中提取实体和概念,为它们生成独立 Wiki 页面,并把来源、相关概念和相关实体串起来。每个生成页面至少带一个别名,别名可以是翻译、缩写或变体名,也会参与跨语言重复检测。

它处理的事情放到真实笔记库里意味着什么
提取实体与概念一篇长笔记不再只有标题和标签,里面的人物、方法与产品都能长出页面
生成双向链接新笔记自动连接到已有知识,不必靠记忆补链接
多来源知识融合同一概念在不同笔记里的新信息会增量合并
保留矛盾与归属不会为了“整洁”把冲突观点强行抹平
保护 reviewed: true 页面人工确认过的内容不会被自动覆盖
保留原文引用来源提及保留原语言,可选翻译,方便追溯

重复摄入同一源文件时,实体页和概念页会增量合并新信息,摘要页则重新生成。文件夹批量摄入还会自动跳过已处理文件,避免每次都重新烧一遍 Token。

Wiki 真正难的不是生成,而是半年后还能不能用

自动生成页面不稀奇,难的是生成几百页以后别变成另一堆垃圾。

这个插件把维护当成核心能力,而不是顺手加的按钮。它能扫描重复页面、断链、空洞页面、孤立页面、缺失别名和矛盾,并提供按因果顺序执行的一键修复:

补全别名 → 合并重复 → 修复断链 → 链接孤立页 → 扩充空洞页

这个顺序有讲究。别名没补全,重复检测就容易漏;重复页面没合并,修链接又可能把错误关系继续扩散。先治上游,再处理下游,比一股脑乱修靠谱。

语义重复检测也分层处理:直接名称、跨语言翻译、缩写和高相似标题属于第一层;共享链接和中等相似度等间接信号属于第二层,再根据 Token 预算验证。

最新的 1.16.1 版本还专门修了 Lint 误报:多个页面都指向同一枢纽页,不再轻易被当成重复内容;大小写变体和空格转连字符导致的页面匹配问题也得到了处理。

问笔记一个问题,回答会把路标一起带回来

查询 Wiki 时,插件提供类似聊天工具的对话框,支持流式 Markdown 和多轮历史。

但回答不是一段说完就断掉的文字,而会带着 wiki-links 指回知识图谱。你可以顺着回答继续打开相关实体、概念和来源页面。

有价值的对话还能保存回 Wiki。保存前会做语义去重,Hash 跟踪也会阻止没有变化的对话被重复评估。

这才是“笔记会聊天”真正有用的地方:回答不是终点,而是重新进入知识库的入口。否则聊天框再聪明,也只是给仓库门口放了个能说会道的保安。

装插件很简单,真正要选的是模型和成本

推荐直接从 Obsidian 社区插件市场安装:

  1. 打开 设置 → 第三方插件。
  2. 点击浏览,搜索 Karpathy LLM Wiki。
  3. 点击安装并启用。

也可以从社区插件网站直接添加,或从 Releases 下载 main.js、manifest.json 和 styles.css,放入新建的 karpathywiki 插件目录。

需要参与开发时,先克隆仓库,再依次执行 pnpm install 和 pnpm build。

启用后,在设置中选择 LLM Provider,填入 API Key,获取或手动填写模型,测试连接后保存。当前支持 Anthropic、Anthropic 兼容接口、Gemini、OpenAI、DeepSeek、Kimi、GLM、OpenRouter、Ollama 和自定义接口。

Ollama 不需要 API Key,也能实现完全本地模式。项目给出的本地模型准备示例是:

ollama pull qwen3.5:latest

第一次接入,先拿一个小文件试水

你: 帮我配置 Karpathy LLM Wiki。
    先用一个测试文件验证,不要直接批量处理整个 Vault。

AI: 我会先确认 Provider、模型和连接状态,
    再摄入单个源文件,检查生成页面、别名和双向链接。

你: 通过后再处理文件夹,并把提取粒度设为粗略。

AI: 明白。先小范围验收,再批量执行,
    同时观察 Token 消耗、限流和重复页面情况。

从一篇笔记开始,比一口吞掉整个 Vault 靠谱

日常使用主要通过命令面板完成:

  • 摄入单个源文件:选择一篇笔记,生成实体、概念和摘要页面。
  • 从文件夹摄入:批量处理文件夹中的笔记。
  • 查询 Wiki:对自己的知识库进行对话式提问。
  • 维护 Wiki:扫描重复页、断链、空洞页、孤立页、缺失别名和矛盾。
  • 重新生成索引:重建带别名信息的 wiki/index.md。
  • 建议 Schema 更新:让 LLM 分析内容并建议结构调整。
  • 取消当前提取:在批次边界安全停止,保留已经完成的工作。

左侧边栏的按钮还能直接摄入当前文件。

flowchart TD
    NOTE[日常笔记] --> INGEST[摄入单篇或文件夹]
    INGEST --> EXTRACT[提取实体与概念]
    EXTRACT --> WIKI[生成 Wiki 页面与索引]
    WIKI --> QUERY[带 Wiki 链接的对话查询]
    WIKI --> LINT[健康扫描]
    LINT --> FIX[按顺序修复知识库]
    QUERY --> FEEDBACK[有价值的对话保存回 Wiki]
    FEEDBACK --> WIKI

提取粒度可以选极简、粗略、标准、精细,或自定义 1 到 300 个实体与概念上限。大文件夹适合先用极简或粗略,关键资料再精细提取。别上来就给每篇日记榨出一百个概念,知识图谱还没长好,账单先长成参天大树。

它没有押注 RAG,长上下文模型才是关键变量

这个插件遵循 Karpathy 的核心思路:查询时把完整 Wiki 上下文交给 LLM,而不是把知识切碎后只检索局部片段。

好处是模型可以在完整知识图谱上理解跨页面关系;代价也很直接:Wiki 越大,对模型上下文窗口和调用成本的要求越高。

本地模型通常上下文窗口更小,项目建议可以用云端 Provider 负责摄入,再用本地模型负责查询。实际怎么选,取决于知识库规模、隐私要求、调用频率和预算,不能只看模型聪不聪明。

并行页面生成支持 1 到 5 个并发,默认是 3。包含十个以上实体的源文件,项目说明给出的加速幅度为 2 到 3 倍。遇到限流时,应降低并发度或增大批次延迟;单页失败不会拖垮其他页面,失败项会独立重试并指数退避。

不想把笔记送出机器,也有一条完整退路

插件没有自己的后端、追踪或数据分析,完全运行在 Obsidian 内部。

除非主动配置 LLM Provider,否则笔记不会离开 Vault。真正发送出去的,是用于摄入或查询的文本,而且只会发往你选择的 Provider。

如果使用 Ollama、LM Studio 或其他本地 Provider,可以让笔记始终留在本机处理。插件需要 Vault 文件权限来读取笔记、生成页面和检查链接;网络权限用于调用所选 LLM API;剪贴板权限只在查询窗口主动点击复制时使用。

这个边界讲得比较清楚,但仍要记住:一旦选择云端 Provider,被摄入和查询的文本就会发送给对应服务商。隐私要求高的 Vault,别只看“数据默认本地”六个字就放心开跑。

笔记库已经开始失控的人,会最先感受到差别

  • Obsidian 笔记很多,但链接、标签和索引长期靠手工维护的人。
  • 想从文章、剪藏、会议记录中自动提取人物、概念和关联的知识管理用户。
  • 需要跨中文、英文、缩写和变体名识别重复页面的多语言知识库。
  • 想用自然语言查询个人资料,同时保留可点击来源路径的人。
  • 已经有旧 Wiki,需要持续检查断链、孤立页、重复页和矛盾的用户。
  • 希望通过 Ollama 或其他本地模型掌控隐私边界的人。

自动维护不是自动正确,源笔记和生成区必须分清

LLM 能帮忙整理,但不会自动让错误信息变正确。

生成页的内容质量仍然取决于源笔记、模型能力和提取粒度。语义去重、矛盾检测和智能修复也可能需要人工复核;重要页面应使用 reviewed: true 保护,别把知识库完全交给自动改写。

自动文件监听、定时 Lint 和启动健康检查默认全部关闭,这是合理的。先理解它会处理哪些目录、消耗多少 Token、如何合并页面,再决定是否打开后台自动维护。

从多个旧版本升级时,虽然当前版本向后兼容,不要求迁移数据,但建议重建索引、运行一次维护扫描,再用 Smart Fix All 清理历史遗留问题。

项目仍在快速迭代。1.16.1 是稳定性和体验热修复,重点解决 Anthropic CORS 回归、Lint 误报、大小写重复页面和模型设置体验,没有引入破坏性变更。

项目地址:https://github.com/green-dalii/obsidian-llm-wiki

真正有用的第二大脑,不只是记得多,而是多年以后仍能把关系找回来。

#Obsidian #LLMWiki #Karpathy #知识管理 #第二大脑 #知识图谱 #PKM #Ollama #LLM #GitHub #双向链接