小遥搜索v1.5.0版本更新【已支持-Agent Skills能力】

0 阅读2分钟

效果如图:(Claude Code示例)

文本搜索(相似度语义搜索、全文搜索、混合搜索)

图片搜索

语音搜索

视频介绍

www.bilibili.com/video/BV14b…


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 助手自动发现。

  1. 确保后端服务运行
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

📦 下载地址


🙏 致谢

感谢 Claude Agent Skills 规范,让 AI 助手能够更方便地使用小遥搜索的能力。


让我们一起打造更好的本地搜索体验! 🚀