ChanilaVidmal/advanced-search-operators
GitHub: ChanilaVidmal/advanced-search-operators
一款帮助用户通过可视化方式构建、验证和管理复杂搜索运算符查询的 Chrome 扩展。
Stars: 0 | Forks: 0
# 高级搜索运算符
[](LICENSE)
[](https://www.typescriptlang.org/)
[](https://react.dev/)
[](https://developer.chrome.com/docs/extensions/develop/concepts/manifest-v3)
[](https://vitejs.dev/)
[](https://tailwindcss.com/)
一款功能强大的 Chrome 扩展,让您轻松掌握所有的 Google 搜索运算符。支持可视化构建复杂查询、进行验证、保存为模板,并在 13 个搜索引擎中进行搜索。
## 功能
- **79 个搜索运算符**:涵盖 11 个类别,附带描述、语法和示例
- **可视化查询构建器** — 拖拽区块、重新排序、复制、实时预览
- **自动补全** — 输入时提供模糊运算符建议
- **查询验证器** — 检测未知运算符、缺失的引号、重复项、已弃用的运算符、未闭合的引号以及缺失的值
- **模板** — 保存、编辑、删除、导入/导出查询模板(包含内置预设)
- **搜索历史** — 自动保存搜索记录、固定收藏夹、搜索统计数据
- **导出** — 将模板和历史记录导出为 JSON、TXT、Markdown 或 CSV 格式
- **多引擎** — 支持 Google、Bing、DuckDuckGo、GitHub、GitLab、StackOverflow、Reddit、YouTube、Google Scholar、Arxiv、NPM、PyPI 和 Docker Hub 搜索
- **深色模式** — 自动主题适配
- **键盘快捷键** — 按 Ctrl+Shift+S 打开侧边栏
## 安装说明
由于此扩展尚未在 Chrome Web Store 上架,请通过开发者模式进行安装:
1. 下载或克隆本仓库
2. 打开 Chrome 并访问 `chrome://extensions`
3. 启用 **开发者模式**(右上角的开关)
4. 点击 **加载已解压的扩展程序**
5. 选择本仓库中的 `extension` 文件夹
6. 扩展程序图标将出现在您的工具栏中
### 从源码构建
```
# 安装 dependencies
cd extension
npm install
# 为 production 构建
npm run build
# 或者在 development 模式下运行
npm run dev
```
## 使用方法
### 浏览器
按类别浏览所有 79 个运算符。支持按名称或运算符搜索。点击任意运算符即可查看其描述、语法、示例和兼容性。
### 构建器
将运算符作为区块添加,填入相应的值,并通过拖拽进行排列。实时的查询预览会同步更新。点击搜索按钮即可在您选定的搜索引擎中打开该查询。
### 验证器
粘贴任意原始搜索查询即可获得即时反馈:未知运算符、缺失的引号、重复的运算符等。
### 模板
将您当前的构建器查询保存为可重复使用的模板。内置模板包括 OSINT 搜索、研究论文、PDF 搜索和 Bug 搜寻。
### 历史记录
每次搜索都会自动保存。您可以固定重要的搜索、标记收藏夹并查看您的搜索统计数据。
### 导出
将您的模板和历史记录导出为 JSON、纯文本、Markdown 或 CSV 格式。通过 URL 或可分享的文本分享您当前的查询。
## 技术栈
| 层级 | 技术 |
|-------|-----------|
| 核心 | TypeScript, React 18 |
| 构建 | Vite |
| 样式 | TailwindCSS, shadcn/ui |
| 状态 | Zustand, Chrome Storage API |
| 扩展 | Manifest V3 |
| 拖拽 | @dnd-kit |
| 测试 | Vitest, Playwright |
| 代码检查 | ESLint, Prettier |
## 项目结构
```
extension/
├── public/
│ ├── background.js
│ └── icons/
├── src/
│ ├── components/
│ │ ├── builder/ # Visual query builder
│ │ ├── explorer/ # Operator explorer
│ │ ├── export/ # Export view
│ │ ├── history/ # Search history
│ │ ├── layout/ # Header, navigation, side panel
│ │ ├── settings/ # Settings page
│ │ ├── templates/ # Template management
│ │ ├── ui/ # Shared UI components (shadcn/ui)
│ │ └── validator/ # Query validator
│ ├── data/
│ │ ├── operators/ # Operator definitions by category
│ │ └── engines.ts # Search engine definitions
│ ├── hooks/ # Custom React hooks
│ ├── lib/ # Utility functions
│ ├── search/ # Query validator engine
│ ├── services/ # Export service
│ ├── types/ # TypeScript type definitions
│ └── main.tsx # Application entry point
├── tests/
├── manifest.json
├── vite.config.ts
├── tailwind.config.ts
└── package.json
```
## 路线图
| 阶段 | 功能 | 状态 |
|-------|---------|--------|
| 1 | 基础架构与项目设置 | 已完成 |
| 2 | 运算符数据库(79 个运算符) | 已完成 |
| 3 | 运算符浏览器与深色模式 | 已完成 |
| 4 | 可视化搜索构建器(拖拽) | 已完成 |
| 5 | 自动补全建议 | 已完成 |
| 6 | 查询验证器(6 种规则类型) | 已完成 |
| 7 | 模板(CRUD、导入/导出) | 已完成 |
| 8 | 搜索历史与统计 | 已完成 |
| 9 | 导出(JSON、TXT、MD、CSV)与分享 | 已完成 |
| 10 | 多引擎支持(13 个引擎) | 已完成 |
| 11 | 自然语言查询解析器 | 已完成 |
| 12 | 特定于引擎的运算符作用域 | 已完成 |
| 13 | Chrome Web Store 上架 | 计划中 |
## 贡献
欢迎踊跃贡献!请阅读 [CONTRIBUTING.md](CONTRIBUTING.md) 了解提交流程,并查阅 [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) 了解社区规范。
## 许可证
[MIT](LICENSE) © 2026 Chanila Vidmal Wijayasundara
标签:Google搜索语法, React, Syscalls, TypeScript, 可视化查询构建器, 安全插件, 搜索工具, 特征检测, 自动化攻击