镜像自地址
https://github.com/lhly/search-syntax-pro.git
已同步 2026-10-20 22:37:48 +08:00
feaf3ef7de
- 添加 DuckDuckGo、Brave、Yandex、Reddit、GitHub 和 StackOverflow 适配器 - 实现动态语言选择器功能 - 更新搜索引擎类型定义和国际化翻译 - 添加详细的搜索引擎文档和语法参考
142 行
5.3 KiB
Markdown
142 行
5.3 KiB
Markdown
# 搜索引擎高级语法参考文档
|
||
|
||
> 本文档详细记录了推荐添加到 SearchSyntax Pro 的六个搜索引擎及其支持的高级搜索语法
|
||
|
||
## 📚 文档目录
|
||
|
||
| 搜索引擎 | 优先级 | 文档链接 | 实施状态 |
|
||
|---------|--------|---------|---------|
|
||
| [DuckDuckGo](#duckduckgo) | P0 (最高) | [详细文档](./duckduckgo.md) | 🔄 待实施 |
|
||
| [Brave Search](#brave-search) | P0 (最高) | [详细文档](./brave.md) | 🔄 待实施 |
|
||
| [Yandex](#yandex) | P1 (中) | [详细文档](./yandex.md) | 🔄 待实施 |
|
||
| [Reddit](#reddit) | P1 (中) | [详细文档](./reddit.md) | 🔄 待实施 |
|
||
| [GitHub](#github) | P2 (低) | [详细文档](./github.md) | 🔄 待实施 |
|
||
| [Stack Overflow](#stack-overflow) | P2 (低) | [详细文档](./stackoverflow.md) | 🔄 待实施 |
|
||
|
||
## 🎯 优先级说明
|
||
|
||
### P0 - 隐私搜索引擎（最高优先级）
|
||
- **DuckDuckGo**: 全球领先的隐私搜索，日活超1亿次搜索
|
||
- **Brave Search**: 新兴隐私搜索，增长最快，技术用户首选
|
||
|
||
**推荐理由**: 低实施复杂度、高用户价值、快速见效
|
||
|
||
### P1 - 国际化与垂直搜索（中等优先级）
|
||
- **Yandex**: 俄罗斯第一搜索引擎，全球份额2.5%，独特语法支持
|
||
- **Reddit**: 全球最大社区平台，月活4.3亿，社交搜索专家
|
||
|
||
**推荐理由**: 扩大用户覆盖面、提供差异化价值
|
||
|
||
### P2 - 专业开发者工具（低优先级）
|
||
- **GitHub**: 全球最大代码托管平台，1亿+开发者
|
||
- **Stack Overflow**: 最大技术问答社区，5000万+月访问
|
||
|
||
**推荐理由**: 专业工具定位、高价值用户群、增强竞争力
|
||
|
||
## 📖 快速对比
|
||
|
||
### 语法支持矩阵
|
||
|
||
| 语法类型 | DuckDuckGo | Brave | Yandex | Reddit | GitHub | Stack Overflow |
|
||
|---------|------------|-------|--------|--------|--------|----------------|
|
||
| `site:` | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ |
|
||
| `filetype:` | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
|
||
| `intitle:` | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
|
||
| `inurl:` | ✅ | ❌ | ❌ | ✅ (url:) | ❌ | ❌ |
|
||
| `"精确匹配"` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||
| `-排除` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||
| `OR` 逻辑 | ✅ | ✅ | ✅ (\|) | ✅ | ✅ | ✅ |
|
||
| 日期范围 | ❌ | ❌ | ❌ | ✅ | ✅ | ✅ |
|
||
| 用户筛选 | ❌ | ❌ | ❌ | ✅ (author:) | ✅ (user:) | ✅ (user:) |
|
||
| 地理位置 | ❌ | ✅ (loc:) | ❌ | ❌ | ❌ | ❌ |
|
||
| 语言筛选 | ❌ | ✅ (lang:) | ❌ | ❌ | ✅ (language:) | ❌ |
|
||
|
||
### 技术实施复杂度
|
||
|
||
| 搜索引擎 | URL构建 | 特殊语法 | 认证需求 | 总体复杂度 |
|
||
|---------|---------|---------|---------|-----------|
|
||
| DuckDuckGo | 简单 | 标准 | 无 | 🟢 低 |
|
||
| Brave Search | 简单 | 标准 | 无 | 🟢 低 |
|
||
| Yandex | 中等 | 独特 (rhost:, mime:) | 无 | 🟡 中 |
|
||
| Reddit | 中等 | 标准 | 无 | 🟡 中 |
|
||
| GitHub | 复杂 | 特殊 (repo:, stars:) | OAuth (可选) | 🔴 高 |
|
||
| Stack Overflow | 中等 | 标签系统 | API Key (可选) | 🔴 高 |
|
||
|
||
## 🔧 实施顺序建议
|
||
|
||
### Phase 1: 隐私搜索引擎（第1周）
|
||
```
|
||
Week 1:
|
||
├── Day 1-2: DuckDuckGo 适配器开发
|
||
├── Day 3-4: Brave Search 适配器开发
|
||
└── Day 5: UI更新、测试、发布
|
||
```
|
||
|
||
### Phase 2: 国际化与社区（第2-3周）
|
||
```
|
||
Week 2-3:
|
||
├── Day 1-3: Yandex 适配器开发
|
||
├── Day 4-6: Reddit 适配器开发
|
||
└── Day 7: 国际化支持、测试
|
||
```
|
||
|
||
### Phase 3: 专业工具（第4-7周）
|
||
```
|
||
Week 4-7:
|
||
├── Week 4: GitHub 适配器开发
|
||
├── Week 5-6: Stack Overflow 适配器开发
|
||
└── Week 7: 完整测试、文档更新
|
||
```
|
||
|
||
## 📋 使用指南
|
||
|
||
### 对于产品经理
|
||
- 查看 [优先级说明](#-优先级说明) 了解各引擎的价值定位
|
||
- 参考 [语法支持矩阵](#语法支持矩阵) 评估功能覆盖度
|
||
- 查看各引擎详细文档了解具体用户场景
|
||
|
||
### 对于开发者
|
||
- 查看各引擎的详细文档了解具体实施细节
|
||
- 参考 [技术实施复杂度](#技术实施复杂度) 评估开发工作量
|
||
- 查看 [实施顺序建议](#-实施顺序建议) 规划开发计划
|
||
|
||
### 对于测试工程师
|
||
- 使用各文档中的示例查询进行测试
|
||
- 验证每个语法操作符的正确性
|
||
- 确保URL构建符合各引擎的规范
|
||
|
||
## 🔗 相关资源
|
||
|
||
### 官方文档链接
|
||
- [DuckDuckGo Search Syntax](https://duckduckgo.com/duckduckgo-help-pages/results/syntax/)
|
||
- [Brave Search Operators](https://search.brave.com/help/operators)
|
||
- [Yandex Query Language](https://yandex.com/support/search/en/query-language/)
|
||
- [Reddit Search Documentation](https://www.reddit.com/wiki/search/)
|
||
- [GitHub Code Search](https://docs.github.com/en/search-github/searching-on-github)
|
||
- [Stack Overflow Search](https://stackoverflow.com/help/searching)
|
||
|
||
### 技术规范
|
||
- [项目适配器接口](../../src/types/index.ts#L156)
|
||
- [搜索引擎类型定义](../../src/types/index.ts#L2)
|
||
- [适配器工厂实现](../../src/services/adapters/factory.ts)
|
||
|
||
## 📝 更新日志
|
||
|
||
| 日期 | 版本 | 更新内容 | 作者 |
|
||
|------|------|---------|------|
|
||
| 2025-11-09 | v1.0 | 初始文档创建，包含6个搜索引擎的完整语法参考 | AI Assistant |
|
||
|
||
## 💡 贡献指南
|
||
|
||
如需更新本文档：
|
||
|
||
1. 确认语法变更来自官方文档
|
||
2. 更新对应引擎的详细文档
|
||
3. 更新语法支持矩阵
|
||
4. 添加更新日志记录
|
||
5. 提交PR并标注文档更新
|
||
|
||
---
|
||
|
||
**下一步**: 查看各搜索引擎的详细文档，了解具体语法和实施细节。
|