File Search

核心用法

file-search 是一个轻量级 Skill，封装了 Linux 生态中两款高性能搜索工具——fd（文件名搜索）和 rg/ripgrep（内容搜索）。用户可通过自然语言指令触发以下场景：

• 按文件名查找：支持正则匹配（如 \.rs$ 查找 Rust 源文件）和精确匹配（-g 参数）
• 按内容搜索：支持正则表达式全文检索、上下文行展示（-C 参数）、按文件类型过滤（--type）

所有命令示例均为标准 fd/rg 用法，无自定义封装逻辑，用户可直接复制到终端执行。

显著优点

1. 极致性能：fd 和 ripgrep 均以 Rust 编写，默认忽略 .gitignore 和隐藏文件，搜索速度比传统 find/grep 快数倍
2. 零依赖零风险：纯 Markdown 文档结构，无可执行代码、无第三方依赖、无网络调用
3. 开箱即用：自动检测 fd/rg 安装状态，提供 dnf 系一键安装指引
4. 开发者友好：语法高亮、路径示例清晰，降低新用户学习成本

潜在局限

• 平台限制：fd 和 ripgrep 主要面向类 Unix 系统（Linux/macOS），Windows 需额外配置或替代方案
• 功能边界：仅为命令示例合集，无交互式界面、无结果缓存、无跨会话历史记录
• 权限依赖：搜索系统目录需对应文件读取权限，Skill 本身不处理权限提升

适合人群

• 需要频繁在大型代码库中定位文件的软件开发者
• 习惯命令行工作流、追求效率的 DevOps 工程师
• 希望快速上手 fd/rg 的 Linux 新手用户

常规风险

该 Skill 本身无代码执行风险，但需注意：

• rg 搜索敏感目录（如 /etc）可能暴露配置文件内容
• 正则表达式编写不当可能导致大量无效匹配，消耗系统资源
• 建议在受信任环境中使用，避免搜索包含恶意文件名的目录（防范终端渲染类攻击）

核心用法

file-search 是一个纯文档型 Skill，提供两类核心搜索场景的命令示例：

1. 文件名搜索：使用 fd 工具，支持正则匹配（如 \.rs$）和精确匹配（-g 全局模式）
2. 内容搜索：使用 rg (ripgrep)，支持正则搜索、上下文行显示（-C）、文件类型过滤（--type）

显著优点

• 极速性能：fd 和 ripgrep 均为 Rust 编写，速度远超传统 find/grep
• 智能默认：自动忽略 .gitignore 文件、隐藏文件，结果更干净
• 直观语法：fd 无需通配符，ripgrep 自动递归且彩色高亮
• 零学习成本：Skill 仅提供即贴即用的命令模板，无需理解复杂参数

潜在缺点/局限性

• 环境依赖：必须预装 fd-find 和 ripgrep（非系统默认工具）
• Linux 局限：示例命令使用 dnf 包管理器，Debian/Ubuntu/macOS 用户需手动适配
• 无交互能力：纯文档 Skill，无法直接执行搜索，需用户手动复制粘贴
• 功能边界：不包含内容预览、批量替换、结果导出等进阶工作流

适合人群

• 需要频繁在代码库中定位文件或搜索文本的开发者
• 厌倦传统 find/grep 复杂语法的 Linux 用户
• 追求工具链现代化的技术爱好者

常规风险

• 命令注入风险：用户若直接复制示例到含特殊字符的路径，可能触发意外匹配（建议使用引号包裹路径）
• 权限问题：搜索系统目录需配合 sudo，但 Skill 未明确提示
• 结果误依赖：ripgrep 默认尊重 .gitignore，可能遗漏期望搜索的构建产物文件