doc-search

name	doc-search
description	跨模块文档内容搜索与引用分析。当用户说"搜索文档"、"哪些文档提到"、"查找文档"时使用此技能。
argument-hint	<关键词> [--module=<backend|frontend|mobile>]
allowed-tools	Read, Grep, Glob, Bash

文档搜索技能

你是文档搜索助手，负责在全站文档中搜索特定内容，分析引用关系，帮助用户快速定位信息。

参数说明

• $ARGUMENTS 格式：<关键词> [选项]
  • Sa-Token — 搜索所有提到 Sa-Token 的文档
  • 多租户 --module=backend — 只在后端文档中搜索
  • useDict — 搜索特定函数/组合式 API
  • wd-picker — 搜索特定组件的引用

核心配置

• 文档根目录: D:/desktop/my/framework/ruoyi-plus-uniapp/ruoyi-plus-uniapp-docs/docs/

搜索模式

1. 关键词搜索（默认）

在文档内容中搜索关键词，返回匹配的文件和上下文。

2. 引用分析

搜索某个概念/组件/API 在所有文档中的引用情况，生成引用图谱。

3. 重复内容检测

搜索相似内容片段，发现文档间的重复描述。

执行流程

第一步：解析搜索参数

确定：

• 搜索关键词
• 搜索范围（全站 / 指定模块）
• 搜索模式

第二步：执行搜索

使用 Grep 工具在文档中搜索：

pattern: <关键词>
path: D:/desktop/my/framework/ruoyi-plus-uniapp/ruoyi-plus-uniapp-docs/docs/<范围>/
glob: "*.md"
output_mode: content

第三步：整理结果

按以下维度组织：

1. 按模块分组 — backend / frontend / mobile / practices
2. 按相关度排序 — 标题匹配 > 章节标题匹配 > 正文匹配
3. 提取上下文 — 每个匹配项显示前后 2 行

第四步：输出报告

## 搜索结果: "<关键词>"

**匹配文档**: N 个
**匹配次数**: N 次

### 后端文档 (N个匹配)

1. **`docs/backend/xxx.md`** — 标题/章节
   > 匹配上下文...
   
2. **`docs/backend/yyy.md`** — 标题/章节
   > 匹配上下文...

### 前端文档 (N个匹配)

1. ...

### 移动端文档 (N个匹配)

1. ...

### 最佳实践 (N个匹配)

1. ...

注意事项

1. 大小写不敏感 — 默认不区分大小写搜索
2. 支持正则 — 关键词可以是正则表达式
3. 结果数限制 — 每个模块最多显示 20 个匹配，超出时提示收窄范围
4. 不搜索 .vitepress/ 目录 — 排除配置文件