SuperAPI AI 工具集

semantic-search

编程与开发

查看项目

更新于 10-16 08:38

技能介绍

用途:该技能用于在文件与目录中搜索内容,结合关键词匹配与基础语义分析,适合查找实现某功能的代码、检索文档主题、按内容定位文件、发现相似代码模式以及研究代码库结构。

主要能力:支持关键词搜索;通过词干化匹配词形变化(如 run、running、ran);使用 TF-IDF 对结果相关性排序;可按扩展名和路径模式过滤文件;为每个匹配展示上下文行。评分范围为 0.0 至 1.0,匹配不区分大小写,仅搜索文本文件。

使用方式:安装命令为 cd /job 后执行 npm install natural compromise。基础用法为 const { searchFiles } = require('./semantic-search'); 并传入根目录与选项对象,选项可含 query、extensions、maxResults、excludeDirs、contextLines、minScore。也提供命令行形式,如 node index.js search "auth middleware" --ext .js,.ts --max 10,可用 --context 设置上下文行、--dir 指定目录。搜索结果的输出包含查询、匹配总数以及每个文件的相对路径、评分与匹配行信息。

适用场景:适合在源码与文档中按自然语言线索查找相关片段,或探索陌生代码库的结构。使用提示包括采用更具体的术语(如 JWT validation 而非仅 auth)、结合文件类型、使用多个词以提高准确度、搜索代码时用 camelCase 术语。

限制:不应用于搜索二进制文件(应使用文件工具)、精确正则匹配(应使用 grep)、以及超过 10 万个文件的超大仓库(应使用索引搜索)。每个文件默认最大处理 1MB,默认排除 node_modules、dist、build、.git、vendor、pycache、.next、.nuxt 等目录。资料未提供收费、价格、平台支持、性能基准与更多效果说明。