xiaoyaosearch
starsforks
How to install xiaoyaosearch?
dtsola/xiaoyaosearch
$git clone https://github.com/dtsola/xiaoyaosearchEnglish Version | 简体中文
README.md
| 1 | # 小遥搜索 XiaoyaoSearch |
| 2 | |
| 3 | [English Version](README_EN.md) | 简体中文 |
| 4 | |
| 5 |  |
| 6 | |
| 7 | ## 📖 项目简介 |
| 8 | |
| 9 |  |
| 10 | |
| 11 | 小遥搜索是一款专为知识工作者、内容创作者和技术开发者设计的跨平台本地桌面应用（Windows/MacOS/Linux）。通过集成的AI模型，支持语音输入（30秒内）、文本输入、图片输入等多种方式，将用户的查询转换为语义进行智能搜索，实现对本地文件的深度检索。 |
| 12 | |
| 13 | ## ⭐️ 重要说明 |
| 14 | - 本项目非商业使用完全免费，允许修改和分发（需保留版权声明和协议）；商业目的需授权，详细见[小遥搜索软件授权协议](LICENSE) |
| 15 | - 本项目完全通过Vibe Coding实现，提供所有源码及开发文档（上下文）供大家交流学习 |
| 16 |  |
| 17 | |
| 18 | ## 作者介绍 |
| 19 | |
| 20 | <p align="center"> |
| 21 | <img src="docs/产品文档/产品截图/author-avatar.jpg" alt="dtsola" width="120" height="120" style="border-radius: 50%;"> |
| 22 | </p> |
| 23 | |
| 24 | <p align="center"> |
| 25 | <b>dtsola</b> — IT架构师 | 一人公司实践者 |
| 26 | </p> |
| 27 | |
| 28 | <p align="center"> |
| 29 | 🌐 <a href="https://www.dtsola.com">个人站点</a> | |
| 30 | 📺 <a href="https://space.bilibili.com/736015">B站</a> | |
| 31 | 💬 微信：dtsola（技术交流 | 商务合作） |
| 32 | </p> |
| 33 | |
| 34 | <p align="center"> |
| 35 | <img src="docs/产品文档/产品截图/个人二维码.png" alt="微信二维码" width="120"> |
| 36 | |
| 37 | <img src="docs/运营文档/开发者交流群图.png" alt="开发者交流群" width="120"> |
| 38 | |
| 39 | <img src="docs/运营文档/用户交流群图.png" alt="用户交流群" width="120"> |
| 40 | </p> |
| 41 | |
| 42 | <p align="center"> |
| 43 | <small>微信联系 开发者交流群 用户交流群</small> |
| 44 | </p> |
| 45 | |
| 46 | ### ✨ 核心特性 |
| 47 | |
| 48 | - **🎤 多模态输入**：支持语音录音、文本输入、图片上传 |
| 49 | - **🔍 深度检索**：支持视频（mp4、avi）、音频（mp3、wav）、文档（txt、markdown、office、pdf）的内容和文件名搜索 |
| 50 | - **🧠 AI增强**：集成BGE-M3、FasterWhisper、CN-CLIP、OLLAMA等先进AI模型 |
| 51 | - **☁️ 云端大模型**：支持OpenAI/DeepSeek/阿里云等兼容API，与本地模型自由切换（v1.3.0） |
| 52 | - **☁️ 云端嵌入模型**：支持OpenAI/DeepSeek/阿里云等嵌入API，提升搜索质量（v1.6.0） |
| 53 | - **📚 专业术语库**：支持术语扩展和同义词匹配，专业领域搜索召回率提升60%（v1.9.0） |
| 54 | - **⚡ 高性能**：基于Faiss向量搜索和Whoosh全文搜索的混合检索架构 |
| 55 | - **🔒 隐私可控**：本地运行默认数据不上传，支持云端API选项，性能与隐私权衡由您选择 |
| 56 | - **🎨 Notion温暖明亮设计**：采用 Notion 温暖明亮设计风格，建立完整设计系统规范，视觉舒适度提升67%（v2.0.0） |
| 57 | - **系统字体栈**：零网络依赖，最优性能，字体加载 < 10ms |
| 58 | - **Lucide Icons**：1000+ 图标，统一视觉语言 |
| 59 | - **精致多层阴影**：4-5层阴影堆叠，增强视觉层次感 |
| 60 | - **🤖 AI生态集成**： |
| 61 | - **MCP 服务器支持**：支持 Model Context Protocol，可被 Claude Desktop 连接进行本地文件智能搜索（v1.4.0） |
| 62 | - **Agent Skills 支持**：为 Claude Code、VS Code、Cursor 等 AI 助手提供标准化工具调用能力（v1.5.0） |
| 63 | |
| 64 | ## 📖 核心界面 |
| 65 | |
| 66 | ### 搜索界面 |
| 67 | |
| 68 | #### 主界面 |
| 69 |  |
| 70 | |
| 71 | #### 通过文本搜索 |
| 72 |  |
| 73 | |
| 74 | #### 通过语音搜索 |
| 75 |  |
| 76 | |
| 77 | #### 通过图片搜索 |
| 78 |  |
| 79 | |
| 80 | ### 索引管理界面 |
| 81 |  |
| 82 | |
| 83 | ### 设置界面 |
| 84 |  |
| 85 | |
| 86 | ### 术语库管理界面（v2.0.0） |
| 87 |  |
| 88 | |
| 89 | ## 🏗️ 技术架构 |
| 90 | |
| 91 | ### 系统架构图 |
| 92 | |
| 93 |  |
| 94 | |
| 95 | ### 技术栈 |
| 96 | |
| 97 | **前端技术** |
| 98 | - **框架**: Electron + Vue 3 + TypeScript |
| 99 | - **UI库**: Ant Design Vue |
| 100 | - **状态管理**: Pinia |
| 101 | - **构建工具**: Vite |
| 102 | |
| 103 | **后端技术** |
| 104 | - **框架**: Python 3.10 + FastAPI + Uvicorn |
| 105 | - **AI模型**: BGE-M3 + FasterWhisper + CN-CLIP + Ollama |
| 106 | - **搜索引擎**: Faiss (向量搜索) + Whoosh (全文搜索) |
| 107 | - **数据库**: SQLite + 索引文件 |
| 108 | |
| 109 | ### 项目结构 |
| 110 | |
| 111 | ``` |
| 112 | xiaoyaosearch/ |
| 113 | ├── backend/ # 后端服务 (Python FastAPI) |
| 114 | │ ├── app/ # 应用核心代码 |
| 115 | │ │ ├── api/ # API路由层 |
| 116 | │ │ ├── core/ # 核心配置 |
| 117 | │ │ ├── models/ # 数据模型 |
| 118 | │ │ ├── services/ # 业务服务 |
| 119 | │ │ ├── schemas/ # 数据模式 |
| 120 | │ │ └── utils/ # 工具函数 |
| 121 | │ ├── requirements.txt # Python依赖 |
| 122 | │ ├── main.py # 应用入口 |
| 123 | │ └── .env # 环境变量 |
| 124 | ├── frontend/ # 前端应用 (Electron + Vue3) |
| 125 | │ ├── src/ # 源代码 |
| 126 | │ │ ├── main/ # Electron主进程 |
| 127 | │ │ ├── preload/ # 预加载脚本 |
| 128 | │ │ └── renderer/ # Vue渲染进程 |
| 129 | │ ├── out/ # 构建输出 |
| 130 | │ ├── dist-electron/ # 打包输出 |
| 131 | │ ├── resources/ # 应用资源 |
| 132 | │ ├── package.json # Node.js依赖 |
| 133 | │ └── electron-builder.yml # 打包配置 |
| 134 | ├── docs/ # 项目文档 |
| 135 | │ ├── 00-mrd.md # 市场调研 |
| 136 | │ ├── 01-prd.md # 产品需求 |
| 137 | │ ├── 02-原型.md # 产品原型 |
| 138 | │ ├── 03-技术方案.md # 技术方案 |
| 139 | │ ├── 04-开发任务清单.md |
People who liked this also viewed
6 picksType
- ddgsA metasearch library that aggregates results from diverse web search servicesMCP ServersMay 2026
- firecrawl-mcp-server🔥 Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients.MCP ServersJul 2026
- fliGoogle Flights MCP, CLI and Python LibraryMCP ServersJul 2026
- sembleFast and Accurate Code Search for Agents. Uses ~98% fewer tokens than grep+readMCP ServersJul 2026
- duckduckgo-mcp-serverA Model Context Protocol (MCP) server that provides web search capabilities through DuckDuckGo, with additional features for content fetching and parsing.MCP ServersJul 2026
- wikipedia-mcpA Model Context Protocol (MCP) server that retrieves information from Wikipedia to provide context to LLMs.MCP ServersMay 2026
