{"id":"e293a9fe-0664-43dc-b352-74e3067a0577","shortId":"hbWcN6","kind":"skill","title":"xiaoyao-search","tagline":"小遥搜索 MCP 工具 - 本地文件智能搜索（语义/全文/图像/语音/混合搜索）","description":"## When to use\n\n当需要搜索本地文件时使用此 Skill：\n\n- 通过自然语言描述搜索本地文档\n- 查找包含特定关键词的文件\n- 用图片搜索相似的本地图片\n- 用语音转文字后搜索文件\n- 需要综合语义和全文搜索结果\n\n## Capability\n\n小遥搜索 MCP 服务器提供以下 5 个搜索工具：\n\n### 1. semantic_search（语义搜索）\n- **用途**：基于 BGE-M3 向量模型的语义搜索\n- **适用**：自然语言查询，如\"关于机器学习的文档\"\n- **参数**：\n  - `query`: string - 搜索关键词（1-500字符）\n  - `limit`: int - 返回结果数（1-100，默认20）\n  - `threshold`: float - 相似度阈值（0.0-1.0，默认0.5）\n  - `file_types`: string[] - 文件类型过滤（可选）\n\n### 2. fulltext_search（全文搜索）\n- **用途**：基于 Whoosh 的精确关键词匹配\n- **适用**：查找特定术语、代码片段\n- **参数**：\n  - `query`: string - 搜索关键词（1-500字符）\n  - `limit`: int - 返回结果数（1-100，默认20）\n  - `file_types`: string[] - 文件类型过滤（可选）\n\n### 3. hybrid_search（混合搜索）\n- **用途**：结合语义和全文搜索，RRF 算法融合结果\n- **适用**：需要全面搜索结果的场景\n- **参数**：\n  - `query`: string - 搜索关键词（1-500字符）\n  - `limit`: int - 返回结果数（1-100，默认20）\n  - `threshold`: float - 相似度阈值（0.0-1.0，默认0.5）\n  - `file_types`: string[] - 文件类型过滤（可选）\n\n### 4. image_search（图像搜索）\n- **用途**：基于 CN-CLIP 的图像相似度搜索\n- **适用**：用图片查找相似的本地文件\n- **参数**：\n  - `image_path`: string - 图片绝对路径\n  - `limit`: int - 返回结果数（1-100，默认20）\n  - `threshold`: float - 相似度阈值（0.0-1.0，默认0.5）\n\n### 5. voice_search（语音搜索）\n- **用途**：FasterWhisper 语音识别后搜索\n- **适用**：通过语音快速搜索本地文件\n- **参数**：\n  - `audio_path`: string - 音频绝对路径\n  - `search_type`: string - 搜索类型（semantic/fulltext/hybrid，默认semantic）\n  - `limit`: int - 返回结果数（1-100，默认20）\n  - `threshold`: float - 相似度阈值（0.0-1.0，默认0.5）\n\n## Usage\n\n### 前提条件\n\n1. 小遥搜索后端服务已启动（默认 http://127.0.0.1:8000）\n2. MCP 功能已启用（默认启用）\n3. 索引已构建完成\n\n### 调用方式\n\nClaude Code 通过 MCP 协议自动发现和调用工具：\n\n```\n用户：帮我找一下关于 Python 异步编程的文档\n→ Claude Code 调用 semantic_search(query=\"Python 异步编程\")\n→ 返回搜索结果\n→ Claude 基于结果回答用户\n```\n\n### 响应格式\n\n搜索结果返回 JSON 格式：\n```json\n{\n  \"total\": 10,\n  \"search_time\": 0.523,\n  \"results\": [\n    {\n      \"file_name\": \"async_guide.md\",\n      \"file_path\": \"D:/docs/async_guide.md\",\n      \"file_type\": \"markdown\",\n      \"relevance_score\": 0.95,\n      \"preview_text\": \"Python异步编程指南...\"\n    }\n  ]\n}\n```\n\n## Examples\n\n### 示例1：语义搜索\n```\n用户：查找关于机器学习算法优化的文档\n\n调用：semantic_search(\n  query=\"机器学习算法优化\",\n  limit=10,\n  threshold=0.5\n)\n```\n\n### 示例2：全文搜索\n```\n用户：查找包含 async def 的 Python 文件\n\n调用：fulltext_search(\n  query=\"async def\",\n  limit=20,\n  file_types=[\"python\"]\n)\n```\n\n### 示例3：图像搜索\n```\n用户：找一下跟这张图片相似的设计稿\n\n调用：image_search(\n  image_path=\"C:/Users/test/reference.png\",\n  limit=10\n)\n```\n\n### 示例4：语音搜索\n```\n用户：（语音输入）帮我找一下上周的会议记录\n\n调用：voice_search(\n  audio_path=\"C:/Users/test/voice.mp3\",\n  search_type=\"semantic\"\n)\n```\n\n### 示例5：混合搜索\n```\n用户：全面搜索关于 Vue3 组件开发的资料\n\n调用：hybrid_search(\n  query=\"Vue3 组件开发\",\n  limit=20,\n  threshold=0.6\n)\n```\n\n## Configuration\n\n### 环境变量\n\n| 变量名 | 默认值 | 说明 |\n|-------|--------|------|\n| MCP_SSE_ENABLED | true | 启用 MCP SSE |\n| MCP_SERVER_NAME | xiaoyao-search | 服务器名称 |\n| MCP_DEFAULT_LIMIT | 20 | 默认结果数 |\n| MCP_DEFAULT_THRESHOLD | 0.5 | 默认相似度阈值 |\n| MCP_VOICE_ENABLED | true | 启用语音搜索 |\n\n### 连接测试\n\n```bash\n# 测试 MCP SSE 端点\ncurl http://127.0.0.1:8000/mcp\n\n# 检查后端健康状态\ncurl http://127.0.0.1:8000/api/system/health\n```\n\n## Troubleshooting\n\n### 问题1：工具调用失败\n- 检查后端服务是否启动\n- 确认 MCP_SSE_ENABLED=true\n- 查看 /mcp 端点是否可访问\n\n### 问题2：搜索结果为空\n- 确认索引已构建\n- 检查查询词是否正确\n- 降低 threshold 值尝试\n\n### 问题3：图像/语音搜索失败\n- 确认文件路径为绝对路径\n- 检查文件格式是否支持\n- 检查文件大小是否在限制内（10MB）","tags":["xiaoyao","search","xiaoyaosearch","dtsola","agent-skills","ai-search","document-search","file-search","local-search","mcp","multimodal-ai","natural-language"],"capabilities":["skill","source-dtsola","skill-xiaoyao-search","topic-agent-skills","topic-ai-search","topic-document-search","topic-file-search","topic-local-search","topic-mcp","topic-multimodal-ai","topic-natural-language","topic-productivity","topic-semantic-search"],"categories":["xiaoyaosearch"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/dtsola/xiaoyaosearch/xiaoyao-search","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add dtsola/xiaoyaosearch","source_repo":"https://github.com/dtsola/xiaoyaosearch","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 1056 github stars · SKILL.md body (3,130 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-03T00:52:59.497Z","embedding":null,"createdAt":"2026-04-18T21:55:50.174Z","updatedAt":"2026-05-03T00:52:59.497Z","lastSeenAt":"2026-05-03T00:52:59.497Z","tsv":"'-1.0':60,123,157,189 '-100':54,89,117,151,183 '-500':48,83,111 '/docs/async_guide.md':242 '/mcp':387 '/users/test/reference.png':296 '/users/test/voice.mp3':310 '0.0':59,122,156,188 '0.5':265,357 '0.523':234 '0.6':329 '0.95':248 '1':29,47,53,82,88,110,116,150,182,193 '10':231,263,298 '10mb':402 '127.0.0.1':196,371,375 '2':67,198 '20':282,327,352 '3':96,202 '4':130 '5':27,159 '8000':197 '8000/api/system/health':376 '8000/mcp':372 'async':270,279 'async_guide.md':238 'audio':169,307 'bash':365 'bge':36 'bge-m3':35 'c':295,309 'capabl':23 'claud':205,214,223 'clip':138 'cn':137 'cn-clip':136 'code':206,215 'configur':330 'curl':370,374 'd':241 'def':271,280 'default':350,355 'enabl':337,361,384 'exampl':252 'fasterwhisp':164 'file':62,91,125,236,239,243,283 'float':57,120,154,186 'fulltext':68,276 'hybrid':97,321 'imag':131,143,291,293 'int':51,86,114,148,180 'json':227,229 'limit':50,85,113,147,179,262,281,297,326,351 'm3':37 'markdown':245 'mcp':5,25,199,208,335,340,342,349,354,359,367,382 'name':237,344 'path':144,170,240,294,308 'preview':249 'python':212,220,273,285 'python异步编程指南':251 'queri':44,79,107,219,260,278,323 'relev':246 'result':235 'rrf':102 'score':247 'search':3,31,69,98,132,161,173,218,232,259,277,292,306,311,322,347 'semant':30,217,258,313 'semantic/fulltext/hybrid':177 'server':343 'skill':17 'skill-xiaoyao-search' 'source-dtsola' 'sse':336,341,368,383 'string':45,64,80,93,108,127,145,171,175 'text':250 'threshold':56,119,153,185,264,328,356,394 'time':233 'topic-agent-skills' 'topic-ai-search' 'topic-document-search' 'topic-file-search' 'topic-local-search' 'topic-mcp' 'topic-multimodal-ai' 'topic-natural-language' 'topic-productivity' 'topic-semantic-search' 'total':230 'troubleshoot':377 'true':338,362,385 'type':63,92,126,174,244,284,312 'usag':191 'use':15 'voic':160,305,360 'vue3':318,324 'whoosh':73 'xiaoyao':2,346 'xiaoyao-search':1,345 '个搜索工具':28 '代码片段':77 '值尝试':395 '全文':9 '全文搜索':70,267 '全面搜索关于':317 '关于机器学习的文档':42 '前提条件':192 '功能已启用':200 '协议自动发现和调用工具':209 '参数':43,78,106,142,168 '变量名':332 '可选':66,95,129 '向量模型的语义搜索':38 '启用':339 '启用语音搜索':363 '响应格式':225 '图像':10,397 '图像搜索':133,287 '图片绝对路径':146 '基于':34,72,135 '基于结果回答用户':224 '如':41 '字符':49,84,112 '小遥搜索':4,24 '小遥搜索后端服务已启动':194 '工具':6 '工具调用失败':379 '帮我找一下上周的会议记录':303 '帮我找一下关于':211 '异步编程':221 '异步编程的文档':213 '当需要搜索本地文件时使用此':16 '找一下跟这张图片相似的设计稿':289 '搜索关键词':46,81,109 '搜索类型':176 '搜索结果为空':390 '搜索结果返回':226 '文件':274 '文件类型过滤':65,94,128 '服务器名称':348 '服务器提供以下':26 '本地文件智能搜索':7 '机器学习算法优化':261 '查找关于机器学习算法优化的文档':256 '查找包含':269 '查找包含特定关键词的文件':19 '查找特定术语':76 '查看':386 '格式':228 '检查后端健康状态':373 '检查后端服务是否启动':380 '检查文件大小是否在限制内':401 '检查文件格式是否支持':400 '检查查询词是否正确':392 '测试':366 '混合搜索':12,99,315 '环境变量':331 '用图片搜索相似的本地图片':20 '用图片查找相似的本地文件':141 '用户':210,255,268,288,301,316 '用语音转文字后搜索文件':21 '用途':33,71,100,134,163 '的':272 '的图像相似度搜索':139 '的精确关键词匹配':74 '相似度阈值':58,121,155,187 '确认':381 '确认文件路径为绝对路径':399 '确认索引已构建':391 '示例1':253 '示例2':266 '示例3':286 '示例4':299 '示例5':314 '端点':369 '端点是否可访问':388 '算法融合结果':103 '索引已构建完成':203 '组件开发':325 '组件开发的资料':319 '结合语义和全文搜索':101 '自然语言查询':40 '语义':8 '语义搜索':32,254 '语音':11 '语音搜索':162,300 '语音搜索失败':398 '语音识别后搜索':165 '语音输入':302 '说明':334 '调用':216,257,275,290,304,320 '调用方式':204 '返回搜索结果':222 '返回结果数':52,87,115,149,181 '连接测试':364 '适用':39,75,104,140,166 '通过':207 '通过自然语言描述搜索本地文档':18 '通过语音快速搜索本地文件':167 '问题1':378 '问题2':389 '问题3':396 '降低':393 '需要全面搜索结果的场景':105 '需要综合语义和全文搜索结果':22 '音频绝对路径':172 '默认':195 '默认0.5':61,124,158,190 '默认20':55,90,118,152,184 '默认semant':178 '默认值':333 '默认启用':201 '默认相似度阈值':358 '默认结果数':353","prices":[{"id":"3645a96c-cc1a-4e32-bf9d-da9e85baf80e","listingId":"e293a9fe-0664-43dc-b352-74e3067a0577","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"dtsola","category":"xiaoyaosearch","install_from":"skills.sh"},"createdAt":"2026-04-18T21:55:50.174Z"}],"sources":[{"listingId":"e293a9fe-0664-43dc-b352-74e3067a0577","source":"github","sourceId":"dtsola/xiaoyaosearch/xiaoyao-search","sourceUrl":"https://github.com/dtsola/xiaoyaosearch/tree/main/skills/xiaoyao-search","isPrimary":false,"firstSeenAt":"2026-04-18T21:55:50.174Z","lastSeenAt":"2026-05-03T00:52:59.497Z"}],"details":{"listingId":"e293a9fe-0664-43dc-b352-74e3067a0577","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"dtsola","slug":"xiaoyao-search","github":{"repo":"dtsola/xiaoyaosearch","stars":1056,"topics":["agent-skills","ai-search","document-search","file-search","local-search","mcp","multimodal-ai","natural-language","productivity","semantic-search"],"license":"other","html_url":"https://github.com/dtsola/xiaoyaosearch","pushed_at":"2026-04-28T16:59:13Z","description":"小遥搜索，听懂你的话、看懂你的图，用AI找到本地任何文件。让搜索像聊天一样简单。XiaoyaoSearch: Understands your words, reads your images, finds any local file with AI. Making search as easy as chatting.","skill_md_sha":"3075126f47d15e2db40f421fa37df456ed633314","skill_md_path":"skills/xiaoyao-search/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/dtsola/xiaoyaosearch/tree/main/skills/xiaoyao-search"},"layout":"multi","source":"github","category":"xiaoyaosearch","frontmatter":{"name":"xiaoyao-search","description":"小遥搜索 MCP 工具 - 本地文件智能搜索（语义/全文/图像/语音/混合搜索）"},"skills_sh_url":"https://skills.sh/dtsola/xiaoyaosearch/xiaoyao-search"},"updatedAt":"2026-05-03T00:52:59.497Z"}}