xiaoyaosearch 是什么?

小遥搜索(XiaoyaoSearch)是作者 dtsola(一人公司实践者)做的跨平台本地桌面应用(Windows/macOS/Linux),用 AI 做本地文件的语义检索:支持语音(30 秒内)、文本、图片多模态输入,把查询转成语义去深度检索本机的视频、音频、文档、PDF 等的内容与文件名,让搜索像聊天一样。它默认本地运行、数据不上传,也可切云端 API,隐私与性能由你权衡。Electron+Vue3 前端 + Python/FastAPI 后端。许可证为自定义协议(非商业免费、可改可分发需保留版权,商用需授权)。它强调全程用 Vibe Coding 实现并开放全部源码与开发文档供学习。

⭐ 1,018 Stars 🍴 88 Forks Python NOASSERTION 作者: dtsola
来源:README 项目简介/核心特性/重要说明;GitHub desc,license NOASSERTION 查看 GitHub 仓库 →

为什么值得关注

约 900 星(体量不大但上了趋势),热度来自一个普遍痛点:本机文件多到找不到、关键词搜又搜不准,而小遥用 AI 做语义 + 多模态(语音/图片)本地检索、默认不上传、还能接 MCP 让 Claude Desktop 搜本地文件。中文一人公司作者、全程 Vibe Coding 开源、并支持国产模型(DeepSeek/阿里)与本地 Ollama,对中文知识工作者和开发者有吸引力。

来源:GitHub 905 stars / 61 forks,created 2025-11-11;README 核心特性

核心功能

多模态输入的语义本地搜索

支持语音录音、文本、图片上传三种输入,把查询转成语义检索本机文件;可搜视频(mp4/avi)、音频(mp3/wav)、文档(txt/markdown/office/pdf) 的内容与文件名。

来源:README 核心特性(多模态输入/深度检索)
本地 + 云端 AI 模型可切换

集成 BGE-M3、FasterWhisper、CN-CLIP、Ollama 等本地模型;也支持 OpenAI/DeepSeek/阿里云等兼容的云端大模型(v1.3)与嵌入模型(v1.6),本地与云端自由切换。

来源:README 核心特性(AI 增强/云端模型)
混合检索 + 专业术语库

基于 Faiss 向量搜索 + Whoosh 全文搜索的混合检索架构;专业术语库支持术语扩展与同义词匹配,作者称专业领域召回率提升 60%(v1.9)。

来源:README 核心特性(高性能/专业术语库)/技术栈
隐私可控(本地优先)

本地运行默认数据不上传,云端 API 为可选项,性能与隐私的权衡交给用户,适合敏感本地资料检索。

来源:README 核心特性(隐私可控)
AI 生态集成(MCP + Agent Skills)

v1.4 起支持 MCP 服务器,可被 Claude Desktop 连接来对本地文件做智能搜索;v1.5 起提供 Agent Skills,为 Claude Code、VS Code、Cursor 等提供标准化工具调用。

来源:README 核心特性(AI 生态集成)

技术架构

Electron 桌面壳 + 前后端分离。前端 frontend/ 用 Electron + Vue 3 + TypeScript + Ant Design Vue + Pinia + Vite(v2.0 起做了 Notion 风格设计系统、系统字体栈、Lucide 图标)。后端 backend/ 用 Python 3.10 + FastAPI + Uvicorn,承载索引与检索:AI 模型层(BGE-M3 嵌入、FasterWhisper 语音转写、CN-CLIP 图文、Ollama/云端 LLM),检索层 Faiss(向量)+ Whoosh(全文)混合,数据落 SQLite + 索引文件;backend/data/plugins 下有飞书/钉钉等数据源插件。它把『多模态输入→转语义→混合检索本地文件→AI 增强结果』串起来,并对外提供 MCP server 与 Agent Skills 让外部 AI 助手调用本地搜索。CUDA 可选(按显卡选 12.1/12.8)。整体是『Electron/Vue 前端 + FastAPI/AI 模型后端 + Faiss/Whoosh 混合检索 + MCP/Skills 接入』的本地 AI 搜索桌面应用。

来源:README 技术架构/技术栈/快速开始;tree(frontend/、backend/、backend/data/plugins)

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) BGE-M3(嵌入) FasterWhisper(语音)FasterWhisper… CN-CLIP(图文) Ollama / 云端 LLMOllama / 云端… Faiss(向量)+ Whoosh(全文)Faiss(向量)+… 多模态输入的语义本地搜索多模态输入的语义本地搜… 本地 + 云端 AI 模型可切换本地 + 云端 AI 模型可… 混合检索 + 专业术语库 隐私可控(本地优先) AI 生态集成(MCP + Agent Skills)AI 生态集成(MCP + A… xiaoyaosearch 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言TypeScript(前端)+ Python(后端)框架Electron + Vue 3(前端)+ FastAPI(后端)
BGE-M3(嵌入)FasterWhisper(语音)CN-CLIP(图文)Ollama / 云端 LLMFaiss(向量)+ Whoosh(全文)SQLiteAnt Design Vue + Pinia + Vite
跨平台桌面(Win/Mac/Linux),本地优先、可选云端 API;CPU 默认、CUDA 可选;提供 MCP server
来源:README 技术栈/快速开始;requirements

快速上手

普通用户用整合包部署(推荐)。开发者:后端进 backend/ 装依赖(默认 CPU 推理,可选装 CUDA——RTX40 及更早用 CUDA 12.1、RTX50 用 12.8),配数据/API/日志,用内置配置或 uvicorn 启动;前端进 frontend/ 装依赖、`npm run dev` 起开发服务器。配好后建索引、用语音/文本/图片搜本地文件;可切本地或云端模型。要让 Claude Desktop 等搜本地文件,启用其 MCP server;Claude Code/Cursor 用其 Agent Skills。
来源:README 快速开始(整合包/开发者部署)

使用场景

适合:①本机文件多、想用语义而非关键词找文档/音视频/PDF 的知识工作者、内容创作者、开发者;②注重隐私、希望本地检索默认不上传、又能按需切云端的人;③想用语音/图片等多模态方式搜本地资料的人;④想让 Claude Desktop/Cursor 等 AI 助手经 MCP 搜自己本地文件的人。不适合:需要团队级/服务器端大规模文件检索的场景;商业用途未获授权者(许可证为非商业免费、商用需授权);以及不愿装桌面应用与本地模型的轻量用户。

来源:README 项目简介/重要说明,结合定位推断

优势与局限

优势

  • 切口实用:本地文件 AI 语义 + 多模态(语音/图片)检索,解决关键词搜不准的真痛点
  • 隐私友好:本地优先、默认不上传,又保留云端 API 选项,权衡交给用户
  • 检索做得专业:Faiss 向量 + Whoosh 全文混合 + 专业术语库,召回有提升
  • AI 生态接得好:MCP server 可被 Claude Desktop 搜本地文件、并提供 Agent Skills
  • 开放学习友好:全程 Vibe Coding、开放源码与开发文档,跨平台、模型可本地可云

局限

  • 许可证为自定义协议:非商业免费、商用需向作者授权,企业使用前需确认
  • 本地模型推理对机器有要求(音视频转写/嵌入吃资源,大文件索引慢,CUDA 可选但需对版本)
  • 检索质量取决于所选模型与索引设置,多模态/跨格式效果需实测
  • 由单一作者主导、体量较小(900 星/61 fork),长期维护与生态待观察
  • 带较强的个人/微信群/商业引流,开源工具与商务合作需分清
来源:README 重要说明/快速开始/作者介绍;本地检索的固有成本

最新版本

仓库以版本化迭代维护(README 标注 v1.3 云端 LLM、v1.4 MCP、v1.5 Agent Skills、v1.6 云端嵌入、v1.9 术语库、v2.0 Notion 设计系统等),无传统 GitHub Release 展示但功能按版本推进;最近 push 2026-05-22(创建于 2025-11-11),更新活跃。

来源:GitHub pushed_at 2026-05-22;README 核心特性(版本标注)/版本升级指南

总结评价

小遥搜索把『本地文件找不到、关键词搜不准』这个日常痛点用 AI 做扎实了:语义 + 多模态(语音/图片)检索本机文档音视频、Faiss+Whoosh 混合 + 专业术语库提升召回、本地优先默认不上传又能切云端,还接了 MCP 让 Claude Desktop 直接搜你的本地文件,作为中文一人公司全程 Vibe Coding 的开源桌面应用,完成度不错。要注意的是它的许可证是非商业免费、商用需授权,本地模型对机器有要求、检索质量需实测,且由单一作者主导、带较强商业引流。对想在本机用 AI 语义搜文件、注重隐私的中文用户,它是个值得一试的桌面工具;商用或团队场景则需先谈授权并评估规模。

来源:综合 README 定位/特性/许可证、tech 架构、维护与商业属性的事实判断
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-23 00:30. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件