# AutoSearchEngine

**Repository Path**: zhaifanhua/AutoSearchEngine

## Basic Information

- **Project Name**: AutoSearchEngine
- **Description**: 一个功能强大的浏览器扩展，提供聚合搜索、智能切换、全局主题等丰富功能，让您的搜索体验更加高效便捷。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-06-08
- **Last Updated**: 2025-06-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 浏览器插件

## README

# 智能搜索引擎切换器 🔍

一个功能强大的浏览器扩展，提供聚合搜索、智能切换、全局主题等丰富功能，让您的搜索体验更加高效便捷。

![](./assets/0.png)

## ✨ 主要功能

### 🚀 聚合搜索（核心功能）

- **同时搜索多个引擎**：一次搜索，同时获取多个搜索引擎的结果
- **智能结果提取**：自动提取搜索结果标题、链接和摘要
- **响应式布局**：3 列网格布局，完美适配各种屏幕尺寸
- **全屏模式**：支持全屏浏览，提供更沉浸的搜索体验
- **自动分页**：滚动到底部自动加载更多搜索结果
- **API 集成**：优先使用官方 API，提供更准确的搜索结果

### 🔄 多搜索引擎支持

- **主流搜索引擎**：Google、百度、必应、DuckDuckGo、搜狗、360 搜索、Yandex、Yahoo
- **专业搜索**：GitHub、Stack Overflow、Wikipedia、知乎、Bilibili
- **自定义搜索引擎**：添加您喜欢的任何搜索引擎
- **智能切换**：快速切换默认搜索引擎

### ⚡ 快捷操作

- **键盘快捷键**：
  - `Ctrl + Shift + S`：快速切换搜索引擎
  - `Ctrl + Shift + F`：搜索选中的文本
  - `Ctrl + K`：聚合搜索页面新搜索
  - `Esc`：退出全屏模式或关闭模态框
- **右键菜单**：选中文本后右键快速搜索
- **一键切换**：点击插件图标快速切换默认搜索引擎
- **聚合搜索**：点击"聚合"按钮打开多引擎搜索页面

### 🧠 智能功能

- **搜索建议**：输入时自动显示搜索建议
- **搜索历史**：记录搜索历史，快速重复搜索
- **收藏功能**：保存常用搜索词，快速访问
- **智能记忆**：记住常用的搜索引擎偏好
- **结果缓存**：智能缓存搜索结果，提升加载速度

### 🎨 现代化界面

- **全局主题系统**：完整的浅色/深色/跟随系统主题支持
- **响应式设计**：完美适配桌面、平板、手机等设备
- **流畅动画**：丰富的交互动画和过渡效果
- **直观布局**：清晰的信息层次和操作流程
- **无缝体验**：所有页面统一的设计语言

## 📦 安装方法

### Chrome/Edge 浏览器

1. **下载插件文件**

   ```bash
   git clone https://github.com/yourusername/AutoSearchEngine.git
   cd AutoSearchEngine
   ```

2. **打开浏览器扩展管理页面**

   - Chrome：访问 `chrome://extensions/`
   - Edge：访问 `edge://extensions/`

3. **启用开发者模式**

   - 点击右上角的"开发者模式"开关

4. **加载插件**

   - 点击"加载已解压的扩展程序"
   - 选择插件文件夹

5. **完成安装**
   - 插件图标将出现在浏览器工具栏中

## 🚀 使用指南

![](./assets/1.png)

![](./assets/2.png)

![](./assets/3.png)

### 基本使用

1. **快速搜索**

   - 点击插件图标打开搜索面板
   - 输入搜索内容，选择搜索引擎
   - 按 Enter 或点击搜索按钮

2. **聚合搜索（推荐）**

   - 点击插件面板中的"聚合"按钮
   - 输入搜索关键词，自动在多个搜索引擎中搜索
   - 查看并比较不同搜索引擎的结果
   - 使用全屏模式获得更好的浏览体验

3. **切换搜索引擎**

   - 点击当前搜索引擎名称
   - 从列表中选择新的搜索引擎
   - 或使用快捷键 `Ctrl + Shift + S`

4. **选中文本搜索**
   - 选中网页上的文本
   - 右键点击选择搜索引擎
   - 或使用快捷键 `Ctrl + Shift + F`

### 高级功能

#### 🔧 设置配置

点击插件图标 → 设置按钮，可以配置：

- **默认搜索引擎**：设置常用的搜索引擎
- **搜索行为**：新标签页打开、搜索建议等
- **功能开关**：右键菜单、键盘快捷键等
- **历史管理**：搜索历史保存和清理
- **主题选择**：浅色/深色/跟随系统主题
- **搜索引擎管理**：启用/禁用特定搜索引擎

#### ➕ 自定义搜索引擎

1. 进入设置页面
2. 点击"添加自定义搜索引擎"
3. 填写搜索引擎信息：
   - **名称**：搜索引擎的显示名称
   - **搜索 URL**：搜索链接模板（使用`{query}`作为关键词占位符）
   - **图标**：可选的 emoji 图标

**示例配置**：

```
名称：MDN Web Docs
URL：https://developer.mozilla.org/zh-CN/search?q={query}
图标：📚
```

#### 📊 搜索历史与收藏

- **查看历史**：点击"历史"按钮查看搜索记录
- **重复搜索**：点击历史记录快速重新搜索
- **收藏搜索**：为常用搜索词添加收藏
- **管理收藏**：查看、编辑和删除收藏项目
- **清理历史**：在设置中清空所有历史记录

#### 🖥️ 聚合搜索高级功能

- **全屏模式**：点击全屏按钮或使用左上角悬浮按钮
- **结果对比**：同时查看多个搜索引擎的结果差异
- **智能加载**：API 优先，内容提取备选，iframe 兜底
- **无限滚动**：自动加载更多搜索结果
- **响应式布局**：3 列（桌面）→ 2 列（平板）→ 1 列（手机）

## ⚙️ 配置选项

### 基本设置

- `默认搜索引擎`：设置主要使用的搜索引擎
- `新标签页打开`：搜索结果是否在新标签页打开

### 功能设置

- `搜索建议`：输入时是否显示搜索建议
- `建议数量`：每次显示的建议条数（1-20）
- `右键菜单`：是否启用选中文本的右键搜索菜单
- `键盘快捷键`：是否启用快捷键功能

### 历史记录

- `保存历史`：是否记录搜索历史
- `历史数量`：保存的历史记录最大条数（10-1000）

### 搜索引擎管理

- `启用的搜索引擎`：选择要在插件中显示的搜索引擎
- `自定义搜索引擎`：添加和管理自定义搜索引擎

### 外观设置

- `主题选择`：浅色主题、深色主题或跟随系统设置
- `全局应用`：主题设置应用于所有扩展页面

## 🔑 键盘快捷键

| 快捷键             | 功能                             |
| ------------------ | -------------------------------- |
| `Ctrl + Shift + S` | 切换默认搜索引擎                 |
| `Ctrl + Shift + F` | 搜索选中的文本                   |
| `Ctrl + K`         | 聚合搜索页面打开新搜索           |
| `Enter`            | 执行搜索                         |
| `Esc`              | 退出全屏模式/关闭模态框/关闭建议 |

> 注：在设置中可以禁用快捷键功能

## 🔒 隐私保护

- **本地存储**：所有设置和历史记录仅保存在本地
- **无数据收集**：插件不收集任何个人信息
- **可选历史**：可以完全禁用搜索历史记录功能
- **安全搜索**：支持 DuckDuckGo 等注重隐私的搜索引擎

## 🛠️ 技术特性

- **Manifest V3**：使用最新的浏览器扩展标准
- **现代 JavaScript**：ES6+ 语法和模块化设计
- **响应式 CSS**：支持各种屏幕尺寸和设备
- **无第三方依赖**：纯原生实现，轻量高效
- **跨平台兼容**：支持 Chrome、Edge 等 Chromium 内核浏览器
- **API 集成**：支持多种搜索引擎官方 API
- **智能提取**：高级内容提取算法，准确获取搜索结果
- **性能优化**：缓存机制、懒加载、防抖节流等优化技术

## 📝 版本历史

### v1.0.0 (2025-06-10)

- ✨ 初始版本发布
- 🚀 聚合搜索功能 - 核心亮点
- 🔧 支持 13 个主流搜索引擎
- ⚡ 键盘快捷键和右键菜单
- 🎨 全局主题系统（浅色/深色/跟随系统）
- 📊 搜索历史和收藏功能
- ➕ 自定义搜索引擎支持
- 🖥️ 全屏模式和响应式设计
- 📱 完美的移动端适配
- 🔌 API 集成和智能结果提取
- 🔄 自动分页和无限滚动

## 🤝 贡献指南

欢迎贡献代码！请遵循以下步骤：

1. Fork 本仓库
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

## 🐛 问题反馈

如果您遇到问题或有建议，请：

1. 查看 [常见问题](docs/FAQ.md)
2. 搜索现有的 [Issues](https://github.com/yourusername/AutoSearchEngine/issues)
3. 创建新的 Issue 详细描述问题

## 💡 功能建议

我们正在计划以下功能：

- [x] ~~聚合搜索功能~~ ✅ 已完成
- [x] ~~全局主题系统~~ ✅ 已完成
- [x] ~~全屏模式~~ ✅ 已完成
- [x] ~~移动端适配~~ ✅ 已完成
- [x] ~~API 集成~~ ✅ 已完成
- [ ] 搜索结果导出功能
- [ ] 搜索统计和分析
- [ ] 团队协作功能
- [ ] 搜索引擎性能比较
- [ ] 语音搜索支持
- [ ] 浏览器同步功能

## 📞 联系我们

- **作者**：ZhaiFanhua
- **项目地址**：https://github.com/ZhaiFanhua/AutoSearchEngine
- **版权声明**：© 2021-Present ZhaiFanhua All Rights Reserved

---

⭐ 如果这个插件对您有帮助，请考虑给项目一个星标！

🔍 让搜索更简单、更高效！