Local AI Search

触发条件

当用户说以下内容时，调用此 Skill：

• - 帮我在本地搜索...
• 帮我在本电脑搜索...
• 帮我在某个文件夹中搜索...
• 搜索本地文件...
• 搜索我的文档...
• 在本机查找...
• 从我的文件中查找...
• 或任何涉及本地/本机/文件夹内容检索的请求

功能说明

本 Skill 提供本地文件的 AI 智能搜索功能：

• - ✅ 支持 xlsx, pptx, pdf, docx, md 等格式
• ✅ 自然语言查询（用日常语言描述要找的内容）
• ✅ 指定文件夹范围进行搜索
• ✅ 返回文件位置信息（工作表名、幻灯片页码）
• ✅ 无需本地大模型，使用云端 API

使用方式

方式一：直接搜索（推荐）

用户: 帮我在本地搜索关于销售数据的内容
用户: 在 ~/Documents/Projects 文件夹中搜索 API 相关的文档
用户: 搜索本电脑中包含关键词的文件

方式二：指定目录搜索

用户: 帮我在 ~/Documents/Projects 文件夹中搜索技术文档

方式三：自然语言查询

用户: 帮我找一下第三季度的销售报告
用户: 搜索一下关于数字化转型的内容
用户: 找找看有没有关于项目计划的 PPT

调用流程

1. 1. 检查服务状态：确认 Khoj 服务是否运行
2. 确定搜索范围：用户指定的文件夹，或默认已索引的知识库
3. 执行搜索：使用自然语言查询本地文件
4. 返回结果：显示匹配的文件名、位置信息、内容片段

快速验证（已测试）

bash

1. 启动 Khoj 服务（嵌入式 PostgreSQL 模式）

2. 转换文档

3. 索引文件（API 方式）

4. 搜索查询

验证结果示例

[1] 文件: test_data.xlsx.md
工作表: Sales Data
内容: | Month | Sales | | January | $10,000 |...

[2] 文件: test_slides.pptx.md
幻灯片: 第 1 页
内容: # Project Overview This is a test presentation...

概述

基于 Khoj 的本地 RAG 知识库解决方案，支持大规模文件（100G到1T）的全文检索和自然语言查询。通过 MarkItDown 转换 Office 文档，结合云端 LLM API 实现轻量级部署，适合资源受限环境。

需求背景

核心需求

硬件约束

技术架构

架构图

┌─────────────────────────────────────────────────────────────────┐
│ OpenCode Skill │
│ rag query 搜索内容 --top-k 10 │
│ rag index /path/to/files │
│ rag status │
└─────────────────────────┬───────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ Khoj API Server │
│ localhost:42110 │
│ • 向量检索 │
│ • 对话生成 │
│ • 文件管理 │
└─────────────────────────┬───────────────────────────────────────┘
│
┌───────────────┴───────────────┐
▼ ▼
┌─────────────────────┐ ┌─────────────────────┐
│ PostgreSQL 数据库 │ │ 云端 LLM API │
│ (嵌入式 pgserver) │ │ 多模型支持 │
│ • 向量存储 │ │ • Chat Model │
│ • 文档索引 │ │ • 对话生成 │
│ • ~50-80GB │ │ • 无本地占用 │
└─────────────────────┘ └─────────────────────┘

数据流

xlsx/pptx → MarkItDown 转换 → Markdown → Khoj 索引 → 向量数据库
↓
用户查询 → 向量检索 → 匹配片段 → 云端 LLM → 自然语言回答
↓
显示来源文件 + 位置

组件说明

安装部署

环境要求

• - Python 3.10+
• macOS / Linux / Windows
• 建议 8GB+ 可用内存
• 足够的磁盘空间（文档大小的 25-40%）

平台支持

Windows 用户：安装 WSL2

WSL2（Windows Subsystem for Linux 2）让 Windows 可以直接运行 Linux，无需虚拟机或双系统。

powershell

1. 在 Windows PowerShell（管理员模式）中运行

2. 重启电脑后，打开 Ubuntu 应用

3. 在 Ubuntu 终端中继续以下安装步骤

安装 WSL2 后，在 Ubuntu 终端中执行所有后续命令。

安装步骤

1. 安装依赖

bash

安装 Khoj

安装 MarkItDown（含 Office 文档支持）

2. 配置云端 LLM API

bash

OpenAI

DeepSeek（推荐，性价比高）

Anthropic Claude

3. 启动 Khoj 服务

bash

嵌入式 PostgreSQL 模式（推荐个人使用）

访问 Web UI

使用指南

命令列表