企业官网建设流程全解析

Khoj Obsidian 插件配置指南：10 分钟修好"点连接一直转圈"

【免费下载链接】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

装完插件、填好地址，Khoj Obsidian 插件里点连接测试却一直在转，最后弹出一句超时。这是 Obsidian 接入 Khoj 配置里最常见的卡点——先别急，多半不是网络问题，而是服务没起、密钥不对、或第一次索引没跑这三件事之一。弄通之后，你能在 Obsidian 里直接用自然语言问自己的笔记，搜索还能跳到对应段落。

最短路径：先跑通

只做三件事：

• 在 Obsidian 社区插件列表里安装并启用 Khoj，打开它的设置页。
• 填服务器地址和 API 密钥：用云服务就保持默认，地址字段不用动；自建的话填本地地址http://127.0.0.1:42110。
• 点设置页底部的 Update，跑第一次全量索引；进度条走完、提示"更新了 X、删除了 Y 个文件"，就算通了。

一般到这一步就通了。完整流程可对照官方 Obsidian 客户端文档。

连不上？按症状查 🔍

遇到 Khoj 插件连接失败时，先别急着重装，看它卡在哪一环。

转圈、超时：这类 Khoj 插件超时的原因基本是地址不通。自建先确认 Khoj 服务起着、端口没写错；用云服务就检查当前网络或代理是否拦截。这里有个坑：设置页顶部状态行提示"无法连接到 Khoj"时，说明还没走到校验密钥那一步，先解决连通性。

绿灯变黄灯：红灯是没连上，黄灯是连上了但账号没认出来。用云服务就去settings#clients页面生成新密钥粘进来；自建匿名模式下密钥栏直接留空即可。

索引卡在"Preparing files"：首次同步要传整个库，本来就慢。卡太久就看图片、PDF、笔记三个开关，库里附件多的话，先关掉不常查的类型，再点一次 Update。

同步时报限流（429）：免费版云端存储配额大约 10MB，超了请求会被直接限流。收窄同步范围或升级套餐，再试。

把体验调顺

下面四个都是 Khoj 索引设置项，按"先动哪个见效最快"排序：

• 索引范围：用 Include/Exclude Folders 把目录圈成只留你常问的，其余挪出去。见效最明显——索引快、搜索不被干扰、配额也省得最多。
• 文件类型开关：以写笔记为主的话，把图片和 PDF 同步关掉，每轮同步量直接变小。
• 同步间隔：默认 60 分钟一次；白天密集写笔记改 5 分钟，平时只看就 24 小时。
• 结果数量：滑杆默认 15，范围 1–30。调小回答更快但容易漏来源，调大引用更全但更慢。

用起来：两个真实场景 💬

点左侧边栏的气泡图标打开对话窗，输入"本周周报里有哪些关键结论"，它会翻完本周的条目归纳要点，每条回答后面都挂着来源笔记。

说不准怎么问时，按 Ctrl+Alt+S 打开搜索框，输"坦桑尼亚 旅行"这类关键词，列表直接给出每条来自哪个文件。已经在看某篇笔记、想找相关篇目，就运行命令面板里的"Khoj: Find Similar Notes"。

配置只是入口，日常问出来的问题、你排除的目录、滑杆拖到的位置，这些用起来之后的反馈才会把参数调对。仍不通的话，翻翻插件源码里的连接检测逻辑，比猜快。

【免费下载链接】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