效果如图：（Claude Code示例）

文本搜索（相似度语义搜索、全文搜索、混合搜索）

图片搜索

语音搜索

视频介绍

https://www.bilibili.com/video/BV14bfZBRE1k/

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

配置 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"
    }
  }
}

开始使用

对 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