企业官网建设流程全解析

Khoj Obsidian 插件完整配置指南：10 分钟把笔记库接入 AI 搜索与对话

【免费下载链接】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 是一个可自托管的 AI 第二大脑，能把你的 Obsidian 笔记库变成可对话、可语义搜索的知识库。装好官方 Obsidian 插件并接通 Khoj 服务器后，你可以在 Obsidian 里直接提问、搜索和找相似笔记。本指南覆盖从装插件到跑通第一次搜索的完整流程，核心配置通常 10 分钟内可以完成。

💬 它能做什么

简单说：Khoj 负责把笔记内容向量化并托管 AI 模型，Obsidian 插件负责把笔记同步过去、把结果展示出来。适合已经在用 Obsidian 记笔记、希望用自然语言检索和问答的人。三个核心功能：

• Chat：以对话方式向自己的笔记提问，答案来自你私有笔记或联网搜索；
• Search：自然语言搜索，边输入边出结果；
• Find Similar Notes：查看与当前笔记相似的其它笔记。

上手前检查

开始之前确认以下几项，基本可以避开大部分问题：

• Obsidian 版本不低于 0.15.0，这是插件清单（src/interface/obsidian/manifest.json）声明的最低要求；
• Khoj 服务器已就绪，两种方式任选：
  • Docker：使用仓库根目录的 docker-compose.yml 启动，适合想要"装完不用管"的场景；
  • Pip：终端执行python -m pip install 'khoj[local]'后启动khoj，首次运行会引导创建管理员账号并选择聊天模型。
• 服务器默认监听 42110 端口，浏览器能打开http://localhost:42110即代表服务端正常；
• 准备一个可用的聊天模型来源（OpenAI、Anthropic、Gemini 的 API Key，或 Ollama 等本地模型）。详见 自托管文档。

🔧 核心操作

在 Obsidian 社区插件商店安装 Khoj

打开 Obsidian 的"设置 → 第三方插件"（Community plugins），先关闭"安全模式"，在商店里搜索Khoj，点 Install，再点 Enable。装完后 Obsidian 左侧边栏会出现一个对话框图标，命令面板里能看到Khoj: Chat、Khoj: Search、Khoj: Find similar notes等命令，插件已加载成功。

配置服务器地址，接通 Khoj

进入"设置 → 插件 → Khoj"，你会看到Khoj URL输入框。两种填法：

• 自托管：填http://127.0.0.1:42110（服务器在 Obsidian 同一台机器上时）；
• 使用在线服务：保持默认地址，无需自己跑服务器。

填完后输入框下方会实时显示连接状态，看到已连接（Signed in）就代表地址对了。注意 URL 结尾不要多带斜杠，插件会自动帮你去掉。

生成并填入 API Key

• 使用在线服务时：打开 Khoj 网页版，进入 设置 → Clients 页面，生成一个 API Key，粘贴到插件的Khoj API Key输入框即可，状态栏会立刻更新连接结果；
• 自托管且以匿名模式运行（即启动参数带了--anonymous-mode的单用户本地场景）：不要填API Key，留空即是正确状态，不要误以为是报错。

触发首次索引，让笔记进入 Khoj

插件设置页有一个Sync区域。打开Auto Sync开关后，插件会按 Sync Interval（默认 60 分钟）周期性自动同步库内笔记；如果想立即建立索引，点Force Sync → Update，按钮会变成月相动画，下方进度条显示Syncing... X / Y files，跑完即完成首次索引。几千条量级的笔记库，一般几分钟内完成。

同步内容默认包含 Markdown 笔记，另有Sync Notes / Sync Images / Sync PDFs三个开关，按需开启图片和 PDF。

开始使用三个功能

• 对话：点左侧边栏 💬 图标或命令面板运行Khoj: Chat，用自然语言提问，比如"我去年什么时候报的税？"；
• 搜索：命令面板运行Khoj: Search（默认快捷键 Ctrl+Alt+S），支持用查询过滤器限定搜索范围；
• 找相似笔记：打开某篇笔记后运行Khoj: Find similar notes（默认 Ctrl+Alt+F）。

❓ 高频问题排查

插件一直显示连接失败

按顺序排查：

1. 确认浏览器能打开 Khoj 网页版（http://localhost:42110），打不开就是服务器问题，与插件无关；
2. 检查 Khoj URL 是否多了斜杠、端口是否写成 42110；
3. 自托管且未用匿名模式启动时，必须填写有效的 API Key，匿名模式才留空——两种模式恰好相反，这是最常见的混淆点；
4. 仍不行，在插件设置里关闭再开启 Khoj（Enable/Disable），强制重新读取配置。

搜索或对话回答里找不到我的笔记

说明索引没有覆盖到这些笔记：

1. 先确认 Sync 区里 Auto Sync 已打开、对应文件类型开关（Notes/Images/PDFs）已勾选；
2. 点一次 Force Sync 重新全量索引；
3. 如果笔记在某个文件夹里而你设置过"仅同步指定文件夹"，确认该文件夹在包含列表中（排除列表优先级更高）。

改了设置但不生效

官方文档给出的处理顺序（见 Obsidian 客户端文档）：打开插件设置页确认改动已保存 → 开关一次 Enable/Disable 让插件重新加载 → 结果失败或过期时点 Update 强制刷新索引。

⚙️ 可选进阶

以下几项都位于插件设置页，不影响基础使用，按需调整：

• 可选：调整同步频率。Sync Interval 提供 1 到 1440 分钟的档位，笔记更新频繁、想更快被搜索到，就调小它；
• 可选：限定同步范围。用 Folders to sync / Folders to exclude 只同步指定目录，排除归档文件夹可以明显减少索引量；
• 可选：调整结果数量。Results Count 滑杆控制搜索返回和对话引用条数（1–30），笔记库很大时适当调低可以减少噪音。

收尾

配置到这里就算跑通了：插件能连上服务器、Force Sync 跑完、三个命令能返回自己的笔记内容，即为完成。之后日常使用中，Auto Sync 会替你处理增量更新，你只需要偶尔在社区插件页点一下 Check for updates 保持插件版本最新。

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