Obsidian连不上Khoj从状态灯到验收通过的完整排障指南【免费下载链接】khojYour AI second brain. Self-hostable. Get answers from the web or your docs. Build custom agents, schedule automations, do deep research. Turn any online or local LLM into your personal, autonomous AI (gpt, claude, gemini, llama, qwen, mistral). Get started - free.项目地址: https://gitcode.com/GitHub_Trending/kh/khojKhoj 是一个可自托管的 AI 第二大脑能对你的笔记做自然语言搜索和对话。本文按 Khoj Obsidian 插件排障时最常见的三类问题——状态灯变红、搜索没结果、同步不及时——给出可操作的修正方法文末附一份完整验收清单。先看状态灯分清是连不上还是没索引排障第一步是判断坏在哪一层。打开 Obsidian 设置面板里的 Khoj 配置页顶部有一个 Connect 状态灯 红灯连不上服务器或 API 密钥无效黄灯服务器可达但账号没被识别绿灯连接正常红灯看下一节绿灯但搜索为空、对话答不出笔记内容说明问题出在索引直接跳到第三节。连不上服务器地址与 API 密钥修正红灯大多由配置页里的两个字段引起。使用云端账号在 Khoj 网页应用的设置页生成密钥复制后粘贴到插件配置页的 Khoj API Key 字段保存后状态灯应变绿。仍为红灯时重点检查密钥首尾有没有多余空格或换行。自托管服务器把 Khoj URL 字段改为http://127.0.0.1:42110。如果你的服务器用khoj --anonymous-mode匿名模式启动密钥字段留空即可。两个字段都改过仍不亮绿灯到社区插件页把 Khoj 关闭再重新启用相当于重载插件。改完设置没生效、页面还显示旧值是这个操作的典型适用场景。绿灯却搜不到全量索引、类型开关与文件夹范围连接正常但搜索和对话都答不出来十有八九是索引没建好按顺序查三处补一次全量索引。配置页 Sync 区域里点 Update 按钮触发 Force Sync页面会显示进度条和文件数。笔记量大时等几分钟别中途关 Obsidian。文件类型开关。Sync Notes、Sync Images、Sync PDFs 三个开关默认都开但如果只开了 PDFMarkdown 笔记就不会进索引。文件夹范围。Include Folders 留空表示同步整个库Exclude Folders 有配置时排除优先于包含。确认你要查的笔记所在文件夹没被排除。修完重跑命令面板里的 Khoj: Search。仍找不到时用查询过滤器缩小范围、确认哪类文件真正被索引了写法见查询过滤器说明。调优结果数量与同步频率能用了之后这三个设置决定日常体验Results Count1 到 30 的滑杆默认 15。搜索结果太散就调低到 5对话引用不够就调到 20 左右。Sync Interval从 1 分钟到 24 小时可选默认 60 分钟。希望新笔记马上可搜就选 1 分钟在意服务器压力就拉长。同步范围用 include/exclude 文件夹把范围收窄索引更快、结果也更聚焦。完整验收走一遍确认配置生效按下面四步走查两分钟内完成配置页状态灯为绿悬停显示已登录的邮箱新建一篇笔记写一句有辨识度的话等一轮同步间隔或手动 Force Sync 一次搜索应能命中命令面板运行 Khoj: Chat问一个只有这篇笔记能回答的问题回答应基于笔记内容修改该笔记内容再同步一次新搜索结果应体现改动四项都通过Khoj Obsidian 插件的配置就完成了。更多用法细节可查官方 Obsidian 客户端文档。下一步现在就打开 Obsidian 设置看一眼 Khoj 插件配置页的状态灯颜色按对应小节开始处理。【免费下载链接】khojYour AI second brain. Self-hostable. Get answers from the web or your docs. Build custom agents, schedule automations, do deep research. Turn any online or local LLM into your personal, autonomous AI (gpt, claude, gemini, llama, qwen, mistral). Get started - free.项目地址: https://gitcode.com/GitHub_Trending/kh/khoj创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考