FEATURES.md•6.42 kB
# Smart Search MCP - 功能详解
## 📊 v2.0.0 功能对比
| 功能项 | v1.0.0 | v2.0.0 | 改进说明 |
|--------|--------|--------|----------|
| 输入验证 | ❌ 无 | ✅ 全部支持 | 防止空关键词搜索 |
| 搜索技巧 | ❌ 无 | ✅ 5-7条/工具 | 专业搜索语法提示 |
| 相关搜索 | ❌ 无 | ✅ 智能推荐 | 提高搜索效率 |
| 多源搜索 | ❌ 单一 | ✅ 部分支持 | NPM、API多源 |
| 平台介绍 | ❌ 无 | ✅ 详细说明 | 了解平台特点 |
| 快速导航 | ❌ 无 | ✅ 官方链接 | 直达常用资源 |
| 输出格式 | ⚠️ 基础 | ✅ 优化 | Markdown格式化 |
| 错误处理 | ⚠️ 基础 | ✅ 完善 | 统一错误机制 |
## 🔍 14个搜索工具详解
### 1. 网络搜索 (`ai_search_web`)
**功能增强**:
- ✅ 支持4大搜索引擎(Google、Bing、百度、搜狗)
- ✅ 自定义结果数量参数
- ✅ 5条高级搜索技巧
- ✅ 4条相关搜索建议
- ✅ 其他引擎快速切换
**搜索技巧**:
- 精确匹配:`"关键词"`
- 排除关键词:`关键词 -排除词`
- 限定站点:`site:github.com 关键词`
- 文件类型:`关键词 filetype:pdf`
- 时间范围:`关键词 after:2023`
---
### 2. GitHub搜索 (`ai_search_github`)
**功能增强**:
- ✅ 多维度筛选(仓库/代码/Issues/用户)
- ✅ 语言筛选
- ✅ 排序方式(Stars/Forks/更新时间)
- ✅ 7条高级搜索技巧
- ✅ 智能相关搜索
**搜索技巧**:
- Stars数量:`关键词 stars:>1000`
- Fork数量:`关键词 forks:>100`
- 特定语言:`关键词 language:javascript`
- 最近更新:`关键词 pushed:>2024-01-01`
- 主题标签:`关键词 topic:react`
- 组织仓库:`关键词 org:facebook`
- 仓库大小:`关键词 size:>10000`
---
### 3. StackOverflow搜索 (`ai_search_stackoverflow`)
**功能增强**:
- ✅ 标签筛选(支持多标签)
- ✅ 排序方式(相关性/投票/创建/活跃度)
- ✅ 7条高级搜索技巧
- ✅ 10个热门技术标签推荐
**搜索技巧**:
- 标签搜索:`[javascript] 关键词`
- 已回答问题:`关键词 is:answer`
- 已接受答案:`关键词 isaccepted:yes`
- 投票数筛选:`关键词 score:5..`
- 多个标签:`[react] [hooks] 关键词`
- 代码搜索:`code:"关键词"`
- 标题搜索:`title:"关键词"`
---
### 4. NPM包搜索 (`ai_search_npm`)
**功能增强**:
- ✅ 双重搜索方式(网页+API)
- ✅ 自定义结果数量
- ✅ 6条搜索技巧
- ✅ 4条相关搜索建议
- ✅ 直达包详情页
- ✅ 8个热门包分类推荐
**搜索方式**:
1. **网页搜索**:适合浏览和发现
2. **API搜索**:结构化数据,适合程序处理
**热门分类**:
react, vue, express, webpack, babel, eslint, testing, cli-tools
---
### 5. 技术文档搜索 (`ai_search_docs`)
**功能增强**:
- ✅ 支持7大框架/语言
- ✅ 优先中文文档
- ✅ 常用主题快速参考
- ✅ 其他框架快速切换
**支持框架**:
- React - 组件、Hooks、State、Context
- Vue.js - 组合式API、响应式、计算属性
- Angular - 指令、服务、模块
- Node.js - fs、http、path、stream
- Python - 列表推导、装饰器、异步
- Java - Collections、Stream、Lambda
- MDN - HTML、CSS、JavaScript、Web API
---
### 6. API参考搜索 (`ai_search_api_reference`)
**功能增强**:
- ✅ 多源搜索(Google、DevDocs、GitHub)
- ✅ 常用库直接文档链接
- ✅ 4条查询提示
- ✅ 3类相关资源链接
**常用库支持**:
- express、axios、lodash
- mongoose、sequelize
- socket.io、jwt
**搜索源**:
1. Google - 全网搜索
2. DevDocs - 开发者文档聚合
3. GitHub - 源码和示例
---
### 7. 微信文档搜索 (`ai_search_wechat_docs`)
**功能增强**:
- ✅ 5大平台分类(小程序/公众号/开放平台/支付/全平台)
- ✅ 百度站内搜索+文档直达
- ✅ 常用API分类展示
- ✅ 开发者社区链接
**常用API**:
- 小程序:wx.request、wx.getUserInfo、wx.login
- 公众号:消息管理、自定义菜单、网页授权
- 支付:JSAPI支付、小程序支付、退款
---
### 8-14. 国内平台搜索
#### CSDN (`ai_search_csdn`)
- 📝 中国最大的IT社区
- 主题:博客文章、技术问答、代码片段、下载资源
#### 掘金 (`ai_search_juejin`)
- 💎 开发者技术内容分享平台
- 主题:前端、后端、Android、iOS、AI
#### SegmentFault (`ai_search_segmentfault`)
- 🔧 中文技术问答社区
- 主题:问答、文章、活动、编程挑战
#### 博客园 (`ai_search_cnblogs`)
- 📚 开发者的网上家园
- 主题:.NET、C#、Java、Python、数据库
#### 开源中国 (`ai_search_oschina`)
- 🌐 中国最大的开源社区
- 主题:开源项目、技术资讯、代码托管
#### 阿里云文档 (`ai_search_aliyun_docs`)
- ☁️ 阿里云产品文档中心
- 产品:ECS、OSS、RDS、SLB、容器服务
#### 腾讯云文档 (`ai_search_tencent_docs`)
- ☁️ 腾讯云产品文档中心
- 产品:CVM、COS、CDN、SCF、数据库
**统一增强**:
- ✅ 详细平台介绍
- ✅ 热门主题推荐
- ✅ 平台首页链接
- ✅ 搜索建议
---
## 🎯 使用建议
### 最佳实践
1. **组合搜索**:结合多个平台搜索,获得更全面的信息
2. **精确关键词**:使用专业术语提高搜索准确度
3. **利用技巧**:善用高级搜索语法过滤结果
4. **查看时间**:优先查看最新的技术文章和文档
5. **多语言搜索**:英文关键词搜国际平台,中文关键词搜国内平台
### 搜索策略
#### 学习新技术
1. 技术文档搜索 → 了解基础概念
2. GitHub搜索 → 查看优秀项目
3. StackOverflow → 解决常见问题
4. 掘金/CSDN → 阅读中文教程
#### 解决Bug
1. StackOverflow → 搜索错误信息
2. GitHub Issues → 查看相关问题
3. 技术社区 → 寻求帮助
#### 选择工具
1. NPM搜索 → 查找相关包
2. GitHub搜索 → 对比Star数
3. 技术文档 → 查看API和示例
---
## 📈 性能优化
v2.0.0 在保持轻量的同时,大幅提升了搜索体验:
- ⚡ 输入验证减少无效请求
- 🎯 智能建议提高搜索成功率
- 📚 多源搜索增加结果覆盖
- 🎨 格式优化提升可读性
- 🔗 快速导航节省查找时间
**代码规模**:
- 核心代码:~830行
- 无外部运行时依赖
- 启动速度:<100ms
- 内存占用:<10MB