\r \r

dir-text-search — 目录文本搜索技能\r

\r

功能概述\r

\r 在指定目录下递归搜索文本或正则表达式，支持：\r \r

• 文本文件（.txt .log .cfg .conf .ini .md .json .xml .py .java 等）\r
• 压缩包递归解压搜索（.zip .rar .tar .tar.gz .tar.bz2 .7z）\r
• 嵌套压缩包（解压后继续递归扫描）\r
• 多编码自动探测（UTF-8 → GBK → latin-1）\r
• 超大文件（> 100 MB）自动跳过并警告\r
• 结果按时间戳自动命名，保存在 search_results/ 子目录，不会覆盖旧结果\r \r

触发场景\r

\r 以下用户请求应加载本 Skill：\r \r

• "在 X 目录下查找 Y"\r
• "搜索所有日志中包含 error 的行"\r
• "在压缩包里找 Account_Main"\r
• "帮我 grep \d{4}-\d{2}-\d{2} 这个模式"\r
• 任何需要在文件/压缩包中批量搜索字符串或正则的请求\r \r

核心脚本\r

\r 脚本路径：scripts/search_tool.py\r \r

标准调用方式\r

\r

python scripts/search_tool.py --path \x3C目标目录> --pattern "\x3C搜索文本或正则>"\r
```\r
\r
### 参数说明\r
\r
| 参数 | 简写 | 说明 | 默认值 |\r
|------|------|------|--------|\r
| `--path` | `-p` | 要搜索的目标目录路径 | 交互式输入 |\r
| `--pattern` | `-t` | 搜索文本或正则表达式 | 交互式输入 |\r
| `--output` | `-o` | 结果保存目录（非文件名） | 脚本所在目录下的 `search_results/` |\r
| `--no-regex` | — | 将 pattern 作为普通字符串（自动转义元字符） | 否（默认正则模式） |\r
\r
### 结果文件位置\r
\r
每次执行自动生成：\r
```\r
search_results/\r
  20260415_101252_Account_Main.txt\r
  20260415_110000_error.txt\r
```\r
\r
## 执行流程\r
\r
1. **收集参数**：从用户消息中提取目标目录和搜索关键词。\r
2. **运行脚本**：调用 `scripts/search_tool.py`，传入 `--path` 和 `--pattern`。\r
3. **展示结果**：\r
   - 告知用户结果文件路径。\r
   - 读取结果文件，汇总每个命中文件的匹配行数。\r
   - 如有特别关键的匹配内容，摘要呈现给用户。\r
\r
## 依赖安装\r
\r
脚本使用 Python 标准库，可选依赖：\r
\r
```bash\r
pip install rarfile   # 支持 .rar 文件（还需系统安装 unrar）\r
pip install py7zr     # 支持 .7z 文件\r
```\r
\r
RAR 所需系统工具：\r
- **Windows**：下载 unrar.exe → https://www.rarlab.com/rar_add.htm\r
- **macOS**：`brew install unrar`\r
- **Linux**：`sudo apt install unrar`\r
\r
若用户未安装上述依赖，脚本会给出友好提示，ZIP/TAR 等格式不受影响仍可正常使用。\r
\r
## 注意事项\r
\r
- 不修改原始文件，只读。\r
- 解压到系统临时目录，搜索完成后自动清理。\r
- 防路径遍历攻击（对 ZIP/TAR 安全提取，拒绝含 `..` 的路径）。\r
- 对用户提供的 pattern，若不确定是否为正则，可加 `--no-regex` 参数安全处理。\r