前言 经过几个月的精心打磨， 小遥搜索 XiaoyaoSearch v2.0.0 今天正式发布了！ 这是一个重大版本更新，带来了全新的 Notion 温暖明亮设计风格 ，完整的 设计系统规范 ，以及全面的 UI 视觉升级 。 相比 v1.x 版本，v2.0.0 不仅保留了强大的多模态 AI 搜索能力，更在视觉体验上实现了 质的飞跃 。 v2.0.0 有什么不同？ 🎨 全新设计系统 Notion 温暖明亮设计风格 借鉴 Notion 的设计理念，打造专业、舒适、高效的视觉体验： 纯白背景 #ffffff + 温暖白 #f6f5f4：营造干净舒适的视觉环境 品牌蓝色 #0075de：统一品牌色调，提升识别度 超细边框 rgba(0,0,0,0.1)：柔和过渡，精致细节 多层阴影堆叠 ：4-5 层阴影，增强视觉层次感 视觉体验提升数据 ： 指标 v1.x v2.0 提升 视觉舒适度 60% 100% +67% 品牌识别度 50% 100% +100% 信息可读性 60% 100% +67% 专业度感知 60% 100% +67% 🔤 系统字体栈（零网络依赖） 告别 Google Fonts ，拥抱系统字体 v1.x 版本使用 Google Fonts CDN 加载字体，存在网络依赖和性能问题。v2.0.0 采用精心挑选的系统字体栈： font-family: -apple-system, /* Apple 系统字体 */ BlinkMacSystemFont, /* macOS Chrome */ "SF Pro Text", /* macOS 专业字体 */ "Segoe UI", /* Windows 系统字体 */ "PingFang SC", /* Apple 中文字体 */ "Microsoft YaHei", /* Windows 中文字体 */ sans-serif; /* 后备字体 */ 性能对比 ： 指标 v1.x （ Google Fonts ） v2.0 （系统字体） 提升 字体加载时间 200-500ms <10ms +98% 首屏渲染时间 2.0-2.5s <2.0s +20% 网络请求数 +2 个 0 个 +100% 离线可用性 否 是 ✅ 🎯 Lucide Icons 图标系统 1000+ 图标，统一视觉语言 采用 Lucide Icons 作为标准图标库，通过 @ iconify /vue 集成： 图标数量 ：1000+ 图标，持续更新 设计风格 ：现代简洁，线条优雅 可定制性 ：支持颜色、大小、粗细调整 按需加载 ：自动按需加载，无性能损耗 📐 完整设计系统规范 CSS Variables + Design Tokens 建立完整的设计令牌系统，确保设计一致性： /* 颜色系统 */ --bg-primary: #ffffff; /* 主背景 */ --bg-secondary: #f6f5f4; /* 次级背景 */ --text-primary: rgba(0,0,0,0.95); /* 主文字 */ --text-secondary: #615d59; /* 次要文字 */ --brand-blue: #0075de; /* 品牌蓝色 */ --border-standard: rgba(0,0,0,0.1); /* 标准边框 */ /* 间距系统（ 8px 基准） */ --space-xs: 4px; --space-sm: 8px; --space-md: 12px; --space-lg: 16px; --space-xl: 20px; --space-2xl: 24px; --space-3xl: 32px; /* 圆角系统 */ --radius-sm: 4px; --radius-md: 6px; --radius-lg: 10px; --radius-xl: 12px; /* 阴影系统 */ --shadow-card: 0 1px 2px rgba(0,0,0,0.04), 0 2px 4px rgba(0,0,0,0.04), 0 4px 8px rgba(0,0,0,0.04), 0 8px 16px rgba(0,0,0,0.04); --shadow-elevated: 0 2px 4px rgba(0,0,0,0.05), 0 4px 8px rgba(0,0,0,0.05), 0 8px 16px rgba(0,0,0,0.05), 0 16px 32px rgba(0,0,0,0.05); ✨ 所有页面 UI 升级 10 个页面/组件全面升级 ： 页面/组件 主要升级 顶部导航栏 Logo 、导航菜单、右侧操作区全新设计 底部状态栏 索引统计、搜索统计、数据统计信息展示 搜索首页 搜索区域、多模态指示器、结果列表精致卡片 搜索结果卡片 卡片样式、图标、标签、操作按钮 设置页面 标签页、表单、开关全新设计 索引管理页面 统计卡片、索引列表、模态框样式升级 术语库管理页面 列表、创建/编辑模态框、表单优化 术语管理页面 列表、CSV 导入、表单样式全面升级 帮助页面 FAQ 、折叠面板、搜索功能升级 关于作者页面 作者信息、联系方式、二维码展示优化 小遥搜索是什么？ 简单来说，它是一个 本地 AI 搜索桌面应用 ，核心特点： 🎤 多模态输入 语音搜索 ：点一下录音，说出你要找的内容，30 秒内语音自动转文字搜索 文本搜索 ：输入关键词，AI 理解语义，精准匹配文件内容 图片搜索 ：上传一张图片，AI 理解图像内容，帮你搜索相关文件 🔍 深度检索 文档 ：TXT 、Markdown 、Word 、Excel 、PPT 、PDF 全文检索 音视频 ：MP4 、AVI 、MP3 、WAV 内容索引和搜索 文件名 ：传统的文件名搜索也不缺席 🧠 AI 技术 集成了多个先进 AI 模型： BGE-M3 ：文本嵌入，理解语义 FasterWhisper ：语音识别，语音转文字 CN-CLIP ：图像理解，以图搜图 Ollama ：本地大语言模型 OpenAI/DeepSeek/阿里云 ：云端大模型（可选） 🎨 v2.0.0 全新 UI Notion 温暖明亮设计风格 ：专业、舒适、高效 系统字体栈 ：零网络依赖，加载速度 < 10ms Lucide Icons ：1000+ 图标，统一视觉语言 完整设计系统 ：确保设计一致性 🔒 隐私安全 完全本地 ：所有数据处理都在本地，不上传云端 隐私模式 ：可选不记录搜索历史 自主可控 ：数据完全由你自己掌控 核心界面一览 搜索主界面（ v2.0.0 全新设计） 设计亮点 ： 居中布局，视觉焦点集中 多模态指示器，清晰展示输入模式 搜索框圆角设计，蓝色光晕效果 结果卡片精致阴影，悬停加深 文本搜索 功能特点 ： 实时搜索结果展示 匹配度高亮显示 支持语义理解和关键词匹配 一键打开文件或定位文件夹 语音搜索 功能特点 ： 30 秒内语音录制 自动语音转文字 支持中英文混合输入 智能语义理解 图片搜索 功能特点 ： 上传图片即可搜索 AI 理解图像内容 支持相似图片匹配 以图搜图，精准定位 索引管理界面（ v2.0.0 全新设计） 设计亮点 ： 统计卡片，悬停提升效果 索引列表，精致阴影堆叠 操作菜单，流畅动画过渡 功能特点 ： 实时索引状态监控 文件夹路径管理 一键重建索引 索引进度可视化 设置界面（ v2.0.0 全新设计） 设计亮点 ： 标签页，次级背景，激活状态清晰 表单布局，标签左对齐，必填标记红色 开关控件，品牌蓝色，平滑过渡 功能特点 ： AI 模型配置 数据源管理 搜索偏好设置 界面主题选择 术语库管理界面（ v2.0.0 新增） 功能亮点 ： 多术语库集合管理 术语同义词扩展 CSV 导入/导出 预置专业术语库（ IT 、产品、医疗、法律） 使用场景 ： 产品经理：PRD 、产品需求文档、产品规格书 医生：CT 、计算机断层扫描、CT 扫描 开发者：API 、应用程序接口、接口文档 法律从业者：合同、协议、契约 技术架构 v2.0.0 技术亮点 新增技术栈 ： @iconify/vue ：图标按需加载系统 CSS Variables ：完整设计令牌系统 Design Tokens ：TypeScript 类型定义 系统字体栈 ：零网络依赖字体方案 性能优化 ： 字体加载时间 < 10ms （ vs 200-500ms ） 首屏渲染时间 < 2.0s （ vs 2.0-2.5s ） 网络请求数 -2 个（移除 Google Fonts ） 离线可用性 ✅ 版本对比：v1.x vs v2.0.0 设计对比 方面 v1.x v2.0.0 设计风格 Ant Design 默认风格 Notion 温暖明亮风格 字体方案 Google Fonts （网络依赖） 系统字体栈（零依赖） 图标系统 Ant Design Icons （ 300+） Lucide Icons （ 1000+） 阴影效果 简单阴影 4-5 层堆叠阴影 边框样式 标准边框 超细边框（ whisper ） 圆角系统 混合使用 统一规范（ 4/6/10/12px ） 动画效果 基础过渡 精致动画（ fadeInUp 、hover ） 响应式设计 部分支持 完整支持（桌面/平板/移动） 功能对比 功能 v1.x v2.0.0 多模态搜索 ✅ ✅ 本地文件检索 ✅ ✅ AI 模型配置 ✅ ✅ 插件化架构 ✅ ✅ 数据源扩展 ✅ 语雀、飞书、钉钉 ✅ + 语雀、飞书、钉钉 术语库系统 ✅ ✅ + UI 升级 MCP 服务器 ✅ ✅ Agent Skills ✅ ✅ UI 视觉系统 基础 全面升级 快速体验 环境要求 操作系统 ：Windows / MacOS / Linux Python ：3.10.11+ Node.js ：21.x+ 内存 ：建议 16GB 以上（ 8GB 可用） 显卡 ：建议 RTX3060 6GB 以上（可选） 安装步骤 方式一：整合包部署（推荐） 下载整合包 ： 从百度网盘下载最新的 Windows 整合包： 链接： https://pan.baidu.com/s/1lDaWjMCRXIT-Sqx9UFjerg?pwd=37ed 提取码：37ed 安装步骤 ： 解压整合包到任意目录 运行 scripts/setup.bat 自动安装依赖 安装并启动 Ollama 下载 AI 模型 运行 scripts/startup.bat 启动应用 方式二：开发者部署 1. 克隆项目 git clone https://github.com/dtsola/xiaoyaosearch.git cd xiaoyaosearch 2. 后端启动 cd backend pip install -r requirements.txt python main.py 3. 前端启动 cd frontend npm install npm run dev 详细安装指南： https://github.com/dtsola/xiaoyaosearch/blob/main/README.md 产品路线图 当前版本（ v2.0.0 ）✅ 核心功能 ： ✅ 多模态 AI 搜索（语音、文本、图片） ✅ 本地文件深度检索 ✅ AI 模型灵活配置（本地/云端） ✅ Notion 温暖明亮设计风格 ✅ 系统字体栈（零网络依赖） ✅ Lucide Icons 图标系统（ 1000+） ✅ 完整设计系统规范 ✅ 插件化架构（语雀、飞书、钉钉） ✅ 专业术语库系统 ✅ MCP 服务器支持 ✅ Agent Skills 支持 UI 升级亮点 ： ✅ 所有页面/组件 UI 全面升级 ✅ 视觉舒适度提升 67% ✅ 品牌识别度提升 100% ✅ 信息可读性提升 67% ✅ 专业度感知提升 67% 未来规划 🎨 UI/UX 持续优化 暗色模式支持（用户呼声最高的功能） 自定义主题配色 更多动画效果和过渡 🚀 性能优化 大文件处理优化 索引构建速度提升 内存占用优化 🔌 更多数据源支持 Notion 知识库 GitHub 代码仓库 GitLab 代码仓库 Confluence Wiki 🧠 AI 能力增强 自适应分块算法 知识图谱构建 RAG 系统升级 💬 智能聊天助手 多轮对话和上下文记忆 基于本地知识库的问答 自然语言交互 详细路线图： https://github.com/dtsola/xiaoyaosearch/blob/main/ROADMAP.md 适合谁使用？ 知识工作者 搜索本地文档、笔记、研究报告，快速定位关键信息 使用场景 ： 搜索产品需求文档（ PRD ） 查找技术方案和架构文档 检索会议记录和决策文档 整理项目资料和学习笔记 内容创作者 搜索素材和灵感，整理音视频内容，管理创作资源 使用场景 ： 搜索视频脚本和分镜 查找音频素材和音效 整理设计素材和灵感 管理项目资源和交付物 技术开发者 搜索代码库和技术文档，整理学习资料，管理项目文件 使用场景 ： 搜索代码片段和技术实现 查找 API 文档和使用示例 整理学习资料和教程 管理项目文件和依赖 研究人员 搜索论文和研究资料，整理文献笔记，管理研究数据 使用场景 ： 搜索论文和参考文献 查找实验数据和结果 整理文献笔记和观点 管理研究项目资料 为什么选择小遥搜索？ 🎯 专为知识工作者设计 多模态输入 ：语音、文本、图片，用最自然的方式搜索 语义理解 ：AI 理解你的意图，不只是关键词匹配 深度检索 ：搜索文件内容，不只是文件名 🔒 隐私安全优先 100% 本地 ：所有数据处理都在本地，不上传云端 隐私模式 ：可选不记录搜索历史 自主可控 ：数据完全由你自己掌控 🧠 AI 技术领先 多模型集成 ：BGE-M3 + FasterWhisper + CN-CLIP + Ollama 云端可选 ：支持 OpenAI/DeepSeek/阿里云等云端模型 持续升级 ：AI 模型和技术持续更新 🎨 v2.0.0 视觉体验 温暖明亮 ：Notion 设计风格，专业舒适 精致细节 ：多层阴影、超细边框、流畅动画 品牌识别 ：统一的视觉语言，提升专业度 高性能 ：零网络依赖，加载速度极快 🤖 开发者友好 100% 开源 ：所有源码、文档、开发经验全部开源 插件化架构 ：支持自定义扩展和数据源 MCP 支持 ：可被 Claude Desktop 等 AI 应用连接 Vibe Coding 案例 ：完整的 AI 辅助开发实践 Vibe Coding 实践案例 100% AI 辅助开发 这个项目从零开始， 完全通过 Vibe Coding 实现 ，包括： ✅ 完整源代码（前端 + 后端 + 所有功能模块） ✅ 设计文档（ PRD 、技术方案、数据库设计、API 文档） ✅ 开发流程（任务分解、进度跟踪、测试验证） ✅ 部署配置（环境搭建、依赖管理、打包发布） ✅ v2.0.0 UI 视觉系统全面升级 开源的价值 对于想要学习以下内容的开发者，这是一个完整的参考实现： AI 辅助开发实践 ：如何用 AI 实现完整项目 Electron 桌面应用 ：从零构建桌面应用 Vue 3 前端开发 ：Composition API + TypeScript Python FastAPI 后端 ：异步架构 + AI 模型集成 设计系统构建 ：从零建立完整设计规范 插件化架构 ：可扩展的插件系统设计 MCP 协议实现 ：AI 应用集成最佳实践 项目亮点总结 技术亮点 多模态 AI 搜索 ：语音、文本、图片三种输入方式 深度文件检索 ：支持文档、音视频的内容和文件名搜索 AI 模型集成 ：BGE-M3 、FasterWhisper 、CN-CLIP 、Ollama 插件化架构 ：支持语雀、飞书、钉钉等数据源 MCP 协议支持 ：可被 Claude Desktop 等 AI 应用连接 v2.0.0 UI 视觉升级 ：Notion 设计风格 + 完整设计系统 设计亮点（ v2.0.0 ） Notion 温暖明亮风格 ：专业、舒适、高效 系统字体栈 ：零网络依赖，最优性能 Lucide Icons ：1000+ 图标，统一视觉语言 多层阴影堆叠 ：4-5 层精致阴影 完整设计系统 ：确保设计一致性 响应式设计 ：完美适配各种设备 开源亮点 100% AI 辅助开发 ：完整的 Vibe Coding 实践案例 完整技术栈 ：前端 + 后端 + AI 模型 详尽文档 ：PRD 、技术方案、API 文档、数据库设计 插件化架构 ：可扩展的插件系统设计 持续更新 ：活跃开发，功能持续增强 邀请你参与 为什么需要你？ 一个人的力量有限，开源社区的力量是无限的！ 优先贡献方向 🎨 UI/UX 优化（高优先级） 暗黑模式支持 （用户呼声最高） 设计暗黑主题配色方案 实现主题切换功能 优化暗黑模式下的视觉体验 自定义主题配色 允许用户自定义品牌色 提供多种预设配色方案 支持导入导出主题配置 更多动画效果 页面切换动画 加载动画优化 微交互动画效果 🔌 更多数据源支持（高优先级） Notion 知识库 Notion API 集成 元数据解析 原文链接跳转 GitHub/GitLab 代码仓库搜索 Wiki 文档索引 Issue 和 PR 检索 ⚡ 性能优化（中优先级） 大文件处理优化 分块索引策略 流式读取优化 内存占用控制 索引构建速度提升 并行索引构建 增量索引更新 智能缓存机制 🧪 测试覆盖（中优先级） 单元测试补充 核心模块测试覆盖 边界条件测试 错误处理测试 集成测试完善 端到端测试场景 跨平台兼容性测试 性能基准测试 如何贡献？ # 1. Fork 项目 git clone https://github.com/dtsola/xiaoyaosearch.git cd xiaoyaosearch # 2. 创建分支 git checkout -b feature/your-feature-name # 3. 进行开发 # 按照项目代码规范开发 # 确保代码有适当注释 # 运行测试确保功能正常 # 4. 提交代码 git add . git commit -m "feat(scope): 简洁描述你的改动" git push origin feature/your-feature-name # 5. 提交 Pull Request # 在 GitHub 上创建 PR ，详细描述改动内容 贡献者权益 📝 在贡献者列表中展示你的名字 🏆 对项目有重大贡献者可成为核心维护者 💼 优秀贡献者可获得推荐信或工作机会 🎁 顶级贡献者可获得项目周边礼品 项目地址 GitHub ： https://github.com/dtsola/xiaoyaosearch 欢迎： ⭐️ Star 本项目，关注最新进展 🍴 Fork 本项目，开始你的贡献 👀 Watch 本项目，及时获取更新 🐛 提 Issue ，报告问题和建议功能 💡 参与讨论 ，分享你的想法 关于我 dtsola - IT 解决方案架构师 | 一人公司实践者 网站 ： https://www.dtsola.com B 站 ： https://space.bilibili.com/736015 开源协议 本项目采用 小遥搜索软件授权协议 ： ✅ 免费使用（非商业用途） ✅ 可以学习和研究代码 ✅ 可以修改后二次分发（需保留版权声明和协议） ✅ 可以集成到其他非商业项目 ❌ 商业使用需授权 这是一个类似 CC-BY-NC-SA 的开源协议，鼓励学习、分享和贡献！ 详细协议： https://github.com/dtsola/xiaoyaosearch/blob/main/LICENSE 版本历史 v2.0.0 (2026-04-24) - UI 视觉系统升级版 🎨 核心升级 ： ✅ Notion 温暖明亮设计风格 ✅ 系统字体栈（零网络依赖） ✅ Lucide Icons 图标系统（ 1000+） ✅ 完整设计系统规范 ✅ 所有页面 UI 全面升级（ 10 个页面/组件） ✅ 响应式设计完善 v1.9.0 (2026-04-12) - 搜索优化版 ✅ 术语扩展时机优化 ✅ 智能合并去重 ✅ 并发控制优化 ✅ 专业术语召回率提升 60% v1.8.0 (2026-04-08) - 钉钉文档支持 ✅ 钉钉文档数据源支持 ✅ 元数据文件解析（.xyddjson 格式） ✅ 原文链接跳转功能 v1.7.0 (2026-03-31) - 飞书文档支持 ✅ 飞书文档数据源支持 ✅ 元数据块解析 ✅ 原文链接跳转功能 v1.6.0 (2026-03-26) - 云端嵌入模型 ✅ 云端嵌入模型调用能力 ✅ 本地/云端互斥切换 ✅ 批量文本嵌入优化 v1.5.0 (2026-03-20) - Agent Skills ✅ MCP Agent Skills 支持 ✅ 为 Claude Code/VS Code/Cursor 提供工具调用能力 v1.4.0 (2026-03-15) - MCP 服务器支持 ✅ MCP 协议支持 ✅ 可被 Claude Desktop 连接 ✅ SSE 传输方式 v1.3.0 (2026-03-10) - OpenAI 云端模型 ✅ OpenAI 兼容云端大模型 ✅ 动态表单配置 ✅ API 密钥加密存储 v1.2.0 (2026-03-05) - 插件化架构 ✅ 插件化架构框架 ✅ 语雀知识库数据源 v1.1.0 (2026-02-28) - i18n 国际化 ✅ 中英文双语支持 ✅ i18n 框架集成 v1.0.0 (2026-02-20) - MVP 版本 ✅ 多模态搜索（文本/语音/图像） ✅ 本地文件深度检索 ✅ BGE-M3 + FasterWhisper + CN-CLIP ✅ Faiss + Whoosh 混合搜索 结语 小遥搜索 v2.0.0 是我们对本地 AI 搜索工具的一次重大升级。 v1.x 时代 ：我们实现了核心的 AI 搜索能力，打造了稳定可用的本地搜索工具。 v2.0.0 时代 ：我们全面升级了视觉体验，建立了完整的设计系统，让产品不仅强大，而且美观易用。 未来 ：我们会持续优化性能，增加更多数据源，引入更多 AI 能力，让小遥搜索成为知识工作者的必备工具。 无论你是： 🔨 想要贡献代码的开发者 💡 想要提供建议的产品经理 📖 想要学习 AI 应用的学生 🚀 想要参与创业的伙伴 都欢迎加入我们，一起打造更好的本地 AI 搜索工具！ 让我们一起，用 AI 技术改变知识管理方式！ 🚀
前言 经过几个月的精心打磨， 小遥搜索 XiaoyaoSearch v2.0.0 今天正式发布了！ 这是一个重大版本更新，带来了全新的 Notion 温暖明亮设计风格 ，完整的 设计系统规范 ，以及全面的 UI 视觉升级 。 相比 v1.x 版本，v2.0.0 不仅保留了强大的多模态 AI 搜索能力，更在视觉体验上实现了 质的飞跃 。 v2.0.0 有什么不同？ 🎨 全新设计系统 Notion 温暖明亮设计风格 借鉴 Notion 的设计理念，打造专业、舒适、高效的视觉体验： 纯白背景 #ffffff + 温暖白 #f6f5f4：营造干净舒适的视觉环境 品牌蓝色 #0075de：统一品牌色调，提升识别度 超细边框 rgba(0,0,0,0.1)：柔和过渡，精致细节 多层阴影堆叠 ：4-5 层阴影，增强视觉层次感 视觉体验提升数据 ： 指标 v1.x v2.0 提升 视觉舒适度 60% 100% +67% 品牌识别度 50% 100% +100% 信息可读性 60% 100% +67% 专业度感知 60% 100% +67% 🔤 系统字体栈（零网络依赖） 告别 Google Fonts ，拥抱系统字体 v1.x 版本使用 Google Fonts CDN 加载字体，存在网络依赖和性能问题。v2.0.0 采用精心挑选的系统字体栈： font-family: -apple-system, /* Apple 系统字体 */ BlinkMacSystemFont, /* macOS Chrome */ "SF Pro Text", /* macOS 专业字体 */ "Segoe UI", /* Windows 系统字体 */ "PingFang SC", /* Apple 中文字体 */ "Microsoft YaHei", /* Windows 中文字体 */ sans-serif; /* 后备字体 */ 性能对比 ： 指标 v1.x （ Google Fonts ） v2.0 （系统字体） 提升 字体加载时间 200-500ms <10ms +98% 首屏渲染时间 2.0-2.5s <2.0s +20% 网络请求数 +2 个 0 个 +100% 离线可用性 否 是 ✅ 🎯 Lucide Icons 图标系统 1000+ 图标，统一视觉语言 采用 Lucide Icons 作为标准图标库，通过 @ iconify /vue 集成： 图标数量 ：1000+ 图标，持续更新 设计风格 ：现代简洁，线条优雅 可定制性 ：支持颜色、大小、粗细调整 按需加载 ：自动按需加载，无性能损耗 📐 完整设计系统规范 CSS Variables + Design Tokens 建立完整的设计令牌系统，确保设计一致性： /* 颜色系统 */ --bg-primary: #ffffff; /* 主背景 */ --bg-secondary: #f6f5f4; /* 次级背景 */ --text-primary: rgba(0,0,0,0.95); /* 主文字 */ --text-secondary: #615d59; /* 次要文字 */ --brand-blue: #0075de; /* 品牌蓝色 */ --border-standard: rgba(0,0,0,0.1); /* 标准边框 */ /* 间距系统（ 8px 基准） */ --space-xs: 4px; --space-sm: 8px; --space-md: 12px; --space-lg: 16px; --space-xl: 20px; --space-2xl: 24px; --space-3xl: 32px; /* 圆角系统 */ --radius-sm: 4px; --radius-md: 6px; --radius-lg: 10px; --radius-xl: 12px; /* 阴影系统 */ --shadow-card: 0 1px 2px rgba(0,0,0,0.04), 0 2px 4px rgba(0,0,0,0.04), 0 4px 8px rgba(0,0,0,0.04), 0 8px 16px rgba(0,0,0,0.04); --shadow-elevated: 0 2px 4px rgba(0,0,0,0.05), 0 4px 8px rgba(0,0,0,0.05), 0 8px 16px rgba(0,0,0,0.05), 0 16px 32px rgba(0,0,0,0.05); ✨ 所有页面 UI 升级 10 个页面/组件全面升级 ： 页面/组件 主要升级 顶部导航栏 Logo 、导航菜单、右侧操作区全新设计 底部状态栏 索引统计、搜索统计、数据统计信息展示 搜索首页 搜索区域、多模态指示器、结果列表精致卡片 搜索结果卡片 卡片样式、图标、标签、操作按钮 设置页面 标签页、表单、开关全新设计 索引管理页面 统计卡片、索引列表、模态框样式升级 术语库管理页面 列表、创建/编辑模态框、表单优化 术语管理页面 列表、CSV 导入、表单样式全面升级 帮助页面 FAQ 、折叠面板、搜索功能升级 关于作者页面 作者信息、联系方式、二维码展示优化 小遥搜索是什么？ 简单来说，它是一个 本地 AI 搜索桌面应用 ，核心特点： 🎤 多模态输入 语音搜索 ：点一下录音，说出你要找的内容，30 秒内语音自动转文字搜索 文本搜索 ：输入关键词，AI 理解语义，精准匹配文件内容 图片搜索 ：上传一张图片，AI 理解图像内容，帮你搜索相关文件 🔍 深度检索 文档 ：TXT 、Markdown 、Word 、Excel 、PPT 、PDF 全文检索 音视频 ：MP4 、AVI 、MP3 、WAV 内容索引和搜索 文件名 ：传统的文件名搜索也不缺席 🧠 AI 技术 集成了多个先进 AI 模型： BGE-M3 ：文本嵌入，理解语义 FasterWhisper ：语音识别，语音转文字 CN-CLIP ：图像理解，以图搜图 Ollama ：本地大语言模型 OpenAI/DeepSeek/阿里云 ：云端大模型（可选） 🎨 v2.0.0 全新 UI Notion 温暖明亮设计风格 ：专业、舒适、高效 系统字体栈 ：零网络依赖，加载速度 < 10ms Lucide Icons ：1000+ 图标，统一视觉语言 完整设计系统 ：确保设计一致性 🔒 隐私安全 完全本地 ：所有数据处理都在本地，不上传云端 隐私模式 ：可选不记录搜索历史 自主可控 ：数据完全由你自己掌控 核心界面一览 搜索主界面（ v2.0.0 全新设计） 设计亮点 ： 居中布局，视觉焦点集中 多模态指示器，清晰展示输入模式 搜索框圆角设计，蓝色光晕效果 结果卡片精致阴影，悬停加深 文本搜索 功能特点 ： 实时搜索结果展示 匹配度高亮显示 支持语义理解和关键词匹配 一键打开文件或定位文件夹 语音搜索 功能特点 ： 30 秒内语音录制 自动语音转文字 支持中英文混合输入 智能语义理解 图片搜索 功能特点 ： 上传图片即可搜索 AI 理解图像内容 支持相似图片匹配 以图搜图，精准定位 索引管理界面（ v2.0.0 全新设计） 设计亮点 ： 统计卡片，悬停提升效果 索引列表，精致阴影堆叠 操作菜单，流畅动画过渡 功能特点 ： 实时索引状态监控 文件夹路径管理 一键重建索引 索引进度可视化 设置界面（ v2.0.0 全新设计） 设计亮点 ： 标签页，次级背景，激活状态清晰 表单布局，标签左对齐，必填标记红色 开关控件，品牌蓝色，平滑过渡 功能特点 ： AI 模型配置 数据源管理 搜索偏好设置 界面主题选择 术语库管理界面（ v2.0.0 新增） 功能亮点 ： 多术语库集合管理 术语同义词扩展 CSV 导入/导出 预置专业术语库（ IT 、产品、医疗、法律） 使用场景 ： 产品经理：PRD 、产品需求文档、产品规格书 医生：CT 、计算机断层扫描、CT 扫描 开发者：API 、应用程序接口、接口文档 法律从业者：合同、协议、契约 技术架构 v2.0.0 技术亮点 新增技术栈 ： @iconify/vue ：图标按需加载系统 CSS Variables ：完整设计令牌系统 Design Tokens ：TypeScript 类型定义 系统字体栈 ：零网络依赖字体方案 性能优化 ： 字体加载时间 < 10ms （ vs 200-500ms ） 首屏渲染时间 < 2.0s （ vs 2.0-2.5s ） 网络请求数 -2 个（移除 Google Fonts ） 离线可用性 ✅ 版本对比：v1.x vs v2.0.0 设计对比 方面 v1.x v2.0.0 设计风格 Ant Design 默认风格 Notion 温暖明亮风格 字体方案 Google Fonts （网络依赖） 系统字体栈（零依赖） 图标系统 Ant Design Icons （ 300+） Lucide Icons （ 1000+） 阴影效果 简单阴影 4-5 层堆叠阴影 边框样式 标准边框 超细边框（ whisper ） 圆角系统 混合使用 统一规范（ 4/6/10/12px ） 动画效果 基础过渡 精致动画（ fadeInUp 、hover ） 响应式设计 部分支持 完整支持（桌面/平板/移动） 功能对比 功能 v1.x v2.0.0 多模态搜索 ✅ ✅ 本地文件检索 ✅ ✅ AI 模型配置 ✅ ✅ 插件化架构 ✅ ✅ 数据源扩展 ✅ 语雀、飞书、钉钉 ✅ + 语雀、飞书、钉钉 术语库系统 ✅ ✅ + UI 升级 MCP 服务器 ✅ ✅ Agent Skills ✅ ✅ UI 视觉系统 基础 全面升级 快速体验 环境要求 操作系统 ：Windows / MacOS / Linux Python ：3.10.11+ Node.js ：21.x+ 内存 ：建议 16GB 以上（ 8GB 可用） 显卡 ：建议 RTX3060 6GB 以上（可选） 安装步骤 方式一：整合包部署（推荐） 下载整合包 ： 从百度网盘下载最新的 Windows 整合包： 链接： https://pan.baidu.com/s/1lDaWjMCRXIT-Sqx9UFjerg?pwd=37ed 提取码：37ed 安装步骤 ： 解压整合包到任意目录 运行 scripts/setup.bat 自动安装依赖 安装并启动 Ollama 下载 AI 模型 运行 scripts/startup.bat 启动应用 方式二：开发者部署 1. 克隆项目 git clone https://github.com/dtsola/xiaoyaosearch.git cd xiaoyaosearch 2. 后端启动 cd backend pip install -r requirements.txt python main.py 3. 前端启动 cd frontend npm install npm run dev 详细安装指南： https://github.com/dtsola/xiaoyaosearch/blob/main/README.md 产品路线图 当前版本（ v2.0.0 ）✅ 核心功能 ： ✅ 多模态 AI 搜索（语音、文本、图片） ✅ 本地文件深度检索 ✅ AI 模型灵活配置（本地/云端） ✅ Notion 温暖明亮设计风格 ✅ 系统字体栈（零网络依赖） ✅ Lucide Icons 图标系统（ 1000+） ✅ 完整设计系统规范 ✅ 插件化架构（语雀、飞书、钉钉） ✅ 专业术语库系统 ✅ MCP 服务器支持 ✅ Agent Skills 支持 UI 升级亮点 ： ✅ 所有页面/组件 UI 全面升级 ✅ 视觉舒适度提升 67% ✅ 品牌识别度提升 100% ✅ 信息可读性提升 67% ✅ 专业度感知提升 67% 未来规划 🎨 UI/UX 持续优化 暗色模式支持（用户呼声最高的功能） 自定义主题配色 更多动画效果和过渡 🚀 性能优化 大文件处理优化 索引构建速度提升 内存占用优化 🔌 更多数据源支持 Notion 知识库 GitHub 代码仓库 GitLab 代码仓库 Confluence Wiki 🧠 AI 能力增强 自适应分块算法 知识图谱构建 RAG 系统升级 💬 智能聊天助手 多轮对话和上下文记忆 基于本地知识库的问答 自然语言交互 详细路线图： https://github.com/dtsola/xiaoyaosearch/blob/main/ROADMAP.md 适合谁使用？ 知识工作者 搜索本地文档、笔记、研究报告，快速定位关键信息 使用场景 ： 搜索产品需求文档（ PRD ） 查找技术方案和架构文档 检索会议记录和决策文档 整理项目资料和学习笔记 内容创作者 搜索素材和灵感，整理音视频内容，管理创作资源 使用场景 ： 搜索视频脚本和分镜 查找音频素材和音效 整理设计素材和灵感 管理项目资源和交付物 技术开发者 搜索代码库和技术文档，整理学习资料，管理项目文件 使用场景 ： 搜索代码片段和技术实现 查找 API 文档和使用示例 整理学习资料和教程 管理项目文件和依赖 研究人员 搜索论文和研究资料，整理文献笔记，管理研究数据 使用场景 ： 搜索论文和参考文献 查找实验数据和结果 整理文献笔记和观点 管理研究项目资料 为什么选择小遥搜索？ 🎯 专为知识工作者设计 多模态输入 ：语音、文本、图片，用最自然的方式搜索 语义理解 ：AI 理解你的意图，不只是关键词匹配 深度检索 ：搜索文件内容，不只是文件名 🔒 隐私安全优先 100% 本地 ：所有数据处理都在本地，不上传云端 隐私模式 ：可选不记录搜索历史 自主可控 ：数据完全由你自己掌控 🧠 AI 技术领先 多模型集成 ：BGE-M3 + FasterWhisper + CN-CLIP + Ollama 云端可选 ：支持 OpenAI/DeepSeek/阿里云等云端模型 持续升级 ：AI 模型和技术持续更新 🎨 v2.0.0 视觉体验 温暖明亮 ：Notion 设计风格，专业舒适 精致细节 ：多层阴影、超细边框、流畅动画 品牌识别 ：统一的视觉语言，提升专业度 高性能 ：零网络依赖，加载速度极快 🤖 开发者友好 100% 开源 ：所有源码、文档、开发经验全部开源 插件化架构 ：支持自定义扩展和数据源 MCP 支持 ：可被 Claude Desktop 等 AI 应用连接 Vibe Coding 案例 ：完整的 AI 辅助开发实践 Vibe Coding 实践案例 100% AI 辅助开发 这个项目从零开始， 完全通过 Vibe Coding 实现 ，包括： ✅ 完整源代码（前端 + 后端 + 所有功能模块） ✅ 设计文档（ PRD 、技术方案、数据库设计、API 文档） ✅ 开发流程（任务分解、进度跟踪、测试验证） ✅ 部署配置（环境搭建、依赖管理、打包发布） ✅ v2.0.0 UI 视觉系统全面升级 开源的价值 对于想要学习以下内容的开发者，这是一个完整的参考实现： AI 辅助开发实践 ：如何用 AI 实现完整项目 Electron 桌面应用 ：从零构建桌面应用 Vue 3 前端开发 ：Composition API + TypeScript Python FastAPI 后端 ：异步架构 + AI 模型集成 设计系统构建 ：从零建立完整设计规范 插件化架构 ：可扩展的插件系统设计 MCP 协议实现 ：AI 应用集成最佳实践 项目亮点总结 技术亮点 多模态 AI 搜索 ：语音、文本、图片三种输入方式 深度文件检索 ：支持文档、音视频的内容和文件名搜索 AI 模型集成 ：BGE-M3 、FasterWhisper 、CN-CLIP 、Ollama 插件化架构 ：支持语雀、飞书、钉钉等数据源 MCP 协议支持 ：可被 Claude Desktop 等 AI 应用连接 v2.0.0 UI 视觉升级 ：Notion 设计风格 + 完整设计系统 设计亮点（ v2.0.0 ） Notion 温暖明亮风格 ：专业、舒适、高效 系统字体栈 ：零网络依赖，最优性能 Lucide Icons ：1000+ 图标，统一视觉语言 多层阴影堆叠 ：4-5 层精致阴影 完整设计系统 ：确保设计一致性 响应式设计 ：完美适配各种设备 开源亮点 100% AI 辅助开发 ：完整的 Vibe Coding 实践案例 完整技术栈 ：前端 + 后端 + AI 模型 详尽文档 ：PRD 、技术方案、API 文档、数据库设计 插件化架构 ：可扩展的插件系统设计 持续更新 ：活跃开发，功能持续增强 邀请你参与 为什么需要你？ 一个人的力量有限，开源社区的力量是无限的！ 优先贡献方向 🎨 UI/UX 优化（高优先级） 暗黑模式支持 （用户呼声最高） 设计暗黑主题配色方案 实现主题切换功能 优化暗黑模式下的视觉体验 自定义主题配色 允许用户自定义品牌色 提供多种预设配色方案 支持导入导出主题配置 更多动画效果 页面切换动画 加载动画优化 微交互动画效果 🔌 更多数据源支持（高优先级） Notion 知识库 Notion API 集成 元数据解析 原文链接跳转 GitHub/GitLab 代码仓库搜索 Wiki 文档索引 Issue 和 PR 检索 ⚡ 性能优化（中优先级） 大文件处理优化 分块索引策略 流式读取优化 内存占用控制 索引构建速度提升 并行索引构建 增量索引更新 智能缓存机制 🧪 测试覆盖（中优先级） 单元测试补充 核心模块测试覆盖 边界条件测试 错误处理测试 集成测试完善 端到端测试场景 跨平台兼容性测试 性能基准测试 如何贡献？ # 1. Fork 项目 git clone https://github.com/dtsola/xiaoyaosearch.git cd xiaoyaosearch # 2. 创建分支 git checkout -b feature/your-feature-name # 3. 进行开发 # 按照项目代码规范开发 # 确保代码有适当注释 # 运行测试确保功能正常 # 4. 提交代码 git add . git commit -m "feat(scope): 简洁描述你的改动" git push origin feature/your-feature-name # 5. 提交 Pull Request # 在 GitHub 上创建 PR ，详细描述改动内容 贡献者权益 📝 在贡献者列表中展示你的名字 🏆 对项目有重大贡献者可成为核心维护者 💼 优秀贡献者可获得推荐信或工作机会 🎁 顶级贡献者可获得项目周边礼品 项目地址 GitHub ： https://github.com/dtsola/xiaoyaosearch 欢迎： ⭐️ Star 本项目，关注最新进展 🍴 Fork 本项目，开始你的贡献 👀 Watch 本项目，及时获取更新 🐛 提 Issue ，报告问题和建议功能 💡 参与讨论 ，分享你的想法 关于我 dtsola - IT 解决方案架构师 | 一人公司实践者 网站 ： https://www.dtsola.com B 站 ： https://space.bilibili.com/736015 开源协议 本项目采用 小遥搜索软件授权协议 ： ✅ 免费使用（非商业用途） ✅ 可以学习和研究代码 ✅ 可以修改后二次分发（需保留版权声明和协议） ✅ 可以集成到其他非商业项目 ❌ 商业使用需授权 这是一个类似 CC-BY-NC-SA 的开源协议，鼓励学习、分享和贡献！ 详细协议： https://github.com/dtsola/xiaoyaosearch/blob/main/LICENSE 版本历史 v2.0.0 (2026-04-24) - UI 视觉系统升级版 🎨 核心升级 ： ✅ Notion 温暖明亮设计风格 ✅ 系统字体栈（零网络依赖） ✅ Lucide Icons 图标系统（ 1000+） ✅ 完整设计系统规范 ✅ 所有页面 UI 全面升级（ 10 个页面/组件） ✅ 响应式设计完善 v1.9.0 (2026-04-12) - 搜索优化版 ✅ 术语扩展时机优化 ✅ 智能合并去重 ✅ 并发控制优化 ✅ 专业术语召回率提升 60% v1.8.0 (2026-04-08) - 钉钉文档支持 ✅ 钉钉文档数据源支持 ✅ 元数据文件解析（.xyddjson 格式） ✅ 原文链接跳转功能 v1.7.0 (2026-03-31) - 飞书文档支持 ✅ 飞书文档数据源支持 ✅ 元数据块解析 ✅ 原文链接跳转功能 v1.6.0 (2026-03-26) - 云端嵌入模型 ✅ 云端嵌入模型调用能力 ✅ 本地/云端互斥切换 ✅ 批量文本嵌入优化 v1.5.0 (2026-03-20) - Agent Skills ✅ MCP Agent Skills 支持 ✅ 为 Claude Code/VS Code/Cursor 提供工具调用能力 v1.4.0 (2026-03-15) - MCP 服务器支持 ✅ MCP 协议支持 ✅ 可被 Claude Desktop 连接 ✅ SSE 传输方式 v1.3.0 (2026-03-10) - OpenAI 云端模型 ✅ OpenAI 兼容云端大模型 ✅ 动态表单配置 ✅ API 密钥加密存储 v1.2.0 (2026-03-05) - 插件化架构 ✅ 插件化架构框架 ✅ 语雀知识库数据源 v1.1.0 (2026-02-28) - i18n 国际化 ✅ 中英文双语支持 ✅ i18n 框架集成 v1.0.0 (2026-02-20) - MVP 版本 ✅ 多模态搜索（文本/语音/图像） ✅ 本地文件深度检索 ✅ BGE-M3 + FasterWhisper + CN-CLIP ✅ Faiss + Whoosh 混合搜索 结语 小遥搜索 v2.0.0 是我们对本地 AI 搜索工具的一次重大升级。 v1.x 时代 ：我们实现了核心的 AI 搜索能力，打造了稳定可用的本地搜索工具。 v2.0.0 时代 ：我们全面升级了视觉体验，建立了完整的设计系统，让产品不仅强大，而且美观易用。 未来 ：我们会持续优化性能，增加更多数据源，引入更多 AI 能力，让小遥搜索成为知识工作者的必备工具。 无论你是： 🔨 想要贡献代码的开发者 💡 想要提供建议的产品经理 📖 想要学习 AI 应用的学生 🚀 想要参与创业的伙伴 都欢迎加入我们，一起打造更好的本地 AI 搜索工具！ 让我们一起，用 AI 技术改变知识管理方式！ 🚀
前言 经过几个月的精心打磨， 小遥搜索 XiaoyaoSearch v2.0.0 今天正式发布了！ 这是一个重大版本更新，带来了全新的 Notion 温暖明亮设计风格 ，完整的 设计系统规范 ，以及全面的 UI 视觉升级 。 相比 v1.x 版本，v2.0.0 不仅保留了强大的多模态 AI 搜索能力，更在视觉体验上实现了 质的飞跃 。 v2.0.0 有什么不同？ 🎨 全新设计系统 Notion 温暖明亮设计风格 借鉴 Notion 的设计理念，打造专业、舒适、高效的视觉体验： 纯白背景 #ffffff + 温暖白 #f6f5f4：营造干净舒适的视觉环境 品牌蓝色 #0075de：统一品牌色调，提升识别度 超细边框 rgba(0,0,0,0.1)：柔和过渡，精致细节 多层阴影堆叠 ：4-5 层阴影，增强视觉层次感 视觉体验提升数据 ： 指标 v1.x v2.0 提升 视觉舒适度 60% 100% +67% 品牌识别度 50% 100% +100% 信息可读性 60% 100% +67% 专业度感知 60% 100% +67% 🔤 系统字体栈（零网络依赖） 告别 Google Fonts ，拥抱系统字体 v1.x 版本使用 Google Fonts CDN 加载字体，存在网络依赖和性能问题。v2.0.0 采用精心挑选的系统字体栈： font-family: -apple-system, /* Apple 系统字体 */ BlinkMacSystemFont, /* macOS Chrome */ "SF Pro Text", /* macOS 专业字体 */ "Segoe UI", /* Windows 系统字体 */ "PingFang SC", /* Apple 中文字体 */ "Microsoft YaHei", /* Windows 中文字体 */ sans-serif; /* 后备字体 */ 性能对比 ： 指标 v1.x （ Google Fonts ） v2.0 （系统字体） 提升 字体加载时间 200-500ms <10ms +98% 首屏渲染时间 2.0-2.5s <2.0s +20% 网络请求数 +2 个 0 个 +100% 离线可用性 否 是 ✅ 🎯 Lucide Icons 图标系统 1000+ 图标，统一视觉语言 采用 Lucide Icons 作为标准图标库，通过 @ iconify /vue 集成： 图标数量 ：1000+ 图标，持续更新 设计风格 ：现代简洁，线条优雅 可定制性 ：支持颜色、大小、粗细调整 按需加载 ：自动按需加载，无性能损耗 📐 完整设计系统规范 CSS Variables + Design Tokens 建立完整的设计令牌系统，确保设计一致性： /* 颜色系统 */ --bg-primary: #ffffff; /* 主背景 */ --bg-secondary: #f6f5f4; /* 次级背景 */ --text-primary: rgba(0,0,0,0.95); /* 主文字 */ --text-secondary: #615d59; /* 次要文字 */ --brand-blue: #0075de; /* 品牌蓝色 */ --border-standard: rgba(0,0,0,0.1); /* 标准边框 */ /* 间距系统（ 8px 基准） */ --space-xs: 4px; --space-sm: 8px; --space-md: 12px; --space-lg: 16px; --space-xl: 20px; --space-2xl: 24px; --space-3xl: 32px; /* 圆角系统 */ --radius-sm: 4px; --radius-md: 6px; --radius-lg: 10px; --radius-xl: 12px; /* 阴影系统 */ --shadow-card: 0 1px 2px rgba(0,0,0,0.04), 0 2px 4px rgba(0,0,0,0.04), 0 4px 8px rgba(0,0,0,0.04), 0 8px 16px rgba(0,0,0,0.04); --shadow-elevated: 0 2px 4px rgba(0,0,0,0.05), 0 4px 8px rgba(0,0,0,0.05), 0 8px 16px rgba(0,0,0,0.05), 0 16px 32px rgba(0,0,0,0.05); ✨ 所有页面 UI 升级 10 个页面/组件全面升级 ： 页面/组件 主要升级 顶部导航栏 Logo 、导航菜单、右侧操作区全新设计 底部状态栏 索引统计、搜索统计、数据统计信息展示 搜索首页 搜索区域、多模态指示器、结果列表精致卡片 搜索结果卡片 卡片样式、图标、标签、操作按钮 设置页面 标签页、表单、开关全新设计 索引管理页面 统计卡片、索引列表、模态框样式升级 术语库管理页面 列表、创建/编辑模态框、表单优化 术语管理页面 列表、CSV 导入、表单样式全面升级 帮助页面 FAQ 、折叠面板、搜索功能升级 关于作者页面 作者信息、联系方式、二维码展示优化 小遥搜索是什么？ 简单来说，它是一个 本地 AI 搜索桌面应用 ，核心特点： 🎤 多模态输入 语音搜索 ：点一下录音，说出你要找的内容，30 秒内语音自动转文字搜索 文本搜索 ：输入关键词，AI 理解语义，精准匹配文件内容 图片搜索 ：上传一张图片，AI 理解图像内容，帮你搜索相关文件 🔍 深度检索 文档 ：TXT 、Markdown 、Word 、Excel 、PPT 、PDF 全文检索 音视频 ：MP4 、AVI 、MP3 、WAV 内容索引和搜索 文件名 ：传统的文件名搜索也不缺席 🧠 AI 技术 集成了多个先进 AI 模型： BGE-M3 ：文本嵌入，理解语义 FasterWhisper ：语音识别，语音转文字 CN-CLIP ：图像理解，以图搜图 Ollama ：本地大语言模型 OpenAI/DeepSeek/阿里云 ：云端大模型（可选） 🎨 v2.0.0 全新 UI Notion 温暖明亮设计风格 ：专业、舒适、高效 系统字体栈 ：零网络依赖，加载速度 < 10ms Lucide Icons ：1000+ 图标，统一视觉语言 完整设计系统 ：确保设计一致性 🔒 隐私安全 完全本地 ：所有数据处理都在本地，不上传云端 隐私模式 ：可选不记录搜索历史 自主可控 ：数据完全由你自己掌控 核心界面一览 搜索主界面（ v2.0.0 全新设计） 设计亮点 ： 居中布局，视觉焦点集中 多模态指示器，清晰展示输入模式 搜索框圆角设计，蓝色光晕效果 结果卡片精致阴影，悬停加深 文本搜索 功能特点 ： 实时搜索结果展示 匹配度高亮显示 支持语义理解和关键词匹配 一键打开文件或定位文件夹 语音搜索 功能特点 ： 30 秒内语音录制 自动语音转文字 支持中英文混合输入 智能语义理解 图片搜索 功能特点 ： 上传图片即可搜索 AI 理解图像内容 支持相似图片匹配 以图搜图，精准定位 索引管理界面（ v2.0.0 全新设计） 设计亮点 ： 统计卡片，悬停提升效果 索引列表，精致阴影堆叠 操作菜单，流畅动画过渡 功能特点 ： 实时索引状态监控 文件夹路径管理 一键重建索引 索引进度可视化 设置界面（ v2.0.0 全新设计） 设计亮点 ： 标签页，次级背景，激活状态清晰 表单布局，标签左对齐，必填标记红色 开关控件，品牌蓝色，平滑过渡 功能特点 ： AI 模型配置 数据源管理 搜索偏好设置 界面主题选择 术语库管理界面（ v2.0.0 新增） 功能亮点 ： 多术语库集合管理 术语同义词扩展 CSV 导入/导出 预置专业术语库（ IT 、产品、医疗、法律） 使用场景 ： 产品经理：PRD 、产品需求文档、产品规格书 医生：CT 、计算机断层扫描、CT 扫描 开发者：API 、应用程序接口、接口文档 法律从业者：合同、协议、契约 技术架构 v2.0.0 技术亮点 新增技术栈 ： @iconify/vue ：图标按需加载系统 CSS Variables ：完整设计令牌系统 Design Tokens ：TypeScript 类型定义 系统字体栈 ：零网络依赖字体方案 性能优化 ： 字体加载时间 < 10ms （ vs 200-500ms ） 首屏渲染时间 < 2.0s （ vs 2.0-2.5s ） 网络请求数 -2 个（移除 Google Fonts ） 离线可用性 ✅ 版本对比：v1.x vs v2.0.0 设计对比 方面 v1.x v2.0.0 设计风格 Ant Design 默认风格 Notion 温暖明亮风格 字体方案 Google Fonts （网络依赖） 系统字体栈（零依赖） 图标系统 Ant Design Icons （ 300+） Lucide Icons （ 1000+） 阴影效果 简单阴影 4-5 层堆叠阴影 边框样式 标准边框 超细边框（ whisper ） 圆角系统 混合使用 统一规范（ 4/6/10/12px ） 动画效果 基础过渡 精致动画（ fadeInUp 、hover ） 响应式设计 部分支持 完整支持（桌面/平板/移动） 功能对比 功能 v1.x v2.0.0 多模态搜索 ✅ ✅ 本地文件检索 ✅ ✅ AI 模型配置 ✅ ✅ 插件化架构 ✅ ✅ 数据源扩展 ✅ 语雀、飞书、钉钉 ✅ + 语雀、飞书、钉钉 术语库系统 ✅ ✅ + UI 升级 MCP 服务器 ✅ ✅ Agent Skills ✅ ✅ UI 视觉系统 基础 全面升级 快速体验 环境要求 操作系统 ：Windows / MacOS / Linux Python ：3.10.11+ Node.js ：21.x+ 内存 ：建议 16GB 以上（ 8GB 可用） 显卡 ：建议 RTX3060 6GB 以上（可选） 安装步骤 方式一：整合包部署（推荐） 下载整合包 ： 从百度网盘下载最新的 Windows 整合包： 链接： https://pan.baidu.com/s/1lDaWjMCRXIT-Sqx9UFjerg?pwd=37ed 提取码：37ed 安装步骤 ： 解压整合包到任意目录 运行 scripts/setup.bat 自动安装依赖 安装并启动 Ollama 下载 AI 模型 运行 scripts/startup.bat 启动应用 方式二：开发者部署 1. 克隆项目 git clone https://github.com/dtsola/xiaoyaosearch.git cd xiaoyaosearch 2. 后端启动 cd backend pip install -r requirements.txt python main.py 3. 前端启动 cd frontend npm install npm run dev 详细安装指南： https://github.com/dtsola/xiaoyaosearch/blob/main/README.md 产品路线图 当前版本（ v2.0.0 ）✅ 核心功能 ： ✅ 多模态 AI 搜索（语音、文本、图片） ✅ 本地文件深度检索 ✅ AI 模型灵活配置（本地/云端） ✅ Notion 温暖明亮设计风格 ✅ 系统字体栈（零网络依赖） ✅ Lucide Icons 图标系统（ 1000+） ✅ 完整设计系统规范 ✅ 插件化架构（语雀、飞书、钉钉） ✅ 专业术语库系统 ✅ MCP 服务器支持 ✅ Agent Skills 支持 UI 升级亮点 ： ✅ 所有页面/组件 UI 全面升级 ✅ 视觉舒适度提升 67% ✅ 品牌识别度提升 100% ✅ 信息可读性提升 67% ✅ 专业度感知提升 67% 未来规划 🎨 UI/UX 持续优化 暗色模式支持（用户呼声最高的功能） 自定义主题配色 更多动画效果和过渡 🚀 性能优化 大文件处理优化 索引构建速度提升 内存占用优化 🔌 更多数据源支持 Notion 知识库 GitHub 代码仓库 GitLab 代码仓库 Confluence Wiki 🧠 AI 能力增强 自适应分块算法 知识图谱构建 RAG 系统升级 💬 智能聊天助手 多轮对话和上下文记忆 基于本地知识库的问答 自然语言交互 详细路线图： https://github.com/dtsola/xiaoyaosearch/blob/main/ROADMAP.md 适合谁使用？ 知识工作者 搜索本地文档、笔记、研究报告，快速定位关键信息 使用场景 ： 搜索产品需求文档（ PRD ） 查找技术方案和架构文档 检索会议记录和决策文档 整理项目资料和学习笔记 内容创作者 搜索素材和灵感，整理音视频内容，管理创作资源 使用场景 ： 搜索视频脚本和分镜 查找音频素材和音效 整理设计素材和灵感 管理项目资源和交付物 技术开发者 搜索代码库和技术文档，整理学习资料，管理项目文件 使用场景 ： 搜索代码片段和技术实现 查找 API 文档和使用示例 整理学习资料和教程 管理项目文件和依赖 研究人员 搜索论文和研究资料，整理文献笔记，管理研究数据 使用场景 ： 搜索论文和参考文献 查找实验数据和结果 整理文献笔记和观点 管理研究项目资料 为什么选择小遥搜索？ 🎯 专为知识工作者设计 多模态输入 ：语音、文本、图片，用最自然的方式搜索 语义理解 ：AI 理解你的意图，不只是关键词匹配 深度检索 ：搜索文件内容，不只是文件名 🔒 隐私安全优先 100% 本地 ：所有数据处理都在本地，不上传云端 隐私模式 ：可选不记录搜索历史 自主可控 ：数据完全由你自己掌控 🧠 AI 技术领先 多模型集成 ：BGE-M3 + FasterWhisper + CN-CLIP + Ollama 云端可选 ：支持 OpenAI/DeepSeek/阿里云等云端模型 持续升级 ：AI 模型和技术持续更新 🎨 v2.0.0 视觉体验 温暖明亮 ：Notion 设计风格，专业舒适 精致细节 ：多层阴影、超细边框、流畅动画 品牌识别 ：统一的视觉语言，提升专业度 高性能 ：零网络依赖，加载速度极快 🤖 开发者友好 100% 开源 ：所有源码、文档、开发经验全部开源 插件化架构 ：支持自定义扩展和数据源 MCP 支持 ：可被 Claude Desktop 等 AI 应用连接 Vibe Coding 案例 ：完整的 AI 辅助开发实践 Vibe Coding 实践案例 100% AI 辅助开发 这个项目从零开始， 完全通过 Vibe Coding 实现 ，包括： ✅ 完整源代码（前端 + 后端 + 所有功能模块） ✅ 设计文档（ PRD 、技术方案、数据库设计、API 文档） ✅ 开发流程（任务分解、进度跟踪、测试验证） ✅ 部署配置（环境搭建、依赖管理、打包发布） ✅ v2.0.0 UI 视觉系统全面升级 开源的价值 对于想要学习以下内容的开发者，这是一个完整的参考实现： AI 辅助开发实践 ：如何用 AI 实现完整项目 Electron 桌面应用 ：从零构建桌面应用 Vue 3 前端开发 ：Composition API + TypeScript Python FastAPI 后端 ：异步架构 + AI 模型集成 设计系统构建 ：从零建立完整设计规范 插件化架构 ：可扩展的插件系统设计 MCP 协议实现 ：AI 应用集成最佳实践 项目亮点总结 技术亮点 多模态 AI 搜索 ：语音、文本、图片三种输入方式 深度文件检索 ：支持文档、音视频的内容和文件名搜索 AI 模型集成 ：BGE-M3 、FasterWhisper 、CN-CLIP 、Ollama 插件化架构 ：支持语雀、飞书、钉钉等数据源 MCP 协议支持 ：可被 Claude Desktop 等 AI 应用连接 v2.0.0 UI 视觉升级 ：Notion 设计风格 + 完整设计系统 设计亮点（ v2.0.0 ） Notion 温暖明亮风格 ：专业、舒适、高效 系统字体栈 ：零网络依赖，最优性能 Lucide Icons ：1000+ 图标，统一视觉语言 多层阴影堆叠 ：4-5 层精致阴影 完整设计系统 ：确保设计一致性 响应式设计 ：完美适配各种设备 开源亮点 100% AI 辅助开发 ：完整的 Vibe Coding 实践案例 完整技术栈 ：前端 + 后端 + AI 模型 详尽文档 ：PRD 、技术方案、API 文档、数据库设计 插件化架构 ：可扩展的插件系统设计 持续更新 ：活跃开发，功能持续增强 邀请你参与 为什么需要你？ 一个人的力量有限，开源社区的力量是无限的！ 优先贡献方向 🎨 UI/UX 优化（高优先级） 暗黑模式支持 （用户呼声最高） 设计暗黑主题配色方案 实现主题切换功能 优化暗黑模式下的视觉体验 自定义主题配色 允许用户自定义品牌色 提供多种预设配色方案 支持导入导出主题配置 更多动画效果 页面切换动画 加载动画优化 微交互动画效果 🔌 更多数据源支持（高优先级） Notion 知识库 Notion API 集成 元数据解析 原文链接跳转 GitHub/GitLab 代码仓库搜索 Wiki 文档索引 Issue 和 PR 检索 ⚡ 性能优化（中优先级） 大文件处理优化 分块索引策略 流式读取优化 内存占用控制 索引构建速度提升 并行索引构建 增量索引更新 智能缓存机制 🧪 测试覆盖（中优先级） 单元测试补充 核心模块测试覆盖 边界条件测试 错误处理测试 集成测试完善 端到端测试场景 跨平台兼容性测试 性能基准测试 如何贡献？ # 1. Fork 项目 git clone https://github.com/dtsola/xiaoyaosearch.git cd xiaoyaosearch # 2. 创建分支 git checkout -b feature/your-feature-name # 3. 进行开发 # 按照项目代码规范开发 # 确保代码有适当注释 # 运行测试确保功能正常 # 4. 提交代码 git add . git commit -m "feat(scope): 简洁描述你的改动" git push origin feature/your-feature-name # 5. 提交 Pull Request # 在 GitHub 上创建 PR ，详细描述改动内容 贡献者权益 📝 在贡献者列表中展示你的名字 🏆 对项目有重大贡献者可成为核心维护者 💼 优秀贡献者可获得推荐信或工作机会 🎁 顶级贡献者可获得项目周边礼品 项目地址 GitHub ： https://github.com/dtsola/xiaoyaosearch 欢迎： ⭐️ Star 本项目，关注最新进展 🍴 Fork 本项目，开始你的贡献 👀 Watch 本项目，及时获取更新 🐛 提 Issue ，报告问题和建议功能 💡 参与讨论 ，分享你的想法 关于我 dtsola - IT 解决方案架构师 | 一人公司实践者 网站 ： https://www.dtsola.com B 站 ： https://space.bilibili.com/736015 开源协议 本项目采用 小遥搜索软件授权协议 ： ✅ 免费使用（非商业用途） ✅ 可以学习和研究代码 ✅ 可以修改后二次分发（需保留版权声明和协议） ✅ 可以集成到其他非商业项目 ❌ 商业使用需授权 这是一个类似 CC-BY-NC-SA 的开源协议，鼓励学习、分享和贡献！ 详细协议： https://github.com/dtsola/xiaoyaosearch/blob/main/LICENSE 版本历史 v2.0.0 (2026-04-24) - UI 视觉系统升级版 🎨 核心升级 ： ✅ Notion 温暖明亮设计风格 ✅ 系统字体栈（零网络依赖） ✅ Lucide Icons 图标系统（ 1000+） ✅ 完整设计系统规范 ✅ 所有页面 UI 全面升级（ 10 个页面/组件） ✅ 响应式设计完善 v1.9.0 (2026-04-12) - 搜索优化版 ✅ 术语扩展时机优化 ✅ 智能合并去重 ✅ 并发控制优化 ✅ 专业术语召回率提升 60% v1.8.0 (2026-04-08) - 钉钉文档支持 ✅ 钉钉文档数据源支持 ✅ 元数据文件解析（.xyddjson 格式） ✅ 原文链接跳转功能 v1.7.0 (2026-03-31) - 飞书文档支持 ✅ 飞书文档数据源支持 ✅ 元数据块解析 ✅ 原文链接跳转功能 v1.6.0 (2026-03-26) - 云端嵌入模型 ✅ 云端嵌入模型调用能力 ✅ 本地/云端互斥切换 ✅ 批量文本嵌入优化 v1.5.0 (2026-03-20) - Agent Skills ✅ MCP Agent Skills 支持 ✅ 为 Claude Code/VS Code/Cursor 提供工具调用能力 v1.4.0 (2026-03-15) - MCP 服务器支持 ✅ MCP 协议支持 ✅ 可被 Claude Desktop 连接 ✅ SSE 传输方式 v1.3.0 (2026-03-10) - OpenAI 云端模型 ✅ OpenAI 兼容云端大模型 ✅ 动态表单配置 ✅ API 密钥加密存储 v1.2.0 (2026-03-05) - 插件化架构 ✅ 插件化架构框架 ✅ 语雀知识库数据源 v1.1.0 (2026-02-28) - i18n 国际化 ✅ 中英文双语支持 ✅ i18n 框架集成 v1.0.0 (2026-02-20) - MVP 版本 ✅ 多模态搜索（文本/语音/图像） ✅ 本地文件深度检索 ✅ BGE-M3 + FasterWhisper + CN-CLIP ✅ Faiss + Whoosh 混合搜索 结语 小遥搜索 v2.0.0 是我们对本地 AI 搜索工具的一次重大升级。 v1.x 时代 ：我们实现了核心的 AI 搜索能力，打造了稳定可用的本地搜索工具。 v2.0.0 时代 ：我们全面升级了视觉体验，建立了完整的设计系统，让产品不仅强大，而且美观易用。 未来 ：我们会持续优化性能，增加更多数据源，引入更多 AI 能力，让小遥搜索成为知识工作者的必备工具。 无论你是： 🔨 想要贡献代码的开发者 💡 想要提供建议的产品经理 📖 想要学习 AI 应用的学生 🚀 想要参与创业的伙伴 都欢迎加入我们，一起打造更好的本地 AI 搜索工具！ 让我们一起，用 AI 技术改变知识管理方式！ 🚀
前言 经过几个月的精心打磨， 小遥搜索 XiaoyaoSearch v2.0.0 今天正式发布了！ 这是一个重大版本更新，带来了全新的 Notion 温暖明亮设计风格 ，完整的 设计系统规范 ，以及全面的 UI 视觉升级 。 相比 v1.x 版本，v2.0.0 不仅保留了强大的多模态 AI 搜索能力，更在视觉体验上实现了 质的飞跃 。 v2.0.0 有什么不同？ 🎨 全新设计系统 Notion 温暖明亮设计风格 借鉴 Notion 的设计理念，打造专业、舒适、高效的视觉体验： 纯白背景 #ffffff + 温暖白 #f6f5f4：营造干净舒适的视觉环境 品牌蓝色 #0075de：统一品牌色调，提升识别度 超细边框 rgba(0,0,0,0.1)：柔和过渡，精致细节 多层阴影堆叠 ：4-5 层阴影，增强视觉层次感 视觉体验提升数据 ： 指标 v1.x v2.0 提升 视觉舒适度 60% 100% +67% 品牌识别度 50% 100% +100% 信息可读性 60% 100% +67% 专业度感知 60% 100% +67% 🔤 系统字体栈（零网络依赖） 告别 Google Fonts ，拥抱系统字体 v1.x 版本使用 Google Fonts CDN 加载字体，存在网络依赖和性能问题。v2.0.0 采用精心挑选的系统字体栈： font-family: -apple-system, /* Apple 系统字体 */ BlinkMacSystemFont, /* macOS Chrome */ "SF Pro Text", /* macOS 专业字体 */ "Segoe UI", /* Windows 系统字体 */ "PingFang SC", /* Apple 中文字体 */ "Microsoft YaHei", /* Windows 中文字体 */ sans-serif; /* 后备字体 */ 性能对比 ： 指标 v1.x （ Google Fonts ） v2.0 （系统字体） 提升 字体加载时间 200-500ms <10ms +98% 首屏渲染时间 2.0-2.5s <2.0s +20% 网络请求数 +2 个 0 个 +100% 离线可用性 否 是 ✅ 🎯 Lucide Icons 图标系统 1000+ 图标，统一视觉语言 采用 Lucide Icons 作为标准图标库，通过 @ iconify /vue 集成： 图标数量 ：1000+ 图标，持续更新 设计风格 ：现代简洁，线条优雅 可定制性 ：支持颜色、大小、粗细调整 按需加载 ：自动按需加载，无性能损耗 📐 完整设计系统规范 CSS Variables + Design Tokens 建立完整的设计令牌系统，确保设计一致性： /* 颜色系统 */ --bg-primary: #ffffff; /* 主背景 */ --bg-secondary: #f6f5f4; /* 次级背景 */ --text-primary: rgba(0,0,0,0.95); /* 主文字 */ --text-secondary: #615d59; /* 次要文字 */ --brand-blue: #0075de; /* 品牌蓝色 */ --border-standard: rgba(0,0,0,0.1); /* 标准边框 */ /* 间距系统（ 8px 基准） */ --space-xs: 4px; --space-sm: 8px; --space-md: 12px; --space-lg: 16px; --space-xl: 20px; --space-2xl: 24px; --space-3xl: 32px; /* 圆角系统 */ --radius-sm: 4px; --radius-md: 6px; --radius-lg: 10px; --radius-xl: 12px; /* 阴影系统 */ --shadow-card: 0 1px 2px rgba(0,0,0,0.04), 0 2px 4px rgba(0,0,0,0.04), 0 4px 8px rgba(0,0,0,0.04), 0 8px 16px rgba(0,0,0,0.04); --shadow-elevated: 0 2px 4px rgba(0,0,0,0.05), 0 4px 8px rgba(0,0,0,0.05), 0 8px 16px rgba(0,0,0,0.05), 0 16px 32px rgba(0,0,0,0.05); ✨ 所有页面 UI 升级 10 个页面/组件全面升级 ： 页面/组件 主要升级 顶部导航栏 Logo 、导航菜单、右侧操作区全新设计 底部状态栏 索引统计、搜索统计、数据统计信息展示 搜索首页 搜索区域、多模态指示器、结果列表精致卡片 搜索结果卡片 卡片样式、图标、标签、操作按钮 设置页面 标签页、表单、开关全新设计 索引管理页面 统计卡片、索引列表、模态框样式升级 术语库管理页面 列表、创建/编辑模态框、表单优化 术语管理页面 列表、CSV 导入、表单样式全面升级 帮助页面 FAQ 、折叠面板、搜索功能升级 关于作者页面 作者信息、联系方式、二维码展示优化 小遥搜索是什么？ 简单来说，它是一个 本地 AI 搜索桌面应用 ，核心特点： 🎤 多模态输入 语音搜索 ：点一下录音，说出你要找的内容，30 秒内语音自动转文字搜索 文本搜索 ：输入关键词，AI 理解语义，精准匹配文件内容 图片搜索 ：上传一张图片，AI 理解图像内容，帮你搜索相关文件 🔍 深度检索 文档 ：TXT 、Markdown 、Word 、Excel 、PPT 、PDF 全文检索 音视频 ：MP4 、AVI 、MP3 、WAV 内容索引和搜索 文件名 ：传统的文件名搜索也不缺席 🧠 AI 技术 集成了多个先进 AI 模型： BGE-M3 ：文本嵌入，理解语义 FasterWhisper ：语音识别，语音转文字 CN-CLIP ：图像理解，以图搜图 Ollama ：本地大语言模型 OpenAI/DeepSeek/阿里云 ：云端大模型（可选） 🎨 v2.0.0 全新 UI Notion 温暖明亮设计风格 ：专业、舒适、高效 系统字体栈 ：零网络依赖，加载速度 < 10ms Lucide Icons ：1000+ 图标，统一视觉语言 完整设计系统 ：确保设计一致性 🔒 隐私安全 完全本地 ：所有数据处理都在本地，不上传云端 隐私模式 ：可选不记录搜索历史 自主可控 ：数据完全由你自己掌控 核心界面一览 搜索主界面（ v2.0.0 全新设计） 设计亮点 ： 居中布局，视觉焦点集中 多模态指示器，清晰展示输入模式 搜索框圆角设计，蓝色光晕效果 结果卡片精致阴影，悬停加深 文本搜索 功能特点 ： 实时搜索结果展示 匹配度高亮显示 支持语义理解和关键词匹配 一键打开文件或定位文件夹 语音搜索 功能特点 ： 30 秒内语音录制 自动语音转文字 支持中英文混合输入 智能语义理解 图片搜索 功能特点 ： 上传图片即可搜索 AI 理解图像内容 支持相似图片匹配 以图搜图，精准定位 索引管理界面（ v2.0.0 全新设计） 设计亮点 ： 统计卡片，悬停提升效果 索引列表，精致阴影堆叠 操作菜单，流畅动画过渡 功能特点 ： 实时索引状态监控 文件夹路径管理 一键重建索引 索引进度可视化 设置界面（ v2.0.0 全新设计） 设计亮点 ： 标签页，次级背景，激活状态清晰 表单布局，标签左对齐，必填标记红色 开关控件，品牌蓝色，平滑过渡 功能特点 ： AI 模型配置 数据源管理 搜索偏好设置 界面主题选择 术语库管理界面（ v2.0.0 新增） 功能亮点 ： 多术语库集合管理 术语同义词扩展 CSV 导入/导出 预置专业术语库（ IT 、产品、医疗、法律） 使用场景 ： 产品经理：PRD 、产品需求文档、产品规格书 医生：CT 、计算机断层扫描、CT 扫描 开发者：API 、应用程序接口、接口文档 法律从业者：合同、协议、契约 技术架构 v2.0.0 技术亮点 新增技术栈 ： @iconify/vue ：图标按需加载系统 CSS Variables ：完整设计令牌系统 Design Tokens ：TypeScript 类型定义 系统字体栈 ：零网络依赖字体方案 性能优化 ： 字体加载时间 < 10ms （ vs 200-500ms ） 首屏渲染时间 < 2.0s （ vs 2.0-2.5s ） 网络请求数 -2 个（移除 Google Fonts ） 离线可用性 ✅ 版本对比：v1.x vs v2.0.0 设计对比 方面 v1.x v2.0.0 设计风格 Ant Design 默认风格 Notion 温暖明亮风格 字体方案 Google Fonts （网络依赖） 系统字体栈（零依赖） 图标系统 Ant Design Icons （ 300+） Lucide Icons （ 1000+） 阴影效果 简单阴影 4-5 层堆叠阴影 边框样式 标准边框 超细边框（ whisper ） 圆角系统 混合使用 统一规范（ 4/6/10/12px ） 动画效果 基础过渡 精致动画（ fadeInUp 、hover ） 响应式设计 部分支持 完整支持（桌面/平板/移动） 功能对比 功能 v1.x v2.0.0 多模态搜索 ✅ ✅ 本地文件检索 ✅ ✅ AI 模型配置 ✅ ✅ 插件化架构 ✅ ✅ 数据源扩展 ✅ 语雀、飞书、钉钉 ✅ + 语雀、飞书、钉钉 术语库系统 ✅ ✅ + UI 升级 MCP 服务器 ✅ ✅ Agent Skills ✅ ✅ UI 视觉系统 基础 全面升级 快速体验 环境要求 操作系统 ：Windows / MacOS / Linux Python ：3.10.11+ Node.js ：21.x+ 内存 ：建议 16GB 以上（ 8GB 可用） 显卡 ：建议 RTX3060 6GB 以上（可选） 安装步骤 方式一：整合包部署（推荐） 下载整合包 ： 从百度网盘下载最新的 Windows 整合包： 链接： https://pan.baidu.com/s/1lDaWjMCRXIT-Sqx9UFjerg?pwd=37ed 提取码：37ed 安装步骤 ： 解压整合包到任意目录 运行 scripts/setup.bat 自动安装依赖 安装并启动 Ollama 下载 AI 模型 运行 scripts/startup.bat 启动应用 方式二：开发者部署 1. 克隆项目 git clone https://github.com/dtsola/xiaoyaosearch.git cd xiaoyaosearch 2. 后端启动 cd backend pip install -r requirements.txt python main.py 3. 前端启动 cd frontend npm install npm run dev 详细安装指南： https://github.com/dtsola/xiaoyaosearch/blob/main/README.md 产品路线图 当前版本（ v2.0.0 ）✅ 核心功能 ： ✅ 多模态 AI 搜索（语音、文本、图片） ✅ 本地文件深度检索 ✅ AI 模型灵活配置（本地/云端） ✅ Notion 温暖明亮设计风格 ✅ 系统字体栈（零网络依赖） ✅ Lucide Icons 图标系统（ 1000+） ✅ 完整设计系统规范 ✅ 插件化架构（语雀、飞书、钉钉） ✅ 专业术语库系统 ✅ MCP 服务器支持 ✅ Agent Skills 支持 UI 升级亮点 ： ✅ 所有页面/组件 UI 全面升级 ✅ 视觉舒适度提升 67% ✅ 品牌识别度提升 100% ✅ 信息可读性提升 67% ✅ 专业度感知提升 67% 未来规划 🎨 UI/UX 持续优化 暗色模式支持（用户呼声最高的功能） 自定义主题配色 更多动画效果和过渡 🚀 性能优化 大文件处理优化 索引构建速度提升 内存占用优化 🔌 更多数据源支持 Notion 知识库 GitHub 代码仓库 GitLab 代码仓库 Confluence Wiki 🧠 AI 能力增强 自适应分块算法 知识图谱构建 RAG 系统升级 💬 智能聊天助手 多轮对话和上下文记忆 基于本地知识库的问答 自然语言交互 详细路线图： https://github.com/dtsola/xiaoyaosearch/blob/main/ROADMAP.md 适合谁使用？ 知识工作者 搜索本地文档、笔记、研究报告，快速定位关键信息 使用场景 ： 搜索产品需求文档（ PRD ） 查找技术方案和架构文档 检索会议记录和决策文档 整理项目资料和学习笔记 内容创作者 搜索素材和灵感，整理音视频内容，管理创作资源 使用场景 ： 搜索视频脚本和分镜 查找音频素材和音效 整理设计素材和灵感 管理项目资源和交付物 技术开发者 搜索代码库和技术文档，整理学习资料，管理项目文件 使用场景 ： 搜索代码片段和技术实现 查找 API 文档和使用示例 整理学习资料和教程 管理项目文件和依赖 研究人员 搜索论文和研究资料，整理文献笔记，管理研究数据 使用场景 ： 搜索论文和参考文献 查找实验数据和结果 整理文献笔记和观点 管理研究项目资料 为什么选择小遥搜索？ 🎯 专为知识工作者设计 多模态输入 ：语音、文本、图片，用最自然的方式搜索 语义理解 ：AI 理解你的意图，不只是关键词匹配 深度检索 ：搜索文件内容，不只是文件名 🔒 隐私安全优先 100% 本地 ：所有数据处理都在本地，不上传云端 隐私模式 ：可选不记录搜索历史 自主可控 ：数据完全由你自己掌控 🧠 AI 技术领先 多模型集成 ：BGE-M3 + FasterWhisper + CN-CLIP + Ollama 云端可选 ：支持 OpenAI/DeepSeek/阿里云等云端模型 持续升级 ：AI 模型和技术持续更新 🎨 v2.0.0 视觉体验 温暖明亮 ：Notion 设计风格，专业舒适 精致细节 ：多层阴影、超细边框、流畅动画 品牌识别 ：统一的视觉语言，提升专业度 高性能 ：零网络依赖，加载速度极快 🤖 开发者友好 100% 开源 ：所有源码、文档、开发经验全部开源 插件化架构 ：支持自定义扩展和数据源 MCP 支持 ：可被 Claude Desktop 等 AI 应用连接 Vibe Coding 案例 ：完整的 AI 辅助开发实践 Vibe Coding 实践案例 100% AI 辅助开发 这个项目从零开始， 完全通过 Vibe Coding 实现 ，包括： ✅ 完整源代码（前端 + 后端 + 所有功能模块） ✅ 设计文档（ PRD 、技术方案、数据库设计、API 文档） ✅ 开发流程（任务分解、进度跟踪、测试验证） ✅ 部署配置（环境搭建、依赖管理、打包发布） ✅ v2.0.0 UI 视觉系统全面升级 开源的价值 对于想要学习以下内容的开发者，这是一个完整的参考实现： AI 辅助开发实践 ：如何用 AI 实现完整项目 Electron 桌面应用 ：从零构建桌面应用 Vue 3 前端开发 ：Composition API + TypeScript Python FastAPI 后端 ：异步架构 + AI 模型集成 设计系统构建 ：从零建立完整设计规范 插件化架构 ：可扩展的插件系统设计 MCP 协议实现 ：AI 应用集成最佳实践 项目亮点总结 技术亮点 多模态 AI 搜索 ：语音、文本、图片三种输入方式 深度文件检索 ：支持文档、音视频的内容和文件名搜索 AI 模型集成 ：BGE-M3 、FasterWhisper 、CN-CLIP 、Ollama 插件化架构 ：支持语雀、飞书、钉钉等数据源 MCP 协议支持 ：可被 Claude Desktop 等 AI 应用连接 v2.0.0 UI 视觉升级 ：Notion 设计风格 + 完整设计系统 设计亮点（ v2.0.0 ） Notion 温暖明亮风格 ：专业、舒适、高效 系统字体栈 ：零网络依赖，最优性能 Lucide Icons ：1000+ 图标，统一视觉语言 多层阴影堆叠 ：4-5 层精致阴影 完整设计系统 ：确保设计一致性 响应式设计 ：完美适配各种设备 开源亮点 100% AI 辅助开发 ：完整的 Vibe Coding 实践案例 完整技术栈 ：前端 + 后端 + AI 模型 详尽文档 ：PRD 、技术方案、API 文档、数据库设计 插件化架构 ：可扩展的插件系统设计 持续更新 ：活跃开发，功能持续增强 邀请你参与 为什么需要你？ 一个人的力量有限，开源社区的力量是无限的！ 优先贡献方向 🎨 UI/UX 优化（高优先级） 暗黑模式支持 （用户呼声最高） 设计暗黑主题配色方案 实现主题切换功能 优化暗黑模式下的视觉体验 自定义主题配色 允许用户自定义品牌色 提供多种预设配色方案 支持导入导出主题配置 更多动画效果 页面切换动画 加载动画优化 微交互动画效果 🔌 更多数据源支持（高优先级） Notion 知识库 Notion API 集成 元数据解析 原文链接跳转 GitHub/GitLab 代码仓库搜索 Wiki 文档索引 Issue 和 PR 检索 ⚡ 性能优化（中优先级） 大文件处理优化 分块索引策略 流式读取优化 内存占用控制 索引构建速度提升 并行索引构建 增量索引更新 智能缓存机制 🧪 测试覆盖（中优先级） 单元测试补充 核心模块测试覆盖 边界条件测试 错误处理测试 集成测试完善 端到端测试场景 跨平台兼容性测试 性能基准测试 如何贡献？ # 1. Fork 项目 git clone https://github.com/dtsola/xiaoyaosearch.git cd xiaoyaosearch # 2. 创建分支 git checkout -b feature/your-feature-name # 3. 进行开发 # 按照项目代码规范开发 # 确保代码有适当注释 # 运行测试确保功能正常 # 4. 提交代码 git add . git commit -m "feat(scope): 简洁描述你的改动" git push origin feature/your-feature-name # 5. 提交 Pull Request # 在 GitHub 上创建 PR ，详细描述改动内容 贡献者权益 📝 在贡献者列表中展示你的名字 🏆 对项目有重大贡献者可成为核心维护者 💼 优秀贡献者可获得推荐信或工作机会 🎁 顶级贡献者可获得项目周边礼品 项目地址 GitHub ： https://github.com/dtsola/xiaoyaosearch 欢迎： ⭐️ Star 本项目，关注最新进展 🍴 Fork 本项目，开始你的贡献 👀 Watch 本项目，及时获取更新 🐛 提 Issue ，报告问题和建议功能 💡 参与讨论 ，分享你的想法 关于我 dtsola - IT 解决方案架构师 | 一人公司实践者 网站 ： https://www.dtsola.com B 站 ： https://space.bilibili.com/736015 开源协议 本项目采用 小遥搜索软件授权协议 ： ✅ 免费使用（非商业用途） ✅ 可以学习和研究代码 ✅ 可以修改后二次分发（需保留版权声明和协议） ✅ 可以集成到其他非商业项目 ❌ 商业使用需授权 这是一个类似 CC-BY-NC-SA 的开源协议，鼓励学习、分享和贡献！ 详细协议： https://github.com/dtsola/xiaoyaosearch/blob/main/LICENSE 版本历史 v2.0.0 (2026-04-24) - UI 视觉系统升级版 🎨 核心升级 ： ✅ Notion 温暖明亮设计风格 ✅ 系统字体栈（零网络依赖） ✅ Lucide Icons 图标系统（ 1000+） ✅ 完整设计系统规范 ✅ 所有页面 UI 全面升级（ 10 个页面/组件） ✅ 响应式设计完善 v1.9.0 (2026-04-12) - 搜索优化版 ✅ 术语扩展时机优化 ✅ 智能合并去重 ✅ 并发控制优化 ✅ 专业术语召回率提升 60% v1.8.0 (2026-04-08) - 钉钉文档支持 ✅ 钉钉文档数据源支持 ✅ 元数据文件解析（.xyddjson 格式） ✅ 原文链接跳转功能 v1.7.0 (2026-03-31) - 飞书文档支持 ✅ 飞书文档数据源支持 ✅ 元数据块解析 ✅ 原文链接跳转功能 v1.6.0 (2026-03-26) - 云端嵌入模型 ✅ 云端嵌入模型调用能力 ✅ 本地/云端互斥切换 ✅ 批量文本嵌入优化 v1.5.0 (2026-03-20) - Agent Skills ✅ MCP Agent Skills 支持 ✅ 为 Claude Code/VS Code/Cursor 提供工具调用能力 v1.4.0 (2026-03-15) - MCP 服务器支持 ✅ MCP 协议支持 ✅ 可被 Claude Desktop 连接 ✅ SSE 传输方式 v1.3.0 (2026-03-10) - OpenAI 云端模型 ✅ OpenAI 兼容云端大模型 ✅ 动态表单配置 ✅ API 密钥加密存储 v1.2.0 (2026-03-05) - 插件化架构 ✅ 插件化架构框架 ✅ 语雀知识库数据源 v1.1.0 (2026-02-28) - i18n 国际化 ✅ 中英文双语支持 ✅ i18n 框架集成 v1.0.0 (2026-02-20) - MVP 版本 ✅ 多模态搜索（文本/语音/图像） ✅ 本地文件深度检索 ✅ BGE-M3 + FasterWhisper + CN-CLIP ✅ Faiss + Whoosh 混合搜索 结语 小遥搜索 v2.0.0 是我们对本地 AI 搜索工具的一次重大升级。 v1.x 时代 ：我们实现了核心的 AI 搜索能力，打造了稳定可用的本地搜索工具。 v2.0.0 时代 ：我们全面升级了视觉体验，建立了完整的设计系统，让产品不仅强大，而且美观易用。 未来 ：我们会持续优化性能，增加更多数据源，引入更多 AI 能力，让小遥搜索成为知识工作者的必备工具。 无论你是： 🔨 想要贡献代码的开发者 💡 想要提供建议的产品经理 📖 想要学习 AI 应用的学生 🚀 想要参与创业的伙伴 都欢迎加入我们，一起打造更好的本地 AI 搜索工具！ 让我们一起，用 AI 技术改变知识管理方式！ 🚀
前言 经过几个月的精心打磨， 小遥搜索 XiaoyaoSearch v2.0.0 今天正式发布了！ 这是一个重大版本更新，带来了全新的 Notion 温暖明亮设计风格 ，完整的 设计系统规范 ，以及全面的 UI 视觉升级 。 相比 v1.x 版本，v2.0.0 不仅保留了强大的多模态 AI 搜索能力，更在视觉体验上实现了 质的飞跃 。 v2.0.0 有什么不同？ 🎨 全新设计系统 Notion 温暖明亮设计风格 借鉴 Notion 的设计理念，打造专业、舒适、高效的视觉体验： 纯白背景 #ffffff + 温暖白 #f6f5f4：营造干净舒适的视觉环境 品牌蓝色 #0075de：统一品牌色调，提升识别度 超细边框 rgba(0,0,0,0.1)：柔和过渡，精致细节 多层阴影堆叠 ：4-5 层阴影，增强视觉层次感 视觉体验提升数据 ： 指标 v1.x v2.0 提升 视觉舒适度 60% 100% +67% 品牌识别度 50% 100% +100% 信息可读性 60% 100% +67% 专业度感知 60% 100% +67% 🔤 系统字体栈（零网络依赖） 告别 Google Fonts ，拥抱系统字体 v1.x 版本使用 Google Fonts CDN 加载字体，存在网络依赖和性能问题。v2.0.0 采用精心挑选的系统字体栈： font-family: -apple-system, /* Apple 系统字体 */ BlinkMacSystemFont, /* macOS Chrome */ "SF Pro Text", /* macOS 专业字体 */ "Segoe UI", /* Windows 系统字体 */ "PingFang SC", /* Apple 中文字体 */ "Microsoft YaHei", /* Windows 中文字体 */ sans-serif; /* 后备字体 */ 性能对比 ： 指标 v1.x （ Google Fonts ） v2.0 （系统字体） 提升 字体加载时间 200-500ms <10ms +98% 首屏渲染时间 2.0-2.5s <2.0s +20% 网络请求数 +2 个 0 个 +100% 离线可用性 否 是 ✅ 🎯 Lucide Icons 图标系统 1000+ 图标，统一视觉语言 采用 Lucide Icons 作为标准图标库，通过 @ iconify /vue 集成： 图标数量 ：1000+ 图标，持续更新 设计风格 ：现代简洁，线条优雅 可定制性 ：支持颜色、大小、粗细调整 按需加载 ：自动按需加载，无性能损耗 📐 完整设计系统规范 CSS Variables + Design Tokens 建立完整的设计令牌系统，确保设计一致性： /* 颜色系统 */ --bg-primary: #ffffff; /* 主背景 */ --bg-secondary: #f6f5f4; /* 次级背景 */ --text-primary: rgba(0,0,0,0.95); /* 主文字 */ --text-secondary: #615d59; /* 次要文字 */ --brand-blue: #0075de; /* 品牌蓝色 */ --border-standard: rgba(0,0,0,0.1); /* 标准边框 */ /* 间距系统（ 8px 基准） */ --space-xs: 4px; --space-sm: 8px; --space-md: 12px; --space-lg: 16px; --space-xl: 20px; --space-2xl: 24px; --space-3xl: 32px; /* 圆角系统 */ --radius-sm: 4px; --radius-md: 6px; --radius-lg: 10px; --radius-xl: 12px; /* 阴影系统 */ --shadow-card: 0 1px 2px rgba(0,0,0,0.04), 0 2px 4px rgba(0,0,0,0.04), 0 4px 8px rgba(0,0,0,0.04), 0 8px 16px rgba(0,0,0,0.04); --shadow-elevated: 0 2px 4px rgba(0,0,0,0.05), 0 4px 8px rgba(0,0,0,0.05), 0 8px 16px rgba(0,0,0,0.05), 0 16px 32px rgba(0,0,0,0.05); ✨ 所有页面 UI 升级 10 个页面/组件全面升级 ： 页面/组件 主要升级 顶部导航栏 Logo 、导航菜单、右侧操作区全新设计 底部状态栏 索引统计、搜索统计、数据统计信息展示 搜索首页 搜索区域、多模态指示器、结果列表精致卡片 搜索结果卡片 卡片样式、图标、标签、操作按钮 设置页面 标签页、表单、开关全新设计 索引管理页面 统计卡片、索引列表、模态框样式升级 术语库管理页面 列表、创建/编辑模态框、表单优化 术语管理页面 列表、CSV 导入、表单样式全面升级 帮助页面 FAQ 、折叠面板、搜索功能升级 关于作者页面 作者信息、联系方式、二维码展示优化 小遥搜索是什么？ 简单来说，它是一个 本地 AI 搜索桌面应用 ，核心特点： 🎤 多模态输入 语音搜索 ：点一下录音，说出你要找的内容，30 秒内语音自动转文字搜索 文本搜索 ：输入关键词，AI 理解语义，精准匹配文件内容 图片搜索 ：上传一张图片，AI 理解图像内容，帮你搜索相关文件 🔍 深度检索 文档 ：TXT 、Markdown 、Word 、Excel 、PPT 、PDF 全文检索 音视频 ：MP4 、AVI 、MP3 、WAV 内容索引和搜索 文件名 ：传统的文件名搜索也不缺席 🧠 AI 技术 集成了多个先进 AI 模型： BGE-M3 ：文本嵌入，理解语义 FasterWhisper ：语音识别，语音转文字 CN-CLIP ：图像理解，以图搜图 Ollama ：本地大语言模型 OpenAI/DeepSeek/阿里云 ：云端大模型（可选） 🎨 v2.0.0 全新 UI Notion 温暖明亮设计风格 ：专业、舒适、高效 系统字体栈 ：零网络依赖，加载速度 < 10ms Lucide Icons ：1000+ 图标，统一视觉语言 完整设计系统 ：确保设计一致性 🔒 隐私安全 完全本地 ：所有数据处理都在本地，不上传云端 隐私模式 ：可选不记录搜索历史 自主可控 ：数据完全由你自己掌控 核心界面一览 搜索主界面（ v2.0.0 全新设计） 设计亮点 ： 居中布局，视觉焦点集中 多模态指示器，清晰展示输入模式 搜索框圆角设计，蓝色光晕效果 结果卡片精致阴影，悬停加深 文本搜索 功能特点 ： 实时搜索结果展示 匹配度高亮显示 支持语义理解和关键词匹配 一键打开文件或定位文件夹 语音搜索 功能特点 ： 30 秒内语音录制 自动语音转文字 支持中英文混合输入 智能语义理解 图片搜索 功能特点 ： 上传图片即可搜索 AI 理解图像内容 支持相似图片匹配 以图搜图，精准定位 索引管理界面（ v2.0.0 全新设计） 设计亮点 ： 统计卡片，悬停提升效果 索引列表，精致阴影堆叠 操作菜单，流畅动画过渡 功能特点 ： 实时索引状态监控 文件夹路径管理 一键重建索引 索引进度可视化 设置界面（ v2.0.0 全新设计） 设计亮点 ： 标签页，次级背景，激活状态清晰 表单布局，标签左对齐，必填标记红色 开关控件，品牌蓝色，平滑过渡 功能特点 ： AI 模型配置 数据源管理 搜索偏好设置 界面主题选择 术语库管理界面（ v2.0.0 新增） 功能亮点 ： 多术语库集合管理 术语同义词扩展 CSV 导入/导出 预置专业术语库（ IT 、产品、医疗、法律） 使用场景 ： 产品经理：PRD 、产品需求文档、产品规格书 医生：CT 、计算机断层扫描、CT 扫描 开发者：API 、应用程序接口、接口文档 法律从业者：合同、协议、契约 技术架构 v2.0.0 技术亮点 新增技术栈 ： @iconify/vue ：图标按需加载系统 CSS Variables ：完整设计令牌系统 Design Tokens ：TypeScript 类型定义 系统字体栈 ：零网络依赖字体方案 性能优化 ： 字体加载时间 < 10ms （ vs 200-500ms ） 首屏渲染时间 < 2.0s （ vs 2.0-2.5s ） 网络请求数 -2 个（移除 Google Fonts ） 离线可用性 ✅ 版本对比：v1.x vs v2.0.0 设计对比 方面 v1.x v2.0.0 设计风格 Ant Design 默认风格 Notion 温暖明亮风格 字体方案 Google Fonts （网络依赖） 系统字体栈（零依赖） 图标系统 Ant Design Icons （ 300+） Lucide Icons （ 1000+） 阴影效果 简单阴影 4-5 层堆叠阴影 边框样式 标准边框 超细边框（ whisper ） 圆角系统 混合使用 统一规范（ 4/6/10/12px ） 动画效果 基础过渡 精致动画（ fadeInUp 、hover ） 响应式设计 部分支持 完整支持（桌面/平板/移动） 功能对比 功能 v1.x v2.0.0 多模态搜索 ✅ ✅ 本地文件检索 ✅ ✅ AI 模型配置 ✅ ✅ 插件化架构 ✅ ✅ 数据源扩展 ✅ 语雀、飞书、钉钉 ✅ + 语雀、飞书、钉钉 术语库系统 ✅ ✅ + UI 升级 MCP 服务器 ✅ ✅ Agent Skills ✅ ✅ UI 视觉系统 基础 全面升级 快速体验 环境要求 操作系统 ：Windows / MacOS / Linux Python ：3.10.11+ Node.js ：21.x+ 内存 ：建议 16GB 以上（ 8GB 可用） 显卡 ：建议 RTX3060 6GB 以上（可选） 安装步骤 方式一：整合包部署（推荐） 下载整合包 ： 从百度网盘下载最新的 Windows 整合包： 链接： https://pan.baidu.com/s/1lDaWjMCRXIT-Sqx9UFjerg?pwd=37ed 提取码：37ed 安装步骤 ： 解压整合包到任意目录 运行 scripts/setup.bat 自动安装依赖 安装并启动 Ollama 下载 AI 模型 运行 scripts/startup.bat 启动应用 方式二：开发者部署 1. 克隆项目 git clone https://github.com/dtsola/xiaoyaosearch.git cd xiaoyaosearch 2. 后端启动 cd backend pip install -r requirements.txt python main.py 3. 前端启动 cd frontend npm install npm run dev 详细安装指南： https://github.com/dtsola/xiaoyaosearch/blob/main/README.md 产品路线图 当前版本（ v2.0.0 ）✅ 核心功能 ： ✅ 多模态 AI 搜索（语音、文本、图片） ✅ 本地文件深度检索 ✅ AI 模型灵活配置（本地/云端） ✅ Notion 温暖明亮设计风格 ✅ 系统字体栈（零网络依赖） ✅ Lucide Icons 图标系统（ 1000+） ✅ 完整设计系统规范 ✅ 插件化架构（语雀、飞书、钉钉） ✅ 专业术语库系统 ✅ MCP 服务器支持 ✅ Agent Skills 支持 UI 升级亮点 ： ✅ 所有页面/组件 UI 全面升级 ✅ 视觉舒适度提升 67% ✅ 品牌识别度提升 100% ✅ 信息可读性提升 67% ✅ 专业度感知提升 67% 未来规划 🎨 UI/UX 持续优化 暗色模式支持（用户呼声最高的功能） 自定义主题配色 更多动画效果和过渡 🚀 性能优化 大文件处理优化 索引构建速度提升 内存占用优化 🔌 更多数据源支持 Notion 知识库 GitHub 代码仓库 GitLab 代码仓库 Confluence Wiki 🧠 AI 能力增强 自适应分块算法 知识图谱构建 RAG 系统升级 💬 智能聊天助手 多轮对话和上下文记忆 基于本地知识库的问答 自然语言交互 详细路线图： https://github.com/dtsola/xiaoyaosearch/blob/main/ROADMAP.md 适合谁使用？ 知识工作者 搜索本地文档、笔记、研究报告，快速定位关键信息 使用场景 ： 搜索产品需求文档（ PRD ） 查找技术方案和架构文档 检索会议记录和决策文档 整理项目资料和学习笔记 内容创作者 搜索素材和灵感，整理音视频内容，管理创作资源 使用场景 ： 搜索视频脚本和分镜 查找音频素材和音效 整理设计素材和灵感 管理项目资源和交付物 技术开发者 搜索代码库和技术文档，整理学习资料，管理项目文件 使用场景 ： 搜索代码片段和技术实现 查找 API 文档和使用示例 整理学习资料和教程 管理项目文件和依赖 研究人员 搜索论文和研究资料，整理文献笔记，管理研究数据 使用场景 ： 搜索论文和参考文献 查找实验数据和结果 整理文献笔记和观点 管理研究项目资料 为什么选择小遥搜索？ 🎯 专为知识工作者设计 多模态输入 ：语音、文本、图片，用最自然的方式搜索 语义理解 ：AI 理解你的意图，不只是关键词匹配 深度检索 ：搜索文件内容，不只是文件名 🔒 隐私安全优先 100% 本地 ：所有数据处理都在本地，不上传云端 隐私模式 ：可选不记录搜索历史 自主可控 ：数据完全由你自己掌控 🧠 AI 技术领先 多模型集成 ：BGE-M3 + FasterWhisper + CN-CLIP + Ollama 云端可选 ：支持 OpenAI/DeepSeek/阿里云等云端模型 持续升级 ：AI 模型和技术持续更新 🎨 v2.0.0 视觉体验 温暖明亮 ：Notion 设计风格，专业舒适 精致细节 ：多层阴影、超细边框、流畅动画 品牌识别 ：统一的视觉语言，提升专业度 高性能 ：零网络依赖，加载速度极快 🤖 开发者友好 100% 开源 ：所有源码、文档、开发经验全部开源 插件化架构 ：支持自定义扩展和数据源 MCP 支持 ：可被 Claude Desktop 等 AI 应用连接 Vibe Coding 案例 ：完整的 AI 辅助开发实践 Vibe Coding 实践案例 100% AI 辅助开发 这个项目从零开始， 完全通过 Vibe Coding 实现 ，包括： ✅ 完整源代码（前端 + 后端 + 所有功能模块） ✅ 设计文档（ PRD 、技术方案、数据库设计、API 文档） ✅ 开发流程（任务分解、进度跟踪、测试验证） ✅ 部署配置（环境搭建、依赖管理、打包发布） ✅ v2.0.0 UI 视觉系统全面升级 开源的价值 对于想要学习以下内容的开发者，这是一个完整的参考实现： AI 辅助开发实践 ：如何用 AI 实现完整项目 Electron 桌面应用 ：从零构建桌面应用 Vue 3 前端开发 ：Composition API + TypeScript Python FastAPI 后端 ：异步架构 + AI 模型集成 设计系统构建 ：从零建立完整设计规范 插件化架构 ：可扩展的插件系统设计 MCP 协议实现 ：AI 应用集成最佳实践 项目亮点总结 技术亮点 多模态 AI 搜索 ：语音、文本、图片三种输入方式 深度文件检索 ：支持文档、音视频的内容和文件名搜索 AI 模型集成 ：BGE-M3 、FasterWhisper 、CN-CLIP 、Ollama 插件化架构 ：支持语雀、飞书、钉钉等数据源 MCP 协议支持 ：可被 Claude Desktop 等 AI 应用连接 v2.0.0 UI 视觉升级 ：Notion 设计风格 + 完整设计系统 设计亮点（ v2.0.0 ） Notion 温暖明亮风格 ：专业、舒适、高效 系统字体栈 ：零网络依赖，最优性能 Lucide Icons ：1000+ 图标，统一视觉语言 多层阴影堆叠 ：4-5 层精致阴影 完整设计系统 ：确保设计一致性 响应式设计 ：完美适配各种设备 开源亮点 100% AI 辅助开发 ：完整的 Vibe Coding 实践案例 完整技术栈 ：前端 + 后端 + AI 模型 详尽文档 ：PRD 、技术方案、API 文档、数据库设计 插件化架构 ：可扩展的插件系统设计 持续更新 ：活跃开发，功能持续增强 邀请你参与 为什么需要你？ 一个人的力量有限，开源社区的力量是无限的！ 优先贡献方向 🎨 UI/UX 优化（高优先级） 暗黑模式支持 （用户呼声最高） 设计暗黑主题配色方案 实现主题切换功能 优化暗黑模式下的视觉体验 自定义主题配色 允许用户自定义品牌色 提供多种预设配色方案 支持导入导出主题配置 更多动画效果 页面切换动画 加载动画优化 微交互动画效果 🔌 更多数据源支持（高优先级） Notion 知识库 Notion API 集成 元数据解析 原文链接跳转 GitHub/GitLab 代码仓库搜索 Wiki 文档索引 Issue 和 PR 检索 ⚡ 性能优化（中优先级） 大文件处理优化 分块索引策略 流式读取优化 内存占用控制 索引构建速度提升 并行索引构建 增量索引更新 智能缓存机制 🧪 测试覆盖（中优先级） 单元测试补充 核心模块测试覆盖 边界条件测试 错误处理测试 集成测试完善 端到端测试场景 跨平台兼容性测试 性能基准测试 如何贡献？ # 1. Fork 项目 git clone https://github.com/dtsola/xiaoyaosearch.git cd xiaoyaosearch # 2. 创建分支 git checkout -b feature/your-feature-name # 3. 进行开发 # 按照项目代码规范开发 # 确保代码有适当注释 # 运行测试确保功能正常 # 4. 提交代码 git add . git commit -m "feat(scope): 简洁描述你的改动" git push origin feature/your-feature-name # 5. 提交 Pull Request # 在 GitHub 上创建 PR ，详细描述改动内容 贡献者权益 📝 在贡献者列表中展示你的名字 🏆 对项目有重大贡献者可成为核心维护者 💼 优秀贡献者可获得推荐信或工作机会 🎁 顶级贡献者可获得项目周边礼品 项目地址 GitHub ： https://github.com/dtsola/xiaoyaosearch 欢迎： ⭐️ Star 本项目，关注最新进展 🍴 Fork 本项目，开始你的贡献 👀 Watch 本项目，及时获取更新 🐛 提 Issue ，报告问题和建议功能 💡 参与讨论 ，分享你的想法 关于我 dtsola - IT 解决方案架构师 | 一人公司实践者 网站 ： https://www.dtsola.com B 站 ： https://space.bilibili.com/736015 开源协议 本项目采用 小遥搜索软件授权协议 ： ✅ 免费使用（非商业用途） ✅ 可以学习和研究代码 ✅ 可以修改后二次分发（需保留版权声明和协议） ✅ 可以集成到其他非商业项目 ❌ 商业使用需授权 这是一个类似 CC-BY-NC-SA 的开源协议，鼓励学习、分享和贡献！ 详细协议： https://github.com/dtsola/xiaoyaosearch/blob/main/LICENSE 版本历史 v2.0.0 (2026-04-24) - UI 视觉系统升级版 🎨 核心升级 ： ✅ Notion 温暖明亮设计风格 ✅ 系统字体栈（零网络依赖） ✅ Lucide Icons 图标系统（ 1000+） ✅ 完整设计系统规范 ✅ 所有页面 UI 全面升级（ 10 个页面/组件） ✅ 响应式设计完善 v1.9.0 (2026-04-12) - 搜索优化版 ✅ 术语扩展时机优化 ✅ 智能合并去重 ✅ 并发控制优化 ✅ 专业术语召回率提升 60% v1.8.0 (2026-04-08) - 钉钉文档支持 ✅ 钉钉文档数据源支持 ✅ 元数据文件解析（.xyddjson 格式） ✅ 原文链接跳转功能 v1.7.0 (2026-03-31) - 飞书文档支持 ✅ 飞书文档数据源支持 ✅ 元数据块解析 ✅ 原文链接跳转功能 v1.6.0 (2026-03-26) - 云端嵌入模型 ✅ 云端嵌入模型调用能力 ✅ 本地/云端互斥切换 ✅ 批量文本嵌入优化 v1.5.0 (2026-03-20) - Agent Skills ✅ MCP Agent Skills 支持 ✅ 为 Claude Code/VS Code/Cursor 提供工具调用能力 v1.4.0 (2026-03-15) - MCP 服务器支持 ✅ MCP 协议支持 ✅ 可被 Claude Desktop 连接 ✅ SSE 传输方式 v1.3.0 (2026-03-10) - OpenAI 云端模型 ✅ OpenAI 兼容云端大模型 ✅ 动态表单配置 ✅ API 密钥加密存储 v1.2.0 (2026-03-05) - 插件化架构 ✅ 插件化架构框架 ✅ 语雀知识库数据源 v1.1.0 (2026-02-28) - i18n 国际化 ✅ 中英文双语支持 ✅ i18n 框架集成 v1.0.0 (2026-02-20) - MVP 版本 ✅ 多模态搜索（文本/语音/图像） ✅ 本地文件深度检索 ✅ BGE-M3 + FasterWhisper + CN-CLIP ✅ Faiss + Whoosh 混合搜索 结语 小遥搜索 v2.0.0 是我们对本地 AI 搜索工具的一次重大升级。 v1.x 时代 ：我们实现了核心的 AI 搜索能力，打造了稳定可用的本地搜索工具。 v2.0.0 时代 ：我们全面升级了视觉体验，建立了完整的设计系统，让产品不仅强大，而且美观易用。 未来 ：我们会持续优化性能，增加更多数据源，引入更多 AI 能力，让小遥搜索成为知识工作者的必备工具。 无论你是： 🔨 想要贡献代码的开发者 💡 想要提供建议的产品经理 📖 想要学习 AI 应用的学生 🚀 想要参与创业的伙伴 都欢迎加入我们，一起打造更好的本地 AI 搜索工具！ 让我们一起，用 AI 技术改变知识管理方式！ 🚀
前言 经过几个月的精心打磨， 小遥搜索 XiaoyaoSearch v2.0.0 今天正式发布了！ 这是一个重大版本更新，带来了全新的 Notion 温暖明亮设计风格 ，完整的 设计系统规范 ，以及全面的 UI 视觉升级 。 相比 v1.x 版本，v2.0.0 不仅保留了强大的多模态 AI 搜索能力，更在视觉体验上实现了 质的飞跃 。 v2.0.0 有什么不同？ 🎨 全新设计系统 Notion 温暖明亮设计风格 借鉴 Notion 的设计理念，打造专业、舒适、高效的视觉体验： 纯白背景 #ffffff + 温暖白 #f6f5f4：营造干净舒适的视觉环境 品牌蓝色 #0075de：统一品牌色调，提升识别度 超细边框 rgba(0,0,0,0.1)：柔和过渡，精致细节 多层阴影堆叠 ：4-5 层阴影，增强视觉层次感 视觉体验提升数据 ： 指标 v1.x v2.0 提升 视觉舒适度 60% 100% +67% 品牌识别度 50% 100% +100% 信息可读性 60% 100% +67% 专业度感知 60% 100% +67% 🔤 系统字体栈（零网络依赖） 告别 Google Fonts ，拥抱系统字体 v1.x 版本使用 Google Fonts CDN 加载字体，存在网络依赖和性能问题。v2.0.0 采用精心挑选的系统字体栈： font-family: -apple-system, /* Apple 系统字体 */ BlinkMacSystemFont, /* macOS Chrome */ "SF Pro Text", /* macOS 专业字体 */ "Segoe UI", /* Windows 系统字体 */ "PingFang SC", /* Apple 中文字体 */ "Microsoft YaHei", /* Windows 中文字体 */ sans-serif; /* 后备字体 */ 性能对比 ： 指标 v1.x （ Google Fonts ） v2.0 （系统字体） 提升 字体加载时间 200-500ms <10ms +98% 首屏渲染时间 2.0-2.5s <2.0s +20% 网络请求数 +2 个 0 个 +100% 离线可用性 否 是 ✅ 🎯 Lucide Icons 图标系统 1000+ 图标，统一视觉语言 采用 Lucide Icons 作为标准图标库，通过 @ iconify /vue 集成： 图标数量 ：1000+ 图标，持续更新 设计风格 ：现代简洁，线条优雅 可定制性 ：支持颜色、大小、粗细调整 按需加载 ：自动按需加载，无性能损耗 📐 完整设计系统规范 CSS Variables + Design Tokens 建立完整的设计令牌系统，确保设计一致性： /* 颜色系统 */ --bg-primary: #ffffff; /* 主背景 */ --bg-secondary: #f6f5f4; /* 次级背景 */ --text-primary: rgba(0,0,0,0.95); /* 主文字 */ --text-secondary: #615d59; /* 次要文字 */ --brand-blue: #0075de; /* 品牌蓝色 */ --border-standard: rgba(0,0,0,0.1); /* 标准边框 */ /* 间距系统（ 8px 基准） */ --space-xs: 4px; --space-sm: 8px; --space-md: 12px; --space-lg: 16px; --space-xl: 20px; --space-2xl: 24px; --space-3xl: 32px; /* 圆角系统 */ --radius-sm: 4px; --radius-md: 6px; --radius-lg: 10px; --radius-xl: 12px; /* 阴影系统 */ --shadow-card: 0 1px 2px rgba(0,0,0,0.04), 0 2px 4px rgba(0,0,0,0.04), 0 4px 8px rgba(0,0,0,0.04), 0 8px 16px rgba(0,0,0,0.04); --shadow-elevated: 0 2px 4px rgba(0,0,0,0.05), 0 4px 8px rgba(0,0,0,0.05), 0 8px 16px rgba(0,0,0,0.05), 0 16px 32px rgba(0,0,0,0.05); ✨ 所有页面 UI 升级 10 个页面/组件全面升级 ： 页面/组件 主要升级 顶部导航栏 Logo 、导航菜单、右侧操作区全新设计 底部状态栏 索引统计、搜索统计、数据统计信息展示 搜索首页 搜索区域、多模态指示器、结果列表精致卡片 搜索结果卡片 卡片样式、图标、标签、操作按钮 设置页面 标签页、表单、开关全新设计 索引管理页面 统计卡片、索引列表、模态框样式升级 术语库管理页面 列表、创建/编辑模态框、表单优化 术语管理页面 列表、CSV 导入、表单样式全面升级 帮助页面 FAQ 、折叠面板、搜索功能升级 关于作者页面 作者信息、联系方式、二维码展示优化 小遥搜索是什么？ 简单来说，它是一个 本地 AI 搜索桌面应用 ，核心特点： 🎤 多模态输入 语音搜索 ：点一下录音，说出你要找的内容，30 秒内语音自动转文字搜索 文本搜索 ：输入关键词，AI 理解语义，精准匹配文件内容 图片搜索 ：上传一张图片，AI 理解图像内容，帮你搜索相关文件 🔍 深度检索 文档 ：TXT 、Markdown 、Word 、Excel 、PPT 、PDF 全文检索 音视频 ：MP4 、AVI 、MP3 、WAV 内容索引和搜索 文件名 ：传统的文件名搜索也不缺席 🧠 AI 技术 集成了多个先进 AI 模型： BGE-M3 ：文本嵌入，理解语义 FasterWhisper ：语音识别，语音转文字 CN-CLIP ：图像理解，以图搜图 Ollama ：本地大语言模型 OpenAI/DeepSeek/阿里云 ：云端大模型（可选） 🎨 v2.0.0 全新 UI Notion 温暖明亮设计风格 ：专业、舒适、高效 系统字体栈 ：零网络依赖，加载速度 < 10ms Lucide Icons ：1000+ 图标，统一视觉语言 完整设计系统 ：确保设计一致性 🔒 隐私安全 完全本地 ：所有数据处理都在本地，不上传云端 隐私模式 ：可选不记录搜索历史 自主可控 ：数据完全由你自己掌控 核心界面一览 搜索主界面（ v2.0.0 全新设计） 设计亮点 ： 居中布局，视觉焦点集中 多模态指示器，清晰展示输入模式 搜索框圆角设计，蓝色光晕效果 结果卡片精致阴影，悬停加深 文本搜索 功能特点 ： 实时搜索结果展示 匹配度高亮显示 支持语义理解和关键词匹配 一键打开文件或定位文件夹 语音搜索 功能特点 ： 30 秒内语音录制 自动语音转文字 支持中英文混合输入 智能语义理解 图片搜索 功能特点 ： 上传图片即可搜索 AI 理解图像内容 支持相似图片匹配 以图搜图，精准定位 索引管理界面（ v2.0.0 全新设计） 设计亮点 ： 统计卡片，悬停提升效果 索引列表，精致阴影堆叠 操作菜单，流畅动画过渡 功能特点 ： 实时索引状态监控 文件夹路径管理 一键重建索引 索引进度可视化 设置界面（ v2.0.0 全新设计） 设计亮点 ： 标签页，次级背景，激活状态清晰 表单布局，标签左对齐，必填标记红色 开关控件，品牌蓝色，平滑过渡 功能特点 ： AI 模型配置 数据源管理 搜索偏好设置 界面主题选择 术语库管理界面（ v2.0.0 新增） 功能亮点 ： 多术语库集合管理 术语同义词扩展 CSV 导入/导出 预置专业术语库（ IT 、产品、医疗、法律） 使用场景 ： 产品经理：PRD 、产品需求文档、产品规格书 医生：CT 、计算机断层扫描、CT 扫描 开发者：API 、应用程序接口、接口文档 法律从业者：合同、协议、契约 技术架构 v2.0.0 技术亮点 新增技术栈 ： @iconify/vue ：图标按需加载系统 CSS Variables ：完整设计令牌系统 Design Tokens ：TypeScript 类型定义 系统字体栈 ：零网络依赖字体方案 性能优化 ： 字体加载时间 < 10ms （ vs 200-500ms ） 首屏渲染时间 < 2.0s （ vs 2.0-2.5s ） 网络请求数 -2 个（移除 Google Fonts ） 离线可用性 ✅ 版本对比：v1.x vs v2.0.0 设计对比 方面 v1.x v2.0.0 设计风格 Ant Design 默认风格 Notion 温暖明亮风格 字体方案 Google Fonts （网络依赖） 系统字体栈（零依赖） 图标系统 Ant Design Icons （ 300+） Lucide Icons （ 1000+） 阴影效果 简单阴影 4-5 层堆叠阴影 边框样式 标准边框 超细边框（ whisper ） 圆角系统 混合使用 统一规范（ 4/6/10/12px ） 动画效果 基础过渡 精致动画（ fadeInUp 、hover ） 响应式设计 部分支持 完整支持（桌面/平板/移动） 功能对比 功能 v1.x v2.0.0 多模态搜索 ✅ ✅ 本地文件检索 ✅ ✅ AI 模型配置 ✅ ✅ 插件化架构 ✅ ✅ 数据源扩展 ✅ 语雀、飞书、钉钉 ✅ + 语雀、飞书、钉钉 术语库系统 ✅ ✅ + UI 升级 MCP 服务器 ✅ ✅ Agent Skills ✅ ✅ UI 视觉系统 基础 全面升级 快速体验 环境要求 操作系统 ：Windows / MacOS / Linux Python ：3.10.11+ Node.js ：21.x+ 内存 ：建议 16GB 以上（ 8GB 可用） 显卡 ：建议 RTX3060 6GB 以上（可选） 安装步骤 方式一：整合包部署（推荐） 下载整合包 ： 从百度网盘下载最新的 Windows 整合包： 链接： https://pan.baidu.com/s/1lDaWjMCRXIT-Sqx9UFjerg?pwd=37ed 提取码：37ed 安装步骤 ： 解压整合包到任意目录 运行 scripts/setup.bat 自动安装依赖 安装并启动 Ollama 下载 AI 模型 运行 scripts/startup.bat 启动应用 方式二：开发者部署 1. 克隆项目 git clone https://github.com/dtsola/xiaoyaosearch.git cd xiaoyaosearch 2. 后端启动 cd backend pip install -r requirements.txt python main.py 3. 前端启动 cd frontend npm install npm run dev 详细安装指南： https://github.com/dtsola/xiaoyaosearch/blob/main/README.md 产品路线图 当前版本（ v2.0.0 ）✅ 核心功能 ： ✅ 多模态 AI 搜索（语音、文本、图片） ✅ 本地文件深度检索 ✅ AI 模型灵活配置（本地/云端） ✅ Notion 温暖明亮设计风格 ✅ 系统字体栈（零网络依赖） ✅ Lucide Icons 图标系统（ 1000+） ✅ 完整设计系统规范 ✅ 插件化架构（语雀、飞书、钉钉） ✅ 专业术语库系统 ✅ MCP 服务器支持 ✅ Agent Skills 支持 UI 升级亮点 ： ✅ 所有页面/组件 UI 全面升级 ✅ 视觉舒适度提升 67% ✅ 品牌识别度提升 100% ✅ 信息可读性提升 67% ✅ 专业度感知提升 67% 未来规划 🎨 UI/UX 持续优化 暗色模式支持（用户呼声最高的功能） 自定义主题配色 更多动画效果和过渡 🚀 性能优化 大文件处理优化 索引构建速度提升 内存占用优化 🔌 更多数据源支持 Notion 知识库 GitHub 代码仓库 GitLab 代码仓库 Confluence Wiki 🧠 AI 能力增强 自适应分块算法 知识图谱构建 RAG 系统升级 💬 智能聊天助手 多轮对话和上下文记忆 基于本地知识库的问答 自然语言交互 详细路线图： https://github.com/dtsola/xiaoyaosearch/blob/main/ROADMAP.md 适合谁使用？ 知识工作者 搜索本地文档、笔记、研究报告，快速定位关键信息 使用场景 ： 搜索产品需求文档（ PRD ） 查找技术方案和架构文档 检索会议记录和决策文档 整理项目资料和学习笔记 内容创作者 搜索素材和灵感，整理音视频内容，管理创作资源 使用场景 ： 搜索视频脚本和分镜 查找音频素材和音效 整理设计素材和灵感 管理项目资源和交付物 技术开发者 搜索代码库和技术文档，整理学习资料，管理项目文件 使用场景 ： 搜索代码片段和技术实现 查找 API 文档和使用示例 整理学习资料和教程 管理项目文件和依赖 研究人员 搜索论文和研究资料，整理文献笔记，管理研究数据 使用场景 ： 搜索论文和参考文献 查找实验数据和结果 整理文献笔记和观点 管理研究项目资料 为什么选择小遥搜索？ 🎯 专为知识工作者设计 多模态输入 ：语音、文本、图片，用最自然的方式搜索 语义理解 ：AI 理解你的意图，不只是关键词匹配 深度检索 ：搜索文件内容，不只是文件名 🔒 隐私安全优先 100% 本地 ：所有数据处理都在本地，不上传云端 隐私模式 ：可选不记录搜索历史 自主可控 ：数据完全由你自己掌控 🧠 AI 技术领先 多模型集成 ：BGE-M3 + FasterWhisper + CN-CLIP + Ollama 云端可选 ：支持 OpenAI/DeepSeek/阿里云等云端模型 持续升级 ：AI 模型和技术持续更新 🎨 v2.0.0 视觉体验 温暖明亮 ：Notion 设计风格，专业舒适 精致细节 ：多层阴影、超细边框、流畅动画 品牌识别 ：统一的视觉语言，提升专业度 高性能 ：零网络依赖，加载速度极快 🤖 开发者友好 100% 开源 ：所有源码、文档、开发经验全部开源 插件化架构 ：支持自定义扩展和数据源 MCP 支持 ：可被 Claude Desktop 等 AI 应用连接 Vibe Coding 案例 ：完整的 AI 辅助开发实践 Vibe Coding 实践案例 100% AI 辅助开发 这个项目从零开始， 完全通过 Vibe Coding 实现 ，包括： ✅ 完整源代码（前端 + 后端 + 所有功能模块） ✅ 设计文档（ PRD 、技术方案、数据库设计、API 文档） ✅ 开发流程（任务分解、进度跟踪、测试验证） ✅ 部署配置（环境搭建、依赖管理、打包发布） ✅ v2.0.0 UI 视觉系统全面升级 开源的价值 对于想要学习以下内容的开发者，这是一个完整的参考实现： AI 辅助开发实践 ：如何用 AI 实现完整项目 Electron 桌面应用 ：从零构建桌面应用 Vue 3 前端开发 ：Composition API + TypeScript Python FastAPI 后端 ：异步架构 + AI 模型集成 设计系统构建 ：从零建立完整设计规范 插件化架构 ：可扩展的插件系统设计 MCP 协议实现 ：AI 应用集成最佳实践 项目亮点总结 技术亮点 多模态 AI 搜索 ：语音、文本、图片三种输入方式 深度文件检索 ：支持文档、音视频的内容和文件名搜索 AI 模型集成 ：BGE-M3 、FasterWhisper 、CN-CLIP 、Ollama 插件化架构 ：支持语雀、飞书、钉钉等数据源 MCP 协议支持 ：可被 Claude Desktop 等 AI 应用连接 v2.0.0 UI 视觉升级 ：Notion 设计风格 + 完整设计系统 设计亮点（ v2.0.0 ） Notion 温暖明亮风格 ：专业、舒适、高效 系统字体栈 ：零网络依赖，最优性能 Lucide Icons ：1000+ 图标，统一视觉语言 多层阴影堆叠 ：4-5 层精致阴影 完整设计系统 ：确保设计一致性 响应式设计 ：完美适配各种设备 开源亮点 100% AI 辅助开发 ：完整的 Vibe Coding 实践案例 完整技术栈 ：前端 + 后端 + AI 模型 详尽文档 ：PRD 、技术方案、API 文档、数据库设计 插件化架构 ：可扩展的插件系统设计 持续更新 ：活跃开发，功能持续增强 邀请你参与 为什么需要你？ 一个人的力量有限，开源社区的力量是无限的！ 优先贡献方向 🎨 UI/UX 优化（高优先级） 暗黑模式支持 （用户呼声最高） 设计暗黑主题配色方案 实现主题切换功能 优化暗黑模式下的视觉体验 自定义主题配色 允许用户自定义品牌色 提供多种预设配色方案 支持导入导出主题配置 更多动画效果 页面切换动画 加载动画优化 微交互动画效果 🔌 更多数据源支持（高优先级） Notion 知识库 Notion API 集成 元数据解析 原文链接跳转 GitHub/GitLab 代码仓库搜索 Wiki 文档索引 Issue 和 PR 检索 ⚡ 性能优化（中优先级） 大文件处理优化 分块索引策略 流式读取优化 内存占用控制 索引构建速度提升 并行索引构建 增量索引更新 智能缓存机制 🧪 测试覆盖（中优先级） 单元测试补充 核心模块测试覆盖 边界条件测试 错误处理测试 集成测试完善 端到端测试场景 跨平台兼容性测试 性能基准测试 如何贡献？ # 1. Fork 项目 git clone https://github.com/dtsola/xiaoyaosearch.git cd xiaoyaosearch # 2. 创建分支 git checkout -b feature/your-feature-name # 3. 进行开发 # 按照项目代码规范开发 # 确保代码有适当注释 # 运行测试确保功能正常 # 4. 提交代码 git add . git commit -m "feat(scope): 简洁描述你的改动" git push origin feature/your-feature-name # 5. 提交 Pull Request # 在 GitHub 上创建 PR ，详细描述改动内容 贡献者权益 📝 在贡献者列表中展示你的名字 🏆 对项目有重大贡献者可成为核心维护者 💼 优秀贡献者可获得推荐信或工作机会 🎁 顶级贡献者可获得项目周边礼品 项目地址 GitHub ： https://github.com/dtsola/xiaoyaosearch 欢迎： ⭐️ Star 本项目，关注最新进展 🍴 Fork 本项目，开始你的贡献 👀 Watch 本项目，及时获取更新 🐛 提 Issue ，报告问题和建议功能 💡 参与讨论 ，分享你的想法 关于我 dtsola - IT 解决方案架构师 | 一人公司实践者 网站 ： https://www.dtsola.com B 站 ： https://space.bilibili.com/736015 开源协议 本项目采用 小遥搜索软件授权协议 ： ✅ 免费使用（非商业用途） ✅ 可以学习和研究代码 ✅ 可以修改后二次分发（需保留版权声明和协议） ✅ 可以集成到其他非商业项目 ❌ 商业使用需授权 这是一个类似 CC-BY-NC-SA 的开源协议，鼓励学习、分享和贡献！ 详细协议： https://github.com/dtsola/xiaoyaosearch/blob/main/LICENSE 版本历史 v2.0.0 (2026-04-24) - UI 视觉系统升级版 🎨 核心升级 ： ✅ Notion 温暖明亮设计风格 ✅ 系统字体栈（零网络依赖） ✅ Lucide Icons 图标系统（ 1000+） ✅ 完整设计系统规范 ✅ 所有页面 UI 全面升级（ 10 个页面/组件） ✅ 响应式设计完善 v1.9.0 (2026-04-12) - 搜索优化版 ✅ 术语扩展时机优化 ✅ 智能合并去重 ✅ 并发控制优化 ✅ 专业术语召回率提升 60% v1.8.0 (2026-04-08) - 钉钉文档支持 ✅ 钉钉文档数据源支持 ✅ 元数据文件解析（.xyddjson 格式） ✅ 原文链接跳转功能 v1.7.0 (2026-03-31) - 飞书文档支持 ✅ 飞书文档数据源支持 ✅ 元数据块解析 ✅ 原文链接跳转功能 v1.6.0 (2026-03-26) - 云端嵌入模型 ✅ 云端嵌入模型调用能力 ✅ 本地/云端互斥切换 ✅ 批量文本嵌入优化 v1.5.0 (2026-03-20) - Agent Skills ✅ MCP Agent Skills 支持 ✅ 为 Claude Code/VS Code/Cursor 提供工具调用能力 v1.4.0 (2026-03-15) - MCP 服务器支持 ✅ MCP 协议支持 ✅ 可被 Claude Desktop 连接 ✅ SSE 传输方式 v1.3.0 (2026-03-10) - OpenAI 云端模型 ✅ OpenAI 兼容云端大模型 ✅ 动态表单配置 ✅ API 密钥加密存储 v1.2.0 (2026-03-05) - 插件化架构 ✅ 插件化架构框架 ✅ 语雀知识库数据源 v1.1.0 (2026-02-28) - i18n 国际化 ✅ 中英文双语支持 ✅ i18n 框架集成 v1.0.0 (2026-02-20) - MVP 版本 ✅ 多模态搜索（文本/语音/图像） ✅ 本地文件深度检索 ✅ BGE-M3 + FasterWhisper + CN-CLIP ✅ Faiss + Whoosh 混合搜索 结语 小遥搜索 v2.0.0 是我们对本地 AI 搜索工具的一次重大升级。 v1.x 时代 ：我们实现了核心的 AI 搜索能力，打造了稳定可用的本地搜索工具。 v2.0.0 时代 ：我们全面升级了视觉体验，建立了完整的设计系统，让产品不仅强大，而且美观易用。 未来 ：我们会持续优化性能，增加更多数据源，引入更多 AI 能力，让小遥搜索成为知识工作者的必备工具。 无论你是： 🔨 想要贡献代码的开发者 💡 想要提供建议的产品经理 📖 想要学习 AI 应用的学生 🚀 想要参与创业的伙伴 都欢迎加入我们，一起打造更好的本地 AI 搜索工具！ 让我们一起，用 AI 技术改变知识管理方式！ 🚀
前言 经过几个月的精心打磨， 小遥搜索 XiaoyaoSearch v2.0.0 今天正式发布了！ 这是一个重大版本更新，带来了全新的 Notion 温暖明亮设计风格 ，完整的 设计系统规范 ，以及全面的 UI 视觉升级 。 相比 v1.x 版本，v2.0.0 不仅保留了强大的多模态 AI 搜索能力，更在视觉体验上实现了 质的飞跃 。 v2.0.0 有什么不同？ 🎨 全新设计系统 Notion 温暖明亮设计风格 借鉴 Notion 的设计理念，打造专业、舒适、高效的视觉体验： 纯白背景 #ffffff + 温暖白 #f6f5f4：营造干净舒适的视觉环境 品牌蓝色 #0075de：统一品牌色调，提升识别度 超细边框 rgba(0,0,0,0.1)：柔和过渡，精致细节 多层阴影堆叠 ：4-5 层阴影，增强视觉层次感 视觉体验提升数据 ： 指标 v1.x v2.0 提升 视觉舒适度 60% 100% +67% 品牌识别度 50% 100% +100% 信息可读性 60% 100% +67% 专业度感知 60% 100% +67% 🔤 系统字体栈（零网络依赖） 告别 Google Fonts ，拥抱系统字体 v1.x 版本使用 Google Fonts CDN 加载字体，存在网络依赖和性能问题。v2.0.0 采用精心挑选的系统字体栈： font-family: -apple-system, /* Apple 系统字体 */ BlinkMacSystemFont, /* macOS Chrome */ "SF Pro Text", /* macOS 专业字体 */ "Segoe UI", /* Windows 系统字体 */ "PingFang SC", /* Apple 中文字体 */ "Microsoft YaHei", /* Windows 中文字体 */ sans-serif; /* 后备字体 */ 性能对比 ： 指标 v1.x （ Google Fonts ） v2.0 （系统字体） 提升 字体加载时间 200-500ms <10ms +98% 首屏渲染时间 2.0-2.5s <2.0s +20% 网络请求数 +2 个 0 个 +100% 离线可用性 否 是 ✅ 🎯 Lucide Icons 图标系统 1000+ 图标，统一视觉语言 采用 Lucide Icons 作为标准图标库，通过 @ iconify /vue 集成： 图标数量 ：1000+ 图标，持续更新 设计风格 ：现代简洁，线条优雅 可定制性 ：支持颜色、大小、粗细调整 按需加载 ：自动按需加载，无性能损耗 📐 完整设计系统规范 CSS Variables + Design Tokens 建立完整的设计令牌系统，确保设计一致性： /* 颜色系统 */ --bg-primary: #ffffff; /* 主背景 */ --bg-secondary: #f6f5f4; /* 次级背景 */ --text-primary: rgba(0,0,0,0.95); /* 主文字 */ --text-secondary: #615d59; /* 次要文字 */ --brand-blue: #0075de; /* 品牌蓝色 */ --border-standard: rgba(0,0,0,0.1); /* 标准边框 */ /* 间距系统（ 8px 基准） */ --space-xs: 4px; --space-sm: 8px; --space-md: 12px; --space-lg: 16px; --space-xl: 20px; --space-2xl: 24px; --space-3xl: 32px; /* 圆角系统 */ --radius-sm: 4px; --radius-md: 6px; --radius-lg: 10px; --radius-xl: 12px; /* 阴影系统 */ --shadow-card: 0 1px 2px rgba(0,0,0,0.04), 0 2px 4px rgba(0,0,0,0.04), 0 4px 8px rgba(0,0,0,0.04), 0 8px 16px rgba(0,0,0,0.04); --shadow-elevated: 0 2px 4px rgba(0,0,0,0.05), 0 4px 8px rgba(0,0,0,0.05), 0 8px 16px rgba(0,0,0,0.05), 0 16px 32px rgba(0,0,0,0.05); ✨ 所有页面 UI 升级 10 个页面/组件全面升级 ： 页面/组件 主要升级 顶部导航栏 Logo 、导航菜单、右侧操作区全新设计 底部状态栏 索引统计、搜索统计、数据统计信息展示 搜索首页 搜索区域、多模态指示器、结果列表精致卡片 搜索结果卡片 卡片样式、图标、标签、操作按钮 设置页面 标签页、表单、开关全新设计 索引管理页面 统计卡片、索引列表、模态框样式升级 术语库管理页面 列表、创建/编辑模态框、表单优化 术语管理页面 列表、CSV 导入、表单样式全面升级 帮助页面 FAQ 、折叠面板、搜索功能升级 关于作者页面 作者信息、联系方式、二维码展示优化 小遥搜索是什么？ 简单来说，它是一个 本地 AI 搜索桌面应用 ，核心特点： 🎤 多模态输入 语音搜索 ：点一下录音，说出你要找的内容，30 秒内语音自动转文字搜索 文本搜索 ：输入关键词，AI 理解语义，精准匹配文件内容 图片搜索 ：上传一张图片，AI 理解图像内容，帮你搜索相关文件 🔍 深度检索 文档 ：TXT 、Markdown 、Word 、Excel 、PPT 、PDF 全文检索 音视频 ：MP4 、AVI 、MP3 、WAV 内容索引和搜索 文件名 ：传统的文件名搜索也不缺席 🧠 AI 技术 集成了多个先进 AI 模型： BGE-M3 ：文本嵌入，理解语义 FasterWhisper ：语音识别，语音转文字 CN-CLIP ：图像理解，以图搜图 Ollama ：本地大语言模型 OpenAI/DeepSeek/阿里云 ：云端大模型（可选） 🎨 v2.0.0 全新 UI Notion 温暖明亮设计风格 ：专业、舒适、高效 系统字体栈 ：零网络依赖，加载速度 < 10ms Lucide Icons ：1000+ 图标，统一视觉语言 完整设计系统 ：确保设计一致性 🔒 隐私安全 完全本地 ：所有数据处理都在本地，不上传云端 隐私模式 ：可选不记录搜索历史 自主可控 ：数据完全由你自己掌控 核心界面一览 搜索主界面（ v2.0.0 全新设计） 设计亮点 ： 居中布局，视觉焦点集中 多模态指示器，清晰展示输入模式 搜索框圆角设计，蓝色光晕效果 结果卡片精致阴影，悬停加深 文本搜索 功能特点 ： 实时搜索结果展示 匹配度高亮显示 支持语义理解和关键词匹配 一键打开文件或定位文件夹 语音搜索 功能特点 ： 30 秒内语音录制 自动语音转文字 支持中英文混合输入 智能语义理解 图片搜索 功能特点 ： 上传图片即可搜索 AI 理解图像内容 支持相似图片匹配 以图搜图，精准定位 索引管理界面（ v2.0.0 全新设计） 设计亮点 ： 统计卡片，悬停提升效果 索引列表，精致阴影堆叠 操作菜单，流畅动画过渡 功能特点 ： 实时索引状态监控 文件夹路径管理 一键重建索引 索引进度可视化 设置界面（ v2.0.0 全新设计） 设计亮点 ： 标签页，次级背景，激活状态清晰 表单布局，标签左对齐，必填标记红色 开关控件，品牌蓝色，平滑过渡 功能特点 ： AI 模型配置 数据源管理 搜索偏好设置 界面主题选择 术语库管理界面（ v2.0.0 新增） 功能亮点 ： 多术语库集合管理 术语同义词扩展 CSV 导入/导出 预置专业术语库（ IT 、产品、医疗、法律） 使用场景 ： 产品经理：PRD 、产品需求文档、产品规格书 医生：CT 、计算机断层扫描、CT 扫描 开发者：API 、应用程序接口、接口文档 法律从业者：合同、协议、契约 技术架构 v2.0.0 技术亮点 新增技术栈 ： @iconify/vue ：图标按需加载系统 CSS Variables ：完整设计令牌系统 Design Tokens ：TypeScript 类型定义 系统字体栈 ：零网络依赖字体方案 性能优化 ： 字体加载时间 < 10ms （ vs 200-500ms ） 首屏渲染时间 < 2.0s （ vs 2.0-2.5s ） 网络请求数 -2 个（移除 Google Fonts ） 离线可用性 ✅ 版本对比：v1.x vs v2.0.0 设计对比 方面 v1.x v2.0.0 设计风格 Ant Design 默认风格 Notion 温暖明亮风格 字体方案 Google Fonts （网络依赖） 系统字体栈（零依赖） 图标系统 Ant Design Icons （ 300+） Lucide Icons （ 1000+） 阴影效果 简单阴影 4-5 层堆叠阴影 边框样式 标准边框 超细边框（ whisper ） 圆角系统 混合使用 统一规范（ 4/6/10/12px ） 动画效果 基础过渡 精致动画（ fadeInUp 、hover ） 响应式设计 部分支持 完整支持（桌面/平板/移动） 功能对比 功能 v1.x v2.0.0 多模态搜索 ✅ ✅ 本地文件检索 ✅ ✅ AI 模型配置 ✅ ✅ 插件化架构 ✅ ✅ 数据源扩展 ✅ 语雀、飞书、钉钉 ✅ + 语雀、飞书、钉钉 术语库系统 ✅ ✅ + UI 升级 MCP 服务器 ✅ ✅ Agent Skills ✅ ✅ UI 视觉系统 基础 全面升级 快速体验 环境要求 操作系统 ：Windows / MacOS / Linux Python ：3.10.11+ Node.js ：21.x+ 内存 ：建议 16GB 以上（ 8GB 可用） 显卡 ：建议 RTX3060 6GB 以上（可选） 安装步骤 方式一：整合包部署（推荐） 下载整合包 ： 从百度网盘下载最新的 Windows 整合包： 链接： https://pan.baidu.com/s/1lDaWjMCRXIT-Sqx9UFjerg?pwd=37ed 提取码：37ed 安装步骤 ： 解压整合包到任意目录 运行 scripts/setup.bat 自动安装依赖 安装并启动 Ollama 下载 AI 模型 运行 scripts/startup.bat 启动应用 方式二：开发者部署 1. 克隆项目 git clone https://github.com/dtsola/xiaoyaosearch.git cd xiaoyaosearch 2. 后端启动 cd backend pip install -r requirements.txt python main.py 3. 前端启动 cd frontend npm install npm run dev 详细安装指南： https://github.com/dtsola/xiaoyaosearch/blob/main/README.md 产品路线图 当前版本（ v2.0.0 ）✅ 核心功能 ： ✅ 多模态 AI 搜索（语音、文本、图片） ✅ 本地文件深度检索 ✅ AI 模型灵活配置（本地/云端） ✅ Notion 温暖明亮设计风格 ✅ 系统字体栈（零网络依赖） ✅ Lucide Icons 图标系统（ 1000+） ✅ 完整设计系统规范 ✅ 插件化架构（语雀、飞书、钉钉） ✅ 专业术语库系统 ✅ MCP 服务器支持 ✅ Agent Skills 支持 UI 升级亮点 ： ✅ 所有页面/组件 UI 全面升级 ✅ 视觉舒适度提升 67% ✅ 品牌识别度提升 100% ✅ 信息可读性提升 67% ✅ 专业度感知提升 67% 未来规划 🎨 UI/UX 持续优化 暗色模式支持（用户呼声最高的功能） 自定义主题配色 更多动画效果和过渡 🚀 性能优化 大文件处理优化 索引构建速度提升 内存占用优化 🔌 更多数据源支持 Notion 知识库 GitHub 代码仓库 GitLab 代码仓库 Confluence Wiki 🧠 AI 能力增强 自适应分块算法 知识图谱构建 RAG 系统升级 💬 智能聊天助手 多轮对话和上下文记忆 基于本地知识库的问答 自然语言交互 详细路线图： https://github.com/dtsola/xiaoyaosearch/blob/main/ROADMAP.md 适合谁使用？ 知识工作者 搜索本地文档、笔记、研究报告，快速定位关键信息 使用场景 ： 搜索产品需求文档（ PRD ） 查找技术方案和架构文档 检索会议记录和决策文档 整理项目资料和学习笔记 内容创作者 搜索素材和灵感，整理音视频内容，管理创作资源 使用场景 ： 搜索视频脚本和分镜 查找音频素材和音效 整理设计素材和灵感 管理项目资源和交付物 技术开发者 搜索代码库和技术文档，整理学习资料，管理项目文件 使用场景 ： 搜索代码片段和技术实现 查找 API 文档和使用示例 整理学习资料和教程 管理项目文件和依赖 研究人员 搜索论文和研究资料，整理文献笔记，管理研究数据 使用场景 ： 搜索论文和参考文献 查找实验数据和结果 整理文献笔记和观点 管理研究项目资料 为什么选择小遥搜索？ 🎯 专为知识工作者设计 多模态输入 ：语音、文本、图片，用最自然的方式搜索 语义理解 ：AI 理解你的意图，不只是关键词匹配 深度检索 ：搜索文件内容，不只是文件名 🔒 隐私安全优先 100% 本地 ：所有数据处理都在本地，不上传云端 隐私模式 ：可选不记录搜索历史 自主可控 ：数据完全由你自己掌控 🧠 AI 技术领先 多模型集成 ：BGE-M3 + FasterWhisper + CN-CLIP + Ollama 云端可选 ：支持 OpenAI/DeepSeek/阿里云等云端模型 持续升级 ：AI 模型和技术持续更新 🎨 v2.0.0 视觉体验 温暖明亮 ：Notion 设计风格，专业舒适 精致细节 ：多层阴影、超细边框、流畅动画 品牌识别 ：统一的视觉语言，提升专业度 高性能 ：零网络依赖，加载速度极快 🤖 开发者友好 100% 开源 ：所有源码、文档、开发经验全部开源 插件化架构 ：支持自定义扩展和数据源 MCP 支持 ：可被 Claude Desktop 等 AI 应用连接 Vibe Coding 案例 ：完整的 AI 辅助开发实践 Vibe Coding 实践案例 100% AI 辅助开发 这个项目从零开始， 完全通过 Vibe Coding 实现 ，包括： ✅ 完整源代码（前端 + 后端 + 所有功能模块） ✅ 设计文档（ PRD 、技术方案、数据库设计、API 文档） ✅ 开发流程（任务分解、进度跟踪、测试验证） ✅ 部署配置（环境搭建、依赖管理、打包发布） ✅ v2.0.0 UI 视觉系统全面升级 开源的价值 对于想要学习以下内容的开发者，这是一个完整的参考实现： AI 辅助开发实践 ：如何用 AI 实现完整项目 Electron 桌面应用 ：从零构建桌面应用 Vue 3 前端开发 ：Composition API + TypeScript Python FastAPI 后端 ：异步架构 + AI 模型集成 设计系统构建 ：从零建立完整设计规范 插件化架构 ：可扩展的插件系统设计 MCP 协议实现 ：AI 应用集成最佳实践 项目亮点总结 技术亮点 多模态 AI 搜索 ：语音、文本、图片三种输入方式 深度文件检索 ：支持文档、音视频的内容和文件名搜索 AI 模型集成 ：BGE-M3 、FasterWhisper 、CN-CLIP 、Ollama 插件化架构 ：支持语雀、飞书、钉钉等数据源 MCP 协议支持 ：可被 Claude Desktop 等 AI 应用连接 v2.0.0 UI 视觉升级 ：Notion 设计风格 + 完整设计系统 设计亮点（ v2.0.0 ） Notion 温暖明亮风格 ：专业、舒适、高效 系统字体栈 ：零网络依赖，最优性能 Lucide Icons ：1000+ 图标，统一视觉语言 多层阴影堆叠 ：4-5 层精致阴影 完整设计系统 ：确保设计一致性 响应式设计 ：完美适配各种设备 开源亮点 100% AI 辅助开发 ：完整的 Vibe Coding 实践案例 完整技术栈 ：前端 + 后端 + AI 模型 详尽文档 ：PRD 、技术方案、API 文档、数据库设计 插件化架构 ：可扩展的插件系统设计 持续更新 ：活跃开发，功能持续增强 邀请你参与 为什么需要你？ 一个人的力量有限，开源社区的力量是无限的！ 优先贡献方向 🎨 UI/UX 优化（高优先级） 暗黑模式支持 （用户呼声最高） 设计暗黑主题配色方案 实现主题切换功能 优化暗黑模式下的视觉体验 自定义主题配色 允许用户自定义品牌色 提供多种预设配色方案 支持导入导出主题配置 更多动画效果 页面切换动画 加载动画优化 微交互动画效果 🔌 更多数据源支持（高优先级） Notion 知识库 Notion API 集成 元数据解析 原文链接跳转 GitHub/GitLab 代码仓库搜索 Wiki 文档索引 Issue 和 PR 检索 ⚡ 性能优化（中优先级） 大文件处理优化 分块索引策略 流式读取优化 内存占用控制 索引构建速度提升 并行索引构建 增量索引更新 智能缓存机制 🧪 测试覆盖（中优先级） 单元测试补充 核心模块测试覆盖 边界条件测试 错误处理测试 集成测试完善 端到端测试场景 跨平台兼容性测试 性能基准测试 如何贡献？ # 1. Fork 项目 git clone https://github.com/dtsola/xiaoyaosearch.git cd xiaoyaosearch # 2. 创建分支 git checkout -b feature/your-feature-name # 3. 进行开发 # 按照项目代码规范开发 # 确保代码有适当注释 # 运行测试确保功能正常 # 4. 提交代码 git add . git commit -m "feat(scope): 简洁描述你的改动" git push origin feature/your-feature-name # 5. 提交 Pull Request # 在 GitHub 上创建 PR ，详细描述改动内容 贡献者权益 📝 在贡献者列表中展示你的名字 🏆 对项目有重大贡献者可成为核心维护者 💼 优秀贡献者可获得推荐信或工作机会 🎁 顶级贡献者可获得项目周边礼品 项目地址 GitHub ： https://github.com/dtsola/xiaoyaosearch 欢迎： ⭐️ Star 本项目，关注最新进展 🍴 Fork 本项目，开始你的贡献 👀 Watch 本项目，及时获取更新 🐛 提 Issue ，报告问题和建议功能 💡 参与讨论 ，分享你的想法 关于我 dtsola - IT 解决方案架构师 | 一人公司实践者 网站 ： https://www.dtsola.com B 站 ： https://space.bilibili.com/736015 开源协议 本项目采用 小遥搜索软件授权协议 ： ✅ 免费使用（非商业用途） ✅ 可以学习和研究代码 ✅ 可以修改后二次分发（需保留版权声明和协议） ✅ 可以集成到其他非商业项目 ❌ 商业使用需授权 这是一个类似 CC-BY-NC-SA 的开源协议，鼓励学习、分享和贡献！ 详细协议： https://github.com/dtsola/xiaoyaosearch/blob/main/LICENSE 版本历史 v2.0.0 (2026-04-24) - UI 视觉系统升级版 🎨 核心升级 ： ✅ Notion 温暖明亮设计风格 ✅ 系统字体栈（零网络依赖） ✅ Lucide Icons 图标系统（ 1000+） ✅ 完整设计系统规范 ✅ 所有页面 UI 全面升级（ 10 个页面/组件） ✅ 响应式设计完善 v1.9.0 (2026-04-12) - 搜索优化版 ✅ 术语扩展时机优化 ✅ 智能合并去重 ✅ 并发控制优化 ✅ 专业术语召回率提升 60% v1.8.0 (2026-04-08) - 钉钉文档支持 ✅ 钉钉文档数据源支持 ✅ 元数据文件解析（.xyddjson 格式） ✅ 原文链接跳转功能 v1.7.0 (2026-03-31) - 飞书文档支持 ✅ 飞书文档数据源支持 ✅ 元数据块解析 ✅ 原文链接跳转功能 v1.6.0 (2026-03-26) - 云端嵌入模型 ✅ 云端嵌入模型调用能力 ✅ 本地/云端互斥切换 ✅ 批量文本嵌入优化 v1.5.0 (2026-03-20) - Agent Skills ✅ MCP Agent Skills 支持 ✅ 为 Claude Code/VS Code/Cursor 提供工具调用能力 v1.4.0 (2026-03-15) - MCP 服务器支持 ✅ MCP 协议支持 ✅ 可被 Claude Desktop 连接 ✅ SSE 传输方式 v1.3.0 (2026-03-10) - OpenAI 云端模型 ✅ OpenAI 兼容云端大模型 ✅ 动态表单配置 ✅ API 密钥加密存储 v1.2.0 (2026-03-05) - 插件化架构 ✅ 插件化架构框架 ✅ 语雀知识库数据源 v1.1.0 (2026-02-28) - i18n 国际化 ✅ 中英文双语支持 ✅ i18n 框架集成 v1.0.0 (2026-02-20) - MVP 版本 ✅ 多模态搜索（文本/语音/图像） ✅ 本地文件深度检索 ✅ BGE-M3 + FasterWhisper + CN-CLIP ✅ Faiss + Whoosh 混合搜索 结语 小遥搜索 v2.0.0 是我们对本地 AI 搜索工具的一次重大升级。 v1.x 时代 ：我们实现了核心的 AI 搜索能力，打造了稳定可用的本地搜索工具。 v2.0.0 时代 ：我们全面升级了视觉体验，建立了完整的设计系统，让产品不仅强大，而且美观易用。 未来 ：我们会持续优化性能，增加更多数据源，引入更多 AI 能力，让小遥搜索成为知识工作者的必备工具。 无论你是： 🔨 想要贡献代码的开发者 💡 想要提供建议的产品经理 📖 想要学习 AI 应用的学生 🚀 想要参与创业的伙伴 都欢迎加入我们，一起打造更好的本地 AI 搜索工具！ 让我们一起，用 AI 技术改变知识管理方式！ 🚀
前言 经过几个月的精心打磨， 小遥搜索 XiaoyaoSearch v2.0.0 今天正式发布了！ 这是一个重大版本更新，带来了全新的 Notion 温暖明亮设计风格 ，完整的 设计系统规范 ，以及全面的 UI 视觉升级 。 相比 v1.x 版本，v2.0.0 不仅保留了强大的多模态 AI 搜索能力，更在视觉体验上实现了 质的飞跃 。 v2.0.0 有什么不同？ 🎨 全新设计系统 Notion 温暖明亮设计风格 借鉴 Notion 的设计理念，打造专业、舒适、高效的视觉体验： 纯白背景 #ffffff + 温暖白 #f6f5f4：营造干净舒适的视觉环境 品牌蓝色 #0075de：统一品牌色调，提升识别度 超细边框 rgba(0,0,0,0.1)：柔和过渡，精致细节 多层阴影堆叠 ：4-5 层阴影，增强视觉层次感 视觉体验提升数据 ： 指标 v1.x v2.0 提升 视觉舒适度 60% 100% +67% 品牌识别度 50% 100% +100% 信息可读性 60% 100% +67% 专业度感知 60% 100% +67% 🔤 系统字体栈（零网络依赖） 告别 Google Fonts ，拥抱系统字体 v1.x 版本使用 Google Fonts CDN 加载字体，存在网络依赖和性能问题。v2.0.0 采用精心挑选的系统字体栈： font-family: -apple-system, /* Apple 系统字体 */ BlinkMacSystemFont, /* macOS Chrome */ "SF Pro Text", /* macOS 专业字体 */ "Segoe UI", /* Windows 系统字体 */ "PingFang SC", /* Apple 中文字体 */ "Microsoft YaHei", /* Windows 中文字体 */ sans-serif; /* 后备字体 */ 性能对比 ： 指标 v1.x （ Google Fonts ） v2.0 （系统字体） 提升 字体加载时间 200-500ms <10ms +98% 首屏渲染时间 2.0-2.5s <2.0s +20% 网络请求数 +2 个 0 个 +100% 离线可用性 否 是 ✅ 🎯 Lucide Icons 图标系统 1000+ 图标，统一视觉语言 采用 Lucide Icons 作为标准图标库，通过 @ iconify /vue 集成： 图标数量 ：1000+ 图标，持续更新 设计风格 ：现代简洁，线条优雅 可定制性 ：支持颜色、大小、粗细调整 按需加载 ：自动按需加载，无性能损耗 📐 完整设计系统规范 CSS Variables + Design Tokens 建立完整的设计令牌系统，确保设计一致性： /* 颜色系统 */ --bg-primary: #ffffff; /* 主背景 */ --bg-secondary: #f6f5f4; /* 次级背景 */ --text-primary: rgba(0,0,0,0.95); /* 主文字 */ --text-secondary: #615d59; /* 次要文字 */ --brand-blue: #0075de; /* 品牌蓝色 */ --border-standard: rgba(0,0,0,0.1); /* 标准边框 */ /* 间距系统（ 8px 基准） */ --space-xs: 4px; --space-sm: 8px; --space-md: 12px; --space-lg: 16px; --space-xl: 20px; --space-2xl: 24px; --space-3xl: 32px; /* 圆角系统 */ --radius-sm: 4px; --radius-md: 6px; --radius-lg: 10px; --radius-xl: 12px; /* 阴影系统 */ --shadow-card: 0 1px 2px rgba(0,0,0,0.04), 0 2px 4px rgba(0,0,0,0.04), 0 4px 8px rgba(0,0,0,0.04), 0 8px 16px rgba(0,0,0,0.04); --shadow-elevated: 0 2px 4px rgba(0,0,0,0.05), 0 4px 8px rgba(0,0,0,0.05), 0 8px 16px rgba(0,0,0,0.05), 0 16px 32px rgba(0,0,0,0.05); ✨ 所有页面 UI 升级 10 个页面/组件全面升级 ： 页面/组件 主要升级 顶部导航栏 Logo 、导航菜单、右侧操作区全新设计 底部状态栏 索引统计、搜索统计、数据统计信息展示 搜索首页 搜索区域、多模态指示器、结果列表精致卡片 搜索结果卡片 卡片样式、图标、标签、操作按钮 设置页面 标签页、表单、开关全新设计 索引管理页面 统计卡片、索引列表、模态框样式升级 术语库管理页面 列表、创建/编辑模态框、表单优化 术语管理页面 列表、CSV 导入、表单样式全面升级 帮助页面 FAQ 、折叠面板、搜索功能升级 关于作者页面 作者信息、联系方式、二维码展示优化 小遥搜索是什么？ 简单来说，它是一个 本地 AI 搜索桌面应用 ，核心特点： 🎤 多模态输入 语音搜索 ：点一下录音，说出你要找的内容，30 秒内语音自动转文字搜索 文本搜索 ：输入关键词，AI 理解语义，精准匹配文件内容 图片搜索 ：上传一张图片，AI 理解图像内容，帮你搜索相关文件 🔍 深度检索 文档 ：TXT 、Markdown 、Word 、Excel 、PPT 、PDF 全文检索 音视频 ：MP4 、AVI 、MP3 、WAV 内容索引和搜索 文件名 ：传统的文件名搜索也不缺席 🧠 AI 技术 集成了多个先进 AI 模型： BGE-M3 ：文本嵌入，理解语义 FasterWhisper ：语音识别，语音转文字 CN-CLIP ：图像理解，以图搜图 Ollama ：本地大语言模型 OpenAI/DeepSeek/阿里云 ：云端大模型（可选） 🎨 v2.0.0 全新 UI Notion 温暖明亮设计风格 ：专业、舒适、高效 系统字体栈 ：零网络依赖，加载速度 < 10ms Lucide Icons ：1000+ 图标，统一视觉语言 完整设计系统 ：确保设计一致性 🔒 隐私安全 完全本地 ：所有数据处理都在本地，不上传云端 隐私模式 ：可选不记录搜索历史 自主可控 ：数据完全由你自己掌控 核心界面一览 搜索主界面（ v2.0.0 全新设计） 设计亮点 ： 居中布局，视觉焦点集中 多模态指示器，清晰展示输入模式 搜索框圆角设计，蓝色光晕效果 结果卡片精致阴影，悬停加深 文本搜索 功能特点 ： 实时搜索结果展示 匹配度高亮显示 支持语义理解和关键词匹配 一键打开文件或定位文件夹 语音搜索 功能特点 ： 30 秒内语音录制 自动语音转文字 支持中英文混合输入 智能语义理解 图片搜索 功能特点 ： 上传图片即可搜索 AI 理解图像内容 支持相似图片匹配 以图搜图，精准定位 索引管理界面（ v2.0.0 全新设计） 设计亮点 ： 统计卡片，悬停提升效果 索引列表，精致阴影堆叠 操作菜单，流畅动画过渡 功能特点 ： 实时索引状态监控 文件夹路径管理 一键重建索引 索引进度可视化 设置界面（ v2.0.0 全新设计） 设计亮点 ： 标签页，次级背景，激活状态清晰 表单布局，标签左对齐，必填标记红色 开关控件，品牌蓝色，平滑过渡 功能特点 ： AI 模型配置 数据源管理 搜索偏好设置 界面主题选择 术语库管理界面（ v2.0.0 新增） 功能亮点 ： 多术语库集合管理 术语同义词扩展 CSV 导入/导出 预置专业术语库（ IT 、产品、医疗、法律） 使用场景 ： 产品经理：PRD 、产品需求文档、产品规格书 医生：CT 、计算机断层扫描、CT 扫描 开发者：API 、应用程序接口、接口文档 法律从业者：合同、协议、契约 技术架构 v2.0.0 技术亮点 新增技术栈 ： @iconify/vue ：图标按需加载系统 CSS Variables ：完整设计令牌系统 Design Tokens ：TypeScript 类型定义 系统字体栈 ：零网络依赖字体方案 性能优化 ： 字体加载时间 < 10ms （ vs 200-500ms ） 首屏渲染时间 < 2.0s （ vs 2.0-2.5s ） 网络请求数 -2 个（移除 Google Fonts ） 离线可用性 ✅ 版本对比：v1.x vs v2.0.0 设计对比 方面 v1.x v2.0.0 设计风格 Ant Design 默认风格 Notion 温暖明亮风格 字体方案 Google Fonts （网络依赖） 系统字体栈（零依赖） 图标系统 Ant Design Icons （ 300+） Lucide Icons （ 1000+） 阴影效果 简单阴影 4-5 层堆叠阴影 边框样式 标准边框 超细边框（ whisper ） 圆角系统 混合使用 统一规范（ 4/6/10/12px ） 动画效果 基础过渡 精致动画（ fadeInUp 、hover ） 响应式设计 部分支持 完整支持（桌面/平板/移动） 功能对比 功能 v1.x v2.0.0 多模态搜索 ✅ ✅ 本地文件检索 ✅ ✅ AI 模型配置 ✅ ✅ 插件化架构 ✅ ✅ 数据源扩展 ✅ 语雀、飞书、钉钉 ✅ + 语雀、飞书、钉钉 术语库系统 ✅ ✅ + UI 升级 MCP 服务器 ✅ ✅ Agent Skills ✅ ✅ UI 视觉系统 基础 全面升级 快速体验 环境要求 操作系统 ：Windows / MacOS / Linux Python ：3.10.11+ Node.js ：21.x+ 内存 ：建议 16GB 以上（ 8GB 可用） 显卡 ：建议 RTX3060 6GB 以上（可选） 安装步骤 方式一：整合包部署（推荐） 下载整合包 ： 从百度网盘下载最新的 Windows 整合包： 链接： https://pan.baidu.com/s/1lDaWjMCRXIT-Sqx9UFjerg?pwd=37ed 提取码：37ed 安装步骤 ： 解压整合包到任意目录 运行 scripts/setup.bat 自动安装依赖 安装并启动 Ollama 下载 AI 模型 运行 scripts/startup.bat 启动应用 方式二：开发者部署 1. 克隆项目 git clone https://github.com/dtsola/xiaoyaosearch.git cd xiaoyaosearch 2. 后端启动 cd backend pip install -r requirements.txt python main.py 3. 前端启动 cd frontend npm install npm run dev 详细安装指南： https://github.com/dtsola/xiaoyaosearch/blob/main/README.md 产品路线图 当前版本（ v2.0.0 ）✅ 核心功能 ： ✅ 多模态 AI 搜索（语音、文本、图片） ✅ 本地文件深度检索 ✅ AI 模型灵活配置（本地/云端） ✅ Notion 温暖明亮设计风格 ✅ 系统字体栈（零网络依赖） ✅ Lucide Icons 图标系统（ 1000+） ✅ 完整设计系统规范 ✅ 插件化架构（语雀、飞书、钉钉） ✅ 专业术语库系统 ✅ MCP 服务器支持 ✅ Agent Skills 支持 UI 升级亮点 ： ✅ 所有页面/组件 UI 全面升级 ✅ 视觉舒适度提升 67% ✅ 品牌识别度提升 100% ✅ 信息可读性提升 67% ✅ 专业度感知提升 67% 未来规划 🎨 UI/UX 持续优化 暗色模式支持（用户呼声最高的功能） 自定义主题配色 更多动画效果和过渡 🚀 性能优化 大文件处理优化 索引构建速度提升 内存占用优化 🔌 更多数据源支持 Notion 知识库 GitHub 代码仓库 GitLab 代码仓库 Confluence Wiki 🧠 AI 能力增强 自适应分块算法 知识图谱构建 RAG 系统升级 💬 智能聊天助手 多轮对话和上下文记忆 基于本地知识库的问答 自然语言交互 详细路线图： https://github.com/dtsola/xiaoyaosearch/blob/main/ROADMAP.md 适合谁使用？ 知识工作者 搜索本地文档、笔记、研究报告，快速定位关键信息 使用场景 ： 搜索产品需求文档（ PRD ） 查找技术方案和架构文档 检索会议记录和决策文档 整理项目资料和学习笔记 内容创作者 搜索素材和灵感，整理音视频内容，管理创作资源 使用场景 ： 搜索视频脚本和分镜 查找音频素材和音效 整理设计素材和灵感 管理项目资源和交付物 技术开发者 搜索代码库和技术文档，整理学习资料，管理项目文件 使用场景 ： 搜索代码片段和技术实现 查找 API 文档和使用示例 整理学习资料和教程 管理项目文件和依赖 研究人员 搜索论文和研究资料，整理文献笔记，管理研究数据 使用场景 ： 搜索论文和参考文献 查找实验数据和结果 整理文献笔记和观点 管理研究项目资料 为什么选择小遥搜索？ 🎯 专为知识工作者设计 多模态输入 ：语音、文本、图片，用最自然的方式搜索 语义理解 ：AI 理解你的意图，不只是关键词匹配 深度检索 ：搜索文件内容，不只是文件名 🔒 隐私安全优先 100% 本地 ：所有数据处理都在本地，不上传云端 隐私模式 ：可选不记录搜索历史 自主可控 ：数据完全由你自己掌控 🧠 AI 技术领先 多模型集成 ：BGE-M3 + FasterWhisper + CN-CLIP + Ollama 云端可选 ：支持 OpenAI/DeepSeek/阿里云等云端模型 持续升级 ：AI 模型和技术持续更新 🎨 v2.0.0 视觉体验 温暖明亮 ：Notion 设计风格，专业舒适 精致细节 ：多层阴影、超细边框、流畅动画 品牌识别 ：统一的视觉语言，提升专业度 高性能 ：零网络依赖，加载速度极快 🤖 开发者友好 100% 开源 ：所有源码、文档、开发经验全部开源 插件化架构 ：支持自定义扩展和数据源 MCP 支持 ：可被 Claude Desktop 等 AI 应用连接 Vibe Coding 案例 ：完整的 AI 辅助开发实践 Vibe Coding 实践案例 100% AI 辅助开发 这个项目从零开始， 完全通过 Vibe Coding 实现 ，包括： ✅ 完整源代码（前端 + 后端 + 所有功能模块） ✅ 设计文档（ PRD 、技术方案、数据库设计、API 文档） ✅ 开发流程（任务分解、进度跟踪、测试验证） ✅ 部署配置（环境搭建、依赖管理、打包发布） ✅ v2.0.0 UI 视觉系统全面升级 开源的价值 对于想要学习以下内容的开发者，这是一个完整的参考实现： AI 辅助开发实践 ：如何用 AI 实现完整项目 Electron 桌面应用 ：从零构建桌面应用 Vue 3 前端开发 ：Composition API + TypeScript Python FastAPI 后端 ：异步架构 + AI 模型集成 设计系统构建 ：从零建立完整设计规范 插件化架构 ：可扩展的插件系统设计 MCP 协议实现 ：AI 应用集成最佳实践 项目亮点总结 技术亮点 多模态 AI 搜索 ：语音、文本、图片三种输入方式 深度文件检索 ：支持文档、音视频的内容和文件名搜索 AI 模型集成 ：BGE-M3 、FasterWhisper 、CN-CLIP 、Ollama 插件化架构 ：支持语雀、飞书、钉钉等数据源 MCP 协议支持 ：可被 Claude Desktop 等 AI 应用连接 v2.0.0 UI 视觉升级 ：Notion 设计风格 + 完整设计系统 设计亮点（ v2.0.0 ） Notion 温暖明亮风格 ：专业、舒适、高效 系统字体栈 ：零网络依赖，最优性能 Lucide Icons ：1000+ 图标，统一视觉语言 多层阴影堆叠 ：4-5 层精致阴影 完整设计系统 ：确保设计一致性 响应式设计 ：完美适配各种设备 开源亮点 100% AI 辅助开发 ：完整的 Vibe Coding 实践案例 完整技术栈 ：前端 + 后端 + AI 模型 详尽文档 ：PRD 、技术方案、API 文档、数据库设计 插件化架构 ：可扩展的插件系统设计 持续更新 ：活跃开发，功能持续增强 邀请你参与 为什么需要你？ 一个人的力量有限，开源社区的力量是无限的！ 优先贡献方向 🎨 UI/UX 优化（高优先级） 暗黑模式支持 （用户呼声最高） 设计暗黑主题配色方案 实现主题切换功能 优化暗黑模式下的视觉体验 自定义主题配色 允许用户自定义品牌色 提供多种预设配色方案 支持导入导出主题配置 更多动画效果 页面切换动画 加载动画优化 微交互动画效果 🔌 更多数据源支持（高优先级） Notion 知识库 Notion API 集成 元数据解析 原文链接跳转 GitHub/GitLab 代码仓库搜索 Wiki 文档索引 Issue 和 PR 检索 ⚡ 性能优化（中优先级） 大文件处理优化 分块索引策略 流式读取优化 内存占用控制 索引构建速度提升 并行索引构建 增量索引更新 智能缓存机制 🧪 测试覆盖（中优先级） 单元测试补充 核心模块测试覆盖 边界条件测试 错误处理测试 集成测试完善 端到端测试场景 跨平台兼容性测试 性能基准测试 如何贡献？ # 1. Fork 项目 git clone https://github.com/dtsola/xiaoyaosearch.git cd xiaoyaosearch # 2. 创建分支 git checkout -b feature/your-feature-name # 3. 进行开发 # 按照项目代码规范开发 # 确保代码有适当注释 # 运行测试确保功能正常 # 4. 提交代码 git add . git commit -m "feat(scope): 简洁描述你的改动" git push origin feature/your-feature-name # 5. 提交 Pull Request # 在 GitHub 上创建 PR ，详细描述改动内容 贡献者权益 📝 在贡献者列表中展示你的名字 🏆 对项目有重大贡献者可成为核心维护者 💼 优秀贡献者可获得推荐信或工作机会 🎁 顶级贡献者可获得项目周边礼品 项目地址 GitHub ： https://github.com/dtsola/xiaoyaosearch 欢迎： ⭐️ Star 本项目，关注最新进展 🍴 Fork 本项目，开始你的贡献 👀 Watch 本项目，及时获取更新 🐛 提 Issue ，报告问题和建议功能 💡 参与讨论 ，分享你的想法 关于我 dtsola - IT 解决方案架构师 | 一人公司实践者 网站 ： https://www.dtsola.com B 站 ： https://space.bilibili.com/736015 开源协议 本项目采用 小遥搜索软件授权协议 ： ✅ 免费使用（非商业用途） ✅ 可以学习和研究代码 ✅ 可以修改后二次分发（需保留版权声明和协议） ✅ 可以集成到其他非商业项目 ❌ 商业使用需授权 这是一个类似 CC-BY-NC-SA 的开源协议，鼓励学习、分享和贡献！ 详细协议： https://github.com/dtsola/xiaoyaosearch/blob/main/LICENSE 版本历史 v2.0.0 (2026-04-24) - UI 视觉系统升级版 🎨 核心升级 ： ✅ Notion 温暖明亮设计风格 ✅ 系统字体栈（零网络依赖） ✅ Lucide Icons 图标系统（ 1000+） ✅ 完整设计系统规范 ✅ 所有页面 UI 全面升级（ 10 个页面/组件） ✅ 响应式设计完善 v1.9.0 (2026-04-12) - 搜索优化版 ✅ 术语扩展时机优化 ✅ 智能合并去重 ✅ 并发控制优化 ✅ 专业术语召回率提升 60% v1.8.0 (2026-04-08) - 钉钉文档支持 ✅ 钉钉文档数据源支持 ✅ 元数据文件解析（.xyddjson 格式） ✅ 原文链接跳转功能 v1.7.0 (2026-03-31) - 飞书文档支持 ✅ 飞书文档数据源支持 ✅ 元数据块解析 ✅ 原文链接跳转功能 v1.6.0 (2026-03-26) - 云端嵌入模型 ✅ 云端嵌入模型调用能力 ✅ 本地/云端互斥切换 ✅ 批量文本嵌入优化 v1.5.0 (2026-03-20) - Agent Skills ✅ MCP Agent Skills 支持 ✅ 为 Claude Code/VS Code/Cursor 提供工具调用能力 v1.4.0 (2026-03-15) - MCP 服务器支持 ✅ MCP 协议支持 ✅ 可被 Claude Desktop 连接 ✅ SSE 传输方式 v1.3.0 (2026-03-10) - OpenAI 云端模型 ✅ OpenAI 兼容云端大模型 ✅ 动态表单配置 ✅ API 密钥加密存储 v1.2.0 (2026-03-05) - 插件化架构 ✅ 插件化架构框架 ✅ 语雀知识库数据源 v1.1.0 (2026-02-28) - i18n 国际化 ✅ 中英文双语支持 ✅ i18n 框架集成 v1.0.0 (2026-02-20) - MVP 版本 ✅ 多模态搜索（文本/语音/图像） ✅ 本地文件深度检索 ✅ BGE-M3 + FasterWhisper + CN-CLIP ✅ Faiss + Whoosh 混合搜索 结语 小遥搜索 v2.0.0 是我们对本地 AI 搜索工具的一次重大升级。 v1.x 时代 ：我们实现了核心的 AI 搜索能力，打造了稳定可用的本地搜索工具。 v2.0.0 时代 ：我们全面升级了视觉体验，建立了完整的设计系统，让产品不仅强大，而且美观易用。 未来 ：我们会持续优化性能，增加更多数据源，引入更多 AI 能力，让小遥搜索成为知识工作者的必备工具。 无论你是： 🔨 想要贡献代码的开发者 💡 想要提供建议的产品经理 📖 想要学习 AI 应用的学生 🚀 想要参与创业的伙伴 都欢迎加入我们，一起打造更好的本地 AI 搜索工具！ 让我们一起，用 AI 技术改变知识管理方式！ 🚀
前言 经过几个月的精心打磨， 小遥搜索 XiaoyaoSearch v2.0.0 今天正式发布了！ 这是一个重大版本更新，带来了全新的 Notion 温暖明亮设计风格 ，完整的 设计系统规范 ，以及全面的 UI 视觉升级 。 相比 v1.x 版本，v2.0.0 不仅保留了强大的多模态 AI 搜索能力，更在视觉体验上实现了 质的飞跃 。 v2.0.0 有什么不同？ 🎨 全新设计系统 Notion 温暖明亮设计风格 借鉴 Notion 的设计理念，打造专业、舒适、高效的视觉体验： 纯白背景 #ffffff + 温暖白 #f6f5f4：营造干净舒适的视觉环境 品牌蓝色 #0075de：统一品牌色调，提升识别度 超细边框 rgba(0,0,0,0.1)：柔和过渡，精致细节 多层阴影堆叠 ：4-5 层阴影，增强视觉层次感 视觉体验提升数据 ： 指标 v1.x v2.0 提升 视觉舒适度 60% 100% +67% 品牌识别度 50% 100% +100% 信息可读性 60% 100% +67% 专业度感知 60% 100% +67% 🔤 系统字体栈（零网络依赖） 告别 Google Fonts ，拥抱系统字体 v1.x 版本使用 Google Fonts CDN 加载字体，存在网络依赖和性能问题。v2.0.0 采用精心挑选的系统字体栈： font-family: -apple-system, /* Apple 系统字体 */ BlinkMacSystemFont, /* macOS Chrome */ "SF Pro Text", /* macOS 专业字体 */ "Segoe UI", /* Windows 系统字体 */ "PingFang SC", /* Apple 中文字体 */ "Microsoft YaHei", /* Windows 中文字体 */ sans-serif; /* 后备字体 */ 性能对比 ： 指标 v1.x （ Google Fonts ） v2.0 （系统字体） 提升 字体加载时间 200-500ms <10ms +98% 首屏渲染时间 2.0-2.5s <2.0s +20% 网络请求数 +2 个 0 个 +100% 离线可用性 否 是 ✅ 🎯 Lucide Icons 图标系统 1000+ 图标，统一视觉语言 采用 Lucide Icons 作为标准图标库，通过 @ iconify /vue 集成： 图标数量 ：1000+ 图标，持续更新 设计风格 ：现代简洁，线条优雅 可定制性 ：支持颜色、大小、粗细调整 按需加载 ：自动按需加载，无性能损耗 📐 完整设计系统规范 CSS Variables + Design Tokens 建立完整的设计令牌系统，确保设计一致性： /* 颜色系统 */ --bg-primary: #ffffff; /* 主背景 */ --bg-secondary: #f6f5f4; /* 次级背景 */ --text-primary: rgba(0,0,0,0.95); /* 主文字 */ --text-secondary: #615d59; /* 次要文字 */ --brand-blue: #0075de; /* 品牌蓝色 */ --border-standard: rgba(0,0,0,0.1); /* 标准边框 */ /* 间距系统（ 8px 基准） */ --space-xs: 4px; --space-sm: 8px; --space-md: 12px; --space-lg: 16px; --space-xl: 20px; --space-2xl: 24px; --space-3xl: 32px; /* 圆角系统 */ --radius-sm: 4px; --radius-md: 6px; --radius-lg: 10px; --radius-xl: 12px; /* 阴影系统 */ --shadow-card: 0 1px 2px rgba(0,0,0,0.04), 0 2px 4px rgba(0,0,0,0.04), 0 4px 8px rgba(0,0,0,0.04), 0 8px 16px rgba(0,0,0,0.04); --shadow-elevated: 0 2px 4px rgba(0,0,0,0.05), 0 4px 8px rgba(0,0,0,0.05), 0 8px 16px rgba(0,0,0,0.05), 0 16px 32px rgba(0,0,0,0.05); ✨ 所有页面 UI 升级 10 个页面/组件全面升级 ： 页面/组件 主要升级 顶部导航栏 Logo 、导航菜单、右侧操作区全新设计 底部状态栏 索引统计、搜索统计、数据统计信息展示 搜索首页 搜索区域、多模态指示器、结果列表精致卡片 搜索结果卡片 卡片样式、图标、标签、操作按钮 设置页面 标签页、表单、开关全新设计 索引管理页面 统计卡片、索引列表、模态框样式升级 术语库管理页面 列表、创建/编辑模态框、表单优化 术语管理页面 列表、CSV 导入、表单样式全面升级 帮助页面 FAQ 、折叠面板、搜索功能升级 关于作者页面 作者信息、联系方式、二维码展示优化 小遥搜索是什么？ 简单来说，它是一个 本地 AI 搜索桌面应用 ，核心特点： 🎤 多模态输入 语音搜索 ：点一下录音，说出你要找的内容，30 秒内语音自动转文字搜索 文本搜索 ：输入关键词，AI 理解语义，精准匹配文件内容 图片搜索 ：上传一张图片，AI 理解图像内容，帮你搜索相关文件 🔍 深度检索 文档 ：TXT 、Markdown 、Word 、Excel 、PPT 、PDF 全文检索 音视频 ：MP4 、AVI 、MP3 、WAV 内容索引和搜索 文件名 ：传统的文件名搜索也不缺席 🧠 AI 技术 集成了多个先进 AI 模型： BGE-M3 ：文本嵌入，理解语义 FasterWhisper ：语音识别，语音转文字 CN-CLIP ：图像理解，以图搜图 Ollama ：本地大语言模型 OpenAI/DeepSeek/阿里云 ：云端大模型（可选） 🎨 v2.0.0 全新 UI Notion 温暖明亮设计风格 ：专业、舒适、高效 系统字体栈 ：零网络依赖，加载速度 < 10ms Lucide Icons ：1000+ 图标，统一视觉语言 完整设计系统 ：确保设计一致性 🔒 隐私安全 完全本地 ：所有数据处理都在本地，不上传云端 隐私模式 ：可选不记录搜索历史 自主可控 ：数据完全由你自己掌控 核心界面一览 搜索主界面（ v2.0.0 全新设计） 设计亮点 ： 居中布局，视觉焦点集中 多模态指示器，清晰展示输入模式 搜索框圆角设计，蓝色光晕效果 结果卡片精致阴影，悬停加深 文本搜索 功能特点 ： 实时搜索结果展示 匹配度高亮显示 支持语义理解和关键词匹配 一键打开文件或定位文件夹 语音搜索 功能特点 ： 30 秒内语音录制 自动语音转文字 支持中英文混合输入 智能语义理解 图片搜索 功能特点 ： 上传图片即可搜索 AI 理解图像内容 支持相似图片匹配 以图搜图，精准定位 索引管理界面（ v2.0.0 全新设计） 设计亮点 ： 统计卡片，悬停提升效果 索引列表，精致阴影堆叠 操作菜单，流畅动画过渡 功能特点 ： 实时索引状态监控 文件夹路径管理 一键重建索引 索引进度可视化 设置界面（ v2.0.0 全新设计） 设计亮点 ： 标签页，次级背景，激活状态清晰 表单布局，标签左对齐，必填标记红色 开关控件，品牌蓝色，平滑过渡 功能特点 ： AI 模型配置 数据源管理 搜索偏好设置 界面主题选择 术语库管理界面（ v2.0.0 新增） 功能亮点 ： 多术语库集合管理 术语同义词扩展 CSV 导入/导出 预置专业术语库（ IT 、产品、医疗、法律） 使用场景 ： 产品经理：PRD 、产品需求文档、产品规格书 医生：CT 、计算机断层扫描、CT 扫描 开发者：API 、应用程序接口、接口文档 法律从业者：合同、协议、契约 技术架构 v2.0.0 技术亮点 新增技术栈 ： @iconify/vue ：图标按需加载系统 CSS Variables ：完整设计令牌系统 Design Tokens ：TypeScript 类型定义 系统字体栈 ：零网络依赖字体方案 性能优化 ： 字体加载时间 < 10ms （ vs 200-500ms ） 首屏渲染时间 < 2.0s （ vs 2.0-2.5s ） 网络请求数 -2 个（移除 Google Fonts ） 离线可用性 ✅ 版本对比：v1.x vs v2.0.0 设计对比 方面 v1.x v2.0.0 设计风格 Ant Design 默认风格 Notion 温暖明亮风格 字体方案 Google Fonts （网络依赖） 系统字体栈（零依赖） 图标系统 Ant Design Icons （ 300+） Lucide Icons （ 1000+） 阴影效果 简单阴影 4-5 层堆叠阴影 边框样式 标准边框 超细边框（ whisper ） 圆角系统 混合使用 统一规范（ 4/6/10/12px ） 动画效果 基础过渡 精致动画（ fadeInUp 、hover ） 响应式设计 部分支持 完整支持（桌面/平板/移动） 功能对比 功能 v1.x v2.0.0 多模态搜索 ✅ ✅ 本地文件检索 ✅ ✅ AI 模型配置 ✅ ✅ 插件化架构 ✅ ✅ 数据源扩展 ✅ 语雀、飞书、钉钉 ✅ + 语雀、飞书、钉钉 术语库系统 ✅ ✅ + UI 升级 MCP 服务器 ✅ ✅ Agent Skills ✅ ✅ UI 视觉系统 基础 全面升级 快速体验 环境要求 操作系统 ：Windows / MacOS / Linux Python ：3.10.11+ Node.js ：21.x+ 内存 ：建议 16GB 以上（ 8GB 可用） 显卡 ：建议 RTX3060 6GB 以上（可选） 安装步骤 方式一：整合包部署（推荐） 下载整合包 ： 从百度网盘下载最新的 Windows 整合包： 链接： https://pan.baidu.com/s/1lDaWjMCRXIT-Sqx9UFjerg?pwd=37ed 提取码：37ed 安装步骤 ： 解压整合包到任意目录 运行 scripts/setup.bat 自动安装依赖 安装并启动 Ollama 下载 AI 模型 运行 scripts/startup.bat 启动应用 方式二：开发者部署 1. 克隆项目 git clone https://github.com/dtsola/xiaoyaosearch.git cd xiaoyaosearch 2. 后端启动 cd backend pip install -r requirements.txt python main.py 3. 前端启动 cd frontend npm install npm run dev 详细安装指南： https://github.com/dtsola/xiaoyaosearch/blob/main/README.md 产品路线图 当前版本（ v2.0.0 ）✅ 核心功能 ： ✅ 多模态 AI 搜索（语音、文本、图片） ✅ 本地文件深度检索 ✅ AI 模型灵活配置（本地/云端） ✅ Notion 温暖明亮设计风格 ✅ 系统字体栈（零网络依赖） ✅ Lucide Icons 图标系统（ 1000+） ✅ 完整设计系统规范 ✅ 插件化架构（语雀、飞书、钉钉） ✅ 专业术语库系统 ✅ MCP 服务器支持 ✅ Agent Skills 支持 UI 升级亮点 ： ✅ 所有页面/组件 UI 全面升级 ✅ 视觉舒适度提升 67% ✅ 品牌识别度提升 100% ✅ 信息可读性提升 67% ✅ 专业度感知提升 67% 未来规划 🎨 UI/UX 持续优化 暗色模式支持（用户呼声最高的功能） 自定义主题配色 更多动画效果和过渡 🚀 性能优化 大文件处理优化 索引构建速度提升 内存占用优化 🔌 更多数据源支持 Notion 知识库 GitHub 代码仓库 GitLab 代码仓库 Confluence Wiki 🧠 AI 能力增强 自适应分块算法 知识图谱构建 RAG 系统升级 💬 智能聊天助手 多轮对话和上下文记忆 基于本地知识库的问答 自然语言交互 详细路线图： https://github.com/dtsola/xiaoyaosearch/blob/main/ROADMAP.md 适合谁使用？ 知识工作者 搜索本地文档、笔记、研究报告，快速定位关键信息 使用场景 ： 搜索产品需求文档（ PRD ） 查找技术方案和架构文档 检索会议记录和决策文档 整理项目资料和学习笔记 内容创作者 搜索素材和灵感，整理音视频内容，管理创作资源 使用场景 ： 搜索视频脚本和分镜 查找音频素材和音效 整理设计素材和灵感 管理项目资源和交付物 技术开发者 搜索代码库和技术文档，整理学习资料，管理项目文件 使用场景 ： 搜索代码片段和技术实现 查找 API 文档和使用示例 整理学习资料和教程 管理项目文件和依赖 研究人员 搜索论文和研究资料，整理文献笔记，管理研究数据 使用场景 ： 搜索论文和参考文献 查找实验数据和结果 整理文献笔记和观点 管理研究项目资料 为什么选择小遥搜索？ 🎯 专为知识工作者设计 多模态输入 ：语音、文本、图片，用最自然的方式搜索 语义理解 ：AI 理解你的意图，不只是关键词匹配 深度检索 ：搜索文件内容，不只是文件名 🔒 隐私安全优先 100% 本地 ：所有数据处理都在本地，不上传云端 隐私模式 ：可选不记录搜索历史 自主可控 ：数据完全由你自己掌控 🧠 AI 技术领先 多模型集成 ：BGE-M3 + FasterWhisper + CN-CLIP + Ollama 云端可选 ：支持 OpenAI/DeepSeek/阿里云等云端模型 持续升级 ：AI 模型和技术持续更新 🎨 v2.0.0 视觉体验 温暖明亮 ：Notion 设计风格，专业舒适 精致细节 ：多层阴影、超细边框、流畅动画 品牌识别 ：统一的视觉语言，提升专业度 高性能 ：零网络依赖，加载速度极快 🤖 开发者友好 100% 开源 ：所有源码、文档、开发经验全部开源 插件化架构 ：支持自定义扩展和数据源 MCP 支持 ：可被 Claude Desktop 等 AI 应用连接 Vibe Coding 案例 ：完整的 AI 辅助开发实践 Vibe Coding 实践案例 100% AI 辅助开发 这个项目从零开始， 完全通过 Vibe Coding 实现 ，包括： ✅ 完整源代码（前端 + 后端 + 所有功能模块） ✅ 设计文档（ PRD 、技术方案、数据库设计、API 文档） ✅ 开发流程（任务分解、进度跟踪、测试验证） ✅ 部署配置（环境搭建、依赖管理、打包发布） ✅ v2.0.0 UI 视觉系统全面升级 开源的价值 对于想要学习以下内容的开发者，这是一个完整的参考实现： AI 辅助开发实践 ：如何用 AI 实现完整项目 Electron 桌面应用 ：从零构建桌面应用 Vue 3 前端开发 ：Composition API + TypeScript Python FastAPI 后端 ：异步架构 + AI 模型集成 设计系统构建 ：从零建立完整设计规范 插件化架构 ：可扩展的插件系统设计 MCP 协议实现 ：AI 应用集成最佳实践 项目亮点总结 技术亮点 多模态 AI 搜索 ：语音、文本、图片三种输入方式 深度文件检索 ：支持文档、音视频的内容和文件名搜索 AI 模型集成 ：BGE-M3 、FasterWhisper 、CN-CLIP 、Ollama 插件化架构 ：支持语雀、飞书、钉钉等数据源 MCP 协议支持 ：可被 Claude Desktop 等 AI 应用连接 v2.0.0 UI 视觉升级 ：Notion 设计风格 + 完整设计系统 设计亮点（ v2.0.0 ） Notion 温暖明亮风格 ：专业、舒适、高效 系统字体栈 ：零网络依赖，最优性能 Lucide Icons ：1000+ 图标，统一视觉语言 多层阴影堆叠 ：4-5 层精致阴影 完整设计系统 ：确保设计一致性 响应式设计 ：完美适配各种设备 开源亮点 100% AI 辅助开发 ：完整的 Vibe Coding 实践案例 完整技术栈 ：前端 + 后端 + AI 模型 详尽文档 ：PRD 、技术方案、API 文档、数据库设计 插件化架构 ：可扩展的插件系统设计 持续更新 ：活跃开发，功能持续增强 邀请你参与 为什么需要你？ 一个人的力量有限，开源社区的力量是无限的！ 优先贡献方向 🎨 UI/UX 优化（高优先级） 暗黑模式支持 （用户呼声最高） 设计暗黑主题配色方案 实现主题切换功能 优化暗黑模式下的视觉体验 自定义主题配色 允许用户自定义品牌色 提供多种预设配色方案 支持导入导出主题配置 更多动画效果 页面切换动画 加载动画优化 微交互动画效果 🔌 更多数据源支持（高优先级） Notion 知识库 Notion API 集成 元数据解析 原文链接跳转 GitHub/GitLab 代码仓库搜索 Wiki 文档索引 Issue 和 PR 检索 ⚡ 性能优化（中优先级） 大文件处理优化 分块索引策略 流式读取优化 内存占用控制 索引构建速度提升 并行索引构建 增量索引更新 智能缓存机制 🧪 测试覆盖（中优先级） 单元测试补充 核心模块测试覆盖 边界条件测试 错误处理测试 集成测试完善 端到端测试场景 跨平台兼容性测试 性能基准测试 如何贡献？ # 1. Fork 项目 git clone https://github.com/dtsola/xiaoyaosearch.git cd xiaoyaosearch # 2. 创建分支 git checkout -b feature/your-feature-name # 3. 进行开发 # 按照项目代码规范开发 # 确保代码有适当注释 # 运行测试确保功能正常 # 4. 提交代码 git add . git commit -m "feat(scope): 简洁描述你的改动" git push origin feature/your-feature-name # 5. 提交 Pull Request # 在 GitHub 上创建 PR ，详细描述改动内容 贡献者权益 📝 在贡献者列表中展示你的名字 🏆 对项目有重大贡献者可成为核心维护者 💼 优秀贡献者可获得推荐信或工作机会 🎁 顶级贡献者可获得项目周边礼品 项目地址 GitHub ： https://github.com/dtsola/xiaoyaosearch 欢迎： ⭐️ Star 本项目，关注最新进展 🍴 Fork 本项目，开始你的贡献 👀 Watch 本项目，及时获取更新 🐛 提 Issue ，报告问题和建议功能 💡 参与讨论 ，分享你的想法 关于我 dtsola - IT 解决方案架构师 | 一人公司实践者 网站 ： https://www.dtsola.com B 站 ： https://space.bilibili.com/736015 开源协议 本项目采用 小遥搜索软件授权协议 ： ✅ 免费使用（非商业用途） ✅ 可以学习和研究代码 ✅ 可以修改后二次分发（需保留版权声明和协议） ✅ 可以集成到其他非商业项目 ❌ 商业使用需授权 这是一个类似 CC-BY-NC-SA 的开源协议，鼓励学习、分享和贡献！ 详细协议： https://github.com/dtsola/xiaoyaosearch/blob/main/LICENSE 版本历史 v2.0.0 (2026-04-24) - UI 视觉系统升级版 🎨 核心升级 ： ✅ Notion 温暖明亮设计风格 ✅ 系统字体栈（零网络依赖） ✅ Lucide Icons 图标系统（ 1000+） ✅ 完整设计系统规范 ✅ 所有页面 UI 全面升级（ 10 个页面/组件） ✅ 响应式设计完善 v1.9.0 (2026-04-12) - 搜索优化版 ✅ 术语扩展时机优化 ✅ 智能合并去重 ✅ 并发控制优化 ✅ 专业术语召回率提升 60% v1.8.0 (2026-04-08) - 钉钉文档支持 ✅ 钉钉文档数据源支持 ✅ 元数据文件解析（.xyddjson 格式） ✅ 原文链接跳转功能 v1.7.0 (2026-03-31) - 飞书文档支持 ✅ 飞书文档数据源支持 ✅ 元数据块解析 ✅ 原文链接跳转功能 v1.6.0 (2026-03-26) - 云端嵌入模型 ✅ 云端嵌入模型调用能力 ✅ 本地/云端互斥切换 ✅ 批量文本嵌入优化 v1.5.0 (2026-03-20) - Agent Skills ✅ MCP Agent Skills 支持 ✅ 为 Claude Code/VS Code/Cursor 提供工具调用能力 v1.4.0 (2026-03-15) - MCP 服务器支持 ✅ MCP 协议支持 ✅ 可被 Claude Desktop 连接 ✅ SSE 传输方式 v1.3.0 (2026-03-10) - OpenAI 云端模型 ✅ OpenAI 兼容云端大模型 ✅ 动态表单配置 ✅ API 密钥加密存储 v1.2.0 (2026-03-05) - 插件化架构 ✅ 插件化架构框架 ✅ 语雀知识库数据源 v1.1.0 (2026-02-28) - i18n 国际化 ✅ 中英文双语支持 ✅ i18n 框架集成 v1.0.0 (2026-02-20) - MVP 版本 ✅ 多模态搜索（文本/语音/图像） ✅ 本地文件深度检索 ✅ BGE-M3 + FasterWhisper + CN-CLIP ✅ Faiss + Whoosh 混合搜索 结语 小遥搜索 v2.0.0 是我们对本地 AI 搜索工具的一次重大升级。 v1.x 时代 ：我们实现了核心的 AI 搜索能力，打造了稳定可用的本地搜索工具。 v2.0.0 时代 ：我们全面升级了视觉体验，建立了完整的设计系统，让产品不仅强大，而且美观易用。 未来 ：我们会持续优化性能，增加更多数据源，引入更多 AI 能力，让小遥搜索成为知识工作者的必备工具。 无论你是： 🔨 想要贡献代码的开发者 💡 想要提供建议的产品经理 📖 想要学习 AI 应用的学生 🚀 想要参与创业的伙伴 都欢迎加入我们，一起打造更好的本地 AI 搜索工具！ 让我们一起，用 AI 技术改变知识管理方式！ 🚀
前言 经过几个月的精心打磨， 小遥搜索 XiaoyaoSearch v2.0.0 今天正式发布了！ 这是一个重大版本更新，带来了全新的 Notion 温暖明亮设计风格 ，完整的 设计系统规范 ，以及全面的 UI 视觉升级 。 相比 v1.x 版本，v2.0.0 不仅保留了强大的多模态 AI 搜索能力，更在视觉体验上实现了 质的飞跃 。 v2.0.0 有什么不同？ 🎨 全新设计系统 Notion 温暖明亮设计风格 借鉴 Notion 的设计理念，打造专业、舒适、高效的视觉体验： 纯白背景 #ffffff + 温暖白 #f6f5f4：营造干净舒适的视觉环境 品牌蓝色 #0075de：统一品牌色调，提升识别度 超细边框 rgba(0,0,0,0.1)：柔和过渡，精致细节 多层阴影堆叠 ：4-5 层阴影，增强视觉层次感 视觉体验提升数据 ： 指标 v1.x v2.0 提升 视觉舒适度 60% 100% +67% 品牌识别度 50% 100% +100% 信息可读性 60% 100% +67% 专业度感知 60% 100% +67% 🔤 系统字体栈（零网络依赖） 告别 Google Fonts ，拥抱系统字体 v1.x 版本使用 Google Fonts CDN 加载字体，存在网络依赖和性能问题。v2.0.0 采用精心挑选的系统字体栈： font-family: -apple-system, /* Apple 系统字体 */ BlinkMacSystemFont, /* macOS Chrome */ "SF Pro Text", /* macOS 专业字体 */ "Segoe UI", /* Windows 系统字体 */ "PingFang SC", /* Apple 中文字体 */ "Microsoft YaHei", /* Windows 中文字体 */ sans-serif; /* 后备字体 */ 性能对比 ： 指标 v1.x （ Google Fonts ） v2.0 （系统字体） 提升 字体加载时间 200-500ms <10ms +98% 首屏渲染时间 2.0-2.5s <2.0s +20% 网络请求数 +2 个 0 个 +100% 离线可用性 否 是 ✅ 🎯 Lucide Icons 图标系统 1000+ 图标，统一视觉语言 采用 Lucide Icons 作为标准图标库，通过 @ iconify /vue 集成： 图标数量 ：1000+ 图标，持续更新 设计风格 ：现代简洁，线条优雅 可定制性 ：支持颜色、大小、粗细调整 按需加载 ：自动按需加载，无性能损耗 📐 完整设计系统规范 CSS Variables + Design Tokens 建立完整的设计令牌系统，确保设计一致性： /* 颜色系统 */ --bg-primary: #ffffff; /* 主背景 */ --bg-secondary: #f6f5f4; /* 次级背景 */ --text-primary: rgba(0,0,0,0.95); /* 主文字 */ --text-secondary: #615d59; /* 次要文字 */ --brand-blue: #0075de; /* 品牌蓝色 */ --border-standard: rgba(0,0,0,0.1); /* 标准边框 */ /* 间距系统（ 8px 基准） */ --space-xs: 4px; --space-sm: 8px; --space-md: 12px; --space-lg: 16px; --space-xl: 20px; --space-2xl: 24px; --space-3xl: 32px; /* 圆角系统 */ --radius-sm: 4px; --radius-md: 6px; --radius-lg: 10px; --radius-xl: 12px; /* 阴影系统 */ --shadow-card: 0 1px 2px rgba(0,0,0,0.04), 0 2px 4px rgba(0,0,0,0.04), 0 4px 8px rgba(0,0,0,0.04), 0 8px 16px rgba(0,0,0,0.04); --shadow-elevated: 0 2px 4px rgba(0,0,0,0.05), 0 4px 8px rgba(0,0,0,0.05), 0 8px 16px rgba(0,0,0,0.05), 0 16px 32px rgba(0,0,0,0.05); ✨ 所有页面 UI 升级 10 个页面/组件全面升级 ： 页面/组件 主要升级 顶部导航栏 Logo 、导航菜单、右侧操作区全新设计 底部状态栏 索引统计、搜索统计、数据统计信息展示 搜索首页 搜索区域、多模态指示器、结果列表精致卡片 搜索结果卡片 卡片样式、图标、标签、操作按钮 设置页面 标签页、表单、开关全新设计 索引管理页面 统计卡片、索引列表、模态框样式升级 术语库管理页面 列表、创建/编辑模态框、表单优化 术语管理页面 列表、CSV 导入、表单样式全面升级 帮助页面 FAQ 、折叠面板、搜索功能升级 关于作者页面 作者信息、联系方式、二维码展示优化 小遥搜索是什么？ 简单来说，它是一个 本地 AI 搜索桌面应用 ，核心特点： 🎤 多模态输入 语音搜索 ：点一下录音，说出你要找的内容，30 秒内语音自动转文字搜索 文本搜索 ：输入关键词，AI 理解语义，精准匹配文件内容 图片搜索 ：上传一张图片，AI 理解图像内容，帮你搜索相关文件 🔍 深度检索 文档 ：TXT 、Markdown 、Word 、Excel 、PPT 、PDF 全文检索 音视频 ：MP4 、AVI 、MP3 、WAV 内容索引和搜索 文件名 ：传统的文件名搜索也不缺席 🧠 AI 技术 集成了多个先进 AI 模型： BGE-M3 ：文本嵌入，理解语义 FasterWhisper ：语音识别，语音转文字 CN-CLIP ：图像理解，以图搜图 Ollama ：本地大语言模型 OpenAI/DeepSeek/阿里云 ：云端大模型（可选） 🎨 v2.0.0 全新 UI Notion 温暖明亮设计风格 ：专业、舒适、高效 系统字体栈 ：零网络依赖，加载速度 < 10ms Lucide Icons ：1000+ 图标，统一视觉语言 完整设计系统 ：确保设计一致性 🔒 隐私安全 完全本地 ：所有数据处理都在本地，不上传云端 隐私模式 ：可选不记录搜索历史 自主可控 ：数据完全由你自己掌控 核心界面一览 搜索主界面（ v2.0.0 全新设计） 设计亮点 ： 居中布局，视觉焦点集中 多模态指示器，清晰展示输入模式 搜索框圆角设计，蓝色光晕效果 结果卡片精致阴影，悬停加深 文本搜索 功能特点 ： 实时搜索结果展示 匹配度高亮显示 支持语义理解和关键词匹配 一键打开文件或定位文件夹 语音搜索 功能特点 ： 30 秒内语音录制 自动语音转文字 支持中英文混合输入 智能语义理解 图片搜索 功能特点 ： 上传图片即可搜索 AI 理解图像内容 支持相似图片匹配 以图搜图，精准定位 索引管理界面（ v2.0.0 全新设计） 设计亮点 ： 统计卡片，悬停提升效果 索引列表，精致阴影堆叠 操作菜单，流畅动画过渡 功能特点 ： 实时索引状态监控 文件夹路径管理 一键重建索引 索引进度可视化 设置界面（ v2.0.0 全新设计） 设计亮点 ： 标签页，次级背景，激活状态清晰 表单布局，标签左对齐，必填标记红色 开关控件，品牌蓝色，平滑过渡 功能特点 ： AI 模型配置 数据源管理 搜索偏好设置 界面主题选择 术语库管理界面（ v2.0.0 新增） 功能亮点 ： 多术语库集合管理 术语同义词扩展 CSV 导入/导出 预置专业术语库（ IT 、产品、医疗、法律） 使用场景 ： 产品经理：PRD 、产品需求文档、产品规格书 医生：CT 、计算机断层扫描、CT 扫描 开发者：API 、应用程序接口、接口文档 法律从业者：合同、协议、契约 技术架构 v2.0.0 技术亮点 新增技术栈 ： @iconify/vue ：图标按需加载系统 CSS Variables ：完整设计令牌系统 Design Tokens ：TypeScript 类型定义 系统字体栈 ：零网络依赖字体方案 性能优化 ： 字体加载时间 < 10ms （ vs 200-500ms ） 首屏渲染时间 < 2.0s （ vs 2.0-2.5s ） 网络请求数 -2 个（移除 Google Fonts ） 离线可用性 ✅ 版本对比：v1.x vs v2.0.0 设计对比 方面 v1.x v2.0.0 设计风格 Ant Design 默认风格 Notion 温暖明亮风格 字体方案 Google Fonts （网络依赖） 系统字体栈（零依赖） 图标系统 Ant Design Icons （ 300+） Lucide Icons （ 1000+） 阴影效果 简单阴影 4-5 层堆叠阴影 边框样式 标准边框 超细边框（ whisper ） 圆角系统 混合使用 统一规范（ 4/6/10/12px ） 动画效果 基础过渡 精致动画（ fadeInUp 、hover ） 响应式设计 部分支持 完整支持（桌面/平板/移动） 功能对比 功能 v1.x v2.0.0 多模态搜索 ✅ ✅ 本地文件检索 ✅ ✅ AI 模型配置 ✅ ✅ 插件化架构 ✅ ✅ 数据源扩展 ✅ 语雀、飞书、钉钉 ✅ + 语雀、飞书、钉钉 术语库系统 ✅ ✅ + UI 升级 MCP 服务器 ✅ ✅ Agent Skills ✅ ✅ UI 视觉系统 基础 全面升级 快速体验 环境要求 操作系统 ：Windows / MacOS / Linux Python ：3.10.11+ Node.js ：21.x+ 内存 ：建议 16GB 以上（ 8GB 可用） 显卡 ：建议 RTX3060 6GB 以上（可选） 安装步骤 方式一：整合包部署（推荐） 下载整合包 ： 从百度网盘下载最新的 Windows 整合包： 链接： https://pan.baidu.com/s/1lDaWjMCRXIT-Sqx9UFjerg?pwd=37ed 提取码：37ed 安装步骤 ： 解压整合包到任意目录 运行 scripts/setup.bat 自动安装依赖 安装并启动 Ollama 下载 AI 模型 运行 scripts/startup.bat 启动应用 方式二：开发者部署 1. 克隆项目 git clone https://github.com/dtsola/xiaoyaosearch.git cd xiaoyaosearch 2. 后端启动 cd backend pip install -r requirements.txt python main.py 3. 前端启动 cd frontend npm install npm run dev 详细安装指南： https://github.com/dtsola/xiaoyaosearch/blob/main/README.md 产品路线图 当前版本（ v2.0.0 ）✅ 核心功能 ： ✅ 多模态 AI 搜索（语音、文本、图片） ✅ 本地文件深度检索 ✅ AI 模型灵活配置（本地/云端） ✅ Notion 温暖明亮设计风格 ✅ 系统字体栈（零网络依赖） ✅ Lucide Icons 图标系统（ 1000+） ✅ 完整设计系统规范 ✅ 插件化架构（语雀、飞书、钉钉） ✅ 专业术语库系统 ✅ MCP 服务器支持 ✅ Agent Skills 支持 UI 升级亮点 ： ✅ 所有页面/组件 UI 全面升级 ✅ 视觉舒适度提升 67% ✅ 品牌识别度提升 100% ✅ 信息可读性提升 67% ✅ 专业度感知提升 67% 未来规划 🎨 UI/UX 持续优化 暗色模式支持（用户呼声最高的功能） 自定义主题配色 更多动画效果和过渡 🚀 性能优化 大文件处理优化 索引构建速度提升 内存占用优化 🔌 更多数据源支持 Notion 知识库 GitHub 代码仓库 GitLab 代码仓库 Confluence Wiki 🧠 AI 能力增强 自适应分块算法 知识图谱构建 RAG 系统升级 💬 智能聊天助手 多轮对话和上下文记忆 基于本地知识库的问答 自然语言交互 详细路线图： https://github.com/dtsola/xiaoyaosearch/blob/main/ROADMAP.md 适合谁使用？ 知识工作者 搜索本地文档、笔记、研究报告，快速定位关键信息 使用场景 ： 搜索产品需求文档（ PRD ） 查找技术方案和架构文档 检索会议记录和决策文档 整理项目资料和学习笔记 内容创作者 搜索素材和灵感，整理音视频内容，管理创作资源 使用场景 ： 搜索视频脚本和分镜 查找音频素材和音效 整理设计素材和灵感 管理项目资源和交付物 技术开发者 搜索代码库和技术文档，整理学习资料，管理项目文件 使用场景 ： 搜索代码片段和技术实现 查找 API 文档和使用示例 整理学习资料和教程 管理项目文件和依赖 研究人员 搜索论文和研究资料，整理文献笔记，管理研究数据 使用场景 ： 搜索论文和参考文献 查找实验数据和结果 整理文献笔记和观点 管理研究项目资料 为什么选择小遥搜索？ 🎯 专为知识工作者设计 多模态输入 ：语音、文本、图片，用最自然的方式搜索 语义理解 ：AI 理解你的意图，不只是关键词匹配 深度检索 ：搜索文件内容，不只是文件名 🔒 隐私安全优先 100% 本地 ：所有数据处理都在本地，不上传云端 隐私模式 ：可选不记录搜索历史 自主可控 ：数据完全由你自己掌控 🧠 AI 技术领先 多模型集成 ：BGE-M3 + FasterWhisper + CN-CLIP + Ollama 云端可选 ：支持 OpenAI/DeepSeek/阿里云等云端模型 持续升级 ：AI 模型和技术持续更新 🎨 v2.0.0 视觉体验 温暖明亮 ：Notion 设计风格，专业舒适 精致细节 ：多层阴影、超细边框、流畅动画 品牌识别 ：统一的视觉语言，提升专业度 高性能 ：零网络依赖，加载速度极快 🤖 开发者友好 100% 开源 ：所有源码、文档、开发经验全部开源 插件化架构 ：支持自定义扩展和数据源 MCP 支持 ：可被 Claude Desktop 等 AI 应用连接 Vibe Coding 案例 ：完整的 AI 辅助开发实践 Vibe Coding 实践案例 100% AI 辅助开发 这个项目从零开始， 完全通过 Vibe Coding 实现 ，包括： ✅ 完整源代码（前端 + 后端 + 所有功能模块） ✅ 设计文档（ PRD 、技术方案、数据库设计、API 文档） ✅ 开发流程（任务分解、进度跟踪、测试验证） ✅ 部署配置（环境搭建、依赖管理、打包发布） ✅ v2.0.0 UI 视觉系统全面升级 开源的价值 对于想要学习以下内容的开发者，这是一个完整的参考实现： AI 辅助开发实践 ：如何用 AI 实现完整项目 Electron 桌面应用 ：从零构建桌面应用 Vue 3 前端开发 ：Composition API + TypeScript Python FastAPI 后端 ：异步架构 + AI 模型集成 设计系统构建 ：从零建立完整设计规范 插件化架构 ：可扩展的插件系统设计 MCP 协议实现 ：AI 应用集成最佳实践 项目亮点总结 技术亮点 多模态 AI 搜索 ：语音、文本、图片三种输入方式 深度文件检索 ：支持文档、音视频的内容和文件名搜索 AI 模型集成 ：BGE-M3 、FasterWhisper 、CN-CLIP 、Ollama 插件化架构 ：支持语雀、飞书、钉钉等数据源 MCP 协议支持 ：可被 Claude Desktop 等 AI 应用连接 v2.0.0 UI 视觉升级 ：Notion 设计风格 + 完整设计系统 设计亮点（ v2.0.0 ） Notion 温暖明亮风格 ：专业、舒适、高效 系统字体栈 ：零网络依赖，最优性能 Lucide Icons ：1000+ 图标，统一视觉语言 多层阴影堆叠 ：4-5 层精致阴影 完整设计系统 ：确保设计一致性 响应式设计 ：完美适配各种设备 开源亮点 100% AI 辅助开发 ：完整的 Vibe Coding 实践案例 完整技术栈 ：前端 + 后端 + AI 模型 详尽文档 ：PRD 、技术方案、API 文档、数据库设计 插件化架构 ：可扩展的插件系统设计 持续更新 ：活跃开发，功能持续增强 邀请你参与 为什么需要你？ 一个人的力量有限，开源社区的力量是无限的！ 优先贡献方向 🎨 UI/UX 优化（高优先级） 暗黑模式支持 （用户呼声最高） 设计暗黑主题配色方案 实现主题切换功能 优化暗黑模式下的视觉体验 自定义主题配色 允许用户自定义品牌色 提供多种预设配色方案 支持导入导出主题配置 更多动画效果 页面切换动画 加载动画优化 微交互动画效果 🔌 更多数据源支持（高优先级） Notion 知识库 Notion API 集成 元数据解析 原文链接跳转 GitHub/GitLab 代码仓库搜索 Wiki 文档索引 Issue 和 PR 检索 ⚡ 性能优化（中优先级） 大文件处理优化 分块索引策略 流式读取优化 内存占用控制 索引构建速度提升 并行索引构建 增量索引更新 智能缓存机制 🧪 测试覆盖（中优先级） 单元测试补充 核心模块测试覆盖 边界条件测试 错误处理测试 集成测试完善 端到端测试场景 跨平台兼容性测试 性能基准测试 如何贡献？ # 1. Fork 项目 git clone https://github.com/dtsola/xiaoyaosearch.git cd xiaoyaosearch # 2. 创建分支 git checkout -b feature/your-feature-name # 3. 进行开发 # 按照项目代码规范开发 # 确保代码有适当注释 # 运行测试确保功能正常 # 4. 提交代码 git add . git commit -m "feat(scope): 简洁描述你的改动" git push origin feature/your-feature-name # 5. 提交 Pull Request # 在 GitHub 上创建 PR ，详细描述改动内容 贡献者权益 📝 在贡献者列表中展示你的名字 🏆 对项目有重大贡献者可成为核心维护者 💼 优秀贡献者可获得推荐信或工作机会 🎁 顶级贡献者可获得项目周边礼品 项目地址 GitHub ： https://github.com/dtsola/xiaoyaosearch 欢迎： ⭐️ Star 本项目，关注最新进展 🍴 Fork 本项目，开始你的贡献 👀 Watch 本项目，及时获取更新 🐛 提 Issue ，报告问题和建议功能 💡 参与讨论 ，分享你的想法 关于我 dtsola - IT 解决方案架构师 | 一人公司实践者 网站 ： https://www.dtsola.com B 站 ： https://space.bilibili.com/736015 开源协议 本项目采用 小遥搜索软件授权协议 ： ✅ 免费使用（非商业用途） ✅ 可以学习和研究代码 ✅ 可以修改后二次分发（需保留版权声明和协议） ✅ 可以集成到其他非商业项目 ❌ 商业使用需授权 这是一个类似 CC-BY-NC-SA 的开源协议，鼓励学习、分享和贡献！ 详细协议： https://github.com/dtsola/xiaoyaosearch/blob/main/LICENSE 版本历史 v2.0.0 (2026-04-24) - UI 视觉系统升级版 🎨 核心升级 ： ✅ Notion 温暖明亮设计风格 ✅ 系统字体栈（零网络依赖） ✅ Lucide Icons 图标系统（ 1000+） ✅ 完整设计系统规范 ✅ 所有页面 UI 全面升级（ 10 个页面/组件） ✅ 响应式设计完善 v1.9.0 (2026-04-12) - 搜索优化版 ✅ 术语扩展时机优化 ✅ 智能合并去重 ✅ 并发控制优化 ✅ 专业术语召回率提升 60% v1.8.0 (2026-04-08) - 钉钉文档支持 ✅ 钉钉文档数据源支持 ✅ 元数据文件解析（.xyddjson 格式） ✅ 原文链接跳转功能 v1.7.0 (2026-03-31) - 飞书文档支持 ✅ 飞书文档数据源支持 ✅ 元数据块解析 ✅ 原文链接跳转功能 v1.6.0 (2026-03-26) - 云端嵌入模型 ✅ 云端嵌入模型调用能力 ✅ 本地/云端互斥切换 ✅ 批量文本嵌入优化 v1.5.0 (2026-03-20) - Agent Skills ✅ MCP Agent Skills 支持 ✅ 为 Claude Code/VS Code/Cursor 提供工具调用能力 v1.4.0 (2026-03-15) - MCP 服务器支持 ✅ MCP 协议支持 ✅ 可被 Claude Desktop 连接 ✅ SSE 传输方式 v1.3.0 (2026-03-10) - OpenAI 云端模型 ✅ OpenAI 兼容云端大模型 ✅ 动态表单配置 ✅ API 密钥加密存储 v1.2.0 (2026-03-05) - 插件化架构 ✅ 插件化架构框架 ✅ 语雀知识库数据源 v1.1.0 (2026-02-28) - i18n 国际化 ✅ 中英文双语支持 ✅ i18n 框架集成 v1.0.0 (2026-02-20) - MVP 版本 ✅ 多模态搜索（文本/语音/图像） ✅ 本地文件深度检索 ✅ BGE-M3 + FasterWhisper + CN-CLIP ✅ Faiss + Whoosh 混合搜索 结语 小遥搜索 v2.0.0 是我们对本地 AI 搜索工具的一次重大升级。 v1.x 时代 ：我们实现了核心的 AI 搜索能力，打造了稳定可用的本地搜索工具。 v2.0.0 时代 ：我们全面升级了视觉体验，建立了完整的设计系统，让产品不仅强大，而且美观易用。 未来 ：我们会持续优化性能，增加更多数据源，引入更多 AI 能力，让小遥搜索成为知识工作者的必备工具。 无论你是： 🔨 想要贡献代码的开发者 💡 想要提供建议的产品经理 📖 想要学习 AI 应用的学生 🚀 想要参与创业的伙伴 都欢迎加入我们，一起打造更好的本地 AI 搜索工具！ 让我们一起，用 AI 技术改变知识管理方式！ 🚀