企业官网建设流程全解析

小遥搜索（XiaoyaoSearch）是一款免费开源的本地AI文件搜索工具：听懂你的话、看懂你的图，用 AI 找到本地任何文件，让搜索像聊天一样简单。Windows 用户只需下载官方一键整合包，按本文 3 个步骤操作，即可在几分钟内完成小遥搜索安装启动，无需配置 Python、Node.js 等开发环境。

✅ 本文适合：首次安装小遥搜索的普通用户、不想折腾环境的电脑小白 ⏱️ 预计耗时：约 10~20 分钟（首次含 AI 模型下载）

安装前准备：确认你的电脑满足系统要求

小遥搜索整合包仅支持Windows 10 / Windows 11（64位），安装前建议对照下表确认配置：

💡为什么推荐整合包？整合包已预置 Python 嵌入式运行时、Node.js、FFmpeg 等全部运行时环境，解压即用，彻底告别"环境配半天"的烦恼。完整说明可参考官方 整合包部署指南。

第1步：解压小遥搜索整合包

1. 从项目发布渠道下载最新的XiaoyaoSearch-Windows-vX.X.X.zip（约 800MB）
2. 解压到非系统盘的目录，例如D:\MyApps\XiaoyaoSearch\
3. 目录路径不要包含中文或特殊字符（避免脚本解析异常）

解压后的目录结构如下，runtime/里就是预置好的全套运行时环境：

XiaoyaoSearch-Windows/ ├── runtime/ # 预置运行时：Python / Node.js / FFmpeg / Ollama 安装包 ├── backend/ # 后端源码（FastAPI） ├── frontend/ # 前端源码（Electron + Vue 3） ├── scripts/ # 自动化脚本（setup.bat / startup.bat） ├── data/ # 数据目录：数据库、索引、模型、日志 └── README.txt # 说明文件

⚠️ 注意：解压路径建议放在 D 盘等非系统盘，且data/目录会随使用逐渐增大（索引 + 模型），请预留足够空间。

第2步：运行 setup.bat 准备环境（仅首次）

双击运行 scripts/setup.bat，脚本会自动完成以下工作，全程无需手动操作（首次约 2~3 分钟，含国内镜像加速下载）：

执行到 scripts/setup.bat#L214-L228 时，脚本会询问是否启用 CUDA GPU 加速：

• 有 NVIDIA 显卡（RTX 3060 及以上，6GB+ 显存）且已安装 CUDA 12.1 → 输入Y
• 没有独显或未装 CUDA → 直接输入N（CPU 模式完全可用）
• 使用RTX 50 系显卡的用户，请改运行 scripts/setup_rtx50显卡.bat，该脚本会安装支持 CUDA 12.8 的 PyTorch 版本

看到如下提示即表示环境准备完成：

======================================== 环境准备完成! ======================================== 下一步: 运行 startup.bat 启动应用程序

第3步：运行 startup.bat 一键启动应用

双击 scripts/startup.bat，脚本会自动按顺序完成：

1. 配置环境变量
2. 启动后端服务（监听http://127.0.0.1:8000）
3. 自动检测后端就绪（健康检查，最多等待 30 秒）
4. 启动前端服务（http://127.0.0.1:5173）
5. 自动打开浏览器进入小遥搜索界面

启动后会看到"小遥搜索-后端"和"小遥搜索-前端"两个命令行窗口，使用完毕直接关闭这两个窗口即可停止，无需额外停止脚本。

首次启动补充：安装 Ollama 与下载 AI 模型

小遥搜索的 AI 能力依赖本地模型，首次使用需额外完成两项准备（详细指引见 整合包部署指南 的「模型下载」章节）：

① 安装 Ollama（大语言模型运行环境）

1. 双击runtime\ollama\OllamaSetup.exe，按提示完成安装
2. 打开新终端，运行以下命令启动服务并拉取默认模型：

ollama serve ollama pull qwen2.5:1.5b

② 下载 AI 模型文件

从项目发布的百度网盘下载全部默认模型（setup.bat运行时也会提示下载链接），然后按目录结构解压：

模型就绪后，进入「设置 → 模型配置」界面，点击测试连接确认四个模型均为已加载状态，即可开始完整体验语义搜索。

安装完成后的体验路线

1. 添加搜索目录：在索引管理页选择要纳入搜索的本地文件夹，构建 Faiss 向量索引 + Whoosh 全文索引
2. 文本搜索：像聊天一样输入自然语言，例如"上次开会的季度总结 PPT"
3. 语音搜索：点击麦克风直接说出问题，FasterWhisper 自动转文字
4. 以图搜图：上传图片，用 CN-CLIP 找到本地视觉相似的图片

常见问题速查（FAQ）

Q1：setup.bat 执行失败怎么办？确认runtime/目录完整（含 python、nodejs、ffmpeg、ollama 四个子目录），并检查网络能否访问阿里云 PyPI 镜像。自动安装失败时，可参考 整合包部署指南 中「常见问题 Q1」手动执行依赖安装命令。

Q2：提示 8000 或 5173 端口被占用？打开命令提示符执行netstat -ano | findstr :8000找到占用进程 ID，用taskkill /PID <进程ID> /F结束进程；或直接编辑backend/.env修改API_PORT端口号。

Q3：杀毒软件拦截脚本运行？将小遥搜索目录加入杀毒软件白名单即可，推荐直接使用误报率较低的 Windows Defender。

Q4：模型加载失败 / Ollama 连接失败？依次检查：模型文件是否放在了正确目录 → Ollama 服务是否已运行（ollama serve）→ 后端日志data/logs/backend.log中的具体报错。内存不足时可切换更小的模型版本（如 bge-small-zh、faster-whisper-small）。

Q5：如何卸载小遥搜索？关闭前后端窗口 → 删除整合包目录即可。如需保留索引和配置，先把data/目录备份到其他位置，重装后复制回去即可恢复。

总结：3步完成小遥搜索部署

配合 Ollama 安装与 AI 模型下载（约 3GB），你拥有一套数据不出本机、完全免费的本地 AI 搜索引擎。遇到更多细节问题，欢迎查阅官方 整合包部署指南 获取完整排障手册。祝使用愉快！🎉