效果如图:(Claude Code示例)
文本搜索(相似度语义搜索、全文搜索、混合搜索)
图片搜索
语音搜索
视频介绍
v1.5.0 版本更新说明
发布日期:2026年3月23日
版本类型:重大功能更新
主题:Agent Skills 支持
📋 版本概述
小遥搜索 v1.5.0 正式支持 Agent Skills,为 Claude Code、VS Code、Cursor 等 AI 助手提供标准化的 MCP 工具调用能力。
核心亮点
- 📖 标准化文档:遵循 Claude Agent Skills 规范
- 🔄 跨平台支持:支持 Claude Code、VS Code、Cursor、OpenCode、Codex
- 🎯 开箱即用:AI 助手可自动发现可用工具
- 📚 完整文档:包含使用指南、故障排查,最佳实践
📥 安装
OpenClaw
下载本项目到本地后,解压到 OpenClaw 的 SKILLS 目录下重启会话生效。
Claude Code
# 项目级别
cp -r skills/ .claude/skills/
# 或全局级别
cp -r skills/ ~/.claude/skills/
✨ 新增功能
Agent Skills 支持
什么是 Agent Skills?
Agent Skills 是 Claude Code 等 AI 助手的标准化能力文档规范。通过 Skill 文档,AI 助手可以:
- 自动发现可用的工具能力
- 理解工具的参数和返回值格式
- 提供正确的使用示例和最佳实践
小遥搜索 Skill 结构:
skills/xiaoyao-search/
├── SKILL.md # 主文件(工具定义)
└── rules/
├── tools.md # 工具详细参数定义
├── connection.md # 连接配置指南
└── examples.md # 使用示例
支持的 AI 助手:
| AI 助手 | 支持状态 | 配置方式 |
|---|---|---|
| Claude Code | ✅ 支持 | claude mcp add |
| Claude Desktop | ✅ 支持 | claude_desktop_config.json |
| VS Code (MCP) | ✅ 支持 | settings.json |
| Cursor | ✅ 支持 | settings.json |
| OpenCode | ✅ 支持 | config.json |
| Codex | ✅ 支持 | config.json |
📚 使用指南
方式一:使用 Skill 文档
小遥搜索 MCP 工具现在可以通过 Agent Skill 被 AI 助手自动发现。
- 确保后端服务运行
cd backend
python main.py
2. 配置 AI 助手连接
# Claude Code
claude mcp add --transport sse xiaoyao-search http://127.0.0.1:8000/mcp
# Claude Desktop (Windows)
# 编辑 %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"xiaoyao-search": {
"url": "http://127.0.0.1:8000/mcp",
"type": "sse"
}
}
}
3. 开始使用
-
- 对 AI 助手说:"帮我找一下关于 Python 异步编程的文档"
- AI 会自动调用 semantic_search 工具
- 返回搜索结果供 AI 分析和回答
方式二:直接使用 MCP
参考 v1.4.0 版本说明 中的 MCP 配置方式。
🔧 可用工具
| 工具名称 | 功能 | 参数 |
|---|---|---|
| semantic_search | 语义搜索(BGE-M3) | query, limit, threshold, file_types |
| fulltext_search | 全文搜索(Whoosh) | query, limit, file_types |
| hybrid_search | 混合搜索(BGE-M3 + Whoosh) | query, limit, threshold, file_types |
| image_search | 图像搜索(CN-CLIP) | image_path, limit, threshold |
| voice_search | 语音搜索(FasterWhisper) | audio_path, search_type, limit, threshold |
📦 下载地址
- 百度网盘:pan.baidu.com/s/1lDaWjMCR…
- GitHub:github.com/dtsola/xiao…
🙏 致谢
感谢 Claude Agent Skills 规范,让 AI 助手能够更方便地使用小遥搜索的能力。
让我们一起打造更好的本地搜索体验! 🚀